Bij het integreren van een nieuwe vervoerder, zoals DHL, UPS of FedEx, in nShift Ship, is het gebruikelijk om te vragen welke velden moeten worden ingevuld om een zending succesvol te boeken. Het antwoord hierop is echter niet universeel.

Secties in dit artikel:

• Vervoerder- en klantspecifieke vereisten
• Aanbevolen aanpak voor Shipment Server API-klanten
• Aanbevolen aanpak voor On-premises klanten
• Foutmeldingen van API-vervoerders begrijpen
• Contact opnemen met nShift Customer Service

Vervoerder- en klantspecifieke vereisten

Elke vervoerder heeft zijn eigen specificaties en de vereisten kunnen variëren afhankelijk van:

• Het servicetype van de vervoerder (bijvoorbeeld express, economy, gevaarlijke goederen)
• De aard van de zending (bijvoorbeeld binnenlands vs. internationaal, benodigde douanedocumentatie, speciale toevoegingen zoals "Saturday Delivery", "Heavy", "Parcel Shop" )
• Uw individuele bedrijfsinrichting en voorkeuren

Vanwege deze variabiliteit is er geen enkele specificatie die van toepassing is op alle klanten of vervoerders.

Aanbevolen aanpak voor Shipment Server API-klanten

Om te bepalen welke velden vereist zijn voor jouw specifieke configuratie, raden we aan om de nShift Portal te gebruiken met Developer Tools ingeschakeld. Hiermee kun je een zending testen en in realtime zien welke velden verplicht zijn.
 

1. Log in op nShift Portal en ga naar Ship > Configuration > Settings.
   
   
    
2. Scroll naar beneden en vink Show developer tools aan onder de kop New Booking .
   
   
    
3. Je hebt nu toegang tot de Developer Tools onderaan alle relevante pagina's onder New.
    
4. Ga naar New en maak een zending aan met de nieuwe vervoerder en services.  Wanneer je op de knop Print klikt, zie je een scherm Validation als er informatie ontbreekt. 
   
   Voorbeeld:
   
   
   
   Note: Sommige validatieberichten komen rechtstreeks van de API van de vervoerder en kunnen moeilijker te interpreteren zijn (zie de sectie over API-vervoerders voor meer informatie).
    
5. Het veld Data in de sectie Developer Tools weerspiegelt alle gegevens die je hebt ingevoerd en laat zien hoe de aanvraag aan de Shipment Server API eruitziet,

including all the fields you have filled in.
  Vul alle ontbrekende informatie in totdat je een label terugkrijgt. Je weet nu welke velden moeten worden gemapt voor jouw specifieke vervoerder en bedrijfsstroom. 

 

Aanbevolen verdere lectuur:

• Inspect the data object with the Developer Tools - legt uit hoe je de volledige payload kunt ophalen voor elke zending die je hebt aangemaakt. 
•  Using Customs Details (Paperless invoice) - legt het gebruik uit van douaneveldgegevens voor paperless facturen en geeft een overzicht van de meest gebruikte velden.

Aanbevolen aanpak voor On-premises klanten

1. Ga naar Main >Production en maak een handmatige testzending aan met je nieuwe vervoerder en de relevante services.
    
2. Beweeg de muis over de knop Print om ontbrekende gegevens te zien volgens de validaties die zijn geïmplementeerd in Ship. Wanneer je op de knop Print klikt, verschijnt er een dialoogvenster dat aangeeft of verplichte informatie ontbreekt, inclusief foutmeldingen die rechtstreeks afkomstig zijn van de API van de vervoerder. (Zie de sectie over API-vervoerders voor meer informatie).
   
   Voorbeeld:
   
   
    

3. Vul alle ontbrekende gegevens in totdat je een label krijgt. 

    

Foutmeldingen van API-vervoerders begrijpen

Wanneer u zendingen boekt via API-verbonden vervoerders, kunt u af en toe foutmeldingen tegenkomen in onze software. Houd er rekening mee dat deze meldingen rechtstreeks worden gegenereerd door het systeem van de vervoerder, niet door nShift. Ze weerspiegelen daarom de actuele vereisten en validaties van de vervoerder, waar wij geen controle over hebben.

De vereisten en foutmeldingen van vervoerders worden regelmatig bijgewerkt en kunnen zonder voorafgaande kennisgeving veranderen. Als u een foutmelding ontvangt die onduidelijk is of moeilijk te interpreteren, raden we u aan contact op te nemen met onze Customer Service. Wij kunnen helpen door namens u contact op te nemen met de vervoerder om het probleem te verduidelijken en na te gaan welke informatie mogelijk ontbreekt of onjuist is geformatteerd.

 

Neem contact op met nShift Customer Service

Als u problemen ondervindt bij het succesvol aanmaken van een zending, dien dan een verzoek in bij nShift Customer Service, die voor u klaarstaat. 

Laat ons weten:

• Naam van de vervoerder, product/services en aanvullende services.
• De foutmelding die u ontvangt - een screenshot kan het oplossen van het probleem versnellen.
• Een correlation ID of ordernummer is ook behulpzaam.

Met deze informatie kunnen we u helpen uitzoeken welke gegevens ontbreken bij uw zending.