Factura Comercial de Exportación de Servicios

Método para la emisión de facturas para transacciones de exportación de servicios.

Modalidad Electrónica en Línea

POST https://sandbox.cucu.bo/api/v1/invoice/electronic/exportService

Modalidad Computarizada en Línea

POST https://sandbox.cucu.bo/api/v1/invoice/computarized/exportService

Cabecera de la factura

Parámetro	Tipo	Requerido	Descripción	Petición
posId	Int	Si	Id asignado al punto de venta.	Req / Res
branchId	Int	No	Id sucursal.	Req / Res
clientReasonSocial	String	Si	Razón Social o nombre registrado en el Padrón Nacional de Contribuyentes de la persona o empresa que emite la factura.	Req / Res
clientDocumentType	Int	Si	Autogenerado desde catálogos por el agrupador 9. (Valor que identifica el Tipo de Documento utilizado para la emisión de la factura).	Req / Res
clientNroDocument	String	Si	Número que corresponde al Tipo de Documento Identidad utilizado y al cual se realizará la facturación.	Req / Res
clientCode	String	Si	Código de identificación único del cliente, deberá ser asignado por el sistema de facturación del contribuyente.	Req / Res
paramPaymentMethod	Int	Si	Autogenerado desde catálogos por el agrupador 13. (Valor que identifica el método de pago. Por ejemplo 1 es efectivo).	Req / Res
userPos	String	Si	Identifica al usuario que emite la factura, deberá ser descriptivo. Por ejemplo JPEREZ.	Req / Res
clientComplement	String	No	Complemento de cliente.	Req / Res
clientCity	String	Si	Ciudad del cliente.	Req / Res
exceptionCode	Int	No	Valor que se envía para autorizar el registro de una factura con NIT inválido. Enviar uno (1) cuando se autorice el registro.	Req / Res
numberCard	Int	No	Cuando el método de pago es 2 (Tarjeta), debe enviarse este valor.	Req / Res
nitEmissor	Int	Si	Número de NIT registrado en el Padrón Nacional de Contribuyentes que corresponde a la persona o empresa que emite la factura.	Res
cuf	String	Si	Código único de factura.	Res
invoiceNumber	Int	Si	Número de factura emitida.	Res
qrCode	String	Si	Código Qr que redirecciona a la pagina de SIAT y su respectiva factura.	Res
dateEmission	String	Si	Fecha y hora en la cual se emite la factura.	Res
amountTotal	Int	Si	Monto total por el cual se realiza el hecho generador.	Res
amountTotalDiscount	Int	Si	Monto Adicional al descuento por item.	Res
amountTotalCurrency	Int	Si	Es el Monto Total expresado en el tipo de moneda, si el código de moneda es boliviano deberá ser igual al monto total.	Res
userCashier	String	No	Usuario que esta a cargo del sistema para realizar el proceso de entrega de la factura.	Res
siatCodeState	Int	Si	Código de estado.	Res
siatCodeReception	String	Si	Código de recepción.	Res
siatDescriptionStatus	String	Si	Descripción del estado	Res
countItems	Int	Si	Número de productos.	Res
invoiceXml	String	Si	Xml de la factura.	Res
invoiceCode	String	Si	Código corto de la factura (invoiceCode).	Res
clientEmail	String	Si	Email del cliente.	Req
additionalDiscount	Int	No	Monto Adicional al descuento por item	Req
invoiceUrl	String	Si	Ruta publica de la factura.	Res
paramCurrency	Int	Si	Autogenerado desde catálogos por el agrupador 14. (Valor que identifica la moneda).	Req
exchangeRate	Float	Si	Tipo de cambio de acuerdo a la moneda en la que se realiza el hecho generador, si el código de moneda es boliviano deberá ser igual a 1.	Req
observations	String	No	Información Adicional.	Req
buyerAddress	String	Si	Dirección donde se está exportando.	Req
destinationPlace	String	Si	Lugar al cual se está realizando la exportación.	Req
codeCountry	Int	Si	Autogenerado desde catálogos por el agrupador 8. (Valor que identifica el código de pais).	Req

Detalle de Factura

