Kom igång med filedrop‑integration (import) – nShift Help Center

Majoriteten av nShifts kunder har någon form av integration mellan nShift Ship och deras ERP-, WMS- eller andra system. Filedrop-integrationen (Import Setup) i On-premises har många avancerade möjligheter och kan konfigureras för att passa nästan vilken uppsättning som helst.

Den här artikeln förklarar hur du sätter upp en grundläggande filedrop-integration i nShift On-premises. Kontakta vår kundservice om du behöver hjälp med att konfigurera din integration eller om du har frågor kring de avancerade konfigurationsmöjligheterna.

Innehåll i denna artikel:

Koncept och arbetsflöde
Aktivering av Import Setup
Specificering av filinnehåll
Lägga till och ta bort fält
Konfigurering av transportörförinställningar

Koncept och arbetsflöde

Ship On-premises kan importera ordrar från vilket system som helst som kan generera en fil. Systemet måste kunna skapa en fil och placera den i en delad mapp som är tillgänglig för båda systemen. Ship On-premises övervakar mappen och så snart det upptäcker en igenkännbar fil i importmappen kommer den att importera och läsa filen och sedan antingen radera den eller flytta den till en säkerhetskopieringsmapp efter bearbetning.

FileDrop model

I exemplen nedan har vi använt en CSV-fil. Detta format är enkelt att arbeta med, men nShift Ship stöder nästan alla format, inklusive platta textfiler, standard fältlängd, Excel och XML. Om du använder XML-filer kommer importen att transformera filerna baserat på ett XSLT-stilmall som du måste ange.

Aktivering av Import Setup

Gå till Setup och välj var du vill placera importinställningen. Den kan placeras på antingen Installation, Location, eller Actor-nivå. Högerklicka på högra sidan av skärmen och välj New > Import Setup.
För att komma igång, markera Import Active. Integrationen är endast aktiv när denna kryssruta är markerad, och den måste vara aktiv för att göra ändringar.
Klicka på New och ange en Source Folder där On-premises hämtar filerna från ditt system. Det är möjligt att lägga till flera källmappar.
Ange filnamn och filändelse.
Trådar används för att bearbeta flera filer samtidigt. Antalet trådar motsvarar antalet filer som kan importeras samtidigt från samma källmapp. Flera källor bearbetas en i taget.
Klicka på OK för att spara.
I avsnittet After Import måste du välja vad som ska hända efter att On-premises har bearbetat en fil. Du kan välja att automatiskt radera den, flytta den till papperskorgen eller flytta den till en angiven mapp. Klicka på OK för att spara dina inställningar.

Specificering av filinnehåll

Du måste tala om för On-premises hur filerna från ditt system ska läsas genom att ange teckenseparatorn och hur fälten i filen ska mappas till fält i On-premises. Fliken Import Setup innehåller mycket funktionalitet. Den här artikeln förklarar de inställningar som behövs för en grundläggande importinställning.

Gå till fliken Import Setup.
Ange Character separator som används i dina filer. I detta exempel används ",". (För att använda XML-filer måste du klicka på Select-knappen och ange en XSLT-fil.)
Olika system använder olika enheter, så det är viktigt att ange de enheter som används i dina filer. Klicka på Unit-knappen för att ange dina enheter och klicka på OK.
Nu måste du mappa fälten i dina filer till fält i On-premises. Detta är enklare om du har en exempelfil från ditt system. Välj Select file, hitta en fil och klicka på Preview för att se en lista över alla fält i filen.
Mappa fälten genom att klicka på varje rad i kolumnen Shipment Field och välja motsvarande On-premises-fält från rullgardinslistan. Du kan söka i listan genom att skriva.
I skärmen nedan har alla fält mappats. Om du har ett fält i din fil som ska ignoreras av On-premises kan du behålla värdet Unknown->Unknown.

Lägga till och ta bort fält

Du kan lägga till eller ta bort fält genom att klicka på Fields-knappen.

append field

När du lägger till ett fält måste du välja fälttyp. Välj mellan ett vanligt fält och ett uttryck. Fälten i exemplet ovan är av typen Field.

Att lägga till uttryck i din importinställning ger dig möjlighet att skapa olika regler samt jämföra och ändra värden i olika fält. För att lära dig mer om hur du använder uttryck, gå till artikeln: Using expressions in your import setup.

Konfigurering av transportörförinställningar

I fliken Carrier PreSettings kan du ange koder från ditt ERP-system som kan användas för att välja en specifik plats, aktör, undertransportör, produkt och tjänster för att skapa en sändning.

Välj Location och Actor som konfigurationen ska gälla för. Om Import Setup läggs till på Location- eller Actor-nivå kan du inte välja en annan plats än den aktuella.
Klicka på New-knappen.
Ange en Carrier code och, om tillämpligt, ett Actor alias. Actor alias kan användas för att välja en specifik aktör i filerna.
Välj Carrier, SubCarrier, och Product. Innehållet i Enabled Carriers återspeglar vald Location och Actor i steg 1.
Välj Services om relevant. Du kan välja flera tjänster eller lämna dem omarkerade om du inte skapar en transportörkod för en produkt med obligatoriska tjänster.
Välj en Stack om du vill att sändningarna ska skickas till en annan stack än standardstacken för produkten.
Om du markerar Autoprint labels kommer alla sändningar som matchar transportörförinställningarna automatiskt att skickas efter import.
Mappningar kan användas för att översätta olika koder. Till exempel kan du använda samma kod för en pall hos alla dina transportörer även om de använder olika koder.

I detta exempel har vi mappat godstypkoden "BOX" till godstypen "PA-BOX-Parcel" hos transportören DHL Express.
Klicka på OK på sidan Carrier PreSettings när du har konfigurerat alla inställningar. Du kan nu använda transportörkoderna i dina filer för att skapa sändningar med de angivna produkterna och tjänsterna.