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

waybill.createPOST

Albarà creat

S'envia quan es crea un albarà a Holded.

Payload

object

Dades del document incloses en els payloads de webhook

idstring

Identificador únic del document

typestring

Tipus de document (invoice, salesorder, estimate, etc.)

documentNumberstring | null

Número del document

datestring | null

Data del document en format ISO 8601

dueDatestring | null

Data de venciment en format ISO 8601

contactIdstring | null

Identificador únic del contacte

contactNamestring | null

Nom del contacte

totalstring | null

Import total

subtotalstring | null

Import subtotal

isDraftboolean | null

Indica si el document es troba en estat esborrany

statusstring | null

Estat del document

languagestring | null

Codi d'idioma del document

descriptionstring | null

Descripció del document

notesstring | null

Notes del document

numberLineIdstring | null

Identificador de la sèrie de numeració

currencystring | null

Codi de moneda

currencyChangenumber<float> | null

Tipus de canvi de la moneda

discountstring | null

Import del descompte

taxstring | null

Import d'impostos

paymentMethodstring | null

Identificador del mètode de pagament

paymentsTotalstring | null

Import total ja pagat

paymentsPendingstring | null

Import pendent de pagament

warehouseIdstring | null

Identificador del magatzem

marketplacestring | null

Nom del marketplace

trackingKeystring | null

Clau de seguiment

trackingNamestring | null

Nom del transportista de seguiment

trackingNumberstring | null

Número de seguiment

accountingDatestring | null

Data comptable en format ISO 8601

approvedAtstring | null

Data d'aprovació en format ISO 8601

tags[]string[] | null

Etiquetes assignades al document

customFields[]object[] | null

Camps personalitzats

lines[]object[] | null

Línies del document

payments[]object[] | null

Registres de pagament

comments[]object[] | null

Comentaris del document

Payload d'exemple

json

{
  "id": "string",
  "type": "string",
  "documentNumber": "string",
  "date": "string",
  "dueDate": "string",
  "contactId": "string",
  "contactName": "string",
  "total": "string",
  "subtotal": "string",
  "isDraft": false,
  "status": "string",
  "language": "string",
  "description": "string",
  "notes": "string",
  "numberLineId": "string",
  "currency": "string",
  "currencyChange": 0,
  "discount": "string",
  "tax": "string",
  "paymentMethod": "string",
  "paymentsTotal": "string",
  "paymentsPending": "string",
  "warehouseId": "string",
  "marketplace": "string",
  "trackingKey": "string",
  "trackingName": "string",
  "trackingNumber": "string",
  "accountingDate": "string",
  "approvedAt": "string",
  "tags": [
    "string"
  ],
  "customFields": [
    {}
  ],
  "lines": [
    {}
  ],
  "payments": [
    {}
  ],
  "comments": [
    {}
  ]
}

waybill.updatePOST

Albarà actualitzat

S'envia quan s'actualitza un albarà a Holded.

Payload

object

Dades del document incloses en els payloads de webhook

idstring

Identificador únic del document

typestring

Tipus de document (invoice, salesorder, estimate, etc.)

documentNumberstring | null

Número del document

datestring | null

Data del document en format ISO 8601

dueDatestring | null

Data de venciment en format ISO 8601

contactIdstring | null

Identificador únic del contacte

contactNamestring | null

Nom del contacte

totalstring | null

Import total

subtotalstring | null

Import subtotal

isDraftboolean | null

Indica si el document es troba en estat esborrany

statusstring | null

Estat del document

languagestring | null

Codi d'idioma del document

descriptionstring | null

Descripció del document

notesstring | null

Notes del document

numberLineIdstring | null

Identificador de la sèrie de numeració

currencystring | null

Codi de moneda

currencyChangenumber<float> | null

Tipus de canvi de la moneda

discountstring | null

Import del descompte

taxstring | null

Import d'impostos

paymentMethodstring | null

Identificador del mètode de pagament

paymentsTotalstring | null

Import total ja pagat

paymentsPendingstring | null

Import pendent de pagament

warehouseIdstring | null

Identificador del magatzem

marketplacestring | null

Nom del marketplace

trackingKeystring | null

Clau de seguiment

trackingNamestring | null

Nom del transportista de seguiment

trackingNumberstring | null

Número de seguiment

accountingDatestring | null

Data comptable en format ISO 8601

approvedAtstring | null

Data d'aprovació en format ISO 8601

tags[]string[] | null

Etiquetes assignades al document

customFields[]object[] | null

Camps personalitzats

lines[]object[] | null

Línies del document

payments[]object[] | null

Registres de pagament

comments[]object[] | null

Comentaris del document

Payload d'exemple

json

{
  "id": "string",
  "type": "string",
  "documentNumber": "string",
  "date": "string",
  "dueDate": "string",
  "contactId": "string",
  "contactName": "string",
  "total": "string",
  "subtotal": "string",
  "isDraft": false,
  "status": "string",
  "language": "string",
  "description": "string",
  "notes": "string",
  "numberLineId": "string",
  "currency": "string",
  "currencyChange": 0,
  "discount": "string",
  "tax": "string",
  "paymentMethod": "string",
  "paymentsTotal": "string",
  "paymentsPending": "string",
  "warehouseId": "string",
  "marketplace": "string",
  "trackingKey": "string",
  "trackingName": "string",
  "trackingNumber": "string",
  "accountingDate": "string",
  "approvedAt": "string",
  "tags": [
    "string"
  ],
  "customFields": [
    {}
  ],
  "lines": [
    {}
  ],
  "payments": [
    {}
  ],
  "comments": [
    {}
  ]
}

waybill.deletePOST

Albarà eliminat

S'envia quan s'elimina un albarà a Holded.

Payload

object

Dades del document eliminat incloses en els payloads de webhook

idstring

Identificador únic del document

typestring

Tipus de document (invoice, salesorder, estimate, etc.)

documentNumberstring | null

Número del document

contactIdstring | null

Identificador únic del contacte

Payload d'exemple

json

{
  "id": "string",
  "type": "string",
  "documentNumber": "string",
  "contactId": "string"
}