Saltar al contenido
Facturador

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.