Ir al contenido

Crear un material con su costo unitario

POST/api/unit-cost-material-direct

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

quotation_item_idintegerobligatorio

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

provider_product_idintegerobligatorio

Producto del proveedor. Debe existir y tener producto asociado; si no, responde 422 en provider_product_id (El producto proveedor no existe o no tiene producto asociado.).

descriptionstring

Descripción del material. Máximo 500 caracteres.

quantitynumberobligatorio

Cantidad. Numérica, con máximo 1000000.

costnumberobligatorio

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

cost_utilitynumberobligatorio

Utilidad por unidad, en monto. Mínimo 0.

syncstring

Qué precio usar cuando el producto 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 material (UnitCostMaterialPolicy::create).

Ventana de terminal
curl -X POST \
"https://servererp.allendostmen.app/api/unit-cost-material-direct" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"quotation_item_id": 45,
"provider_product_id": 88,
"quantity": 1,
"cost": 25.5,
"cost_utility": 2.55
}'
Material creado201
{
"id": 31,
"unit_cost_id": 12,
"provider_product_id": 88,
"product_id": 40,
"measurement_unit_id": 5,
"name": "CEMENTO PORTLAND TIPO I 42.5 KG",
"description": null,
"index": 1,
"original_price": "25.50000000",
"original_coin_id": 1,
"original_coin_value": "1.00000000",
"cost": 25.5,
"cost_utility": 2.55,
"cost_utility_percentage": 10.0,
"price": 28.05,
"quantity": 10.0,
"total_cost": 255.0,
"total_cost_utility": 25.5,
"total": 280.5,
"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 producto proveedor no existe o no tiene producto asociado.",
"errors": {
"provider_product_id": [
"El producto proveedor no existe o no tiene producto asociado."
]
}
}
Sin permiso403
{
"message": "This action is unauthorized."
}