Últimos comprobantes
GET /api/documents/lists
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Devuelve los últimos 50 comprobantes (facturas, boletas y notas) ordenados por fecha de emisión descendente. No acepta filtros: para listados completos usa Listar comprobantes con cursor.
Quién puede usarlo: cualquier usuario autenticado. Un administrador ve todos los registros; un vendedor solo los que registró él.
Formato de respuesta: listado de cantidad fija (take/limit): devuelve como máximo N registros, sin metadatos de paginación. Respuesta {data: [...]} (máximo 50 filas, sin success).
Cada fila trae además indicadores de interfaz (btn_*), estados de envío y relaciones (notas, guías, pedidos); el ejemplo muestra los campos principales. Las fechas date_of_issue y date_of_due vienen en formato DD-MM-YYYY.
Respuestas
200 — Listado
{
"data": [
{
"id": 1520,
"external_id": "9b2f6c1e-7a44-4d0b-9a55-0f3c2a1d8e77",
"group_id": "01",
"soap_type_id": "02",
"soap_type_description": "Producción",
"date_of_issue": "07-11-2026",
"date_of_due": "07-11-2026",
"number": "F001-1520",
"filename": "20123456789-01-F001-1520",
"document_type_id": "01",
"document_type_description": "FACTURA ELECTRÓNICA",
"customer_name": "EMPRESA XYZ S.A.C.",
"customer_number": "20501973522",
"customer_identity_document_type_description": "RUC",
"customer_telephone": "014271148",
"customer_email": "facturacion@xyz.com.pe",
"currency_type_id": "PEN",
"exchange_rate_sale": "1.000",
"total_exportation": "0.00",
"total_free": "0.00",
"total_unaffected": "0.00",
"total_exonerated": "0.00",
"total_taxed": "100.00",
"total_igv": "18.00",
"total_charge": "0.00",
"total": "118.00",
"balance": "0.00",
"date_of_payment": "2026-11-07",
"state_type_id": "05",
"state_type_description": "Aceptado",
"has_xml": true,
"has_pdf": true,
"has_cdr": true,
"download_xml": "https://empresa.dominio/downloads/document/xml/9b2f6c1e-7a44-4d0b-9a55-0f3c2a1d8e77",
"download_pdf": "https://empresa.dominio/downloads/document/pdf/9b2f6c1e-7a44-4d0b-9a55-0f3c2a1d8e77",
"download_cdr": "https://empresa.dominio/downloads/document/cdr/9b2f6c1e-7a44-4d0b-9a55-0f3c2a1d8e77",
"affected_document": null,
"notes": [],
"sales_note": [],
"order_note": [],
"dispatches": [],
"guides": null,
"purchase_order": "OC-2026-0045",
"user_id": 5,
"user_name": "JUAN PEREZ",
"source_module": "API",
"regularize_shipping": false,
"message_regularize_shipping": null,
"created_at": "2026-11-07 10:11:11",
"updated_at": "2026-11-07 10:11:15"
}
]
}
Pruébalo
Prueba este endpoint con tu empresa y tu token: elige la URL en Servers, pega el token en Authorize y haz clic en Try it out.