Reporte de comprobantes
GET /api/reports/documents
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Lista los comprobantes electrónicos del rango con cliente, estado, pagos detallados y totales por afectación. Las notas de crédito salen en negativo y los comprobantes anulados o rechazados en 0.
Quién puede usarlo: cualquier usuario autenticado (administrador o vendedor).
Formato de respuesta: heredado sin envoltura: devuelve directamente el objeto o arreglo (sin success). Devuelve directamente un arreglo, o {success: false, message} si un filtro por nombre no encuentra coincidencias.
Filtros por nombre: item_name, user_name, person_name y establishment_name buscan por coincidencia parcial (los _ se tratan como espacios) y usan el primer registro que coincide. Si no encuentran nada responden HTTP 200 con {success: false, message: "No se encontro ..."}. Sin date_start / date_end se usa el mes actual.
Parámetros
| Parámetro | Dónde | Obligatorio | Ejemplo | Descripción |
|---|---|---|---|---|
date_start |
query | no | 2026-11-01 |
Fecha inicial YYYY-MM-DD. Por defecto, inicio del mes actual. |
date_end |
query | no | 2026-11-30 |
Fecha final. Por defecto, fin del mes actual. |
document_type_id |
query | no | 01 |
Tipo de comprobante: 01 factura, 03 boleta, 07 nota de crédito, 08 nota de débito. |
person_name |
query | no | Nombre (parcial) del cliente. | |
establishment_name |
query | no | Nombre (parcial) del establecimiento. | |
seller_id |
query | no | Id del vendedor. | |
state_type_id |
query | no | Estado: 01, 05, 09, 11. |
Respuestas
200 — Comprobantes
[
{
"user": "JUAN PEREZ",
"document_type_id": "01",
"number": "F001-219",
"date_of_issue": "2026-11-04",
"date_of_due": "2026-11-04",
"document_affected": "",
"guides": [],
"quotations": "",
"district": "MIRAFLORES",
"province": "LIMA",
"department": "LIMA",
"address_customer": "AV. AREQUIPA 450",
"document_type_customer": null,
"name_customer": "DISTRIBUIDORA ANDINA S.A.C.",
"number_customer": "20512345678",
"status": "Aceptado",
"currency_type_id": "PEN",
"sale_note": "",
"date_of_issue_sale_note": "",
"payments": [
{
"description": "Efectivo",
"payment": 118.0
}
],
"exchange_rate_sale": 1.0,
"total_charge": 0.0,
"total_exonerated": 0.0,
"total_unaffected": 0.0,
"total_taxed": 100.0,
"total_discount": 0.0,
"total_free": 0.0,
"total_igv": 18.0,
"total_isc": 0.0,
"total": 118.0
}
]
200 — Cliente no encontrado
{
"success": false,
"message": "No se encontro la persona DISTRIBUIDORA XYZ"
}
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.