Listar cotizaciones
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.
Parámetros de consulta
Sección titulada «Parámetros de consulta»per_pageintegerRegistros por página. Por defecto 20.
searchstringTexto a buscar en las columnas definidas por el modelo.
statusstringFiltra por estado del registro.
not_statusstringExcluye los registros con ese estado.
trashedbooleanIncluye también los registros eliminados.
only_trashedbooleanDevuelve solo los registros eliminados.
idsstringDevuelve solo los registros con esos identificadores.
not_idsstringExcluye los registros con esos identificadores.
filtersobjectFiltros por campo, que resuelve filterFields del modelo.
created_at_fromdateCreados desde esta fecha.
created_at_todateCreados hasta esta fecha.
updated_at_fromdateModificados desde esta fecha.
updated_at_todateModificados hasta esta fecha.
select_fieldsstringCampos a devolver.
relationsstringRelaciones a cargar.
count_relationsstringConteos de relaciones.
customer_idintegerSolo las cotizaciones de ese cliente. Si se envía, no se aplica el límite por rol.
seller_idintegerSolo las cotizaciones de ese vendedor.
project_manager_idintegerSolo las cotizaciones de ese project manager.
project_idintegerSolo las cotizaciones de ese proyecto.
project_folder_idintegerFiltra por project_folder_id. La tabla quotations no tiene esa columna, así que enviarlo provoca un error del servidor.
budget_folder_idintegerSolo las cotizaciones de esa carpeta de presupuesto.
opportunity_idintegerSolo las cotizaciones de esa oportunidad.
reference_quotation_id_is_nullstringCon el valor true, solo las cotizaciones principales (sin cotización de referencia).
status_not_instringEstados a excluir, separados por comas.
group_versionsbooleanCon 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.
orderstringOrden de los resultados. Campos permitidos: id, name, created_at, updated_at, status. Por defecto, id|DESC.
Permiso
Sección titulada «Permiso»No exige un permiso del módulo: QuotationPolicy::viewAny devuelve verdadero para cualquier usuario autenticado.
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"const response = await fetch( "https://servererp.allendostmen.app/api/quotation?per_page=20&search=eléctrica&seller_id=5&order=created_at|DESC", { method: "GET", headers: { Authorization: `Bearer ${token}`, Accept: "application/json", }, },);const data = await response.json();use Illuminate\Support\Facades\Http;
$response = Http::withToken($token) ->acceptJson() ->get('https://servererp.allendostmen.app/api/quotation', [ 'per_page' => 20, 'search' => 'eléctrica', 'seller_id' => 5, 'order' => 'created_at|DESC', ]);{ "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}{ "message": "This action is unauthorized."}