Hoe werkt het gebruik van een afhaal locatie in de Post NL integratie?

Dit document beschrijft hoe afhaal locaties werken in RetailVista in combinatie met een Post NL API integratie. Het gebruik van afhaal locaties vereist een speciale verwerking omdat er zowel sprake is van een afzender adres, een klant adres en een afhaal adres. Dat zijn drie adressen terwijl er normaalweg met slechts twee adressen gewerkt wordt.

Post NL API

De pakketdienst integratie in RetailVista is gemaakt op basis van de Post NL API specificaties. In die specificaties wordt een Post NL afhaal locatie 'Pakje Gemak' genoemd.

De meest recente Post NL API documentatie is momenteel te vinden op

https://developer.postnl.nl/browse-apis/send-and-track/labelling-webservice/documentation/

Bepaling van bezorgadres in RetailVista

Bij een verkooporder kan een afwijkende aflever relatie en/of een afwijkend aflever adres opgegeven worden. Wanneer een of beide van die velden gevuld zijn, dan zal RetailVista van uit die velden een afwijkend afleveradres bepalen. Als beide velden of alleen het afwijkend afleveradres veld gevuld is/zijn, dan wordt het afwijkend aflever adres veld gebruikt als adressering. Is alleen het afwijkend aflever relatie veld gevuld, dan wordt van die relatie het aflever adres veld gebruikt. Bevat die relatie geen aflever adres, dan wordt er gezocht in volgorde naar een post adres en daarna naar een bezoek (standaard) adres.

Als er geen enkele afwijkend aflever adres gevonden kan worden, of beide velden zijn niet opgegeven, dan wordt het aflever adres van de relatie van de verkooporder gebruikt. Ook hier geldt dat als die relatie geen aflever adres heeft, dan wordt er gezocht in volgorde naar een post adres en daarna naar een bezoek (standaard) adres.

Vertaling van gevonden adres naar Post NL API

In het Post NL Address object (zie de Post NL API documentatie) bevindt zich een Type veld. Met dat veld wordt aangegeven wat het type is van het adres. Als er in RetailVista in een verkooporder geen afwijkend aflever adres gevonden kon worden (via de twee afwijkende relatie en adres velden uit de verkooporder) dan wordt er altijd een bestemming adres aangemaakt met code '01' waarin het gevonden aflever adres van de relatie zelf vermeld wordt.

Wordt er wél een afwijkend aflever adres gevonden, dan wordt er nog gecontroleerd of er een 'Pakje Gemak' productcode gebruikt is. Dat moet een code zijn uit de range 3531, 3532, 3533, 3534, 3535, 3536, 3543, 3544, 3545, 3546, 3553, 3543, 3544, 3545, 3546. Ook is het mogelijk om in plaats van deze productcodes de tekst '/pakjegemak' bij de geavanceerde instellingen van de pakketdienst op te geven. Door het gebruik van een van de hiervoor genoemde productcodes of de tekst /Pakjegemak weet RetailVista dat het om een Post NL Pickup locatie gaat.

Als er nu geconstateerd is er een Post NL Pickup locatie gewenst is, dan worden er 2 'bestemming' adressen aangemaakt. De eerste is een adres object met type '01' waarin het uiteindelijke afleveradres van de klant zelf vermeld wordt. Daarnaast wordt er tweede adres object met type '09' aangemaakt waarin het afwijkende aflever adres vermeld wordt. Dat zal dus het gekozen adres van de Post NL afhaal locatie moeten zijn!

Deze informatie wordt doorgestuurd naar de labeling service van Post NL waarna RetailVista een correct opgebouwd adres etiket zal ontvangen.

Samengevat moet dus in het webshop order bericht een 'Delivery' adres worden meegestuurd, wat het adres is van de afhaal locatie van Post NL. Met bovenstaande toelichting moet deze functionaliteit dan correct werken.