Ir al contenido

Crear un ítem de mano de obra

POST/api/unit-cost-workforce

Agrega un recurso de mano de obra a un costo unitario dentro de una transacción. El servidor recalcula el costo de la mano de obra en la moneda del costo unitario y lo compara con cost: si difiere, responde 422 en cost (El precio de la mano de obra ha cambiado desde la última consulta. Por favor, actualice y verifique nuevamente antes de continuar.). Si la misma mano de obra ya está en otro costo unitario de la oportunidad con un costo distinto y no se envía sync, responde 409 con el detalle del conflicto. La cantidad se calcula con resource * workday / yield del costo unitario. Si el precio resulta menor que el costo, responde 422 (El precio de la mano de obra no puede ser menor al costo.). Después actualiza los totales del costo unitario, de sus equipos y herramientas especiales, de su ítem de cotización y de la cotización. Responde 201 con el ítem.

unit_cost_idintegerobligatorio

Costo unitario al que se agrega. Debe existir.

workforce_idintegerobligatorio

Mano de obra. Debe existir.

descriptionstring

Descripción. Máximo 500 caracteres.

costnumberobligatorio

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

cost_utilitynumberobligatorio

Utilidad por unidad, en monto. Mínimo 0. Si el costo unitario no usa utilidad individual, se recalcula con su porcentaje.

resourcenumberobligatorio

Recurso: cantidad de personas o cuadrillas.

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 UnitCostWorkforcePolicy::create.

Ventana de terminal
curl -X POST \
"https://servererp.allendostmen.app/api/unit-cost-workforce" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"unit_cost_id": 12,
"workforce_id": 4,
"cost": 18.5,
"cost_utility": 1.85,
"resource": 1
}'
Ítem de mano de obra creado201
{
"id": 21,
"unit_cost_id": 12,
"workforce_id": 4,
"measurement_unit_id": 6,
"name": "OFICIAL ALBAÑIL",
"description": null,
"original_price": "18.50000000",
"original_coin_id": 1,
"original_coin_value": "1.00000000",
"index": 1,
"yield": null,
"cost": 18.5,
"cost_utility": 1.85,
"cost_utility_percentage": 10.0,
"price": 20.35,
"resource": 1.0,
"quantity": 0.6667,
"total_cost": 12.3333,
"total_cost_utility": 1.2333,
"total": 13.5667,
"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 recurso es obligatorio",
"errors": {
"resource": [
"El recurso es obligatorio"
]
}
}
Sin permiso403
{
"message": "This action is unauthorized."
}