Hoe stel ik de Post NL integratie in zodat reserveringen automatisch vooraangemeld worden?

Om gebruik te kunnen maken van de Post NL integratie is het nodig om in het bezit te zijn van een pakketdienst CAL (Client Access License/licentie) en moeten er inlog gegevens bekend zijn vanuit Post NL. Deze laatste zijn op te vragen door contact op te nemen met PostNL Paketten Dedicated IT, welke te bereiken zijn via 088-8742050

Post NL zal uiteindelijk reageren met een klantnummer, klantcode, inlogcode en wachtwoord. Deze informatie moet overgenomen worden in RetailVista via Administratie, Pakketdiensten. Controleer nu in de configuratie van RetailVista bij sectie 'Webshop' de Post NL CIF URL.

Standaard zal Post NL eerst een 'sandbox' URL uitgeven. Bovenstaande URL is een voorbeeld van een sandbox URL en zal waarschijnlijk overeengekomen met de sandbox URL die Post NL aangeeft. Controleer of deze URL correct is bij de instellingen. Het gebruik van een sandbox is een testomgeving en zal nooit leiden tot het echt afhalen van bestelling.

Ga nu naar Extra, Vestigingen en selecteer tab 'Webshop'. Geef daar aan welke relatie de webshop relatie is. Het adres van die relatie wordt gebruikt als afzenderadres op het te printen Post NL label. De opgegeven relatie dient dus ook een adres te hebben. Hetzelfde geldt voor de contactpersoon email adres, collectie adres en retour adres. Die laatste twee mogen leeg blijven als er geen afwijkend collectie en retour adres bestaan.

Geef als laatste de LocalService thermische printer aan waarop etiketten geprint moeten worden. In bovenstaand voorbeeld is een Zebra TLP2844 thermische printer toegevoegd aan LocalServices en is daarom te kiezen als bestemmingsprinter voor etiketten.
Juiste selectie van printer type is erg belangrijk, Zebra EPS2 en Zebra ZPL II zijn 2 verschillende zaken waardoor in detail de afdruk kan verschillen: voor de Zebra GK420d moet worden gekozen voor de ZPLII en voor de TLP2844 de EPS2 zie verder documentatie in binaries.
Ook het labelmateriaal moet exact worden gekozen, bij buitenlandse pakketten wordt de barcode niet volledig geprint als er bijvoorbeeld voor 100x150 etiketten van SATO wordt gekozen, hiervoor is 102x152 noodzakelijk, deze laatste is verkrijgbaar bij PostNL. Zie ook handleiding "ParcelWare Desktop" http://www.postnl.nl/Images/Handleiding-Parcelware-Desktop-2-7-PostNL_tcm10-16664.pdf
Ga nu naar Administratie, Pakketdiensten, onder blok Relaties. Maak daar een nieuwe pakketdienst aan zoals in onderstaand scherm aangegeven. Vul uiteraard de eigen ontvangen gegevens in zoals gebruikersnaam, wachtwoord etcetera. De type printer moet een door Post NL vastgestelde code zijn. In de binaries bijlage is documentatie te vinden van Post NL met de printers welke door hen ondersteund worden.

Het aflevering artikelnummer wordt door Post NL opgegeven en staat voor de manier van pakket verzending. Normaalweg wordt code 3085 gebruikt voor standaard pakketverzending, maar ook andere codes (voor bijvoorbeeld aangetekende verzending) zijn mogelijk. Het hangt van het contract met Post NL af welke productcodes toegestaan zijn. Als er meerdere manieren van pakketbezorging nodig zijn (meerdere productcodes), maak dan voor elke productcode een nieuwe pakketdienst aan.

Er bestaat de mogelijkheid om vanuit RetailVista automatisch een email te sturen als pakket aankondiging. Deze mail bevat XML gegevens over de pakket verzending en moet gestuurd worden aan een social media partner die de inhoud van dit bericht omzet in een qua huisstijl opgemaakt bericht richting de finale klant. Informatie over de technische opbouw van dit aankondigingsbericht (ParcelAnnouncement) is te vinden op de technische documentatie website http://help.api.retail3000.net.

Onder tabblad Geavanceerd vul je de URL en de APiKey in.

Doorklik URL: https://mijnpakket.postnl.nl/Claim?barcode={1}&postalcode={0}&Foreign=false#

Let op dat de ApiKey behoort bij de juiste URL. Dat wil zeggen: als bij instellingen de URL van de Sandbox is opgegeven, hier de ApiKey die daarbij hoort ingegeven moet worden en indien de URL van de Productie omgeving is opgegeven bij instellingen, hier de ApiKey die behoort bij de Productie omgeving hier wordt opgegeven.

Ga nu als laatste naar Administratie, Transporttypes onder blok Relaties. Zoek de verschillende transport mogelijkheden op en geef daar bij elk transporttype de pakketdienst aan, als een reservering via Post NL bezorgd moet worden.

Alle reserveringen die nu worden afgesloten (contact of op rekening) worden automatisch aangemeld bij Post NL, mits bij de reservering een pakketdienst opgegeven is. Het verslag van het aanmeld proces is terug te vinden bij de reserveringen in de tab 'Pakketdienst' en als LocalServices goed ingesteld is zal er ook automatisch een adresetiket geprint worden.

Bestaat een reservering uit meerdere pakketten, dan moet dit vooraf worden aangegeven in de reservering. Voer hiervoor additionele pakketten toe onder de tab Pakketdienst in de reservering. Als hier niks wordt ingevoerd, dan gaat het systeem er van uit dat er 1 sticker moet worden geprint tijdens verwerking. Na verwerking via de kassa is het niet meer mogelijk om extra stickers af te drukken.

Om een test uit te voeren t.b.v de labelprinter ga je naar:

Verkooporders > reservering onderhoud > zoek een contant geleverde reservering op.
Ga vervolgens naar > Send reservations to parcel services > Send > Print parcel service label > print.
Bij het tabblad "Pakketdienst" kan je vervolgens de pakketdienst log inzien.

Om het hele proces te testen:

Maak een verkooporder aan in de backoffice en kies bij Transport het transporttype 'Pakketpost'
Haal de reservering op in de kassa. Hier krijg je de melding dat het om een pakketpost gaat en voeg het aantal pakketjes toe en het gewicht.
Nu zal het pakketlabel geprint zijn.
Zoek de reservering op in de backoffice en kijk bij tabblad 'Pakketten'. Daar zie je de barcode van het pakket en de log.

Indien er gebruik wordt gemaakt van de Sandbox van PostNL moet na een periode van testen het label voor akkoord opgestuurd worden naar PostNL. Na akkoord zal er een API-Key aangevraagd kunnen worden voor de Productie-omgeving. De Api-Key en de URL bij de instellingen moeten dan worden gewijzigd. Als er dan een pakket zoek raakt kan dit niet aan het label liggen, omdat deze dan goedgekeurd is door PostNL. 

Troubleshooting

Q: Mijn bericht wordt afgekeurd op de melding: [1460104] Receiver HouseNo is required

A: Een bericht moet een geldige opbouw van het adres bevatten, verzekert u ervan dat de instelling 'Relaties -> Adres formaat' de waarde 'Straat gevolgd door adres' heeft.