Reporte de cotizaciones
GET /api/reports/quotations
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Lista las cotizaciones del rango con cliente, estado, totales y los comprobantes / notas de venta generados a partir de ellas.
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. |
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 de la cotización. |
Respuestas
200 — Cotizaciones
[
{
"date_of_issue": "2026-11-03",
"user_name": "JUAN PEREZ",
"customer_name": "DISTRIBUIDORA ANDINA S.A.C.",
"state": "Registrado",
"number_full": "COT-45",
"documents": [
{
"document_type_description": "FACTURA ELECTRÓNICA",
"number_full": "F001-219"
}
],
"sale_notes": [],
"case": "",
"currency": "PEN",
"total_exportation": 0.0,
"total_unaffected": 0.0,
"total_exonerated": 0.0,
"total_taxed": 100.0,
"total_igv": 18.0,
"total": 118.0
}
]
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.