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.

page inicia en 0 y size admite hasta 100. sortBy acepta numeroNota, fechaEmision, montoTotalDevuelto o estado. Los filtros disponibles son estado, codigoDocumentoSector, codigoPuntoVenta, numeroNota, cuf, facturaId y varianteDocumento. Las notas aceptadas incluyen urlQr y urlPdf; la API no expone XML para notas.

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",
        "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"
      }
    ],
    "page": 0,
    "size": 20,
    "totalElements": 1,
    "totalPages": 1
  }
}

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

Volver a Notas de crédito