Actualizar un producto
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.
Parámetros de la ruta
Sección titulada «Parámetros de la ruta»idintegerobligatorioIdentificador de un producto.
Parámetros del cuerpo
Sección titulada «Parámetros del cuerpo»part_numberstringobligatorioNúmero de parte. Máximo 50 caracteres. Debe ser único, también frente a productos eliminados.
namestringobligatorioNombre del producto. Máximo 255 caracteres.
descriptionstringobligatorioDescripción del producto. Máximo 1000 caracteres.
brand_idintegerobligatorioMarca. Debe existir en marcas.
measurement_unit_idintegerobligatorioUnidad de medida base. Debe existir en unidades de medida.
unified_index_idintegerÍndice unificado. Debe existir en índices unificados.
product_categoriesarrayobligatorioCategorías del producto. Debe tener al menos un elemento y cada elemento lleva category_id (obligatorio, debe existir en categorías).
featuresstringCaracterísticas del producto.
buy_pricenumberPrecio de compra. No tiene reglas de formato.
sale_pricenumberPrecio de venta. No tiene reglas de formato.
stockintegerStock. No tiene reglas de formato.
imagestringImagen del producto: una ruta existente o un objeto base64 del frontend. Si envías la clave, el servidor reemplaza la imagen.
filestringSe acepta en la validación, pero el caso de uso no lo usa; la imagen se envía en image.
file_extensionstringObligatorio si se envía file. El caso de uso no lo usa.
provider_productsarrayLista 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_categoriesarrayCategorías de costo unitario. Cada elemento lleva unit_cost_category_id, que debe existir en categorías de costo unitario.
is_inventory_itembooleanIndica si el producto participa del kardex físico.
is_dropshipping_enabledbooleanIndica si el producto expone la disponibilidad del proveedor.
tracking_typestringTrazabilidad: none, lot, serial o lot_serial.
picking_strategystringcondicionalEstrategia 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_unitsarrayPresentaciones 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_barcodesarrayCó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.
Permiso
Sección titulada «Permiso»quotation.configuration.edit, que se valida en ProductPolicy::update.
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"}'const response = await fetch( "https://servererp.allendostmen.app/api/product/1", { method: "PUT", headers: { Authorization: `Bearer ${token}`, Accept: "application/json", "Content-Type": "application/json", }, body: JSON.stringify({ "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" }), },);const data = await response.json();use Illuminate\Support\Facades\Http;
$response = Http::withToken($token) ->acceptJson() ->put('https://servererp.allendostmen.app/api/product/1', [ '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',]);{ "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}{ "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." ] }}{ "message": "No query results for model [App\\Models\\Product] 3"}{ "message": "This action is unauthorized."}