Vi har udviklet et gratis NAV add-on til Microsoft Dynamics NAV, som gør det muligt at oprette forsendelser og shipping labels direkte fra økonomisystemet.

I denne vejledning gennemgår vi, hvordan integrationsmodulet implementeres i Microsoft Dynamics NAV, og hvordan løsningen kan tilpasses til virksomhedens arbejdsgange.

Benytter I Microsoft Dynamics NAV og ønsker at håndtere forsendelser direkte fra jeres økonomisystem, skal I kontakte jeres Microsoft Dynamics NAV-partner, som kan hjælpe med implementering og opsætning.

Shipmondo-integrationsmodulet kommunikerer med vores RESTful API og er bygget modulært. Det gør det muligt at udvide og tilpasse løsningen, så den matcher den enkelte virksomheds arbejdsgange.

Herunder gennemgår vi den grundlæggende opsætning af modulet og viser et simpelt eksempel på, hvordan en udskrivningsknap kan implementeres under salgsordrer i Dynamics NAV.

Opsætningen tager cirka 30 minutter. Herefter vil I være klar til at oprette den første forsendelse og udskrive en shipping label direkte fra Dynamics NAV.

Kontakt vores Customer Success-team og oplys, hvilken version af Microsoft Dynamics NAV du eller din kunde benytter. Så sender vi den korrekte NAV-objektpakke samt tilhørende filer.

Installer det medfølgende Newtonsoft Json.NET-bibliotek ved at følge denne vejledning. Det er filen Newtonsoft.Json.dll, som følger med zip-filen, I har modtaget fra os. Læs vejledning til installation af Newtonsoft Json.NET for Dynamics NAV her.

Indlæs herefter NAV-objektpakken i Dynamics NAV-udviklingsmiljøet. Objekterne ligger i nummerserien 90001..90008.

Afslut med at kompilere objekterne.

Åbn Pakkelabels profiler (NAV page 90005).

Opret en ny profil.

Angiv API-bruger og API-nøgle fra jeres Shipmondo-konto. Se, hvordan I finder jeres API-oplysninger her.

Under fanen Afsender angiver I de afsenderoplysninger, som skal fremgå på jeres forsendelser og shipping labels.

Hvis I har flere forretninger, for eksempel flere webshops med forskellige navne, kan I oprette flere Pakkelabels-profiler med forskellige afsendere.

Nu skal I tilknytte jeres speditør- og leveringskoder i Dynamics NAV til de relevante fragtprodukter i Shipmondo (standardfelter i NAV som bl.a. kan vælges på debitorkortet og under salgsordrer). 

Denne opsætning sikrer, at det korrekte fragtprodukt bliver bestilt, når I opretter en forsendelse fra for eksempel en salgsordre i Dynamics NAV.

Herunder beskriver vi opsætningen for én leveringsmetode. Benytter I flere speditører eller leveringsformer, skal opsætningen gentages for hver metode.

Åbn Pakkelabels leveringsmetoder (NAV page 90007).

Opret en ny leveringsmetode. 

Under fanen NAV speditør og leveringskode angiver I den speditørkode og leveringskode i Dynamics NAV, som skal kobles til et fragtprodukt i Shipmondo.

I eksemplet herunder opsættes speditørkoden "GLS" og leveringskoden "PAKKESHOP".

Under fanen Pakkelabels fragtprodukt skal I angive Produktkode fra Shipmondo. For GLS PakkeShop er produktkoden eksempelvis GLS_DK_SD.

Produktkoden er den værdi, der sendes med i API-kaldet, når en forsendelse oprettes. Den bruges til at identificere det korrekte fragtprodukt og den tilhørende transportør i Shipmondo.

Hvert fragtprodukt har sin egen unikke produktkode.

I kan se en oversigt over tilgængelige fragtprodukter og produktkoder under Indstillinger > Integrationer > API fragtprodukt- og serviceoversigt, når I er logget ind på jeres Shipmondo-konto.

Alternativt kan I benytte API-kaldet Products.

Læs mere her. 

I kan angive en standardvægt for forsendelser pr. leveringsmetode.

Har I vægtangivelser på varerne i Dynamics NAV, kan løsningen også tilpasses, så den korrekte vægt automatisk overføres til forsendelsen.​
​