Parámetro	Tipo	Requerido	Descripción	Petición
detailInvoice	Array	Si	Detalle de los productos de la factura.	Req / Res
activityEconomic	String	Si	Actividad económica registrada en el Padrón Nacional de Contribuyentes relacionada al NIT.	Req / Res
unitMeasure	Int	Si	Autogenerado desde catálogos por el agrupador 17. (Valor que identifica la unidad de medida).	Req / Res
codeProductSin	String	Si	Homologado a los códigos de productos genéricos enviados por impuestos (ver agrupador 1 de catálogos).	Req / Res
codeProduct	String	Si	Código que otorga el contribuyente a su servicio o producto.	Req / Res
description	String	Si	Descripción que otorga el contribuyente a su servicio o producto.	Req / Res
qty	Int	Si	Cantidad del producto o servicio otorgado. En caso de servicio este valor debe ser 1.	Req / Res
priceUnit	Int	Si	Precio que otorga el contribuyente a su servicio o producto.	Req / Res
amountDiscount	Int	No	Monto de descuento sobre el producto o servicio específico, Si no aplica deberá ser nulo.	Req / Res
subTotal	Int	Si	El subtotal es igual a la (cantidad * precio unitario) – descuento.	Res

Request

json

{
  "posId": 1,
  "clientReasonSocial": "VIDAURRE",
  "clientDocumentType": 5,
  "clientNroDocument": "1410245015",
  "exceptionCode": 1,
  "clientCode": "ADMINCLIENT",
  "clientComplement": null,
  "clientEmail": "prueba@gmail.com",
  "paramPaymentMethod": 1,
  "userPos": "USRTESTB341",
  "clientCity": "SANTA CRUZ",
  "paramCurrency": 2,
  "exchangeRate": 6.96,
  "buyerAddress": "LA PAZ",
  "destinationPlace": "PERU",
  "codeCountry": 5,
  "observations": "COMERCIO DE SERVICIO DE CONSULTORIA",
  "additionalDiscount": 10,
  "detailInvoice": [
    {
      "activityEconomic": "620100",
      "unitMeasure": 58,
      "codeProductSin": 83141,
      "codeProduct": "177",
      "description": "VISTOS BUENOS C/IMPUESTO",
      "qty": 1,
      "priceUnit": 100,
      "amountDiscount": 50
    }
  ]
}

Response

json

{
  "message": "COMPLETED_EXPORT_SERVICES",
  "errors": null,
  "success": true,
  "data": {
    "nitEmissor": 6822046012,
    "invoiceCode": "28FE72CE",
    "cuf": "1D2C888524A5A792AC2C111AD718AF77BAE2C8FC6C9661364C48207D74",
    "invoiceNumber": 30,
    "qrCode": "https://pilotosiat.impuestos.gob.bo/consulta/QR?nit=6822046012&cuf=1D2C888524A5A792AC2C111AD718AF77BAE2C8FC6C9661364C48207D74&numero=30&t=2",
    "invoiceUrl": "/pdf?code=28FE72CE9fh6Yj7HikcyCiSJXJNJ&client=GQQX0A8NNZOK8DN2FN246B244",
    "dateEmission": "2022-11-29T16:38:32.425",
    "amountTotal": 0.0,
    "amountTotalDiscount": 10.0,
    "amountTotalCurrency": 40.0,
    "userCashier": "USRTESTB341",
    "siatCodeState": 901,
    "siatCodeReception": null,
    "siatDescriptionStatus": "VALIDADA",
    "countItems": 1,
    "invoiceXml": "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>\n<facturaComputarizadaComercialExportacionServicio>\n    <cabecera>\n        <nitEmisor></nitEmisor>\n        <razonSocialEmisor>HILARA APAZA CAROLA ESTHER</razonSocialEmisor>\n        <municipio>LA PAZ</municipio>\n        <telefono></telefono>\n        <numeroFactura>30</numeroFactura>\n        <cuf>1D2C888524A5A792AC2C111AD718AF77BAE2C8FC6C9661364C48207D74</cuf>\n        <cufd>BQVVCdVU6R0E=Nz0Y1OTc5ODA2REY=Q1VeWm1RZUxXVUFI1MUNFNzUyNjE5N</cufd>\n        <codigoSucursal>0</codigoSucursal>\n        <direccionNA  IRPAVI</direccion>\n        <codigoPuntoVenta>0</codigoPuntoVenta>\n        <fechaEmision>2022-11-29T16:38:32.425</fechaEmision>\n        <nombreRazonSocial>VIDAURRE</nombreRazonSocial>\n        <codigoTipoDocumentoIdentidad>5</codigoTipoDocumentoIdentidad>\n        <numeroDocumento>1410245015</numeroDocumento>\n        <complemento xsi:nil=\"true\" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"/>\n        <direccionComprador>ssdsdsd</direccionComprador>\n        <codigoCliente>ADMINCLIENT</codigoCliente>\n        <lugarDestino>asdsdds</lugarDestino>\n        <codigoPais>5</codigoPais>\n        <codigoMetodoPago>1</codigoMetodoPago>\n        <numeroTarjeta xsi:nil=\"true\" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"/>\n        <montoTotal>40.0</montoTotal>\n        <montoTotalSujetoIva>0.0</montoTotalSujetoIva>\n        <codigoMoneda>1</codigoMoneda>\n        <tipoCambio>1.0</tipoCambio>\n        <montoTotalMoneda>40.0</montoTotalMoneda>\n        <informacionAdicional>sdsdsdsd</informacionAdicional>\n        <descuentoAdicional>10.0</descuentoAdicional>\n        <codigoExcepcion>1</codigoExcepcion>\n        <cafc xsi:nil=\"true\" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"/>\n        <leyenda>Ley N° 453: La interrupción del servicio debe comunicarse con anterioridad a las Autoridades que correspondan y a los usuarios afectados.</leyenda>\n        <usuario>USRTESTB341</usuario>\n        <codigoDocumentoSector>28</codigoDocumentoSector>\n    </cabecera>\n    <detalle>\n        <actividadEconomica>620100</actividadEconomica>\n        <codigoProductoSin>83141</codigoProductoSin>\n        <codigoProducto>177</codigoProducto>\n        <descripcion>VISTOS BUENOS C/IMPUESTO</descripcion>\n        <cantidad>1</cantidad>\n        <unidadMedida>58</unidadMedida>\n        <precioUnitario>100.0</precioUnitario>\n        <montoDescuento>50.0</montoDescuento>\n        <subTotal>50.0</subTotal>\n    </detalle>\n</facturaComputarizadaComercialExportacionServicio>\n",
    "detailInvoice": [
      {
        "detailId": 21529,
        "activityEconomic": "620100",
        "codeProductSin": "83141",
        "codeProduct": "177",
        "description": "VISTOS BUENOS C/IMPUESTO",
        "qty": 1.0,
        "unitMeasure": 58,
        "priceUnit": 100.0,
        "amountDiscount": 50.0,
        "subTotal": 50.0,
        "numberSerial": null,
        "numberImei": null
      }
    ]
  }
}

