Ir al contenido

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.

Ventana de terminal
curl https://faktura-test.cgallardo.me/v1/documents/01a1d5fc-899b-720e-a6ea-03d37a346f81 \
-H "Authorization: Bearer sk_test_..."

Método: GET

GET https://faktura-test.cgallardo.me/v1/documents/{id}
{
"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=…"
}
}
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).
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.