Naar hoofdinhoud gaan
Gebruik de REST API om records realtime in Clarus aan te maken. Deze pagina behandelt drie veelvoorkomende voorbeelden — producten, goods in receipts en verkooporders — om het typische patroon te tonen. Het zijn illustraties, niet het volledige plaatje: de API kan veel meer resources aanmaken en beheren dan deze.
Dit zijn voorbeeld-use-cases, gekozen omdat ze de meest voorkomende integratieflow dekken. Voor de volledige lijst met resources, endpoints, payloads en velden is de API Reference de enige bron van waarheid — raadpleeg deze altijd. De details hier zijn bewust hoog over gehouden, zodat ze niet afwijken van het canonieke schema.
Alle API-verzoeken moeten geauthenticeerd zijn — zie Authenticatie & toegang.

​
Maak eerst producten aan

Voordat een order of ontvangst naar een product kan verwijzen, moet het product in Clarus bestaan. Wanneer upstream een product wordt aangemaakt voor een klant die voorraad in het magazijn opslaat, maakt u hetzelfde product in Clarus aan en bewaart u het teruggegeven ID bij het bronrecord. Stuur het product naar het products-endpoint en bewaar het teruggegeven Clarus product-ID — latere calls verwijzen er rechtstreeks naar zonder nieuwe opzoeking. Plaats uw eigen product-ID in external_system_reference1 voor afstemming.

​
Maak goods in receipts aan

Wanneer upstream een inkomende order wordt aangemaakt, stuurt u die naar Clarus zodat het magazijnteam ertegen kan ontvangen.
1

Zoek de product storage unit op

Een product kan meerdere storage units hebben (losse eenheden, dozen, pallets). Voordat u de ontvangst aanmaakt, vraagt u de storage units van het product op en gebruikt u die met priority 0. Die waarde gaat in het storage-unitveld op de ontvangstregel.
2

Plaats de ontvangst

Stuur de ontvangst-header (referentie, verwachte datum, magazijn, account) met een of meer regels. Geef batch-, pallet- en storage-unitaantallen op regelniveau alleen op als u ze hebt — ze kunnen ook tijdens de ontvangst worden vastgelegd.
3

Bewaar het teruggegeven ID

Bewaar het Clarus-ontvangst-ID bij de bronorder en volg de voortgang met webhooks of polling terwijl er wordt ontvangen en weggezet.

​
Maak verkooporders (goods out) aan

Wanneer upstream een verkooporder wordt aangemaakt, stuurt u die naar Clarus zodat hij kan worden gepickt en verzonden. Stuur de orderheader, een of meer regels en het bezorgadres.
  • Het bezorgadres wordt meegestuurd als een gekoppeld adresblok. Gebruik een ISO 3166-1 alpha-2-landcode, bijvoorbeeld GB, BE of DE.
  • Gebruik de generieke referentievelden (string1–5, enzovoort) voor gegevens zoals Incoterm of douanestatus, zoals afgesproken voor uw integratie.
  • Bewaar het teruggegeven goods out-ID en volg de verzendvoortgang met webhooks of polling.
Waarden zoals pick type, pack strategy, dispatch strategy, receipt kind en order type hebben standaardwaarden maar kunnen anders worden geconfigureerd. Bevestig de juiste waarden voor uw opzet met uw implementatieconsultant — zie de opmerkingen in Bouwen met de Clarus API.

​
Verder dan deze voorbeelden

Producten, ontvangsten en verkooporders zijn slechts enkele van de records waarmee u kunt werken. Hetzelfde patroon — aanmaken en het ID bewaren — geldt voor de hele API, en er zijn veel andere resources en operaties beschikbaar. Zie de API Reference voor de volledige lijst van wat u kunt aanmaken, lezen en bijwerken.