Ir al contenido

Actualizar un producto

PUT/api/product/{id}

Actualiza un producto. Dentro de una transacción, el servidor sincroniza los precios por proveedor (si se envía provider_products), las categorías, las categorías de costo unitario, las presentaciones y los códigos de barras (si se envían sus claves), actualiza el producto, reemplaza la imagen si se envió image, recalcula las palabras clave y responde 200 con el registro actualizado. Las categorías (product_categories) son obligatorias también al actualizar.

idintegerobligatorio

Identificador de un producto.

part_numberstringobligatorio

Número de parte. Máximo 50 caracteres. Debe ser único, también frente a productos eliminados.

namestringobligatorio

Nombre del producto. Máximo 255 caracteres.

descriptionstringobligatorio

Descripción del producto. Máximo 1000 caracteres.

brand_idintegerobligatorio

Marca. Debe existir en marcas.

measurement_unit_idintegerobligatorio

Unidad de medida base. Debe existir en unidades de medida.

unified_index_idinteger

Índice unificado. Debe existir en índices unificados.

product_categoriesarrayobligatorio

Categorías del producto. Debe tener al menos un elemento y cada elemento lleva category_id (obligatorio, debe existir en categorías).

featuresstring

Características del producto.

buy_pricenumber

Precio de compra. No tiene reglas de formato.

sale_pricenumber

Precio de venta. No tiene reglas de formato.

stockinteger

Stock. No tiene reglas de formato.

imagestring

Imagen del producto: una ruta existente o un objeto base64 del frontend. Si envías la clave, el servidor reemplaza la imagen.

filestring

Se acepta en la validación, pero el caso de uso no lo usa; la imagen se envía en image.

file_extensionstring

Obligatorio si se envía file. El caso de uso no lo usa.

provider_productsarray

Lista de precios por proveedor. Cada elemento lleva provider_id (obligatorio, debe existir), code (obligatorio, máximo 50), coin_id (obligatorio, debe existir), price (obligatorio, numérico, de 0.01 a 1000000000), stock (obligatorio, entero de 0 a 1000000000), delivery_days (obligatorio, entero de 1 a 180), link_url (URL), commentary, name, description, payment_type (contado, crédito, credito_15, credito_30 o credito_60), inquiry_date (fecha que no sea futura) y evidence_file (objeto con base_64 y extension_file, que puede ser pdf, jpg, jpeg, png o webp).

product_unit_cost_categoriesarray

Categorías de costo unitario. Cada elemento lleva unit_cost_category_id, que debe existir en categorías de costo unitario.

is_inventory_itemboolean

Indica si el producto participa del kardex físico.

is_dropshipping_enabledboolean

Indica si el producto expone la disponibilidad del proveedor.

tracking_typestring

Trazabilidad: none, lot, serial o lot_serial.

picking_strategystringcondicional

Estrategia de salida: fefo, fifo o manual. Obligatoria si tracking_type es lot o lot_serial. Si falta, el mensaje es La estrategia de salida es obligatoria para productos con trazabilidad por lote.

product_unitsarray

Presentaciones del producto. Cada elemento lleva measurement_unit_id (debe existir), factor (numérico, mayor que 0), is_purchase_default e is_sale_default (booleanos). La unidad base se agrega con factor 1. Si envías la clave, el servidor sincroniza las presentaciones.

product_barcodesarray

Códigos de barras. Cada elemento lleva barcode (obligatorio, texto de hasta 255 caracteres), source (obligatorio: manufacturer, internal o provider), symbology (EAN13, UPCA, C128 o QR), provider_id (obligatorio si source es provider; no aplica en los demás), product_unit_id, is_primary, label e id. El código no puede repetirse en la lista ni estar registrado en otro producto. Si envías la clave, el servidor sincroniza los códigos.

quotation.configuration.edit, que se valida en ProductPolicy::update.

Ventana de terminal
curl -X PUT \
"https://servererp.allendostmen.app/api/product/1" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"part_number": "NSX100F",
"name": "Interruptor termomagnético 3x100A Compact",
"description": "Interruptor termomagnético tripolar de 100 A",
"brand_id": 1,
"measurement_unit_id": 2,
"product_categories": [
{
"category_id": 3
}
],
"sale_price": 150,
"is_inventory_item": true,
"tracking_type": "none"
}'
Producto actualizado200
{
"id": 1,
"brand_id": 1,
"measurement_unit_id": 2,
"unified_index_id": null,
"code": "0000001",
"part_number": "NSX100F",
"name": "Interruptor termomagnético 3x100A Compact",
"description": "Interruptor termomagnético tripolar de 100 A",
"features": null,
"search_keywords": "interruptor termomagnetico 3x100a nsx100f 0000001 schneider",
"buy_price": "120.00000000",
"sale_price": "150.00000000",
"stock": null,
"image": null,
"thumbnall": null,
"is_inventory_item": true,
"is_dropshipping_enabled": false,
"tracking_type": "none",
"picking_strategy": null,
"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": 1,
"delete_user_id": null,
"restore_user_id": null,
"created_at": "2026-11-19T10:40:15.000000Z",
"updated_at": "2026-11-19T11:15:00.000000Z",
"deleted_at": null
}
Error de validación422
{
"message": "El número de parte ya existe. Verifique o restaure el registro si fue eliminado anteriormente.",
"errors": {
"part_number": [
"El número de parte ya existe. Verifique o restaure el registro si fue eliminado anteriormente."
]
}
}
No encontrado404
{
"message": "No query results for model [App\\Models\\Product] 3"
}
Sin permiso403
{
"message": "This action is unauthorized."
}