Event types

Registreer een webhook met een van de onderstaande event_type-waarden (zie Webhooks beheren). De payload volgt altijd de standaard envelop; het data-object verschilt per event.

Event typeWanneer
order_statusDe status van een order wijzigt
receiptGoederen worden ontvangen
preadvice_statusDe status van een preadvies wijzigt
shippedEen orderregel is verzonden
order_shippedEen volledige order is verzonden
order_shortageEen tekort bij het picken is geaccepteerd
adjustmentEen lost & found voorraadcorrectie

order_status

Verstuurd wanneer de status van een order verandert.

{
  "event": "order_status",
  "timestamp": "2026-06-19T10:30:00.000Z",
  "site_id": "SITE01",
  "data": {
    "order_id": "ORD-001",
    "old_status": "Released",
    "new_status": "Allocated"
  }
}

De statussen en wanneer ze voorkomen staan bij Orderstatus. Let op Partially Allocated: die komt ook na een short pick, als de picker minder vond dan verwacht. De order wordt pas Picked als het tekort is opgelost en de rest gepickt is, of als het tekort geaccepteerd is (zie order_shortage). Zolang een tekort open staat, wordt de order niet Shipped.

receipt

Verstuurd bij elke ontvangst, ook als NextWMS geen inruimlocatie vindt en de voorraad op de ontvangstlocatie blijft (zie Ontvangst). Het veld receipt_type bepaalt de variant en welke velden aanwezig zijn.

Normale ontvangst (receipt_type: "normal"):

{
  "event": "receipt",
  "timestamp": "2026-06-19T10:30:00.000Z",
  "site_id": "SITE01",
  "data": {
    "receipt_type": "normal",
    "content_id": 1001,
    "tag": "TAG-0001",
    "sku_id": "SKU-001",
    "loc_id": "LOC-A01",
    "qty": 100,
    "expiry_date": "2027-01-01",
    "client_id": null
  }
}

Ontvangst op preadvies (receipt_type: "preadvice"):

{
  "receipt_type": "preadvice",
  "content_id": 1001,
  "tag": "TAG-0001",
  "pre_advice_id": "PA-001",
  "sku_id": "SKU-001",
  "loc_id": "LOC-A01",
  "qty": 100,
  "client_id": "CLIENT01"
}

Pallet-ontvangst (receipt_type: "pallet"):

{
  "receipt_type": "pallet",
  "pallet_id": "PLT-001",
  "loc_id": "LOC-A01",
  "receipts": [
    { "content_id": 1001, "tag": 5012, "sku_id": "SKU-001", "final_loc": "A-01-01" },
    { "content_id": 1002, "tag": 5013, "sku_id": "SKU-002", "final_loc": null }
  ]
}

receipts heeft een regel per ontvangen preadviesregel. final_loc is de inruimlocatie, of null als er geen gevonden is.

preadvice_status

Verstuurd wanneer de status van een preadvies verandert (bijv. Released → In progress → Complete).

{
  "event": "preadvice_status",
  "timestamp": "2026-06-19T10:30:00.000Z",
  "site_id": "SITE01",
  "data": {
    "pre_advice_id": "PA-001",
    "old_status": "Released",
    "new_status": "In progress"
  }
}

shipped

Verstuurd per orderregel die verzonden wordt vanuit een container. Wordt een order in meer dozen geladen, dan komt shipped bij elke doos voor de regels die erin zitten; de order zelf kan dan nog open zijn.

{
  "event": "shipped",
  "timestamp": "2026-06-19T10:30:00.000Z",
  "site_id": "SITE01",
  "data": {
    "order_id": "ORD-001",
    "line_id": 1,
    "sku_id": "SKU-001",
    "qty": 10,
    "container_id": "CON-001",
    "shipdock": "DOCK-01",
    "client_id": null
  }
}

order_shipped

Verstuurd één keer per order zodra de volledige order is verzonden: alle regels zijn geladen, op geaccepteerde tekorten na. Op dat moment wordt de order ook Shipped (webhook order_status).

  • Gaat een order in meer dozen de deur uit, dan komt order_shipped pas bij de laatste doos; container_id is die laatste doos.
  • Is de rest al geladen en accepteert het magazijn daarna een tekort (zie order_shortage), dan komt order_shipped bij het accepteren, met de doos en het shipdock van de laatste lading.
{
  "event": "order_shipped",
  "timestamp": "2026-06-19T10:30:00.000Z",
  "site_id": "SITE01",
  "data": {
    "order_id": "ORD-001",
    "container_id": "CON-001",
    "shipdock": "DOCK-01"
  }
}

order_shortage

Verstuurd per orderregel als het magazijn een tekort bij het picken accepteert: er komt geen voorraad meer voor. qty_short is het aantal dat niet geleverd wordt; qty_ordered het bestelde aantal van de regel.

{
  "event": "order_shortage",
  "timestamp": "2026-06-19T10:30:00.000Z",
  "site_id": "SITE01",
  "data": {
    "order_id": "ORD-001",
    "line_id": 1,
    "sku_id": "SKU-001",
    "qty_ordered": 3,
    "qty_short": 2,
    "reason": "Plek bijna leeg",
    "client_id": "CLIENT01"
  }
}

Daarna volgt een order_status-webhook: Partially Allocated → Picked, of direct → Shipped als de rest al geladen is (dan volgt ook order_shipped). Is er van de order niets gepickt, dan blijft de status Partially Allocated en komt er geen order_status-webhook.

adjustment

Verstuurd bij een lost & found voorraadcorrectie. Het veld type is Found (gevonden) of Not found (niet gevonden).

{
  "event": "adjustment",
  "timestamp": "2026-06-19T10:30:00.000Z",
  "site_id": "SITE01",
  "data": {
    "sku_id": "SKU-001",
    "qty": 5,
    "loc_id": "LOC-A01",
    "type": "Not found",
    "client_id": null
  }
}