Generic Carrier-interface

De Generic Carrier Interface is een XML-over-SFTP-interface waarmee vervoerders kunnen integreren met Paazl. Het biedt een tweerichtingsdienst waarmee Paazl bestellingen naar vervoerders kan communiceren en vervoerders Paazl kunnen voorzien van realtime trackinginformatie. Zodra je (de vervoerder) bent geïntegreerd met Paazl, is jouw vervoerdersdienst toegankelijk voor alle Paazl-klanten die een contract met je hebben.

Functies van de interface

De Generic Carrier Interface van Paazl ondersteunt de volgende functionaliteiten:

• Afhaal- en afleverzendingen
• Zelfde dag (same-day), volgende dag (next-day) en geplande levering (voorkeursdatum)
• Verzendopties voor onder rembours (COD)
• Internationale verzending (douaneafhandeling)
• Naam en logo van de vervoerder op het etiket
• Statusupdates & e-mailnotificaties

Algemeen proces

Hieronder vind je een schematische weergave van het Generic Carrier Interface-landschap tussen onze klanten, Paazl en de vervoerders.

Stap 1. Registratiebestand

Webshops die zijn aangesloten op Paazl slaan verzendinformatie op bij Paazl. Tijdens het fulfillmentproces vragen de webshops via een API een etiket aan bij Paazl, waarna Paazl een intern etiket aanmaakt en een registratiebestand naar de vervoerder stuurt. Het registratiebestand wordt elke 10 minuten naar (S)FTP gepusht en bevat alle bestellingen waarvoor de webshop een etiket heeft aangevraagd. Op de pagina Over het registratiebestand vind je een volledige lijst van de informatie die het bestand bevat.

Stap 2. Trackingbestand

Het trackingbestand wordt in de (S)FTP-map geplaatst om het Paazl-platform te voorzien van realtime trackinginformatie per pakket. Paazl controleert elke 30 minuten op statuswijzigingen en haalt alle bestanden op die in de map zijn geplaatst. In het trackingbestand communiceer je de statuscodes van de Paazl-vervoerder, die tijdens de integratie worden gekoppeld. Paazl slaat trackingupdates op het platform op, zodat webshops deze updates weer kunnen doorgeven aan hun klanten. Op de pagina Over het trackingbestand vind je een volledige lijst van de informatie die het bestand bevat.

Logo's van vervoerders

Paazl kan jouw logo activeren voor de Checkout Widget van Paazl en op de vervoerderspagina van Paazl.com. Voor logo's gelden de volgende eisen:

• Het logo moet een vectorafbeelding zijn (in .SVG- of .EPS-formaat)
• Het logo moet vierkant zijn, met een gelijke breedte en hoogte.

Verzendopties

Paazl configureert contracten en verzendopties voor de webshops die je bedient. Paazl configureert jouw verzendopties vooraf, zodat webshops jouw verzendopties kunnen tonen en/of gebruiken in hun checkout.

Het registratiebestand dat Paazl verzendt, bevat een 'serviceCode'. Dit is de unieke identificatiecode voor jouw verzendopties. Het is aan jou om de namen en ID's van de verzendopties te bepalen en aan te leveren die wij moeten configureren. Bijvoorbeeld: als "SFEB" de code voor de verzendoptie is, moet je Paazl laten weten dat de beschrijvende naam "Super fast E-bike" is.

Verzendlabel

Paazl genereert verzendlabels die webshops kunnen printen en op pakketten kunnen plakken. Voor Generic Carriers print Paazl een standaard verzendlabel dat de volgende informatie bevat:

• Informatie over de afzender
• Naam en adres van de geadresseerde
• (Optioneel) Aanvullende leveringsinformatie
• Een Code 128-barcode en een bestelreferentienummer; de barcode bevat het nummer van jouw contract met de webshop, gevolgd door een getal van zes cijfers (van 000000 tot 999999).

Ondersteuning

Voor het integreren van de Generic Carrier Interface zijn geen ontwikkelingscapaciteiten van Paazl nodig. Daarom moeten alle integratievragen worden gestuurd naar de Paazl Customer Support. In uitzonderlijke gevallen (bijv. tijdens een escalatie of bij een goedgekeurd verzoek voor een nieuwe functie) zal een product owner van Paazl aansluiten bij het supportteam.