Serveis 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)

service.createPOST

Servei creat

S'envia quan es crea un servei a Holded.

Payload

object

Dades del servei incloses en els payloads de webhook

idstring

Identificador únic del servei

namestring

Nom del servei

codestring

Codi del servei

descriptionstring

Descripció del servei

pricestring

Preu de venda

coststring

Preu de cost

salesAccountstring | null

Codi del compte de vendes

colorstring | null

Color en format hexadecimal

durationnumber<float> | null

Durada en minuts

archivedboolean

Indica si el servei està arxivat

tags[]string[]

Identificadors d'etiquetes

taxes[]string[]

Claus d'impostos

Payload d'exemple

json

{
  "id": "string",
  "name": "string",
  "code": "string",
  "description": "string",
  "price": "string",
  "cost": "string",
  "salesAccount": "string",
  "color": "string",
  "duration": 0,
  "archived": false,
  "tags": [
    "string"
  ],
  "taxes": [
    "string"
  ]
}

service.updatePOST

Servei actualitzat

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

Payload

object

Dades del servei incloses en els payloads de webhook

idstring

Identificador únic del servei

namestring

Nom del servei

codestring

Codi del servei

descriptionstring

Descripció del servei

pricestring

Preu de venda

coststring

Preu de cost

salesAccountstring | null

Codi del compte de vendes

colorstring | null

Color en format hexadecimal

durationnumber<float> | null

Durada en minuts

archivedboolean

Indica si el servei està arxivat

tags[]string[]

Identificadors d'etiquetes

taxes[]string[]

Claus d'impostos

Payload d'exemple

json

{
  "id": "string",
  "name": "string",
  "code": "string",
  "description": "string",
  "price": "string",
  "cost": "string",
  "salesAccount": "string",
  "color": "string",
  "duration": 0,
  "archived": false,
  "tags": [
    "string"
  ],
  "taxes": [
    "string"
  ]
}

service.deletePOST

Servei eliminat

S'envia quan s'elimina un servei a Holded.

Payload

object

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

idstring

Identificador únic del servei

deletedAtstring

Data d'eliminació en format ISO 8601

Payload d'exemple

json

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