Skip to content
Página

Factura de Compra y Venta

Método para la emisión de facturas de compra y venta en las modalidades electrónica y computarizada respectivamente.

Modalidad Electrónica en Línea

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

Modalidad Computarizada en Línea

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

Cabecera de la factura

ParámetroTipoRequeridoDescripciónPetición
posIdIntSiId asignado al punto de venta.Req / Res
branchIdIntNoId sucursal.Req / Res
clientReasonSocialStringSiRazón Social o nombre registrado en el Padrón Nacional de Contribuyentes de la persona o empresa que emite la factura.Req / Res
clientDocumentTypeIntSiAutogenerado desde catálogos por el agrupador 9. (Valor que identifica el Tipo de Documento utilizado para la emisión de la factura).Req / Res
clientNroDocumentStringSiNúmero que corresponde al Tipo de Documento Identidad utilizado y al cual se realizará la facturación.Req / Res
clientCodeStringSiCódigo de identificación único del cliente, deberá ser asignado por el sistema de facturación del contribuyente.Req / Res
paramPaymentMethodIntSiAutogenerado desde catálogos por el agrupador 13. (Valor que identifica el método de pago. Por ejemplo 1 es efectivo).Req / Res
userPosStringSiIdentifica al usuario que emite la factura, deberá ser descriptivo. Por ejemplo JPEREZ.Req / Res
typeInvoiceIntSiTipo de la factura, valores permitidos:
1 = Factura con Derecho a Crédito Fiscal
2 = Factura sin Derecho a Crédito Fiscal
3 = Documento de Ajuste
Req / Res
paramCurrencyIntSiAutogenerado desde catálogos por el agrupador 14. (Valor que identifica la moneda).Req / Res
clientComplementStringNoComplemento de cliente.Req / Res
clientCityStringSiCiudad del cliente.Req / Res
exceptionCodeIntNoValor 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
numberCardIntNoCuando el método de pago es 2 (Tarjeta), debe enviarse este valor.Req / Res
giftCardIntNoMonto a ser cancelado con una Gift Card.Req / Res
nitEmissorIntSiNúmero de NIT registrado en el Padrón Nacional de Contribuyentes que corresponde a la persona o empresa que emite la factura.Res
cufStringSiCódigo único de factura.Res
invoiceNumberIntSiNúmero de factura emitida.Res
qrCodeStringSiCódigo Qr que redirecciona a la pagina de SIAT y su respectiva factura.Res
dateEmissionStringSiFecha y hora en la cual se emite la factura automático. (Si esta en evento con cafc mandar fecha manual dentro del rango del evento)Req / Res
amountTotalIntSiMonto total por el cual se realiza el hecho generador.Res
amountTotalDiscountIntSiMonto Adicional al descuento por item.Res
amountTotalCurrencyIntSiEs el Monto Total expresado en el tipo de moneda, si el código de moneda es boliviano deberá ser igual al monto total.Res
userCashierStringNoUsuario que esta a cargo del sistema para realizar el proceso de entrega de la factura.Res
siatCodeStateIntSiCódigo de estado.Res
siatCodeReceptionStringSiCódigo de recepción.Res
siatDescriptionStatusStringSiDescripción del estadoRes
countItemsIntSiNúmero de productos.Res
invoiceXmlStringSiXml de la factura.Res
invoiceCodeStringSiCódigo corto de la factura (invoiceCode).Res
clientEmailStringSiEmail del cliente.Req
additionalDiscountIntNoMonto Adicional al descuento por itemReq
invoiceUrlStringSiRuta publica de la factura.Res

Detalle de Factura

ParámetroTipoRequeridoDescripciónPetición
detailInvoiceArraySiDetalle de los productos de la factura.Req / Res
activityEconomicStringSiActividad económica registrada en el Padrón Nacional de Contribuyentes relacionada al NIT.Req / Res
unitMeasureIntSiAutogenerado desde catálogos por el agrupador 17. (Valor que identifica la unidad de medida).Req / Res
codeProductSinStringSiHomologado a los códigos de productos genéricos enviados por impuestos (ver agrupador 1 de catálogos).Req / Res
codeProductStringSiCódigo que otorga el contribuyente a su servicio o producto.Req / Res
descriptionStringSiDescripción que otorga el contribuyente a su servicio o producto.Req / Res
qtyIntSiCantidad del producto o servicio otorgado. En caso de servicio este valor debe ser 1.Req / Res
priceUnitIntSiPrecio que otorga el contribuyente a su servicio o producto.(puede contener decimales ejem. 9.99)Req / Res
amountDiscountIntNoMonto de descuento sobre el producto o servicio específico, Si no aplica deberá ser nulo.Req / Res
subTotalIntSiEl subtotal es igual a la (cantidad * precio unitario) – descuento.Res
numberSerialIntNoNúmero de serie correspondiente al producto vendido de línea blanca o negra. Nulo en otro caso.Res
numberImeiIntNoNúmero de Imei del celular vendido, nulo en otro caso.Res

Request

