eventId: de sleutel om dubbele events te herkennen. Behandel het als een ondoorzichtige tekst; ontleed het niet.

sequence: een getal dat per artikel en magazijn altijd oploopt. Het is gelijk aan lastSequence van GET /api/v1/stock/levels direct na de beweging.

movementId, occurredAt: de nieuwste voorraadbeweging in het event en het tijdstip (UTC).

ownerCustomerId: de merchant voor wie de voorraad wordt bewaard; null voor uw eigen voorraad. partnerCustomerId: null, behalve in de kopie voor de eigenaar die hieronder staat.

fromLocationCode, toLocationCode: de locatie die de stuks verlieten en waar ze binnenkwamen. Null betekent buiten de voorraad (leverancier, klant, correctie) of meerdere locaties in één event.

reason: bijvoorbeeld received, putaway, moved, adjusted, shipped, returned, scrapped, blocked, unblocked. Behandel een waarde die u niet kent als een algemene beweging.

documentType, documentId, movementCount: het voorraaddocument achter de wijziging en hoeveel bewegingen het event optelt.

quantity: verplaatste stuks. delta: wijziging van de aanwezige voorraad in dit magazijn; 0 bij een verplaatsing, een pick of een wegzetting binnen het magazijn.

onHand, sellable, available: de stand van het artikel in dit magazijn direct na de beweging.

ruleId: de waarschuwing. crossing: telt de waarschuwingen van deze regel (1, 2, 3 enzovoort).

warehouseId, warehouseCode: null wanneer de waarschuwing alle magazijnen samen telt.

threshold: het waarschuwingsniveau. available: het beschikbare aantal toen de waarschuwing afging.

transactionId, transactionKey, orderId: de order, zoals in fulfilment/packed.

picklistId: de picklijst. Null wanneer een fulfilmentpartner de order voor u pickte.

pickedAt: wanneer de picklijst is afgerond. hasShorts: true wanneer minstens één regel van deze order te weinig is gepickt.

pickedByUserId: de picker. Dit veld staat standaard uit; zet het aan met Customize payload. Null wanneer een fulfilmentpartner pickte.

sessionId: altijd null bij dit event.

Ontvangsten: receipt/created, receipt/line_received (één event per geboekte ontvangst, met de ontvangen regels) en receipt/completed. Velden zijn onder meer receiptId, receiptNumber, state, warehouseCode, purchaseOrderId, reference, supplierName en totals.

Inkooporders: purchase_order/created, purchase_order/sent, purchase_order/received (ook wanneer een dropshiporder wordt afgerekend) en purchase_order/closed (met reason). Velden zijn onder meer purchaseOrderId, purchaseOrderNumber, state, supplierName, expectedOn en aantallen in totals.

Tellingen: count/completed (de telling is ingediend) en count/approved, met countId, kind, state en totals zoals getelde regels en regels met een verschil.

Containers: container/created, container/moved (met de vorige locatie) en container/emptied (met de doellocatie, regels en aantal).

Teamtaken: task/created en task/completed, met taskId, title, status, dueAt en het object waar de taak over gaat.

Fulfilment: picklist/assigned (een picklijst is aan een picker gegeven), picklist/cancelled, picklist/batch_created (een batchrun heeft meerdere picklijsten gemaakt; de ids staan erin) en fulfilment/snoozed (een order is gesnoozed of de snooze is opgeheven; snoozed vertelt welke).

Overboekingen: transfer/sent, transfer/received (één gebeurtenis per ontvangst op de bestemming, met documentId en de ontvangen lines), transfer/completed en transfer/cancelled. De velden zijn onder meer transferId, transferNumber, state, het van- en naar-magazijn, reference, expectedOn, sentAt, completedAt, shipping (vervoerder, trackingnummer en link, pakketten, gewicht) en de aantallen in totals. Ze horen bij geen enkel verkoopkanaal.

Ontvangstgebeurtenissen bevatten nu supplierId als de ontvangst aan een leverancier is gekoppeld. Gebeurtenissen van inkooporders voegen reference, supplierReference, supplierConfirmedAt en partialDeliveryAllowed toe, nog steeds zonder prijzen.

Elk event wordt minstens één keer afgeleverd, dus hetzelfde event kan twee keer aankomen. Bewaar de eventId-waarden die u hebt verwerkt en sla een bekende over.

Events kunnen in een andere volgorde aankomen. Bewaar voor stock/adjusted de laatste sequence per voorraadartikel en magazijn en negeer een event met een lager getal.

Om te starten, of om te herstellen nadat uw endpoint uit de lucht was, leest u de standen met GET /api/v1/stock/levels en vergelijkt u lastSequence. Na een lange onderbreking worden voorraadwijzigingen ouder dan 6 uur niet meer als stock/adjusted gemeld.

Een voorraadevent hoort bij geen verkoopkanaal. stock/adjusted en stock/low gaan naar elke actieve webhook van uw account die het event heeft aangevinkt, ook naar een webhook die op één kanaal is ingesteld.

fulfilment/picked volgt het verkoopkanaal van de order, net als fulfilment/packed, en vereist de paktafel op uw account.

Een grote stroom voorraadevents, bijvoorbeeld na een import of een volledige telling, wordt over de volgende minuten verspreid. Uw order- en fulfilmentevents lopen daardoor nooit vertraging op.

Een gepauzeerde webhook slaat events over; ze worden niet bewaard.

De events van ontvangsten, inkooporders, tellingen, containers, teamtaken, fulfilment/snoozed en de inbound-events horen ook bij geen enkel verkoopkanaal. Elke actieve webhook van uw account die ze heeft aangevinkt ontvangt ze, ook een webhook die op één kanaal is ingesteld, en ook als de paktafel uit staat. De ontvanger is het account van wie het magazijndocument is.

De picklijst-events volgen het verkoopkanaal van de picklijst, net als picklist/created.

Een webhook die minder dan 15 seconden geleden is opgeslagen, kan een event van dat moment missen.

partnerCustomerId is het partnermagazijn en ownerCustomerId is uw eigen account.

fromLocationCode, toLocationCode, documentType en documentId zijn altijd null. U ontvangt nooit locaties.

De eventId is anders dan die uw partner ontvangt.

stock/low komt alleen van uw eigen waarschuwingen bij lage voorraad, nooit van de waarschuwingen van uw partner.