Ir al contenido

Crear una cotización

POST/api/quotation

Crea una cotización. El servidor toma el cliente, la unidad de negocio y la moneda de la oportunidad, copia el valor actual de la moneda, fija la versión en 1, genera el código y toma el IGV y la renta de los impuestos configurados. La cotización queda en estado cotizando y el usuario autenticado figura como creador.

El código se arma con el mes (2 dígitos) y un correlativo (4 dígitos), el nombre y el cliente (cada uno recortado a 20 caracteres, con los espacios, comas y guiones cambiados por _) y la versión, por ejemplo 110012 - INSTALACION_ELECTRICA - ACME_SAC-V1.

namestringobligatorio

Nombre de la cotización. Máximo 255 caracteres.

descriptionstringobligatorio

Descripción de la cotización.

opportunity_idintegerobligatorio

Oportunidad de la cotización.

budget_folder_idintegerobligatorio

Carpeta de presupuesto. Debe pertenecer a la oportunidad indicada.

customer_contact_idintegerobligatorio

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

datedateobligatorio

Fecha de la cotización.

days_validityintegerobligatorio

Días de validez de la cotización.

limit_decimalsinteger

Cantidad de decimales con que se calculan los montos.

project_idinteger

Proyecto asociado.

project_manager_idinteger

Project manager de la cotización.

seller_idinteger

Vendedor de la cotización.

items_utility_individualboolean

Indica si la utilidad es individual por ítem.

detractionnumber

Porcentaje de detracción.

include_igv_items_for_pdfboolean

Indica si los ítems del PDF incluyen el IGV.

is_global_utilityboolean

Indica si la utilidad es global. Solo se usa al crear.

quotation.create, que se valida en QuotationPolicy::create.

Ventana de terminal
curl -X POST \
"https://servererp.allendostmen.app/api/quotation" \
-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",
"opportunity_id": 77,
"budget_folder_id": 31,
"customer_contact_id": 14,
"date": "2026-11-19",
"days_validity": 30,
"seller_id": 5,
"project_manager_id": 9
}'
Cotización creada201
{
"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
}
Sin permiso403
{
"message": "This action is unauthorized."
}
Datos no válidos422
{
"message": "La carpeta seleccionada no pertenece a la oportunidad seleccionada.",
"errors": {
"budget_folder_id": [
"La carpeta seleccionada no pertenece a la oportunidad seleccionada."
]
}
}