1. Introduktion
Dette kapitel giver et overblik over dokumentet og introducerer dig til ShipIT-tilføjelsesprogrammet til Microsoft Dynamics NAV.
1.1 Om ShipIT
ShipIT er et tilføjelsesprogram til Microsoft Dynamics NAV, der tilbyder én enkel løsning til håndtering af transportører over hele verden. Til dine transportordrer kan du vælge transportører som DHL, UPS, FEDEX, TNT, PostNL, for blot at nævne nogle få. Hver af dem har deres egen grænseflade, måde at mærke forsendelser på, information og notifikationer, og det er svært at administrere. Derfor har idyn udviklet ShipIT, den enkle måde at administrere dine internationale transportordrer direkte fra din Microsoft Dynamics NAV.
Uanset om du kun arbejder med en salgsordre eller vareforsendelser fra lageret, fører ét enkelt klik dig til ShipIT. Valgfrit kan du vælge din foretrukne transportør eller gennemse priser og leveringstider. Så snart din transport order er klar, skal du blot klikke på ‘Book & Print’ for at få den afsendt. Det eneste, du skal gøre, er at sætte etiketten på kassen. Track & trace-links og statusopdateringer vil automatisk blive vist i Microsoft Dynamics NAV.
ShipIT er udviklet sammen med vores partner Transsmart, den førende udbyder af logistikdata, og de fokuserer på at strømline kommunikationen mellem transportører og ERP-systemer. Transsmart arbejder med hundredvis af transportør-grænseflader og giver idyn en gnidningsfri måde at arbejde i Microsoft Dynamics NAV. Dette gør det meget let at skifte mellem eller tilføje nye transportører.
Tilføjelsesprogrammets funktionalitet omfatter følgende nøglefunktioner:
- Carrier-connectivity med næsten alle transportører verden over
- Vælg transportør afhængigt af bedste priser og/eller leveringstider
- Real-time forbindelse via web services
- Label-print direkte fra Microsoft Dynamics NAV
- Print på enhver printer i din organisation
- Tilpassede e-mail-notifikationer
- Real-time statusinformation om forsendelser
- Real-time track & trace-information i Microsoft Dynamics NAV
- Freight audit-tjenester
- BI-rapportering
- Omfattende Service Level Agreements
- Tilbyd afhentningssteder afhængigt af kundens placering
- Forsendelsespriser baseret på indholdet af shopping cart
- Track & Trace-info direkte tilgængelig for kunder
- Brug track & trace og anden forsendelsesinfo i notifikationer
1.2 Om dokumentet
Dette dokument er en brugervejledning med en guide til opsætning af ShipIT add-on til Microsoft Dynamics NAV. Den indeholder specifikke instruktioner til konfigurering af add-on’et. Guiden dækker også installationsproceduren.
2. Hvad er nyt i version 4.0
Hovedemner
- Anvendelse af API V2 i stedet for API V1.
Bemærk venligst, at API V1 ikke længere understøttes.
2. Factbox med Transport Order-information på alle kildedokumenter.
3. Forbedret Carrier Select, til at vise mulige/umulige Carrier/Service Level-kombinationer, datoer og priser.
4. Integration af manual og Online Help direkte fra applikationen.
5. Markér Item Type, så varer af typen SERVICE ikke bliver inkluderet i Transport Order.
6. Bedre fejlrepræsentation.
7. Debug-mekanisme tilføjet til produktet, så det bliver muligt at logge alle request/response-meddelelser.
8. Udfyldelse af feltet Origin så Transsmart kan se, hvilken NAV/SI-version der er ansvarlig for at oprette en Transport Order.
9. Yderligere felter (Route ID, Driver ID) tilføjet til Transport Order.
10. Adgang fra Transport Order til Transsmart Portal-oversigten, ikke kun selve Shipment .
11. Forbedret håndtering af Transport Orders i tilfælde af fejl, for eksempel muligheden for at re-booke en eksisterende
Transport Order efter at fejlen er rettet.
Den sædvanlige oprydning
- Implementering af alle eksisterende hot fixes fra alle SI3.X.X-versioner
- Flere mindre rettelser (forkerte eller manglende billedtekster osv.)
Dokumentation
- Ny manual tilføjet produktet. Også tilgængelig fra NAV-add-on'et.
- Du kigger på den lige nu! :) Feedback er velkommen!
3. Sådan opgraderer du til ShipIT V4
Opgrader ShipIT NAV add-on fra 3.00 til 4.00:
- Opgrader applikationen
- Opdater dine Transsmart service-URL'er https://xyz.api.transwise.eu til https://acceptapi.transsmart.com or https://api.transsmart.com for produktionsmiljøet.
- Indtast dine legitimationsoplysninger
- Opdater Master Data via menuen – Dette henter alle (nye) Master Data fra Transsmart
- Kontrollér/opdater mapping af NAV data til nye Transsmart Master Data.
Label-print
- Afinstaller dit nuværende QZ print utility.
- Installer den nyeste Smart Print utility i henhold til følgende manual: Installing the SmartPrint Client
- Konfigurér dine printerstier og -navne i MyTranssmart-portalen ved hjælp af dine email- og adgangskode-legitimationsoplysninger.
4. Installation og opsætning
Dette kapitel giver vejledning i installation og opsætning af ShipIT add-on'en.
4.1 Installation
Inden du påbegynder ShipIT opsætningen i et Microsoft Dynamics NAV-miljø, skal der oprettes en Transsmart konto for at kunne kommunikere med Transsmart webservices til Transport order-behandling. Mere info på www.nshift.com eller via vores support på dette link. Derudover skal ShipIT modulerne være tilgængelige i din Microsoft Dynamics NAV-licens.
4.1.1 Installér komponenter
Kopiér de krævede ddl-filer til mappen \Add-ins\TranssmartV2\ i NAV service-mappen på NAV service tier-maskinen/-maskinerne. Hvis du kører flere service tiers, skal du gentage denne opgave for alle service tiers.
Figur 2-1: ShipIT og Transsmart installationskomponenter
Disse komponenter leveres sammen med objekterne.
4.1.2 Importér eller flet NAV-objekter
Brug den FOB-fil, der svarer til din NAV target version, og importér eller flet objekter, hvis relevant.
Figur 2-2: Identificer NAV target version
Figur 2-3: Import eller flet NAV-objekter
Rekompiler alle objekter og også alle MenuSuite-objekter, og genstart Dynamics NAV-klienten.
4.2 Opgradering af tidligere versioner
Hvis du opgraderer en ældre version af ShipIT er det vigtigt først at fjerne de gamle komponenter. Find venligst følgende filer i NAV-service-mappen, og slet dem. Du kan finde disse filer under: C:\Program Files\Microsoft Dynamics NAV\90\Service eller C:\Program Files\Microsoft DynamicsNAV\100\Service.
4.3 Opsætning
Opsætningsmenuen for ShipIT add-on’en indeholder adskillige sektioner, der giver ret fleksible muligheder for applikationskonfiguration både i Microsoft Dynamics NAV og med Transsmart. Dette kapitel beskriver generel ShipIT-opsætning, brugeropsætning samt, hvordan du opsætter mapping for fragtfører, forsendelsesmetode, valuta og land eller område. Dette kapitel beskriver også Transsmart-specifikke settings, der bruges af ShipIT applikationen.
4.3.1. Administration Setup
For at få adgang til Administration Setup, gå i Microsoft Dynamics NAV til Departments > ShipIT > Setup. Opsætningsmenuen indeholder følgende elementer:
Figur 2-4: ShipIT opsætningsmenupunkter
4.3.2 ShipIT User Setup
Vælg ShipIT User Setup og indtast alle relevante Dynamics NAV-brugere og deres respektive Transsmart loginoplysninger.
Figur 2-5: ShipIT User Setup
Alle brugere kan have deres egen personlige konto eller dele den samme Transsmart konto på tværs af hele virksomheden, afhængigt af variationen i brugerspecifikke printer-settings.
4.3.3 ShipIT Setup
Vælg fra Departments > ShipIT > Setup menupunktet ShipIT Setup og udfyld alle nødvendige felter.
Figur 2-6: ShipIT Setup
Tabellen ShipIT Setup Fields Description nedenfor viser alle tilgængelige felter, værdiindstillinger og description for brug af siden ShipIT Setup.
Tabel 2-1: ShipIT Setup Fields Description
4.3.4 Opdatér Transsmart Master Data
I ShipIT Setup startes der med at indtaste API Base URL (i dette eksempel en test-URL)
Figur 2-7: ShipIT Setup General FastTab Transsmart URLs
Klik på Update Master Data for at forbinde til Transsmart web services og downloade alle tilgængelige Transsmart master data:
Figur 2-8: ShipIT Setup Transsmart Master Data
I eksemplet nedenfor er to tilgængelige Carrier ID’s blevet downloadet. I de næste trin skal disse ID’er mappes til dine Microsoft Dynamics NAV Shipping Agents, Shipment Methods,Currencies og Country/Region koder. I ShipIT > Setup > Transsmart Master Data klikkes der på Carriers.
Figur 2-9: ShipIT opsætning Transsmart stamdata, Carriers
Vælg en linje, og klik på Carrier Profiles for at se detaljer om visse forsendelsesmetoder, der er tilgængelige fra denne speditør, og hvilke metoder der er ”mappet” til din Dynamics NAV.
Figur 2-10: ShipIT opsætning Transsmart stamdata, Carrier Profiles
Endnu et eksempel nedenfor viser listen over Shipment Method*s, referred as *Incoterms, tilgængelige fra Transsmart:
Figur 2-11: ShipIT opsætning Transsmart stamdata, Incoterms
Næste trin er at ”mappe” de downloadede koder til dine Dynamics NAV-koder.
4.3.5 Mapping af Dynamics NAV-koder til Transsmart-koder
Fra Departments > ShipIT > Setup > Administration ”mapper” du de koder, der er downloadet fra Transsmart til dine Dynamics NAV-koder efter eksemplet nedenfor. Mindst én Dynamics NAV-kode skal være ”mappet” til en Transsmart kode for alle listede emner:
- Shipping Agent-tilknytninger
- Shipment Method-tilknytninger
- Valutatilknytninger
- Country/Region-tilknytninger
4.3.6 Shipping Agent Service-tilknytninger
Gå til Shipping Agent Mappings og vælg en linje:
Figur 2-12: ShipIT-opsætning, Shipping Agent-tilknytninger
Klik på Shipping Agent Service Mappings, og angiv værdierne, der beskriver Shipping Agent Service Code, Description og Transsmart kode, som skal referere til dit valg.
Figur 2-13: ShipIT-opsætning, Shipping Agent Service-tilknytninger
I eksemplet er koden Dynamics NAVShipping Agent DHL blevet “mappet” til Transsmart Carrier ID 5 med et serviceniveau 1DAY.
4.3.7 Verificer opsætningen
For at verificere ShipIT -opsætningen skal du gå til Departments > ShipIT > Setup > ShipIT Setup. Fra siden ShipIT Setup skal du klikke på Verify Setup og verificere din opsætning ved hjælp af siden Setup Verification Result:
Figur 2-14: Verificér ShipIT-opsætning, resultat
Kontrollér, om alle nødvendige felter og tabeller er konfigureret korrekt. Gå tilbage for at færdiggøre mapping eller datasynkronisering, og kør opsætningsverifikationen igen for at sikre, at opsætningen fuldføres korrekt. Se tabellen i kapitlet ShipIT Setup for at færdiggøre opsætningen af alle andre nødvendige værdier og settings for at konfigurere, hvordan ShipIT skal opføre sig i din Dynamics NAV -applikation.
5. Kørsel af funktionaliteten
Dette kapitel giver et overblik over den ShipIT add-on-funktionalitet, der er tilgængelig i Microsoft Dynamics NAV, samt nogle almindelige anvendelsesscenarier.
5.1 Test Transport Order
Når opsætningen af ShipIT add-on er fuldført, kan du teste din applikation og begynde at oprette Transport Orders. Gå for eksempel til Sales Orders, klik på New, og opret en normal Sales Order.
Figur 3-1: Brug af ShipIT, oprettelse af Sales Order
Sørg for at vælge de værdier, der er ‘mapped’ til Transsmart værdier i felterne Shipment Method, Shipping Agent og Agent Service, ellers vil der ikke blive oprettet en Transport Order baseret på denne Sales Order. Derefter indtaster du varelinjerne på din Sales Order og klikker på Create Transport Order på fanen Actions i båndet. Hvis der er oprettet en Transport Order, vil du se denne dialog, der giver dig mulighed for at gå direkte til Transport Order .
Figur 3-2: Brug af ShipIT, notifikation ved succesfuldt oprettet Transport Order
Klik på Yes og se den resulterende Transport Order:
Figur 3-3: Brug af ShipIT, resulterende Transport Order
Factbox med Transsmart detaljer angiver koder, der henviser til den valgte Shipping Agent, Shipment Method og Shipment Service. Gå venligst tilbage til den bogførte Sales Order og bemærk, at Transport Order Details Factbox er blevet udfyldt med de tilgængelige logistikoplysninger:
Figur 3-4: Brug af ShipIT, Transport Order faktaboks på salgsordren
Transport Order er klar til at blive bogført og udskrevet!
5.2 Transportordrer
For at åbne listen Transport Orders gå til Departments > ShipIT > Order Processing > Lists og klik på Transport Orders:
Figur 3-5: Brug af ShipIT, liste over transportordrer
Listen over tilgængelige handlinger for Transport Orders vises på billedet nedenfor:
Figur 3-6: Brug af ShipIT, liste over handlinger for transportordrer
Vælg en vilkårlig Transport Order-linje i listen, og klik på View eller Edit for at åbne Transport Order Card.
Figur 3-7: Brug af ShipIT, Transport Order Card, liste over handlinger
Felterne på Transport Order-kortet er selvforklarende. Det er værd at nævne, at Additional References FastTab ikke findes i NAV-databasen og er beregnet til at give en måde at gemme nyttige oplysninger på, for eksempel Driver ID eller Route ID. Transsmart kommer til at bruge nogle værdier i dette felt til mere præcise omkostningsberegninger og bedre logistik. Listen over handlinger, der er tilgængelige på Transport Order Card, ligner meget Transport Orders List og er vist på billedet nedenfor:
Figur 3-8: Brug af ShipIT, Transport Orders Actions List
For automatisk at beregne de mulige og tilgængelige kombinationer af Shipping Agent, Shipment Method og Shipment Service, skal du klikke på Carrier Select i båndet.
Figur 3-9: Brug af ShipIT, Carrier Select List
De tilstrækkelige linjer vil blive markeret med grøn farve, mens de kombinationer, der fejler, vil blive markeret med rød. Transport Order-behandling understøttes af brugervenlig fejl- og undtagelseshåndtering. Hvis du har glemt at tilføje en Shipping Agent og forsøgte at klikke på Book, kan du gå tilbage, rette fejlen og booke Transport Order igen.
Figur 3-10: Brug af ShipIT, booking af Transport Order med fejl
I eksemplet ovenfor angiver fejlen tydeligt, at en Shipping Agent Code skal have en værdi, og dette gør det langt nemmere at finde årsagen til en fejl i behandlingen. Da der ikke findes rapporter i Dynamics NAV, som indeholder ShipIT information, er det muligt at oprette en liste over rapporter pr. Transport Order ved hjælp af add-on’en. For at oprette listen over rapporter skal du klikke på Reports i fanen Transsmart på båndet.
Disse rapporter vil blive brugt (udskrevet) på et bestemt tidspunkt under håndteringen af en Transport Order (for eksempel før eller efter booking). NAV partneren og slutkunden bør beslutte, på hvilket tidspunkt rapporterne skal udskrives. De skal også træffe en beslutning om automatisk at knytte et standardsæt af rapporter til en Transport Order.
5.3 Transport Worksheet
Gå til Departments > ShipIT > Order Processing > Tasks, og klik på Transport Worksheet. Brug filteret til at hente kildedokumenterne (for eksempel efter Shipping Agent), og opret flere T*ransport Orders* ud fra kildedokumentlinjerne.
Figur 3-11: Brug af ShipIT, behandling af Transport Worksheet
5.4 Arkivering af Transport Orders
Det er nogle gange nødvendigt at arkivere en Transport Order, men uden at foretage en egentlig transportbooking. Med ShipIT er det muligt at arkivere en Transport Order uden at foretage en booking til Transsmart. For at se de arkiverede Transport Orders gå til Departments > ShipIT > Order Processing > Archive og klik på Archived Transport Orders.
Figur 3-12: Brug af ShipIT, arkivering af Transport Orders
Vedhæftet er ShipIT 4.0-dokumentet, som er en brugervejledning med en guide til opsætning af ShipIT add-on til Microsoft Dynamics NAV.
Det indeholder specifikke instruktioner til konfigurering af add-on. Vejledningen dækker også installationsproceduren.