Ontvangst

Goederen ontvangen op een ontvangstlocatie. NextWMS maakt bij elke ontvangst een voorraadregel met een eigen tag en, als er een inruimlocatie gevonden wordt, een inruimtaak naar die locatie.

Endpoints

Met een API key is het recht receipt met methode POST nodig (zie Authenticatie). Een gebruiker heeft het recht op het bijbehorende ontvangstscherm nodig (zie Rechten van gebruikers).

Transactie en webhook

Elke ontvangen voorraadregel krijgt een transactie Receipt en NextWMS verstuurt de webhook receipt, ook als er geen inruimlocatie gevonden wordt.

De transactie heeft de opdrachtgever en de gebruiker die ontving (leeg bij een API key). Bij een ontvangst op preadvies of pallet staan het preadvies en het regelnummer erin.

Geen inruimlocatie betekent: er zijn geen inruimregels voor het artikel, of alle plekken in de zones van die regels zijn geblokkeerd voor inslag.

Ontvangst zonder preadvies

POST /receipt/normal

Voor leveringen die niet vooraf zijn aangekondigd.

Request

{
  "sku_id": "SKU-001",
  "loc_id": "ONTVANGST",
  "qty": 5,
  "expiry_date": "2028-06-30",
  "client_id": "CLIENT01"
}

Response 200 OK

{
  "message": "Ontvangst geregistreerd",
  "content_id": 1001,
  "tag": 5012
}

De voorraad staat daarna op de ontvangstlocatie met een inruimtaak naar de gevonden locatie, en NextWMS verstuurt de webhook receipt met receipt_type: "normal".

Vindt NextWMS geen inruimlocatie voor het artikel, dan is de melding Ontvangst geregistreerd (geen putaway locatie gevonden). De voorraad staat dan op de ontvangstlocatie, zonder inruimtaak. De transactie en de webhook komen er wel (zie Transactie en webhook).

Fouten

Bij een fout wordt niets ontvangen: er komt geen voorraadregel bij.

Ontvangst op preadvies

POST /receipt/pre-advice

Request

{
  "pre_advice_id": "PA-001",
  "sku_id": "SKU-001",
  "loc_id": "ONTVANGST",
  "qty": 5
}

De opdrachtgever komt van de regel of de kop van het preadvies. Het ontvangen aantal wordt bij de regel opgeteld en het preadvies gaat naar status In progress.

Response 200 OK

{
  "message": "Pre-advice ontvangst geregistreerd",
  "content_id": 1001,
  "tag": 5012
}

Fouten

Pallet-ontvangst

POST /receipt/pallet

Ontvangt in één keer alle preadviesregels met dit pallet_id, elk met het volledige aantal van de regel.

Request

{
  "pallet_id": "PLT-001",
  "loc_id": "ONTVANGST"
}

Response 200 OK

{
  "message": "Pallet ontvangst geregistreerd (2 regels)",
  "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 }
  ]
}

final_loc is leeg (null) als er voor die regel geen inruimlocatie gevonden is. De webhook receipt (receipt_type: "pallet") bevat dezelfde lijst receipts.

Fouten

Als één regel een onbekend artikel heeft, wordt geen enkele regel van de pallet ontvangen.