Ir al contenido

Crear un ítem de cotización

POST/api/quotation-item

Crea un ítem. El servidor lo agrega al final (index es el mayor índice de la cotización más uno) y calcula su nivel: 1 si no tiene padre, o el nivel del padre más uno. Si se indica el padre, la cotización es la del padre. Todo ocurre en una transacción.

typestringobligatorio

Tipo del ítem: simple o costo unitario.

namestringcondicional

Obligatorio si type es simple.

descriptionstring

Descripción del ítem.

quotation_idintegercondicional

Obligatorio si no se envía parent_quotation_item_id.

parent_quotation_item_idintegercondicional

Obligatorio si no se envía quotation_id. Es el título que contiene al ítem.

unit_cost_idintegercondicional

Obligatorio si type es costo unitario.

indexinteger

Posición. El servidor la reemplaza por el siguiente índice libre.

quantitynumbercondicional

Obligatorio si se envía provider_product_id.

utilitynumbercondicional

Obligatorio si se envía provider_product_id.

provider_product_idinteger

Producto de proveedor del ítem.

Se exige poder editar la cotización: quotation.edit, que se valida en QuotationPolicy::update, con la cotización en estado cotizando y el usuario como root, vendedor, project manager o superior de ellos.

Ventana de terminal
curl -X POST \
"https://servererp.allendostmen.app/api/quotation-item" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"type": "simple",
"name": "Cableado",
"quotation_id": 1520
}'
Ítem creado201
{
"id": 301,
"quotation_id": 1520,
"parent_quotation_item_id": null,
"unit_cost_id": null,
"measurement_unit_id": 4,
"type": "simple",
"name": "Cableado",
"description": null,
"cost": 0,
"cost_utility": 0.3,
"cost_utility_percentage": 7.1429,
"price": 0,
"quantity": 0,
"total_cost": 504,
"total_cost_utility": 36,
"total": 0,
"index": 1,
"level": 1,
"status": "activo",
"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": "El campo name es obligatorio cuando type es simple.",
"errors": {
"name": [
"El campo name es obligatorio cuando type es simple."
]
}
}