Ver un comprobante
Devuelve el comprobante con su estado actual en SUNAT. Responde 404 NotFound si el id no existe o pertenece a otro emisor o a otro entorno.
curl https://faktura-test.cgallardo.me/v1/documents/01a1d5fc-899b-720e-a6ea-03d37a346f81 \ -H "Authorization: Bearer sk_test_..."use Illuminate\Support\Facades\Http;
$response = Http::withToken('sk_test_...') ->get('https://faktura-test.cgallardo.me/v1/documents/01a1d5fc-899b-720e-a6ea-03d37a346f81');
$data = $response->json();const response = await fetch('https://faktura-test.cgallardo.me/v1/documents/01a1d5fc-899b-720e-a6ea-03d37a346f81', { headers: { Authorization: 'Bearer sk_test_...', },});const data = await response.json();Método: GET
Endpoint
Sección titulada «Endpoint»GET https://faktura-test.cgallardo.me/v1/documents/{id}GET https://faktura.cgallardo.me/v1/documents/{id}Respuesta 200 OK (aceptado por SUNAT)
Sección titulada «Respuesta 200 OK (aceptado por SUNAT)»{ "id": "01a1d5fc-899b-720e-a6ea-03d37a346f81", "document_type": "03", "series": "B001", "number": 1, "full_number": "B001-1", "issue_date": "2026-11-13", "currency": "PEN", "igv_percent": "18", "status": "accepted", "customer": { "doc_type": "DNI", "doc_number": "45678912", "name": "MARIA PEREZ" }, "totals": { "taxed": "13.64", "exempt": "0.00", "unaffected": "0.00", "free": "0.00", "igv": "2.46", "icbper": "0.50", "total_taxes": "2.96", "discounts": "0.00", "charges": "0.00", "total": "16.60" }, "net_payable": "16.60", "amount_in_words": "SON DIECISÉIS CON 60/100 SOLES", "payment": { "type": "contado", "installments": [] }, "items": [ { "product_code": "CAF-01", "description": "Cafe americano", "unit_code": "NIU", "quantity": "2", "unit_value": "6.78", "unit_price": "8", "igv_type": "gravado", "line_value": "13.56", "igv": "2.44", "icbper": "0.00" }, { "product_code": null, "description": "Bolsa plastica", "unit_code": "NIU", "quantity": "1", "unit_value": "0.08", "unit_price": "0.1", "igv_type": "gravado", "line_value": "0.08", "igv": "0.02", "icbper": "0.50" } ], "sunat": { "code": "0", "description": "La Boleta numero B001-1, ha sido aceptada", "notes": [], "hash": "x/NyYaC+yItSOzJpanQWdBmcxDE=", "send_attempts": 1 }, "links": { "self": "/v1/documents/01a1d5fc-899b-720e-a6ea-03d37a346f81", "xml": "/v1/documents/01a1d5fc-899b-720e-a6ea-03d37a346f81/xml", "cdr": "/v1/documents/01a1d5fc-899b-720e-a6ea-03d37a346f81/cdr", "pdf": "/v1/documents/01a1d5fc-899b-720e-a6ea-03d37a346f81/pdf", "public_pdf": "https://faktura-test.cgallardo.me/p/01a1d52b-…/01a1d5fc-…/a4.pdf?expires=…&signature=…", "public_ticket": "https://faktura-test.cgallardo.me/p/01a1d52b-…/01a1d5fc-…/ticket.pdf?expires=…&signature=…", "public_ticket_58": "https://faktura-test.cgallardo.me/p/01a1d52b-…/01a1d5fc-…/ticket58.pdf?expires=…&signature=…" }}El objeto comprobante
Sección titulada «El objeto comprobante»| Campo | Tipo | Descripción |
|---|---|---|
id |
UUID | Identificador del comprobante en Faktura. |
document_type |
texto | 01 factura, 03 boleta, 07 nota de crédito, 08 nota de débito. |
series, number, full_number |
texto, entero, texto | Serie, correlativo y ambos unidos (B001-1). |
issue_date |
fecha | Fecha de emisión (hora de Perú). |
currency |
texto | PEN o USD. |
igv_percent |
texto | Tasa de IGV aplicada al comprobante ("18"). |
status |
texto | Estado del envío a SUNAT (Estados). |
customer |
objeto | doc_type (Catálogos), doc_number (- si es anónimo) y name. |
totals |
objeto | Montos como texto decimal (Cálculo de impuestos). |
totals.discounts |
texto | Suma de descuentos sobre la base (por ítem y global). |
net_payable |
texto | Neto pendiente de pago: total menos detracción y retención. |
service_charge |
objeto o null | base_amount y amount cuando hay recargo al consumo. |
global_discount |
objeto o null | base_amount (gravado antes del descuento) y amount (descuento sobre la base). |
detraction |
objeto o null | code, percent, amount (en soles), amount_in_document_currency, bank_account, payment_method, exchange_rate. |
retention |
objeto o null | percent (3), base_amount y amount. |
purchase_order, despatch_references, observations, due_date |
varios | Datos comerciales enviados al emitir. |
amount_in_words |
texto | Total en letras (leyenda 1000 de SUNAT). |
payment |
objeto | type (contado o credito) e installments (amount, due_date). |
items[] |
lista | Por ítem: product_code, sunat_product_code, description, unit_code, quantity, unit_value (sin IGV, antes del descuento), unit_price (con IGV, después del descuento), igv_type, discount (sobre la base), line_value (base, ya descontada), igv, icbper. |
sunat.code |
texto o null | Código de respuesta de SUNAT (0 aceptado). |
sunat.description |
texto o null | Descripción de SUNAT. |
sunat.notes |
lista | Observaciones de SUNAT (estado observed). |
sunat.hash |
texto o null | Valor resumen (DigestValue) de la firma, para la representación impresa. |
sunat.send_attempts |
entero | Intentos de envío realizados. |
note |
objeto o null | En notas: reason_code, reason_description y affected_document (id, document_type, full_number). |
void |
objeto o null | Si se pidió la anulación: status (requested, voided, rejected) y reason. Ver Anulación. |
links.self |
texto | Ruta de este comprobante (/v1/documents/{id}). |
links.xml, links.cdr |
texto o null | Rutas de descarga de XML y CDR cuando ya existen. |
links.pdf |
texto | Representación impresa con API key (?format=a4, ticket o ticket58). |
links.public_pdf, links.public_ticket, links.public_ticket_58 |
texto | Enlaces firmados (A4, ticket 80 mm y ticket 58 mm), sin API key, que vencen a los 7 días (ver detalles). |
Respuestas y errores
Sección titulada «Respuestas y errores»| Estado | reason |
Significado |
|---|---|---|
200 |
— | Devuelve el objeto comprobante completo. |
401 |
Unauthenticated |
Falta la API key, es inválida o venció. |
403 |
ApiKeyScopeInsufficient |
La clave es de alcance lookup (solo consultas de RUC/DNI). |
404 |
NotFound |
El id no existe o pertenece a otro emisor o entorno. |
429 |
TooManyRequests |
Superaste las 120 peticiones por minuto. |