Ir al contenido

Actualizar la utilidad global de los gastos generales

PATCH/api/quotation/{quotationId}/update-global-utility-overhead

Guarda overheads_global_utility_percentage y recalcula la utilidad de cada gasto general que no es un título (costo × porcentaje / 100, con los decimales de la cotización). Después recalcula el total de gastos generales. Todo ocurre en una transacción y deja un registro en el historial.

quotationIdintegerobligatorio

Identificador de la cotización.

overheads_global_utility_percentagenumbercondicional

Porcentaje de utilidad global. Si se envía, debe ser numérico. Si no se envía, se aplica 0 a los gastos.

quotation.edit, que se valida en QuotationPolicy::update. Además la cotización debe estar en estado cotizando, y el usuario debe ser root, el vendedor o el project manager de la cotización, o un superior de ellos, y tener el permiso de vendedor o de project manager. Si no cumple, responde 403 con el motivo, por ejemplo No tiene permisos para editar cotizaciones. o No se puede editar una cotización que no está en estado Cotizando.

Ventana de terminal
curl -X PATCH \
"https://servererp.allendostmen.app/api/quotation/1/update-global-utility-overhead" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"overheads_global_utility_percentage": 10
}'
Cotización actualizada200
{
"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,
"overheads_global_utility_percentage": 10
}
Sin permiso403
{
"message": "No se puede editar una cotización que no está en estado Cotizando."
}
Datos no válidos422
{
"message": "The overheads global utility percentage field is required.",
"errors": {
"overheads_global_utility_percentage": [
"The overheads global utility percentage field is required."
]
}
}