Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.cucu.bo/llms.txt

Use this file to discover all available pages before exploring further.

Documento de ajuste que permite corregir o anular parcialmente una factura ya emitida. Obligatorio para devoluciones despues de 30 dias de la emision original.

​
Datos del sector

CampoValor
Sector SIAT24 (Documento de Ajuste)
WSDL SIATServicioFacturacionDocumentoAjuste
Tipo internoNOTE_CREDIT_DEBIT

​
Endpoint dedicado

Las notas de credito/debito se crean a partir de una factura original existente usando un endpoint dedicado: 
POST /api/v1/invoices/{originalInvoiceId}/credit-note
A diferencia de otros documentos sector, las notas no se crean via POST /api/v1/invoices. Usa el endpoint dedicado que obtiene automaticamente los datos de la factura original (cliente, CUF, montos, items).
Ver la referencia completa del endpoint en Crear Nota Credito/Debito.

​
Como funciona

  1. Envias el UUID de la factura original en la URL + los items devueltos en el body
  2. El sistema obtiene automaticamente los datos de la factura original
  3. Los items se separan en dos tablas: originales (codigoDetalleTransaccion=1) y devueltos (codigoDetalleTransaccion=2)
  4. Se calculan montos automaticamente: montoTotalOriginal, montoTotalDevuelto, montoDescuentoCreditoDebito, montoEfectivoCreditoDebito
  5. La nota se valida contra el SIAT via ServicioFacturacionDocumentoAjuste
  6. Se genera PDF dedicado (con dos tablas: items originales + items devueltos) y se envia email

​
Campos del SIAT (sector 24)

Estos campos se calculan automaticamente por el sistema. Se documentan aqui como referencia del XML que se envia al SIAT:

​
Cabecera

Campo XMLDescripcion
numeroAutorizacionCufCUF de la factura original
numeroFactura (original)Numero de la factura original
fechaEmision (original)Fecha de emision de la factura original
montoTotalOriginalSuma de subtotales de items originales (antes de descuento global)
montoTotalSujetoIvaMonto total devuelto sujeto a IVA
montoDescuentoCreditoDebitoDescuento proporcional aplicado en la nota
montoEfectivoCreditoDebito13% IVA sobre el monto devuelto

​
Detalle

Campo XMLValorDescripcion
codigoDetalleTransaccion1Item de la factura original
codigoDetalleTransaccion2Item devuelto/ajustado

​
Ejemplo rapido

curl -X POST "https://sandbox.cucu.bo/api/v1/invoices/ORIGINAL_INVOICE_UUID/credit-note" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "pointOfSaleId": "660e8400-e29b-41d4-a716-446655440004",
    "notaType": "CREDITO",
    "paymentMethodCode": 1,
    "returnedDetails": [
      {
        "activityEconomic": "620100",
        "codeProductSin": "83141",
        "description": "Devolucion parcial - Servicio de software",
        "quantity": 1,
        "unitMeasure": 58,
        "priceUnit": 200.00
      }
    ]
  }'

​
Anular una nota

Para anular una nota de credito/debito emitida: 
POST /api/v1/invoices/{noteId}/cancel-note?motivo=1
Ver Anular Nota Credito/Debito para la referencia completa.
La factura original debe estar en estado VALIDATED. No se puede emitir una nota sobre una factura rechazada o ya anulada.
Si la factura original usa montoGiftCard > 0, el paymentMethodCode debe incluir 27 (Gift Card). Error SIAT 1050 si se omite.