Productes Webhooks

3 esdeveniments

Capçaleres comunes

Cada petició de webhook inclou aquestes capçaleres:

x-holded-webhook-eventstring

Nom de l'esdeveniment, p. ex. invoice.create

x-holded-webhook-datestring · ISO 8601

Moment de l'enviament, p. ex. 2026-06-18T11:10:35Z

x-holded-webhook-signaturestring

Signatura HMAC-SHA256 amb prefix sha256= (vegeu a sota)

x-holded-webhook-idstring

Identificador únic de l'esdeveniment; utilitza'l com a clau d'idempotència

x-holded-webhook-account-idstring

Identificador del compte de Holded que origina l'esdeveniment

x-holded-webhook-versionstring

Versió del sistema de webhooks (p. ex. v1)

product.createPOST

Producte creat

S'envia quan es crea un producte a Holded.

Payload

object

Dades del producte incloses en els payloads de webhook

idstring

Identificador únic del producte

namestring

Nom del producte

descriptionstring | null

Descripció del producte

kindstring

Tipus de producte (simple, variants, lots, serial_numbers, pack)

skustring | null

Codi de referència (SKU)

barcodestring | null

Codi de barres

pricestring | null

Preu de venda

coststring | null

Preu de cost

stockstring

Estoc disponible

variants[]object[]

Variants del producte

idstring

Identificador únic de la variant

skustring | null

Codi de referència (SKU)

barcodestring | null

Codi de barres

pricestring | null

Preu de venda

coststring | null

Preu de cost

stockstring | null

Estoc disponible

descriptionstring | null

Descripció de la variant

packItems[]object[]

Composició del pack, present només en productes de tipus pack

productIdstring

Identificador del producte inclòs en el pack

variantIdstring | null

Identificador de la variant inclosa en el pack, quan l'element del pack és una variant

unitsstring

Unitats d'aquest producte incloses en el pack

Payload d'exemple

json

{
  "id": "string",
  "name": "string",
  "description": "string",
  "kind": "string",
  "sku": "string",
  "barcode": "string",
  "price": "string",
  "cost": "string",
  "stock": "string",
  "variants": [
    {
      "id": "string",
      "sku": "string",
      "barcode": "string",
      "price": "string",
      "cost": "string",
      "stock": "string",
      "description": "string"
    }
  ],
  "packItems": [
    {
      "productId": "string",
      "variantId": "string",
      "units": "string"
    }
  ]
}

product.updatePOST

Producte actualitzat

S'envia quan s'actualitza un producte existent a Holded.

Payload

object

Dades del producte incloses en els payloads de webhook

idstring

Identificador únic del producte

namestring

Nom del producte

descriptionstring | null

Descripció del producte

kindstring

Tipus de producte (simple, variants, lots, serial_numbers, pack)

skustring | null

Codi de referència (SKU)

barcodestring | null

Codi de barres

pricestring | null

Preu de venda

coststring | null

Preu de cost

stockstring

Estoc disponible

variants[]object[]

Variants del producte

idstring

Identificador únic de la variant

skustring | null

Codi de referència (SKU)

barcodestring | null

Codi de barres

pricestring | null

Preu de venda

coststring | null

Preu de cost

stockstring | null

Estoc disponible

descriptionstring | null

Descripció de la variant

packItems[]object[]

Composició del pack, present només en productes de tipus pack

productIdstring

Identificador del producte inclòs en el pack

variantIdstring | null

Identificador de la variant inclosa en el pack, quan l'element del pack és una variant

unitsstring

Unitats d'aquest producte incloses en el pack

Payload d'exemple

json

{
  "id": "string",
  "name": "string",
  "description": "string",
  "kind": "string",
  "sku": "string",
  "barcode": "string",
  "price": "string",
  "cost": "string",
  "stock": "string",
  "variants": [
    {
      "id": "string",
      "sku": "string",
      "barcode": "string",
      "price": "string",
      "cost": "string",
      "stock": "string",
      "description": "string"
    }
  ],
  "packItems": [
    {
      "productId": "string",
      "variantId": "string",
      "units": "string"
    }
  ]
}

product.deletePOST

Producte eliminat

S'envia quan un producte es mou a la paperera a Holded.

Payload

object

Dades del producte incloses en els payloads de webhook d'eliminació

idstring

Identificador únic del producte

kindstring

Tipus de producte (simple, variants, lots, serialnumbers, pack)

deletedAtstring

Marca de temps d'eliminació en format ISO 8601

Payload d'exemple

json

{
  "id": "string",
  "kind": "string",
  "deletedAt": "string"
}