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
Endpoint
Sección titulada «Endpoint»GET https://faktura-test.cgallardo.me/v1/documents?document_type=03&from=2026-11-01&to=2026-11-30&page=1&page_size=50GET https://faktura.cgallardo.me/v1/documents?document_type=03&from=2026-11-01&to=2026-11-30&page=1&page_size=50Parámetros
Sección titulada «Parámetros»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). |
Ejemplo
Sección titulada «Ejemplo»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_..."use Illuminate\Support\Facades\Http;
$response = Http::withToken('sk_test_...') ->get('https://faktura-test.cgallardo.me/v1/documents?document_type=03&from=2026-11-01&to=2026-11-30&page=1&page_size=50');
$data = $response->json();const response = await fetch('https://faktura-test.cgallardo.me/v1/documents?document_type=03&from=2026-11-01&to=2026-11-30&page=1&page_size=50', { headers: { Authorization: 'Bearer sk_test_...', },});const data = await response.json();Buscar por serie y correlativo
Sección titulada «Buscar por serie y correlativo»curl "https://faktura-test.cgallardo.me/v1/documents?series=B001&number=1" \ -H "Authorization: Bearer sk_test_..."use Illuminate\Support\Facades\Http;
$response = Http::withToken('sk_test_...') ->get('https://faktura-test.cgallardo.me/v1/documents?series=B001&number=1');
$data = $response->json();const response = await fetch('https://faktura-test.cgallardo.me/v1/documents?series=B001&number=1', { headers: { Authorization: 'Bearer sk_test_...', },});const data = await response.json();Respuesta 200 OK
Sección titulada «Respuesta 200 OK»{ "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. |
Respuestas y errores
Sección titulada «Respuestas y errores»| 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. |