Ir al contenido

Actualizar los montos generales

PATCH/api/quotation/{quotation}/update-general-amounts

Actualiza la utilidad global y el descuento global. El servidor recalcula el porcentaje de descuento a partir de total_global_discount, el subtotal (ítems más gastos generales menos el descuento, sin bajar de 0), el IGV y el total. Si la cotización usa utilidad global y cambia global_utility_percentage, recalcula la utilidad de todos los ítems que no son títulos y los totales de la cotización. Deja un registro en el historial.

quotationintegerobligatorio

Identificador de la cotización.

is_global_utility_in_percentagebooleanobligatorio

Indica si la utilidad global se expresa en porcentaje.

global_utility_percentagenumberobligatorio

Porcentaje de utilidad global.

global_discount_percentagenumberobligatorio

Porcentaje de descuento global. El servidor lo recalcula a partir de total_global_discount.

is_global_discount_in_percentagebooleanobligatorio

Indica si el descuento global se expresa en porcentaje.

total_global_discountnumbercondicional

Monto del descuento global. Si se envía, debe ser numérico.

total_global_utilitynumbercondicional

Monto de la utilidad global. Si se envía, debe ser numérico.

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-general-amounts" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"is_global_utility_in_percentage": true,
"global_utility_percentage": 15,
"global_discount_percentage": 0,
"is_global_discount_in_percentage": true,
"total_global_discount": 500
}'
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": 13500,
"total_igv": 2430,
"total": 15930,
"create_user_id": 5,
"created_at": "2026-11-19T10:40:15.000000Z",
"updated_at": "2026-11-19T10:40:15.000000Z",
"deleted_at": null,
"global_utility_percentage": 15,
"total_global_discount": 500
}
Sin permiso403
{
"message": "No se puede editar una cotización que no está en estado Cotizando."
}
Datos no válidos422
{
"message": "The global utility percentage field is required.",
"errors": {
"global_utility_percentage": [
"The global utility percentage field is required."
]
}
}