Det er muligt at styre, om forsendelser skal oprettes gennem egne fragtaftaler eller gennem Shipmondos fragtaftaler.

Hvis I ønsker at bruge egne fragtaftaler, skal disse først være aktiveret på jeres Shipmondo-konto. Læs mere om egne fragtaftaler her.

Via API’et er det muligt at tilvælge forskellige services til en forsendelse.

I integrationsmodulet har vi gjort e-mail- og SMS-adviseringer samt personlige beskeder tilgængelige i opsætningen. Løsningen kan også udvides til at understøtte andre services, for eksempel forsikring, hvis der er behov for det.

Læs mere om tilvalg til forsendelser her.

For at kunne udskrive shipping labels til en labelprinter skal vores Printklient installeres på en computer eller server, som har adgang til printeren.

Når Printklienten er installeret, kan I tilføje de printere, som skal bruges sammen med Shipmondo.

Printklienten kører i baggrunden og kommunikerer med Shipmondos server, så printjobs kan overføres til labelprinteren.

Læs mere om Shipmondo Printklienten her og følg guiden for installation Shipmondo Printklient og tilføjelse af printer.

Når Printklienten er installeret, og printerne er tilføjet, kan I klikke på Hent printerliste i menuen på den opsatte Pakkelabels-profil. Printerlisten bliver herefter hentet eller opdateret, og I kan vælge den ønskede printer under Printernavn.

​

I punkt 1 til 4 har vi gennemgået den grundlæggende opsætning af integrationsmodulet og vist, hvordan en labelprinter tilknyttes løsningen.

Næste skridt er at implementere en udskrivningsknap under salgsordrer i Dynamics NAV.

Vi har bevidst valgt ikke at præoprette en udskrivningsknap i objektpakken, da virksomheder ofte har forskellige behov og arbejdsgange. Derudover har mange virksomheder egne tilpasninger i deres NAV-løsning, hvilket gør det vanskeligt at tilbyde en reel plug-and-play-løsning.

I stedet er integrationsmodulet bygget modulært, så det er let for en NAV-udvikler at implementere og placere en udskrivningsknap det ønskede sted i Dynamics NAV.

Herunder viser vi et eksempel på, hvordan en udskrivningsknap kan implementeres under salgsordrer i Dynamics NAV:

1. Opret en knap under Salgsordre og navngiv den f. eks. Udskriv shipping label.

2. Indsæt følgende to kodelinjer under OnAction() på den oprettede knap:

PakkelabelsProfile er en instans af Table 90005.

Udskrivningsknappen er nu implementeret.

I kan nu oprette en forsendelse og udskrive en shipping label til jeres labelprinter direkte fra en salgsordre i Dynamics NAV ved at klikke på Udskriv pakkelabel.

Gennem vores API er det muligt at få adgang til stort set alle funktioner og services i Shipmondo.

I kan derfor bygge videre på løsningen og tilpasse den, så den matcher virksomhedens behov.

For at gøre arbejdet lettere har vi i Codeunit 90005 Pakkelabels Mgnt. i NAV-objektpakken inkluderet en række hjælpefunktioner og kodeeksempler med kald til vores API, som kan bruges som udgangspunkt.

Vi anbefaler også, at I gennemgår vores API vejledninger, som indeholder beskrivelser af fremgangsmåder samt konkrete eksempler på, hvordan de forskellige API-kald håndteres.

NAV-integrationsmodulet understøtter ikke avancerede forsendelser som f.eks. DHL Express, FedEx og UPS som standard, men løsningen kan udvides til at understøtte disse.

Årsagen er, at disse transportører stiller særlige krav til bookingen, som gør det vanskeligt at tilbyde en reel plug-and-play-løsning.

For eksempel kræver DHL Express, at pakkens mål sendes med i bookingen, og at der oprettes en elektronisk proformafaktura ved forsendelser udenfor EU. 

Da disse oplysninger kan være gemt forskelligt i Dynamics NAV fra kunde til kunde, kræver det en kundespecifik implementering.

For at understøtte dette har vi lavet en vejledning med eksempler på, hvordan I booker advanced parcels gennem vores API.

Se eksemplerne her.