Recibos de venta Webhooks

4 eventos

Cabeceras comunes

Cada petición de webhook incluye estas cabeceras:

x-holded-webhook-eventstring

Nombre del evento, p. ej. invoice.create

x-holded-webhook-datestring · ISO 8601

Momento del envío, p. ej. 2026-06-18T11:10:35Z

x-holded-webhook-signaturestring

Firma HMAC-SHA256 con prefijo sha256= (ver abajo)

x-holded-webhook-idstring

Identificador único del evento; úsalo como clave de idempotencia

x-holded-webhook-account-idstring

Identificador de la cuenta de Holded que origina el evento

x-holded-webhook-versionstring

Versión del sistema de webhooks (p. ej. v1)

salesreceipt.createPOST

Ticket de venta creado

Se envía cuando se crea un ticket de venta en Holded.

Payload

object

Datos del documento incluidos en los payloads de webhook

idstring

Identificador único del documento

typestring

Tipo de documento (invoice, salesorder, estimate, etc.)

documentNumberstring | null

Número del documento

datestring | null

Fecha del documento en formato ISO 8601

dueDatestring | null

Fecha de vencimiento en formato ISO 8601

contactIdstring | null

Identificador único del contacto

contactNamestring | null

Nombre del contacto

totalstring | null

Importe total

subtotalstring | null

Importe subtotal

isDraftboolean | null

Indica si el documento está en estado borrador

statusstring | null

Estado del documento

languagestring | null

Código de idioma del documento

descriptionstring | null

Descripción del documento

notesstring | null

Notas del documento

numberLineIdstring | null

Identificador de la serie de numeración

currencystring | null

Código de moneda

currencyChangenumber<float> | null

Tipo de cambio de la moneda

discountstring | null

Importe del descuento

taxstring | null

Importe de impuestos

paymentMethodstring | null

Identificador del método de pago

paymentsTotalstring | null

Importe total ya pagado

paymentsPendingstring | null

Importe pendiente de pago

warehouseIdstring | null

Identificador del almacén

marketplacestring | null

Nombre del marketplace

trackingKeystring | null

Clave de seguimiento

trackingNamestring | null

Nombre del transportista de seguimiento

trackingNumberstring | null

Número de seguimiento

accountingDatestring | null

Fecha contable en formato ISO 8601

approvedAtstring | null

Fecha de aprobación en formato ISO 8601

tags[]string[] | null

Etiquetas asignadas al documento

customFields[]object[] | null

Campos personalizados

lines[]object[] | null

Líneas del documento

payments[]object[] | null

Registros de pago

comments[]object[] | null

Comentarios del documento

Payload de ejemplo

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": [
    {}
  ]
}

salesreceipt.updatePOST

Ticket de venta actualizado

Se envía cuando se actualiza un ticket de venta en Holded.

Payload

object

Datos del documento incluidos en los payloads de webhook

idstring

Identificador único del documento

typestring

Tipo de documento (invoice, salesorder, estimate, etc.)

documentNumberstring | null

Número del documento

datestring | null

Fecha del documento en formato ISO 8601

dueDatestring | null

Fecha de vencimiento en formato ISO 8601

contactIdstring | null

Identificador único del contacto

contactNamestring | null

Nombre del contacto

totalstring | null

Importe total

subtotalstring | null

Importe subtotal

isDraftboolean | null

Indica si el documento está en estado borrador

statusstring | null

Estado del documento

languagestring | null

Código de idioma del documento

descriptionstring | null

Descripción del documento

notesstring | null

Notas del documento

numberLineIdstring | null

Identificador de la serie de numeración

currencystring | null

Código de moneda

currencyChangenumber<float> | null

Tipo de cambio de la moneda

discountstring | null

Importe del descuento

taxstring | null

Importe de impuestos

paymentMethodstring | null

Identificador del método de pago

paymentsTotalstring | null

Importe total ya pagado

paymentsPendingstring | null

Importe pendiente de pago

warehouseIdstring | null

Identificador del almacén

marketplacestring | null

Nombre del marketplace

trackingKeystring | null

Clave de seguimiento

trackingNamestring | null

Nombre del transportista de seguimiento

trackingNumberstring | null

Número de seguimiento

accountingDatestring | null

Fecha contable en formato ISO 8601

approvedAtstring | null

Fecha de aprobación en formato ISO 8601

tags[]string[] | null

Etiquetas asignadas al documento

customFields[]object[] | null

Campos personalizados

lines[]object[] | null

Líneas del documento

payments[]object[] | null

Registros de pago

comments[]object[] | null

Comentarios del documento

Payload de ejemplo

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": [
    {}
  ]
}

salesreceipt.deletePOST

Ticket de venta eliminado

Se envía cuando se elimina un ticket de venta en Holded.

Payload

object

Datos del documento eliminado incluidos en los payloads de webhook

idstring

Identificador único del documento

typestring

Tipo de documento (invoice, salesorder, estimate, etc.)

documentNumberstring | null

Número del documento

contactIdstring | null

Identificador único del contacto

Payload de ejemplo

json

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

salesreceipt.approvePOST

Ticket de venta aprobado

Se envía cuando se aprueba un ticket de venta (sale del estado borrador) en Holded.

Payload

object

Datos del documento incluidos en los payloads de webhook

idstring

Identificador único del documento

typestring

Tipo de documento (invoice, salesorder, estimate, etc.)

documentNumberstring | null

Número del documento

datestring | null

Fecha del documento en formato ISO 8601

dueDatestring | null

Fecha de vencimiento en formato ISO 8601

contactIdstring | null

Identificador único del contacto

contactNamestring | null

Nombre del contacto

totalstring | null

Importe total

subtotalstring | null

Importe subtotal

isDraftboolean | null

Indica si el documento está en estado borrador

statusstring | null

Estado del documento

languagestring | null

Código de idioma del documento

descriptionstring | null

Descripción del documento

notesstring | null

Notas del documento

numberLineIdstring | null

Identificador de la serie de numeración

currencystring | null

Código de moneda

currencyChangenumber<float> | null

Tipo de cambio de la moneda

discountstring | null

Importe del descuento

taxstring | null

Importe de impuestos

paymentMethodstring | null

Identificador del método de pago

paymentsTotalstring | null

Importe total ya pagado

paymentsPendingstring | null

Importe pendiente de pago

warehouseIdstring | null

Identificador del almacén

marketplacestring | null

Nombre del marketplace

trackingKeystring | null

Clave de seguimiento

trackingNamestring | null

Nombre del transportista de seguimiento

trackingNumberstring | null

Número de seguimiento

accountingDatestring | null

Fecha contable en formato ISO 8601

approvedAtstring | null

Fecha de aprobación en formato ISO 8601

tags[]string[] | null

Etiquetas asignadas al documento

customFields[]object[] | null

Campos personalizados

lines[]object[] | null

Líneas del documento

payments[]object[] | null

Registros de pago

comments[]object[] | null

Comentarios del documento

Payload de ejemplo

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": [
    {}
  ]
}