Listar facturas emitidas

POST/api/v1/facturas/buscar

Devuelve las facturas de la empresa asociada a la X-API-Key. Requiere el permiso facturas.consultar; no expone CUIS, CUFD, token, certificado ni XML firmado.

Header requerido X-API-KeyVer operaciones de Facturas

Contrato de la operación

Devuelve las facturas de la empresa asociada a la X-API-Key. Requiere el permiso facturas.consultar; no expone CUIS, CUFD, token, certificado ni XML firmado.

page comienza en 0; size usa 20 por defecto y admite hasta 100. sortBy acepta numeroFactura, fechaEmision, montoTotal, estado o codigoDocumentoSector; sortDir acepta asc o desc. Los filtros permitidos son ambiente, estado, codigoDocumentoSector, codigoPuntoVenta, numeroFactura, cuf, fechaDesde y fechaHasta. Los filtros numéricos aceptan número o texto. Responde 200, 400, 401 o 403.

ambiente admite pruebas o produccion. Actualmente no se fuerza al de la API key: sin ese filtro, la consulta puede incluir ambos ambientes de la misma empresa. El aislamiento obligatorio por ambiente de la clave queda identificado como corrección prioritaria en [revision-endpoints-siat.md](../revision-endpoints-siat.md).

fechaDesde y fechaHasta comparan la fecha de emisión con límites inclusivos (>= y <=). Envía RFC 3339 con zona, por ejemplo 2026-08-01T00:00:00-04:00. La implementación también acepta AAAA-MM-DDTHH:mm y AAAA-MM-DD sin zona y los interpreta como UTC; una fecha sin hora representa la medianoche y no abarca todo el día en fechaHasta. Este comportamiento necesita unificación con la política de fechas del API.

json

{"message":"facturas obtenidas correctamente","data":{"content":[{"id":"00000000-0000-4000-8000-000000000001","numeroFactura":42,"cuf":"2D9D...","codigoRecepcion":"00000000-0000-4000-8000-000000000001","co...

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": {}
}

Respuesta

Ejemplo de respuesta

200 OKapplication/json

JSON

{
  "message": "facturas obtenidas correctamente",
  "data": {
    "content": [
      {
        "id": "00000000-0000-4000-8000-000000000001",
        "numeroFactura": 42,
        "cuf": "A1B2C3D4E5F60718293A4B5C6D7E8F90123456789ABCDEF0123456789ABCDEF0",
        "codigoRecepcion": "00000000-0000-4000-8000-000000000042",
        "codigoEstado": 908,
        "estado": "aceptado",
        "ambiente": "pruebas",
        "fechaEmision": "2026-08-30T16:10:00-04:00",
        "montoTotal": 500,
        "codigoPuntoVenta": 0,
        "codigoDocumentoSector": 1,
        "nombreDocumentoSector": "Compra y venta",
        "urlQr": "https://pilotosiat.impuestos.gob.bo/consulta/QR?nit=123456789&cuf=A1B2C3D4E5F60718293A4B5C6D7E8F90123456789ABCDEF0123456789ABCDEF0&numero=42&t=2",
        "urlXml": "https://api.example.test/api/v1/public/facturas/A1B2C3D4E5F60718293A4B5C6D7E8F90123456789ABCDEF0123456789ABCDEF0/xml",
        "urlPdf": "https://api.example.test/api/v1/public/facturas/A1B2C3D4E5F60718293A4B5C6D7E8F90123456789ABCDEF0123456789ABCDEF0/pdf"
      }
    ],
    "page": 0,
    "size": 20,
    "totalElements": 1,
    "totalPages": 1
  }
}

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

Volver a Facturas