Anulación de la Factura

Se permite hacer la anulación de la factura en su modalidad correspondiente.

Modalidad Electrónica en Línea

POST https://sandbox.cucu.bo/api/v1/invoice/electronic/exportService/anulation

Modalidad Computarizada en Línea

POST https://sandbox.cucu.bo/api/v1/invoice/computarized/exportService/anulation

Parámetro	Tipo	Requerido	Descripción	Petición
posId	Int	Si	Id asignado.	Req / Res
branchId	Int	No	Id sucursal.
invoiceCode	String	Si	Código de factura que está siendo anulado.	Req / Res
codeMotive	Int	Si	Autogenerado desde catálogos por el agrupador 7. (Indica el motivo por el cual la Factura está siendo anulada).	Req / Res
invoiceNumber	Int	Si	Número de factura que está siendo anulado.	Req / Res
siatCodeState	Int		Código de estado enviado por el SIN.	Res
siatDescriptionStatus	String		Descripción del estado enviado por el SIN.	Res
qrCode	String		Código Qr que redirecciona a la pagina de SIAT y su respectiva factura.	Res

Request

json

{
  "invoiceCode": "28FE72CE",
  "posId": 1,
  "codeMotive": 1,
  "invoiceNumber": 30
}

Response

json

{
  "message": "COMPLETED_EXPORT_SERVICES",
  "errors": null,
  "success": true,
  "data": {
    "invoiceNumber": 30,
    "cuf": "1D2C888524A5A792AC2C111AD718AF77BAE2C8FC6C9661364C48207D74",
    "siatCodeState": 905,
    "siatDescriptionStatus": "ANULACION CONFIRMADA",
    "qrCode": "https://pilotosiat.impuestos.gob.bo/consulta/QR?nit=6822046012&cuf=1D2C888524A5A792AC2C111AD718AF77BAE2C8FC6C9661364C48207D74&numero=30&t=2",
    "invoiceCode": "28FE72CE"
  }
}

Factura Comercial de Exportación de Servicios #

Modalidad Electrónica en Línea #

Modalidad Computarizada en Línea #

Cabecera de la factura #

Detalle de Factura #

Request #

Response #

Anulación de la Factura #

Modalidad Electrónica en Línea #

Modalidad Computarizada en Línea #

Request #

Response #

Factura Comercial de Exportación de Servicios

Modalidad Electrónica en Línea

Modalidad Computarizada en Línea

Cabecera de la factura

Detalle de Factura

Request

Response

Anulación de la Factura

Modalidad Electrónica en Línea

Modalidad Computarizada en Línea

Request

Response