Mall JSON

JSON-mallarna används för alla fraktjänster mot nShift för att skapa leveranser. Bex anropar nShift via REST-API med orderinformation och får fraktetikett i svar om tur/retur sändning skapats i nShift och hos transportör. Vad som ska skickas i anropet för en specifik fraktjänst (och land) anges i JSON-mallarna.

Mallarna är uppbyggda av nShift-specifika fält som populeras av varibler från Bex. För ett specifkt fält hämtar Bex alltså information från ordern.

Exempel:

"receiver": {
  "quickId": "{CustomerNo}",
  "name": "{ShipToCustomerName}",

Ovan är information som gäller mottagaren i nShifit. För fältet QuickID i nShift kommer Bex här skicka det kundnummer kunden fått i Bex. Namn på mottagaren kommer vara det namn som står som Leveransnamn på ordern.

"name": = Fältet i nShift
{ShipToCustomerName} = Varibel som hämtar information från Bex

Det finns ett antal varibler skapade som går att använda i mallarna. För att se en lista på tillgängliga variabler, läs mer här.

Ny fraktjänst i Bex
När man sätter upp en ny fraktjänst i Bex skapas en standard JSON-mall. JSON-mallen innehåller information om mottagare, avsändare, fraktjänst

Denna mall är INTE anpassad för specifika frakttjänster, länder etc. utan är standard. Kräver en specifik transportör någon avvikande information behöver således mallen uppdateras för att hantera detta med korrekt fält och variabler.

Olika fraktjänster kan även behöva olika information beroende på land. Så ändringar på landets specifika JSON för fraktjänsten kan behövas för att det ska bli korrekt.

Man måste alltså kolla med nShift/Transportören för att få reda på vad en specifik tjänst kräver som minimum och sedan bygga upp JSON-mallen efter det med tillgängliga variabler.

Om ni vill lägga till Options eller Addons läs mer här för översikt av tillägg. OBS! Olika tjänster har olika värden för sina tillägg

Om data för tullhantering ska skickas till nShift behöver det sättas upp. Om ni vill lägga till variabler för Tullhantering läs mer här.

Om er e-handel skickar in metadata på ordern, för exempelvis utlämningställe eller order ID som måste vidare till nShift, läs mer här.

Om ni ska använda er av Prepared ID för fraktjänsten, ofta i samband med nShift fraktväljare i er e-handel så läs mer här.

Vid felmeddelanden

Eventuella fel som visas vid bokföring kommer FRÅN Nshift. Det kan vara fel uppsatt i JSON eller så saknas information som fraktjänsten kräver.

Har tidigare leveranser fungerat till det landet och med den tjänsten är det troligtivis fel i det underlag som skickas. E.g. vikt saknas från artikeln eller mobilnummer från kunden. LÄS felmeddelandet. Vad som saknas specificeras.

Om det ändå är oklart, skicka med felmeddelandet till Bex Support eller nShift Support.