Ir al contenido

Crear un subcontrato de costo unitario

POST/api/unit-cost-subcontract

Agrega un subcontrato a un costo unitario. El servidor recalcula el costo del proveedor de subcontrato en la moneda del costo unitario y lo compara con cost: si difiere, responde 422 en cost (El precio del subcontrato ha cambiado desde la última consulta. Por favor, actualice y verifique nuevamente antes de continuar.). Si el mismo subcontrato ya está en otro costo unitario de las cotizaciones de la oportunidad (en cotizando, revisando, aprobado, negociando o cerrado) con un costo distinto y no se envía sync, responde 409 con el detalle del conflicto. Después calcula precio, totales y porcentaje de utilidad, y actualiza los totales del costo unitario, de su ítem de cotización y de la cotización. Al terminar actualiza updated_at del costo unitario. Responde 201 con el subcontrato.

unit_cost_idintegerobligatorio

Costo unitario al que se agrega. Debe existir. La validación solo lo exige cuando falta quotation_item_id, pero store lo necesita siempre para ubicar el costo unitario.

quotation_item_idinteger

Solo tiene efecto en la ruta de crear directo. Si se envía, debe existir en ítems de cotización; en esta ruta no se usa.

subcontract_provider_idintegerobligatorio

Proveedor de subcontrato. 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 subcontrato 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 UnitCostSubcontractPolicy::create.

Ventana de terminal
curl -X POST \
"https://servererp.allendostmen.app/api/unit-cost-subcontract" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"unit_cost_id": 12,
"subcontract_provider_id": 15,
"quantity": 2,
"cost": 500,
"cost_utility": 50
}'
Subcontrato creado201
{
"id": 8,
"unit_cost_id": 12,
"subcontract_provider_id": 15,
"measurement_unit_id": 8,
"subcontract_id": 6,
"name": "SERVICIO DE ENCOFRADO",
"description": null,
"original_price": "500.00000000",
"original_coin_id": 1,
"original_coin_value": "1.00000000",
"index": 1,
"cost": 500.0,
"cost_utility": 50.0,
"cost_utility_percentage": 10.0,
"price": 550.0,
"quantity": 2.0,
"total_cost": 1000.0,
"total_cost_utility": 100.0,
"total": 1100.0,
"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": 480.0,
"new_cost": 500.0,
"coin_symbol": "S/",
"can_use_new_price": true,
"blocked_reason": null,
"affected_unit_costs": 1,
"affected_quotations": 1
}
Datos no válidos422
{
"message": "El precio del subcontrato ha cambiado desde la última consulta. Por favor, actualice y verifique nuevamente antes de continuar.",
"errors": {
"cost": [
"El precio del subcontrato ha cambiado desde la última consulta. Por favor, actualice y verifique nuevamente antes de continuar."
]
}
}
Sin permiso403
{
"message": "This action is unauthorized."
}