json
{
  "posId": 1,
  "clientReasonSocial": "CLIENTE TEST",
  "clientDocumentType": 1,
  "clientNroDocument": 123456789,
  "clientCode": "CLIENTE2-TEST",
  "paramPaymentMethod": 1,
  "userPos": "S4INC12ABCX",
  "typeInvoice": 1,
  "paramCurrency": 1,
  "clientComplement": 1,
  "clientCity": "Santa Cruz",
  "clientEmail": "cliente@gmail.com",
  "detailInvoice": [
    {
      "activityEconomic": "620100",
      "unitMeasure": 11,
      "codeProductSin": 83141,
      "codeProduct": "CC-SRVSISCLOUD123",
      "description": "IMPLEMETACION DE SISTEMAS EN LA NUBE",
      "qty": 2,
      "priceUnit": 1000
    },
    {
      "activityEconomic": "620100",
      "unitMeasure": 23,
      "codeProductSin": "83141",
      "codeProduct": "CC-SRVSISCLOUD124",
      "description": "IMPLEMETACION DE SISTEMAS EN LA NUBE V1",
      "qty": 1,
      "priceUnit": 600,
      "amountDiscount": 10
    }
  ]
}

Response

json
{
  "message": "COMPLETED",
  "errors": null,
  "success": true,
  "data": {
    "nitEmissor": 6822046012,
    "invoiceCode": "D6A0D688",
    "cuf": "1D2C888524*****************1B887CDFDC74",
    "invoiceNumber": 1,
    "qrCode": "https://pilotosiat.impuestos.gob.bo/consulta/QR?nit=6822046012&cuf=1D2C888524A53036C3A38518F1E3AA21C963E8606A883D1B887CDFDC74&numero=1&t=1",
    "invoiceUrl": "/pdf?code=DC3E4E6TUWxbaS36JJ0w3iOcmlfb&client=10T9ATSWLFY5GOFRETODKH6BF",
    "dateEmission": "2021-12-13T20:46:54.305",
    "amountTotal": 2580.0,
    "amountTotalDiscount": 10.0,
    "amountTotalCurrency": 2580.0,
    "userCashier": "S4INC12ABCX",
    "siatCodeState": 908,
    "siatCodeReception": "2b10887***********a**e133**f60",
    "siatDescriptionStatus": "accepted",
    "countItems": 2,
    "invoiceXml": "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>\n<facturaComputarizadaCompraVenta>\n    <cabecera>\n        <nitEmisor></nitEmisor>\n        <razonSocialEmisor></facturaComputarizadaCompraVenta>\n",
    "detailInvoice": [
      {
        "detailId": 3,
        "activityEconomic": "620100",
        "codeProductSin": "83141",
        "codeProduct": "CC-SRVSISCLOUD123",
        "description": "IMPLEMETACION DE SISTEMAS EN LA NUBE",
        "qty": 2.0,
        "unitMeasure": 11,
        "priceUnit": 1000.0,
        "amountDiscount": 0.0,
        "subTotal": 2000.0,
        "numberSerial": null,
        "numberImei": null
      },
      {
        "detailId": 4,
        "activityEconomic": "620100",
        "codeProductSin": "83141",
        "codeProduct": "CC-SRVSISCLOUD124",
        "description": "IMPLEMETACION DE SISTEMAS EN LA NUBE V1",
        "qty": 1.0,
        "unitMeasure": 23,
        "priceUnit": 600.0,
        "amountDiscount": 10.0,
        "subTotal": 590.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/sale/anulation

Modalidad Computarizada en Línea

POST https://sandbox.cucu.bo/api/v1/invoice/computarized/sale/anulation
ParámetroTipoRequeridoDescripciónPetición
posIdIntSiId asignado.Req / Res
branchIdIntNoId sucursal.
invoiceCodeStringSiCódigo de factura que está siendo anulado.Req / Res
codeMotiveIntSiAutogenerado desde catálogos por el agrupador 7. (Indica el motivo por el cual la Factura está siendo anulada).Req / Res
invoiceNumberIntSiNúmero de factura que está siendo anulado.Req / Res
siatCodeStateIntCódigo de estado enviado por el SIN.Res
siatDescriptionStatusStringDescripción del estado enviado por el SIN.Res
qrCodeStringCódigo Qr que redirecciona a la pagina de SIAT y su respectiva factura.Res

Request

json
{
  "invoiceCode": "D80C9B77",
  "posId": 1,
  "codeMotive": 1,
  "invoiceNumber": 5
}

Response

json
{
  "message": "COMPLETED_SALE",
  "errors": null,
  "success": true,
  "data": {
    "invoiceNumber": 5,
    "cuf": "1D2C888524A59DA163372084D5C6D0EF29B39A4212405AA79B33246D74",
    "siatCodeState": 905,
    "siatDescriptionStatus": "ANULACION CONFIRMADA",
    "qrCode": "https://pilotosiat.impuestos.gob.bo/consulta/QR?nit=6822046012&cuf=1D2C888524A59DA163372084D5C6D0EF29B39A4212405AA79B33246D74&numero=5&t=2",
    "invoiceCode": "D80C9B77"
  }
}