Ir al contenido

Actualizar una cotización

PUT/api/quotation/{quotationId}

Actualiza los datos generales de una cotización. El cliente siempre sale de la oportunidad indicada. Si cambia la oportunidad, la unidad de negocio pasa a ser la de la nueva oportunidad; si cambia el cliente y no llega contacto, el contacto se borra. El servidor recalcula el código y deja un registro en el historial.

Una versión (V2, V3…) no cambia el nombre, la oportunidad ni la carpeta: esos datos se cambian en la cotización principal (V1), que los propaga a sus versiones que no estén cerradas. La moneda y la utilidad global no se editan aquí: si llegan, se ignoran.

quotationIdintegerobligatorio

Identificador de la cotización.

namestringobligatorio

Nombre de la cotización.

descriptionstringobligatorio

Descripción de la cotización.

datedateobligatorio

Fecha de la cotización.

days_validityintegerobligatorio

Días de validez.

limit_decimalsintegerobligatorio

Cantidad de decimales de los montos.

opportunity_idintegerobligatorio

Oportunidad. Debe existir y no estar eliminada.

budget_folder_idintegerobligatorio

Carpeta de presupuesto. Debe pertenecer a la oportunidad.

customer_contact_idinteger

Contacto del cliente. Debe existir y pertenecer al cliente de la oportunidad.

seller_idinteger

Vendedor. Debe existir en usuarios.

project_manager_idinteger

Project manager. Debe existir en usuarios.

detractionnumber

Porcentaje de detracción. Mínimo 0.

include_igv_items_for_pdfboolean

Indica si los ítems del PDF incluyen el IGV.

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 PUT \
"https://servererp.allendostmen.app/api/quotation/1" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"name": "Instalación eléctrica",
"description": "Instalación eléctrica del almacén central",
"date": "2026-11-19",
"days_validity": 45,
"limit_decimals": 4,
"opportunity_id": 77,
"budget_folder_id": 31,
"customer_contact_id": 14
}'
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": 45,
"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
}
Sin permiso403
{
"message": "No se puede editar una cotización que no está en estado Cotizando."
}
Datos no válidos422
{
"message": "La oportunidad es requerida.",
"errors": {
"opportunity_id": [
"La oportunidad es requerida."
]
}
}