Ir al contenido

Crear un ítem de equipo o herramienta

POST/api/unit-cost-equipment-tool

Agrega un equipo o herramienta a un costo unitario dentro de una transacción. Para un equipo normal, el servidor recalcula el costo en la moneda del costo unitario y lo compara con cost: si difiere, responde 422 en cost (El precio ha cambiado desde la última consulta. Por favor, actualice y verifique.); si el mismo equipo ya está en otro costo unitario de la oportunidad con un costo distinto y no se envía sync, responde 409. Para el equipo herramientas manuales con unidad %mo, el costo se toma del total_workforces del costo unitario y no se compara. Si el precio resulta menor que el costo, responde 422 (El precio no puede ser menor al costo.). Responde 201 con el ítem.

unit_cost_idintegerobligatorio

Costo unitario al que se agrega. Debe existir.

equipment_tool_idintegerobligatorio

Equipo o herramienta. Debe existir.

descriptionstring

Descripción. Máximo 500 caracteres.

quantitynumberobligatorio

Cantidad.

costnumberobligatorio

Costo que el cliente vio. Debe coincidir con el recalculado por el servidor.

cost_utilitynumberobligatorio

Utilidad por unidad, en monto. Entre 0 y 1000.

syncstring

Qué precio usar cuando el recurso ya está en otra cotización de la oportunidad con un costo distinto: new adopta el precio nuevo y lo propaga a las demás cotizaciones en cotizando; old adopta el costo ya cotizado. Si falta y los costos difieren, la API responde 409.

quotation.configuration.create, que se valida en UnitCostEquipmentToolPolicy::create.

Ventana de terminal
curl -X POST \
"https://servererp.allendostmen.app/api/unit-cost-equipment-tool" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"unit_cost_id": 12,
"equipment_tool_id": 9,
"quantity": 0.5,
"cost": 40,
"cost_utility": 4
}'
Ítem creado201
{
"id": 17,
"unit_cost_id": 12,
"equipment_tool_id": 9,
"measurement_unit_id": 7,
"name": "MEZCLADORA DE CONCRETO",
"description": null,
"original_price": "40.00000000",
"original_coin_id": 1,
"original_coin_value": "1.00000000",
"index": 1,
"resource": null,
"cost": 40.0,
"cost_utility": 4.0,
"cost_utility_percentage": 10.0,
"price": 44.0,
"quantity": 0.5,
"total_cost": 20.0,
"total_cost_utility": 2.0,
"total": 22.0,
"is_percentage_workforce": false,
"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,
"created_at": "2026-11-19T10:40:15.000000Z",
"updated_at": "2026-11-19T10:40:15.000000Z",
"deleted_at": null
}
Conflicto de precio409
{
"requires_sync": true,
"message": "Este recurso ya está en la oportunidad a un precio distinto. Elegí qué precio usar.",
"existing_cost": 24.8,
"new_cost": 25.5,
"coin_symbol": "S/",
"can_use_new_price": true,
"blocked_reason": null,
"affected_unit_costs": 2,
"affected_quotations": 1
}
Datos no válidos422
{
"message": "El precio ha cambiado desde la última consulta. Por favor, actualice y verifique.",
"errors": {
"cost": [
"El precio ha cambiado desde la última consulta. Por favor, actualice y verifique."
]
}
}
Sin permiso403
{
"message": "This action is unauthorized."
}