Actualitzar un producte
inventory:products.writehttps://api.holded.com/api/v2/products/{productId}Substitueix tots els camps editables d'un producte existent. Es tracta d'una substitució completa del recurs.
Paràmetres
Paràmetres de ruta
stringobligatoriID del producte (ObjectId hexadecimal de 24 caràcters)
Cos de la petició
Product name
Product description
Stock keeping unit code
Barcode value
Unit sale price as a decimal string
nullUnit cost price as a decimal string
nullUnit purchase price as a decimal string
nullWeight in account default unit
nullList of tag names
Tax keys applied to this product. Accepts the human tax name (e.g. "IVA 21%") or the internal key (e.g. "s_iva_21"); resolved automatically.
Whether the product is available for sale
Whether the product is available for purchase
Whether the product is archived
Variants of the product (for variants, lots and serial numbers product types). Sending this field replaces all existing variants.
Variant identifier
Only for LOTS products
Only for LOTS and serial number products. ISO 8601 format. Accepts date (YYYY-MM-DD) or datetime (e.g. 2025-01-01T00:00:00+00:00)
Only for LOTS and serial number products. ISO 8601 format. Accepts date (YYYY-MM-DD) or datetime (e.g. 2025-12-31T00:00:00+00:00)
Items included in this pack product. Sending this field replaces all existing pack items.
Product ID or "productId#variantId"
Show lot start date in documents. Only for LOTS products.
Show lot end date in documents. Only for LOTS products.
Default warehouse identifier for this product
Sales channel identifier for this product
Expense/purchases accounting account identifier for this product
Petició
import requests
url = "https://api.holded.com/api/v2/products/{productId}"
headers = {
"Authorization": "Bearer YOUR_API_KEY",
"Accept": "application/json",
}
payload = {
"name": "string",
"description": "string",
"sku": "string",
"barcode": "string",
"price": "49.99",
"cost": "29.99",
"purchase_price": "19.99",
"weight": 0,
"tags": [
"string"
],
"taxes": [
"s_iva_21"
],
"for_sale": false,
"for_purchase": false,
"archived": false,
"variants": [
{
"id": "string",
"sku": "string",
"barcode": "string",
"price": "19.99",
"cost": "string",
"purchase_price": "string",
"stock": 0,
"description": "string",
"weight": 0,
"factory_code": "string",
"archived": false,
"lot_number": "string",
"start_date": "2025-01-01",
"end_date": "2025-12-31"
}
],
"pack_items": [
{
"product_selection": "507f1f77bcf86cd799439011",
"units": 2
}
],
"show_start_date": false,
"show_end_date": false,
"warehouse_id": "string",
"sales_channel_id": "string",
"exp_account_id": "string"
}
response = requests.put(url, headers=headers, json=payload)
print(response.json())Respostes
Resposta
{
"id": "string"
}Respostes exitoses
200Producte actualitzatapplication/jsonRespostes d'error
400Sol·licitud incorrectaapplication/json401API key no vàlida o no proporcionadaapplication/json403Permisos insuficientsapplication/json404Producte no trobatapplication/json422Error de validacióapplication/json429Límit de sol·licituds exceditapplication/json