PN - PalletLine orderimport/-export
Beschrijft hoe Palletline-orders via API-polling in Qargo worden geïmporteerd en via dispatchtaken worden geëxporteerd. Bevat richtlijnen voor de functie voor label-ID's van derden voor klanten die hun eigen labels beheren.
Inhoudsopgave
Export (API)
Voor de orderexport is er een dispatchtaak waarmee de zending naar Palletline kan worden verzonden. Zo is dezelfde functionaliteit beschikbaar (bv. de taak kan automatisch worden voltooid om zendingen automatisch naar Palletline te verzenden):
Configuratie van de dispatchtaak; de integratie om naar te dispatchen is “Palletline”:

De dispatchtaken worden alleen aangemaakt voor resources van onderaannemers waarvoor de Palletline-integratie actief is. De toggle “Palletnetwerk” kan worden geactiveerd om de resources te verbergen op het gewone planbord en ze te tonen op het planbord voor het palletnetwerk.

In Qargo wordt dispatchen altijd op tripniveau uitgevoerd en de Palletline-API verwacht één zending. Daarom wordt tijdens het dispatchen gecontroleerd dat er slechts één zending aanwezig is op de trip die wordt gedispatcht.
Het is dus niet mogelijk om meerdere ladingen te consolideren en samen naar de Palletline-API te sturen.

De depotcodes die aan de API worden doorgegeven, zijn:
- als aanvragend depot: het resultaat van de Qargo-gazetteering van de locatie op de etappe die niet wordt geëxporteerd, of de standaardwaarde bij het exporteren van directe etappes;
- als ophaaldepot: het resultaat van de Qargo-gazetteering bij het exporteren van de leveringsetappe;
- als leveringsdepot: wordt nooit doorgegeven.
Na het dispatchen geeft de Palletline-API informatie terug aan Qargo, namelijk de routeringsinformatie en de palletbarcodes.
Import (API)
De orderimport gebeurt via API. Elke minuut wordt de Palletline-API gepolld om de zendingen op te vragen die aan een van de depots van de tenant zijn toegewezen.
De depotcodes worden overgenomen uit de geïmporteerde orders en niet opnieuw via gazetteering in Qargo bepaald.
Orders die via API binnenkomen, krijgen het Palletline-transportnetwerk toegewezen op basis van de configuratie van de transportdienst.
Ze volgen de configuratie van het Palletline-transportnetwerk wat betreft de opsplitsing in het depot en de automatische toewijzing van resources:
- het transportnetwerk is geconfigureerd om automatisch een resource toe te wijzen
- de onderaannemer die aan het transportnetwerk is toegewezen, heeft actieve resources waarvoor de toggle “Palletline-integratie” is uitgeschakeld

\
Import (bestand): alleen tijdens onboarding, niet live {#h_14c1f93506}
Tijdens de onboarding-periode kunnen Palletline-klanten orders ook via bestandsimport importeren. Zo kunnen ze één factuur voor hun klanten aanmaken (met zowel zendingen van vóór als van na de overstap naar Qargo).
Bij orders die via een bestand zijn geïmporteerd, worden geen gegevens gesynchroniseerd vanuit het Palletline-systeem (bv. statusupdates gaan verloren).
De zendingen moeten handmatig worden bijgewerkt om ze in de juiste status te brengen, zodat ze kunnen worden gefactureerd.

Label-ID van derden
Standaard vraagt Qargo automatisch een label-ID aan bij het Palletline-netwerk wanneer in Qargo een zending voor een Palletline-job wordt aangemaakt. Sommige klanten beheren hun eigen Palletline-labels via een apart systeem (bijvoorbeeld een WMS of ERP) en leveren zelf een label-ID aan in Qargo, in plaats van Qargo er een te laten genereren.
Het veld palletline__third_party_label_id ondersteunt deze werkwijze. Als er een waarde op de order staat, slaat Qargo de stap voor het automatisch aanmaken van het label bij het aanmaken van de order over en gebruikt het in plaats daarvan het aangeleverde ID. Barcodes worden bij het Palletline-netwerk bevestigd op het moment van dispatchen.

Hoe het werkt
Het label-ID van derden wordt aangeleverd via de Qargo-API of via EDI-import. Het kan niet handmatig worden ingesteld via de gebruikersinterface van Qargo.
-
Het ID wordt meegegeven wanneer de order in Qargo wordt aangemaakt en vervangt de standaard labelaanvraag van Qargo bij Palletline.
-
De zending dispatchen met de standaard Export to Palletline-dispatchtaak.
- Bij het dispatchen bevestigt Qargo de barcodes bij het Palletline-netwerk met het aangeleverde label-ID.
