Emitir nota de crédito
/api/v1/facturas/:facturaId/nota-creditoEmite una nota sobre la factura aceptada indicada por facturaId. Requiere X-API-Key con permiso notascredito.crear; la factura debe pertenecer a la misma empresa.
X-API-KeyVer operaciones de Notas de crédito Contrato de la operación
Emite una nota sobre la factura aceptada indicada por facturaId. Requiere X-API-Key con permiso notas_credito.crear; la factura debe pertenecer a la misma empresa.
puntoVentaId es el UUID de un punto de venta activo de la empresa y debe coincidir con el de la factura original. El backend obtiene desde allí los códigos SIAT del punto y de su sucursal. tipoNota sólo admite CREDITO; ambos campos siguen siendo obligatorios en el contrato actual, aunque el backend podría derivarlos de la factura y de la operación. codigoMetodoPago es un entero positivo y debe coincidir con el método original cuando la factura conserva uno positivo. Cada elemento de detallesDevueltos se relaciona automáticamente por actividad, producto SIN y unidad de medida. La cantidad no puede superar la original y precioUnitario no puede ser mayor al facturado. codigoProducto y montoDescuento son opcionales.
La fecha de emisión de la nota la fija el backend en el momento de emitir; no se envía en el cuerpo. La fecha de la factura original se conserva como referencia del ajuste. CREDITO es una selección del contrato de Falmus y no un tipo configurable de compra del RCV.
El cliente no elige documento sector, variante ni prorrateos. El servidor usa sector 24 normalmente y sector 47 cuando la factura original contiene descuento adicional; calcula los montos oficiales, CUF, CUIS/CUFD y firma el XML. La empresa y la clave deben tener habilitado el tipo inferido. Responde 201, 400, 401, 403, 404, 409, 422 o 503.
json
{"message":"nota de c...Ejemplo
Solicitud de ejemplo
{
"puntoVentaId": "{{puntoVentaId}}",
"tipoNota": "CREDITO",
"codigoMetodoPago": 1,
"detallesDevueltos": [
{
"actividadEconomica": "6201000",
"codigoProductoSin": 1003914,
"descripcion": "Devolución parcial - Servicio de software",
"cantidad": 1,
"codigoUnidadMedida": 58,
"precioUnitario": 50
}
]
}Respuesta
Ejemplo de respuesta
application/json{
"message": "nota de crédito emitida correctamente",
"data": {
"id": "00000000-0000-4000-8000-000000000001",
"facturaId": "00000000-0000-4000-8000-000000000042",
"numeroNota": 1,
"cuf": "B2C3D4E5F60718293A4B5C6D7E8F90123456789ABCDEF0123456789ABCDEF01",
"codigoRecepcion": "00000000-0000-4000-8000-000000000043",
"codigoEstado": 908,
"estado": "aceptado",
"fechaEmision": "2026-08-30T16:10:00-04:00",
"montoTotalOriginal": 500,
"montoTotalDevuelto": 100,
"montoEfectivoCredito": 13,
"codigoPuntoVenta": 0,
"codigoDocumentoSector": 24,
"varianteDocumento": "credito_debito",
"urlQr": "https://pilotosiat.impuestos.gob.bo/consulta/QR?nit=123456789&cuf=B2C3D4E5F60718293A4B5C6D7E8F90123456789ABCDEF0123456789ABCDEF01&numero=1&t=2",
"urlPdf": "https://api.example.test/api/v1/public/notas-credito/B2C3D4E5F60718293A4B5C6D7E8F90123456789ABCDEF0123456789ABCDEF01/pdf",
"creadoEn": "2026-08-30T16:10:00-04:00",
"actualizadoEn": "2026-08-30T16:10:00-04:00"
}
}Datos ficticios; los identificadores y valores cambian en cada respuesta.