Saltar al contingut principal
PUT

Actualitzar un producte

Scope:inventory:products.write
https://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

productIdstringobligatori

ID del producte (ObjectId hexadecimal de 24 caràcters)

Cos de la petició

object
namestringrequired

Product name

descriptionstring | nulloptional

Product description

skustring | nulloptional

Stock keeping unit code

barcodestring | nulloptional

Barcode value

pricestring | nulloptional

Unit sale price as a decimal string

default: null
coststring | nulloptional

Unit cost price as a decimal string

default: null
purchase_pricestring | nulloptional

Unit purchase price as a decimal string

default: null
weightnumber | nulloptional

Weight in account default unit

default: null
tags[]string[] | nulloptional

List of tag names

taxes[]string[] | nulloptional

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.

for_salebooleanrequired

Whether the product is available for sale

for_purchasebooleanrequired

Whether the product is available for purchase

archivedbooleanrequired

Whether the product is archived

variants[]object[] | nulloptional

Variants of the product (for variants, lots and serial numbers product types). Sending this field replaces all existing variants.

idstring

Variant identifier

skustring | null
barcodestring | null
pricestring | null
coststring | null
purchase_pricestring | null
stocknumber | null
descriptionstring | null
weightnumber | null
factory_codestring | null
archivedboolean | null
lot_numberstring | null

Only for LOTS products

start_datestring<date> | null

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)

end_datestring<date> | null

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)

pack_items[]object[] | nulloptional

Items included in this pack product. Sending this field replaces all existing pack items.

product_selectionstring

Product ID or "productId#variantId"

unitsnumber
show_start_dateboolean | nulloptional

Show lot start date in documents. Only for LOTS products.

show_end_dateboolean | nulloptional

Show lot end date in documents. Only for LOTS products.

warehouse_idstring | nulloptional

Default warehouse identifier for this product

sales_channel_idstring | nulloptional

Sales channel identifier for this product

exp_account_idstring | nulloptional

Expense/purchases accounting account identifier for this product

Petició

python
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

json
{
  "id": "string"
}

Respostes exitoses

200Producte actualitzatapplication/json
object
idstring

Respostes d'error

400Sol·licitud incorrectaapplication/json
401API key no vàlida o no proporcionadaapplication/json
403Permisos insuficientsapplication/json
404Producte no trobatapplication/json
422Error de validacióapplication/json
429Límit de sol·licituds exceditapplication/json