Saltar al contenido
Facturador

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.