Skip to content
Página

Nota Crédito - Débito

Método para realizar ajustes en el Crédito y Débito Fiscal de los Sujetos Pasivos o compradores.

Modalidad Electrónica en Línea

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

Modalidad Computarizada en Línea

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

Cabecera de Nota Crédito - Débito

ParámetroTipoRequeridoDescripciónPetición
posIdIntSiId asignado al punto de venta.Req / Res
branchIdIntNoId sucursal.Req / Res
invoiceNumberIntSiNúmero de factura que está siendo anulado.Req / Res
cufStringSiCódigo único de factura.Res
userPosStringSiUsuario del punto de ventaReq / 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 nota crédito - débito emitida.Res
qrCodeStringSiCódigo Qr que redirecciona a la pagina de SIAT y su respectiva factura.Res
qrCodeDownloadStringSiCódigo para descargar el Qr.Res
dateEmissionStringSiFecha y hora en la cual se emite la factura.Res
userCashierStringNoUsuario que esta a cargo del sistema para realizar el proceso de entrega de la factura.Res
invoiceXmlStringSiXml de la factura.Res
amountTotalDiscountIntSiMonto total de descuento.Res
siatCodeStateIntSiCódigo de estado.Res
siatCodeReceptionStringSiCódigo de recepción.Res
siatDescriptionStatusStringSiDescripción del estado.Res
countItemsIntSiNúmero de productos.Res
amountTotalOriginalIntSiMonto total Sujeto a Crédito fiscal en la factura Original.Res
amountTotalReturnIntSiMonto total que está siendo devuelto.Res
amountLiteralReturnStringSiMonto total que está siendo devuelto de forma literal.Res
amountDiscountCreditDebitIntSiMonto de descuento efectuado.Res
amountCashCreditDebitIntSiTrece por ciento (13%) del monto total devuelto.Res
invoiceCodeStringSiCódigo corto de la factura (invoiceCode).Res/Req
invoiceUrlStringSiRuta publica de la factura.Res

Detalle de Nota Crédito - Débito

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 el SIN (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.Req / Res
amountDiscountIntNoMonto de descuento sobre el producto o servicio específico, Si no aplica deberá ser nulo.Req / Res
returnProductBooleanSiProducto que sera devuelto.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
codeDetailTransactionIntSiCódigo que permite especificar si se trata de la transacción original (enviar 1) o del monto que está siendo devuelto (enviar 2).Res

Request

json
{
  "posId": 1,
  "invoiceNumber": 3006,
  "invoiceCode": "517142F8",
  "userPos": "USERNEW123",
  "detailInvoice": [
    {
      "detailId": 192,
      "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,
      "returnProduct": true
    }
  ]
}

Response

json
{
  "message": "COMPLETED",
  "errors": null,
  "success": true,
  "data": {
    "nitEmissor": 6822046012,
    "cuf": "1D2C888524A5303**********************429F67CDFDC74",
    "invoiceNumber": 3,
    "invoiceCode": "C123282A",
    "qrCode": "https://pilotosiat.impuestos.gob.bo/consulta/QR?nit=6822046012&cuf=1D2C888524A53036C451B7CCD559632ECD8988A93E270429F67CDFDC74&numero=3&t=1",
    "qrCodeDownload": "https://pilotosiat.impuestos.gob.bo/consulta/factura?nit=6822046012&cuf=1D2C888524A53036C451B7CCD559632ECD8988A93E270429F67CDFDC74&numero=3&t=1",
    "dateEmission": "2021-12-13T20:55:16.892",
    "userCashier": "USERNEW123",
    "invoiceXml": "<notaFiscalElectronicaCreditoDebito xmlns:ns2=\"http://www.w3.org/2000/09/xmldsig#\">\n    <cabecera>\n        <nitEmisor>6</nitEmisor>\n        <razonSocialEmisor>HR</razonSocialEmisor>\n        <municipio>Murillo</municipio>\n        <telefono>12345678</telefono>\n        <numeroNotaCreditoDebito>3</numeroNotaCreditoDebito>\n        fechaEmisionFactura>\n        <montoTotalOriginal>2000.0</montoTotalOriginal>\n        <montoTotalDevuelto>590.0</montoTotalDevuelto>\n        <montoDescuentoCreditoDebito xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" xsi:nil=\"true\"></montoDescuentoCreditoDebito>\n        <subTotal>2000.0</subTotal>\n        <codigoDetalleTransaccion>1</codigoDetalleTransaccion>\n    </detalle>\n    <detalle>\n        <actividadEconomica>620100</actividadEconomica>\n        <codigoProductoSin>83141</codigoProductoSin>\n        <codigoProducto>CC-SRVSISCLOUD124</codigoProducto>\n        <descripcion>IMPLEMETACION DE SISTEMAS EN LA NUBE V1</descripcion>\n        <cantidad>1.0</cantidad>\n        <unidadMedida>23</unidadMedida>\n        <precioUnitario>600.0</precioUnitario>\n        <montoDescuento>10.0</montoDescuento>\n        <subTotal>590.0</subTotal>\n        </notaFiscalElectronicaCreditoDebito>",
    "amountTotalDiscount": null,
    "siatCodeState": 908,
    "siatCodeReception": "45cd3501-5c78-11ec-bcab-cf3b2025231a",
    "siatDescriptionStatus": "accepted",
    "countItems": 4,
    "amountTotalOriginal": 2000.0,
    "amountTotalReturn": 590.0,
    "amountLiteralReturn": "QUINIENTOS NOVENTA 00/100 BOLIVIANOS",
    "amountDiscountCreditDebit": null,
    "amountCashCreditDebit": 76.7,
    "detailInvoice": [
      {
        "detailId": 7,
        "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,
        "codeDetailTransaction": 1
      },
      {
        "detailId": 8,
        "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,
        "codeDetailTransaction": 1
      },
      {
        "detailId": 9,
        "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,
        "codeDetailTransaction": 2
      }
    ]
  }
}

Anulación de Factura

Permite anular una nota crédito - débito registrada en impuestos como requisito para este recurso se debe proporcionar el motivo por el cual se esta anulando la nota además del idVenta que se quiere anular.

Modalidad Electrónica en Línea

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

Modalidad Computarizada en Línea

POST https://sandbox.cucu.bo/api/v1/invoice/computarized/debit/anulation
ParámetroTipoRequeridoDescripciónPetición
invoiceCodeStringSiCódigo de factura que está siendo anulado.Req / Res
posIdIntSiId asignado.Req / Res
codeMotiveIntSiAutogenerado desde catálogos por el agrupador 7. (Indica el motivo por el cual la Factura está siendo anulada).Req / Res
invoiceNumberIntSiNumero 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
qrCodeStringCodigo Qr que redirecciona a la pagina de SIAT y su respectiva factura.Res

Request

json
{
  "invoiceCode": "07010F59",
  "posId": 1,
  "codeMotive": 1,
  "invoiceNumber": 7
}

Response

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