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á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 |
invoiceNumber | Int | Si | Número de factura que está siendo anulado. | Req / Res |
cuf | String | Si | Código único de factura. | Res |
userPos | String | Si | Usuario del punto de venta | 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 nota crédito - débito emitida. | Res |
qrCode | String | Si | Código Qr que redirecciona a la pagina de SIAT y su respectiva factura. | Res |
qrCodeDownload | String | Si | Código para descargar el Qr. | Res |
dateEmission | String | Si | Fecha y hora en la cual se emite la factura. | Res |
userCashier | String | No | Usuario que esta a cargo del sistema para realizar el proceso de entrega de la factura. | Res |
invoiceXml | String | Si | Xml de la factura. | Res |
amountTotalDiscount | Int | Si | Monto total de descuento. | 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 |
amountTotalOriginal | Int | Si | Monto total Sujeto a Crédito fiscal en la factura Original. | Res |
amountTotalReturn | Int | Si | Monto total que está siendo devuelto. | Res |
amountLiteralReturn | String | Si | Monto total que está siendo devuelto de forma literal. | Res |
amountDiscountCreditDebit | Int | Si | Monto de descuento efectuado. | Res |
amountCashCreditDebit | Int | Si | Trece por ciento (13%) del monto total devuelto. | Res |
invoiceCode | String | Si | Código corto de la factura (invoiceCode). | Res/Req |
invoiceUrl | String | Si | Ruta publica de la factura. | Res |
Detalle de Nota Crédito - Débito
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 el SIN (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 |
returnProduct | Boolean | Si | Producto que sera devuelto. | Req / Res |
subTotal | Int | Si | El subtotal es igual a la (cantidad * precio unitario) – descuento. | Res |
numberSerial | Int | No | Número de serie correspondiente al producto vendido de línea blanca o negra. Nulo en otro caso. | Res |
numberImei | Int | No | Número de Imei del celular vendido. Nulo en otro caso. | Res |
codeDetailTransaction | Int | Si | Có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ámetro | Tipo | Requerido | Descripción | Petición |
---|---|---|---|---|
invoiceCode | String | Si | Código de factura que está siendo anulado. | Req / Res |
posId | Int | Si | Id asignado. | 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 | Numero 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 | Codigo 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"
}
}