Ir al contenido

Crear un gasto general de cotización

POST/api/quotation-overhead

Crea un título o un gasto en una transacción. Si hay padre, toma la cotización del padre y el nivel es el del padre más uno; si no, el nivel es 1. El índice es el mayor índice de la cotización más uno. Calcula los importes derivados, guarda el estado activo y al usuario en create_user_id, y responde 201 con el registro. El observador recalcula los totales de la cotización si no es un título.

quotation_idintegerobligatorio

Cotización. Debe existir. Si se envía quotation_overhead_parent_id, el servidor la reemplaza por la del padre.

quotation_overhead_parent_idinteger

Título o gasto padre. Debe existir en gastos generales.

is_titlebooleanobligatorio

Verdadero para un título. En un título el servidor fuerza cost, cost_utility y quantity en 0 y deja nulos participation_percentage, resource y measurement_unit_id.

namestringobligatorio

Nombre. Máximo 255 caracteres.

typestringobligatorio

Tipo: fijo o variable.

measurement_unit_idintegercondicional

Obligatorio si no es un título. Debe existir en unidades de medida.

costnumbercondicional

Obligatorio si no es un título. Costo unitario.

cost_utilitynumbercondicional

Obligatorio si no es un título. Utilidad unitaria.

quantitynumbercondicional

Obligatorio si no es un título. Máximo 1000000.

participation_percentagenumber

Porcentaje de participación. Si se envía con valor, debe ser numérico y no mayor que 100.

resourcenumber

Recurso. Si se envía con valor, debe ser numérico y no mayor que 100.

Se valida con Gate::authorize('update', cotización), es decir, QuotationPolicy::update: exige el permiso quotation.edit, que la cotización esté en estado cotizando y que el usuario sea el vendedor, el project manager o un superior (el rol root omite esta última comprobación). QuotationOverheadPolicy::create no se evalúa en este endpoint.

Ventana de terminal
curl -X POST \
"https://servererp.allendostmen.app/api/quotation-overhead" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"quotation_id": 15,
"quotation_overhead_parent_id": 30,
"is_title": false,
"name": "Alquiler de oficina",
"type": "fijo",
"measurement_unit_id": 5,
"cost": 1500,
"cost_utility": 300,
"quantity": 6,
"participation_percentage": 100,
"resource": 1
}'
Gasto creado201
{
"id": 31,
"quotation_id": 15,
"quotation_overhead_parent_id": 30,
"name": "Alquiler de oficina",
"description": null,
"is_title": false,
"type": "fijo",
"cost": 1500,
"cost_utility": 300,
"cost_utility_percentage": 20,
"participation_percentage": 100,
"measurement_unit_id": 5,
"amount": 1800,
"price": 1800,
"quantity": 6,
"resource": 1,
"quantity_calculated": 6,
"total_cost": 9000,
"total_cost_utility": 1800,
"total": 10800,
"index": 1,
"level": 2,
"status": "activo",
"previous_status": null,
"status_update_comment": null,
"status_update_date": null,
"status_update_user_id": null,
"create_user_id": 1,
"update_user_id": null,
"delete_user_id": null,
"restore_user_id": null,
"restored_at": null,
"created_at": "2026-11-19T10:40:15.000000Z",
"updated_at": "2026-11-19T10:40:15.000000Z",
"deleted_at": null
}
Sin permiso403
{
"message": "No tiene permisos para editar cotizaciones."
}
Datos no válidos422
{
"message": "El campo name es obligatorio.",
"errors": {
"name": [
"El campo name es obligatorio."
]
}
}