Sathena

Welke dienstcode elk artikel krijgt, en welke dienst een order krijgt, zodat SathenaPortal je bezorging en installatie kan inplannen.

Updated 27 Sep 2026·Reading time 5 mingevorderdmodule

Wat is het?

SathenaPortal is een planningssysteem voor bezorging en installatie van grote apparaten, zoals vaatwassers, koelkasten en ovens. Stuur je een order naar Sathena, dan moet elke dienst op die order een dienstcode hebben die vooraf met Sathena is afgesproken, bijvoorbeeld 106-DISHWASHER-THRESHOLD-DELIVERY. Een onbekende code, of geen code, en Sathena weigert de hele order. De bezorging wordt dan niet ingepland.

De module Sathena bepaalt die codes voor je. Hij is voor winkels die witgoed verkopen en de bezorging en installatie via SathenaPortal laten plannen.

Wat levert het op?

Geen geweigerde orders door een ontbrekende code. Elk apparaat krijgt een code uit de afgesproken lijst, op basis van regels.
Regels die zichzelf voorstellen. Nexym leest je catalogus en stelt regels voor, met het bewijs erbij. Je vinkt aan wat klopt.
De juiste dienst per order. Een bezorging op de Waddeneilanden krijgt vanzelf een andere code dan dezelfde vaatwasser in Utrecht, en een wasmachine naar etage 5 zonder lift wordt vanzelf Alleen tillen.
Uitzonderingen vastzetten. Eén artikel met de hand een code geven, zonder dat een import het terugdraait.
Zien wat er naar Sathena ging, met het nummer dat Sathena zelf gebruikt, en de barcodelabels op één klik.

Voorbeeld. Voorbeeldshop verkoopt 6.000 artikelen: apparaten, maar ook filters, kranen en pannen. Met Voorstellen uit de catalogus krijgen ze 22 regels voorgesteld. Samen geven die 90% van de apparaten een groep. De rest, vooral losse onderdelen, hoort geen code te hebben. Drie bijzondere artikelen zetten ze met de hand vast. Een klant op Texel bestelt een vaatwasser; de order gaat vanzelf met de Waddencode naar Sathena.

Hoe werkt het?

Een dienstcode bestaat uit twee delen:

   groep       ×      dienst            =   code
 DISHWASHER    ×  THRESHOLD-DELIVERY    →   106-DISHWASHER-THRESHOLD-DELIVERY
 DISHWASHER    ×  WADDEN-DELIVERY       →   107-DISHWASHER-WADDEN-DELIVERY

De groep zegt wat het artikel is: een vaatwasser, een koelkast. Dat hoort bij het artikel en wordt één keer bepaald, door de productregels.
De dienst zegt wat er op de dag zelf gebeurt: bezorgen tot achter de drempel, of bezorgen op een Waddeneiland. Dat hoort bij het bezoek en wordt per order bepaald.

Zo gaat het stap voor stap:

De codelijst staat klaar. De module levert de lijst met afgesproken codes mee: 14 groepen, 148 codes. Je laadt hem één keer in.
Productregels geven elk artikel een groep. Een regel zegt bijvoorbeeld: “als de naam vaatwasser bevat, dan groep DISHWASHER”. De eerste regel die past, wint.
De groep komt op het product te staan, in het veld sathena_dienstgroep, samen met de code die daar bij de standaarddienst uit volgt (sathena_dienstcode). Je ziet hem dus op het product, en je kunt er regels en de API op loslaten.
Nieuwe artikelen krijgen hun groep na de productimport, en elke nacht rond 04:30 loopt Nexym de artikelen zonder code na.
Bij het versturen van een order kiest Nexym één dienst voor de hele order. Dat doen de regels op Bezorgdiensten. Past er geen, dan geldt de standaarddienst. Heeft de groep van een artikel die dienst niet, dan krijgt dat artikel de standaarddienst.
Per orderregel wordt groep × dienst de code. Komt dezelfde dienst vaker voor op één order, dan krijgt de eerste de gewone code en elke volgende de -STAFFEL-variant. Zo wil Sathena het.
Een regel zonder code is gewoon een artikel. Die gaat met zijn eigen SKU mee, en dat is goed voor goederen.

Aan de slag

Wat je nodig hebt

De module, vrijgegeven voor je project. Je vindt hem in de Toolbox onder Catalogus & kanalen.
Producten in de hub, via een koppeling met je shop of ERP.
Een koppeling met Sathena als doel, voor orders. Zie Koppelingen.
De afspraken met Sathena over welke codes je gebruikt.
Geen embed-script en geen toestemming van bezoekers: alles gebeurt op de server.

Aanzetten

Zet de module in de Toolbox op Test.
Klik op Overzicht (of Instellingen) op Laad de codelijst. Dit zet de afgesproken codes klaar en maakt ook de regels voor de Waddeneilanden en voor etage 5 zonder lift aan.
Klik Voorstellen uit de catalogus. Vink de regels aan die kloppen en klik Maak de geselecteerde regels aan.
Klik Toepassen op producten. Het resultaat verschijnt in Runs & logs.
Open Dekking, filter op Zonder code en zet de apparaten die overblijven met de hand vast.
Zet de module op Aan. Vanaf dan gaan de codes mee met elke order naar Sathena.

Testmodus en live

In testmodus worden de codes wel bepaald, op de producten gezet en op de schermen getoond. Maar ze worden van alles wat Nexym verstuurt afgehaald: een order gaat naar Sathena met de gewone artikelcodes, alsof deze module er niet is. Dat geldt voor elke koppeling en ook voor het voorbeeld van een payload. Zo kun je de regels en de dekking rustig controleren. Staat alles goed, zet de module dan op Aan.

Checklist

De codelijst is geladen en je hebt uitgezet wat je niet verkoopt.
Je productregels staan in de goede volgorde: specifiek boven algemeen.
Je hebt Toepassen op producten gedaan na de laatste regelwijziging.
Dekking met het filter Zonder code toont geen apparaten meer.
De standaarddienst klopt, en de Waddenregel staat aan met de juiste postcodes.
Levert je orderbestand de etage en de lift, dan zijn die twee kolommen gekoppeld (zie de etageregel).
In testmodus zag een testorder er goed uit onder Exports.
De module staat op Aan.

Wat ziet je bezoeker?

Niets: de module komt niet op je website. Het resultaat komt terecht bij Sathena, op de orderregels van elke werkorder. In je beheer zie je het in de kolom Sathena in je orderlijst (het nummer van Sathena en of de bezorging is ingepland) en op het tabblad Exports.