Buscar notas de crédito

POST/api/v1/notas-credito/buscar

Lista las notas de la empresa asociada a X-API-Key. Requiere facturas.consultar.

Header requerido X-API-KeyVer operaciones de Notas de crédito

Contrato de la operación

Lista las notas de la empresa asociada a X-API-Key. Requiere facturas.consultar.

Paginación y filtros

page inicia en 0 y size admite hasta 100. sortBy acepta nroNota, fechaEmision, montoTotalDevuelto o estado; sortDir usa asc o desc.

Filtro	Descripción
`estado`	`reservado`, `aceptado`, `rechazado`, `anulacion_pendiente`, `anulado` o `reversion_pendiente`.
`facturaId`	UUID de la factura original.
`codigoDocumentoSector`	`24` para la variante estándar o `47` para la variante con descuento adicional.
`codigoPuntoVenta`	Código SIAT del punto de venta.
`nroNota`	Número fiscal de la nota.
`cuf`	Texto contenido en el CUF de la nota.

Contenido de la respuesta

Devuelve 200 con content, page, size, totalElements y totalPages. Cada elemento es un resumen de la nota; para consultar tipoNota, cliente y líneas, usa Obtener nota de crédito.

Las notas aceptadas, con anulación pendiente, anuladas o con reversión pendiente incluyen urlQr, urlXml y urlPdf. urlXml descarga el XML firmado en la ruta pública por CUF.

El ambiente se toma de la clave y no puede cambiarse mediante filtros. Una anulación pendiente conserva el monto consumido hasta confirmarse ante SIAT.

Ejemplo

Solicitud de ejemplo

Clave ficticia; no se ejecuta desde esta página

JSON · cuerpo de solicitud

{
  "page": 0,
  "size": 20,
  "sortBy": "fechaEmision",
  "sortDir": "desc",
  "filters": {
    "estado": "aceptado",
    "facturaId": "{{facturaId}}"
  }
}

Respuesta

Ejemplo de respuesta

200 OKapplication/json

JSON

{
  "message": "notas de crédito obtenidas correctamente",
  "data": {
    "content": [
      {
        "id": "00000000-0000-4000-8000-000000000001",
        "facturaId": "00000000-0000-4000-8000-000000000042",
        "nroNota": 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,
        "urlQr": "https://pilotosiat.impuestos.gob.bo/consulta/QR?nit=123456789&cuf=B2C3D4E5F60718293A4B5C6D7E8F90123456789ABCDEF0123456789ABCDEF01&numero=1&t=2",
        "urlXml": "https://api.example.test/api/v1/public/notas-credito/B2C3D4E5F60718293A4B5C6D7E8F90123456789ABCDEF0123456789ABCDEF01/xml",
        "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"
      }
    ],
    "page": 0,
    "size": 20,
    "totalElements": 1,
    "totalPages": 1
  }
}

Datos ficticios; los identificadores y valores cambian en cada respuesta.

Volver a Notas de crédito