Ir al contenido

Crear un material de costo unitario

POST/api/unit-cost-material

Agrega un material a un costo unitario dentro de una transacción. El servidor recalcula el costo del producto del proveedor en la moneda del costo unitario y lo compara con cost: si difiere, responde 422 en cost (El precio del producto ha cambiado desde la última consulta. Por favor, actualice y verifique nuevamente antes de continuar.). Si el mismo producto 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. Si no hay conflicto, se calculan precio, totales y porcentaje de utilidad; si el precio resulta menor que el costo, responde 422 (El precio del producto no puede ser menor al costo.). Después actualiza los totales del costo unitario, de su ítem de cotización y de la cotización. Responde 201 con el material.

unit_cost_idintegerobligatorio

Costo unitario al que se agrega el material. 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.

provider_product_idintegerobligatorio

Producto del proveedor. Debe existir y no estar ya agregado (sin eliminar) al mismo costo unitario. Si ya está: El producto ya existe para este costo unitario.

descriptionstring

Descripción. Máximo 500 caracteres.

quantitynumberobligatorio

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

costnumberobligatorio

Costo que el cliente vio al elegir el producto. El servidor lo recalcula y debe coincidir; si no, responde 422.

cost_utilitynumberobligatorio

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

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 en UnitCostMaterialPolicy::create.

Ventana de terminal
curl -X POST \
"https://servererp.allendostmen.app/api/unit-cost-material" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"unit_cost_id": 12,
"provider_product_id": 88,
"quantity": 10,
"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 precio del producto ha cambiado desde la última consulta. Por favor, actualice y verifique nuevamente antes de continuar.",
"errors": {
"cost": [
"El precio del producto ha cambiado desde la última consulta. Por favor, actualice y verifique nuevamente antes de continuar."
]
}
}
Sin permiso403
{
"message": "This action is unauthorized."
}