Ir al contenido

Listar comprobantes

Comprobantes de tu empresa en el entorno de tu API key, del más reciente al más antiguo. Sirve para cuadrar la caja del día, conciliar estados o recuperar un comprobante si perdiste la respuesta de la emisión.

Método: GET

GET https://faktura-test.cgallardo.me/v1/documents?document_type=03&from=2026-11-01&to=2026-11-30&page=1&page_size=50

Todos son opcionales y se combinan entre sí.

Parámetro Descripción
document_type 01, 03, 07 u 08.
series, number Serie (B001) y correlativo.
status pending, sending, uncertain, accepted, observed, rejected o failed.
from, to Rango de fechas de emisión YYYY-MM-DD (inclusive).
customer_doc_number Documento del cliente.
page, page_size Página (desde 1) y tamaño (1 a 100, 20 por defecto).
Ventana de terminal
curl "https://faktura-test.cgallardo.me/v1/documents?document_type=03&from=2026-11-01&to=2026-11-30&page=1&page_size=50" \
-H "Authorization: Bearer sk_test_..."
Ventana de terminal
curl "https://faktura-test.cgallardo.me/v1/documents?series=B001&number=1" \
-H "Authorization: Bearer sk_test_..."
{
"items": [
{
"id": "01a1d5fd-…", "document_type": "03", "series": "B001", "number": 2, "full_number": "B001-2",
"issue_date": "2026-11-14", "currency": "PEN",
"customer": { "doc_type": "DNI", "doc_number": "45678912", "name": "MARÍA PÉREZ" },
"total": "9.00", "status": "accepted", "void": null,
"links": { "self": "/v1/documents/01a1d5fd-…" }
}
],
"page": 1, "page_size": 50, "total_count": 1
}
Campo Tipo Descripción
items[] lista Resumen de cada comprobante de la página (id, document_type, series, number, full_number, issue_date, currency, customer, total, status, void, links.self).
items[].total texto Importe total del comprobante como texto decimal ("9.00"). El desglose completo de impuestos y líneas está en Ver un comprobante.
items[].void objeto o null null si no se pidió anulación, o {"status": "requested", "reason": "…"} (donde status es requested, voided o rejected).
page, page_size entero Página devuelta y tamaño de página aplicado.
total_count entero Total de comprobantes que cumplen los filtros enviados.
Estado reason Causa
200 — Devuelve la página de comprobantes.
401 Unauthenticated Falta la API key, es inválida o venció.
403 ApiKeyScopeInsufficient La clave es de alcance lookup.
422 ValidationFailed Un parámetro tiene un valor inválido (por ejemplo, page_size mayor a 100 o to anterior a from).
429 TooManyRequests Superaste las 120 peticiones por minuto.