Ir al contenido

Crear un subcontrato con su costo unitario

POST/api/unit-cost-subcontract-direct

Crea en una sola llamada un costo unitario y su primer subcontrato. Primero crea el costo unitario (como en Crear un costo unitario) con el nombre y la unidad de medida del subcontrato, rendimiento 1, la moneda del proveedor de subcontrato y el ítem de cotización indicado; luego agrega el subcontrato con las mismas reglas que Crear un subcontrato. Todo corre en una transacción. Responde 201 con el subcontrato.

quotation_item_idintegerobligatorio

Ítem de cotización del que colgará el costo unitario nuevo. Debe existir en ítems de cotización.

subcontract_provider_idintegerobligatorio

Proveedor de subcontrato. Debe existir y tener subcontrato asociado; si no, responde 422 en subcontract_provider_id (El proveedor de subcontrato no existe o no tiene subcontrato asociado.).

descriptionstring

Descripción del subcontrato. 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 al crear el costo unitario (UnitCostPolicy::create) y el subcontrato (UnitCostSubcontractPolicy::create).

Ventana de terminal
curl -X POST \
"https://servererp.allendostmen.app/api/unit-cost-subcontract-direct" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"quotation_item_id": 45,
"subcontract_provider_id": 15,
"quantity": 1,
"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 proveedor de subcontrato no existe o no tiene subcontrato asociado.",
"errors": {
"subcontract_provider_id": [
"El proveedor de subcontrato no existe o no tiene subcontrato asociado."
]
}
}
Sin permiso403
{
"message": "This action is unauthorized."
}