Skip to main content
GET
/
api
/
cotizaciones
Listar Cotizaciones
curl --request GET \
  --url https://api.example.com/api/cotizaciones \
  --header 'Authorization: <authorization>'
{
  "500": {},
  "success": true,
  "data": [
    {
      "id": 123,
      "numero": 123,
      "fecha": "<string>",
      "cliente_nombre": "<string>",
      "total": 123,
      "moneda": "<string>",
      "estado": "<string>",
      "aplicar_igv": true
    }
  ]
}
Obtiene el listado completo de cotizaciones de la empresa autenticada, ordenadas por ID descendente (más recientes primero).

Autenticación

Requiere token Bearer y permiso cotizaciones.view.

Headers

Authorization
string
required
Token de autenticación Bearer
X-Empresa-Activa
integer
ID de la empresa activa (opcional, usa la empresa del usuario por defecto)

Respuesta Exitosa

success
boolean
Indica si la operación fue exitosa
data
array
Listado de cotizaciones desde la vista view_cotizaciones

Ejemplo de Respuesta

{
  "success": true,
  "data": [
    {
      "id": 15,
      "numero": 15,
      "fecha": "2026-03-06",
      "cliente_nombre": "Distribuidora ABC S.A.C.",
      "total": 1180.00,
      "moneda": "PEN",
      "estado": "pendiente",
      "aplicar_igv": true,
      "subtotal": 1000.00,
      "igv": 180.00,
      "descuento": 0.00
    }
  ]
}

Códigos de Error

500
error
Error interno del servidor al obtener cotizaciones

Notas de Implementación

  • Los datos se obtienen de la vista de base de datos view_cotizaciones que agrupa información de múltiples tablas
  • El filtro por empresa (id_empresa) se aplica automáticamente según el usuario autenticado
  • Para ver el detalle completo de una cotización (con productos y cuotas), usa el endpoint GET /api/cotizaciones/{id}

Build docs developers (and LLMs) love