Webhook Events

Webhook Events

Available Events

Supplier Events

Event	Trigger
supplier.created	New supplier synced from external system
supplier.updated	Existing supplier data updated
supplier.deleted	Supplier deleted from platform

Product Events

Event	Trigger
product.created	New product synced
product.updated	Existing product updated
product.deleted	Product deleted

Batch Events

Event	Trigger
batch.created	New batch synced
batch.updated	Existing batch updated
batch.deleted	Batch deleted

Sync Events

Event	Trigger
sync.completed	Batch sync operation completed successfully
sync.failed	Sync operation encountered errors

DDS Events

Event	Trigger
dds.status_changed	DDS status changed (e.g., DRAFT → SUBMITTED)
dds.submitted	DDS submitted to EU TRACES
dds.approved	DDS approved by competent authority

Event Payloads

Supplier/Product/Batch Events

{
  "event": "supplier.created",
  "timestamp": "2024-01-15T10:30:00.000Z",
  "integrationId": "int_abc",
  "data": {
    "externalId": "VENDOR-001",
    "internalId": "clx..."
  }
}

Sync Events

{
  "event": "sync.completed",
  "timestamp": "2024-01-15T10:30:00.000Z",
  "integrationId": "int_abc",
  "data": {
    "entityType": "SUPPLIER",
    "created": 5,
    "updated": 3,
    "errors": 0
  }
}

DDS Events

{
  "event": "dds.status_changed",
  "timestamp": "2024-01-15T10:30:00.000Z",
  "integrationId": "int_abc",
  "data": {
    "batchExternalId": "BATCH-001",
    "ddsNumber": "DDS-2024-00042",
    "previousStatus": "DRAFT",
    "newStatus": "SUBMITTED"
  }
}

Subscribing to Events

When creating a webhook, specify the events array. Use * to subscribe to all events:

{
  "url": "https://your-server.com/webhook",
  "events": ["*"]
}

Or subscribe to specific events:

{
  "url": "https://your-server.com/webhook",
  "events": ["supplier.created", "supplier.updated", "dds.status_changed"]
}