Ir al contenido

Listar cotizaciones

GET/api/quotation

Devuelve la lista paginada de cotizaciones. Usa BaseControllerHelper::index, así que admite los filtros comunes del sistema, más los filtros propios de la cotización. Si no se envía customer_id, el listado se limita según el rol del usuario: un usuario con rol KAM solo ve las cotizaciones donde es vendedor y uno con rol PM, las que gestiona como project manager. Ver Paginación, filtros y orden.

per_pageinteger

Registros por página. Por defecto 20.

searchstring

Texto a buscar en las columnas definidas por el modelo.

statusstring

Filtra por estado del registro.

not_statusstring

Excluye los registros con ese estado.

trashedboolean

Incluye también los registros eliminados.

only_trashedboolean

Devuelve solo los registros eliminados.

idsstring

Devuelve solo los registros con esos identificadores.

not_idsstring

Excluye los registros con esos identificadores.

filtersobject

Filtros por campo, que resuelve filterFields del modelo.

created_at_fromdate

Creados desde esta fecha.

created_at_todate

Creados hasta esta fecha.

updated_at_fromdate

Modificados desde esta fecha.

updated_at_todate

Modificados hasta esta fecha.

select_fieldsstring

Campos a devolver.

relationsstring

Relaciones a cargar.

count_relationsstring

Conteos de relaciones.

customer_idinteger

Solo las cotizaciones de ese cliente. Si se envía, no se aplica el límite por rol.

seller_idinteger

Solo las cotizaciones de ese vendedor.

project_manager_idinteger

Solo las cotizaciones de ese project manager.

project_idinteger

Solo las cotizaciones de ese proyecto.

project_folder_idinteger

Filtra por project_folder_id. La tabla quotations no tiene esa columna, así que enviarlo provoca un error del servidor.

budget_folder_idinteger

Solo las cotizaciones de esa carpeta de presupuesto.

opportunity_idinteger

Solo las cotizaciones de esa oportunidad.

reference_quotation_id_is_nullstring

Con el valor true, solo las cotizaciones principales (sin cotización de referencia).

status_not_instring

Estados a excluir, separados por comas.

group_versionsboolean

Con true, devuelve solo las principales, cada una con sus versiones en versions (de la menor a la mayor). Una principal aparece si ella o alguna de sus versiones cumple los filtros.

orderstring

Orden de los resultados. Campos permitidos: id, name, created_at, updated_at, status. Por defecto, id|DESC.

No exige un permiso del módulo: QuotationPolicy::viewAny devuelve verdadero para cualquier usuario autenticado.

Ventana de terminal
curl -G \
"https://servererp.allendostmen.app/api/quotation" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json" \
--data-urlencode "per_page=20" \
--data-urlencode "search=eléctrica" \
--data-urlencode "seller_id=5" \
--data-urlencode "order=created_at|DESC"
Lista de cotizaciones200
{
"current_page": 1,
"data": [
{
"id": 1520,
"code": "110012 - INSTALACION_ELECTRICA - ACME_SAC-V1",
"version": 1,
"igv": 18,
"rent": 1.5,
"detraction": 12,
"name": "Instalación eléctrica",
"date": "2026-11-19",
"description": "Instalación eléctrica del almacén central",
"days_validity": 30,
"coin_id": 1,
"coin_value": 3.75,
"limit_decimals": 4,
"customer_id": 8,
"customer_contact_id": 14,
"seller_id": 5,
"project_manager_id": 9,
"opportunity_id": 77,
"budget_folder_id": 31,
"status": "cotizando",
"is_global_utility": false,
"total_items": 12500,
"total_overheads": 1500,
"subtotal": 14000,
"total_igv": 2520,
"total": 16520,
"create_user_id": 5,
"created_at": "2026-11-19T10:40:15.000000Z",
"updated_at": "2026-11-19T10:40:15.000000Z",
"deleted_at": null
}
],
"first_page_url": "https://servererp.allendostmen.app/api/quotation?page=1",
"from": 1,
"last_page": 1,
"last_page_url": "https://servererp.allendostmen.app/api/quotation?page=1",
"next_page_url": null,
"path": "https://servererp.allendostmen.app/api/quotation",
"per_page": 20,
"prev_page_url": null,
"to": 1,
"total": 1
}
Sin permiso403
{
"message": "This action is unauthorized."
}