EDI Microsoft Dynamics NAV 2009 SP1 Klassisk Side 1
Indholdet i dette dokument må på ingen måde gengives helt eller delvist hverken på tryk eller i anden form - uden forudgående skriftlig tilladelse fra Naddon. Naddon kan træffes på: Sct. Cathrine Vej 21, 9800 Hjørring Tlf. 70 200 222 e-mail: kursus@naddon.dk www.naddon.dk Udgivelsesdato 31.10.10 Side 2
Indhold 1. Indledning... 5 Generelt... 5 Forudsætninger... 5 Skærmbilleder... 5 Naddon produkter... 5 2. Generelt... 6 Introduktion for brugeren... 6 Introduktion for udvikleren... 6 Naddon EDI udvekslingsdiagram... 8 Naddon EDI Ordbog og terminologi... 9 Naddon EDI hovedmenuen... 11 3. Opsætning... 13 Naddon EDI Opsætning... 13 Fanebladet Generelt... 13 Fanebladet Nummerering... 15 Fanebladet Mapning... 17 Fanebladet Eksterne programmer... 18 Fanebladet FTP / E-mail... 19 Fanebladet Version... 20 Eksterne programmer... 21 FTP Servere... 24 E-mail adresser... 26 4. Mapning... 28 Generelt om mapning i Naddon EDI... 28 Kundenr. og Leverandørnr. - Mapning... 30 Finans-/varenr. mapning pr. kunde/leverandør... 31 Finanskontonr. og varenr. mapning... 33 5. Udveksling... 37 Udvekslingsoversigt... 38 Knappen Udveksling... 38 Udvekslingsoversigt øverste del... 39 Udvekslingsoversigt Log... 39 Udvekslingsoversigt Filer/Dokumenter... 40 Knappen Aftale... 41 Knappen Fil... 41 Knappen Dokument... 42 Side 3
E-mailposter... 42 6. Udvekslingsaftale... 45 Udvekslingsaftale... 45 Fanebladet Generelt... 46 Fanebladet Objekter... 48 Fanebladet Filer... 50 Fanebladet Indgående... 52 Fanebladet Udgående... 55 Fanebladet Mapning... 56 Fanebladet Notificering... 58 Fanebladene Log & Filer/Dokumenter... 59 Aftale kunder/leverandører... 60 Udvekslingsaftale oversigt... 63 7. Udvekslingsdokument... 65 Udvekslingsdokument... 65 Fanebladet Fakturering... 67 Fanebladet Fakturering... 68 Fanebladet Levering... 69 Fanebladet Udveksling... 70 Udvekslingsdokument linjer... 71 Udvekslingsdokument - log... 72 8. Udvekslingskvittering... 75 Generelt om kvittering for udveksling... 75 Udvekslingskvittering... 75 Fanebladet Generelt... 77 Udvekslingskvittering - linjer... 79 Udvekslingskvittering - log... 80 Side 4
1. Indledning Generelt Naddon EDI er en funktionalitetsudvidelse til Microsoft Dynamics NAV og er en integration mellem Microsoft Dynamics NAV og Electronic Data Interchange (EDI). Naddon EDI integrerer virksomehdens elektroniske udvekslinger af købs- og salgsdokumenter (ordrer, fakturaer, kreditnotaer og lignende) mellem leverandører og kunder. Kursusmaterialet gennemgår - udover opsætning - de forskellige dokumenter og hvordan skærmbillederne skal læses: Forudsætninger For at benytte EDI forudsættes adgang til Microsoft Dynamics NAV samt standard windows funktionalitet. Typisk udveksles dokumenter i EDIFACT og XML formater. Det forudsættes at læseren af dette kursusmateriale er øvet Microsoft Dynamics NAV. Skærmbilleder Under hvert skærmbillede er menustien angivet. Fra Microsoft Dynamics NAV vil man via knappen Hjælp (F1) kunne se de respektive kapitler i dette kursushæfte, såfremt webhjælp er slået til (se kapitel 2). Naddon produkter På hjemmesiden www.naddon.dk kan du læse om dette og øvrige produkter i Naddon serien. Side 5
2. Generelt Introduktion for brugeren Naddon EDI modulet giver brugeren følgende muligheder/fordele: 1. Alle ind-/udlæsninger af salgs-/købsdokumenter kan samles under én brugerflade 2. Dokumenter kan indlæses i kladdeform selvom der evt. mangler opsætning/mapning af stamdata (eks. kunde/lev.nr. og finans/varenr.). Herved undgår man at skulle genindlæse (og evt. redigere) filerne, hvis der bare er tale om manglende opsætning. 3. Indlæste dokumenter vises i et billede, der er opbygget med hoved/linier ligesom standard dokumenter (ordrer, fakturaer ), hvilket gør dem meget tilgængeligt og genkendelige. NAVI PARTNER KURSUS 4. Indlæste dokumenter bliver valideret (de mest grundlæggende felter) inden de kan overføres til standard dokumenter. 5. Indlæste dokumenter kan redigeres/rettes i vid udstrækning inden de overføres til standard dokumenter. 6. Avanceret logning (log-poster og fil-/dokumentposter) af ind-/udlæsninger giver den nødvendige historik og dokumentation til at spore ind-/udlæste filer og dokumenter. 7. Gen-ind/udlæsning af filer og dokumenter styres på simpel og overskuelig måde inde fra programmet. Det er f.eks. ikke nødvendigt at flytte rundt på filer i stifinderen for at få dem genindlæst. 8. Mulighed for automatisk udveksling af filer til/fra FTP og SFTP server(e). Udvekslingen af filer via FTP/SFTP foregår som en integreret del af udvekslingskørslen i Naddon EDI inklusiv logning / fejlhåndtering. Herved undgår man at skulle køre et eksternt program (den traditionelle løsning) for at overføre til/fra FTP/SFTP servere. 9. Mulighed for automatisk afsendelse af filer via email. 10. Stor overskuelighed på alle niveauer, der gør det nemt at se/finde/rette de fejl (typisk manglende mapning) der måtte være på indlæste dokumenter. Efterhånden som fejlene udbedres afspejles det på overliggende niveauer. Introduktion for udvikleren Naddon EDI modulet giver udvikleren af import/eksport funktioner følgende fordele: 1. Med relativt få tilretninger i et ind-/udlæsningsobjekt får man automatisk al funktionalitet som logning, mapning, fejlhåndtering og filhåndtering (på OS-niveau) foræret af Naddon EDI modulet. 2. Selvom Naddon EDI er lavet med hovedvægt på udveksling af dokumenter, så kan andre typer af udvekslinger (f.eks. stamdata, prislister o.l.) også integreres med Naddon EDI for at opnå en samlet/ens brugerflade og få fordelen af den indbyggede log og fil-historik. 3. Naddon EDI modulet er lavet så lidt styrende som muligt. Det vil sige, at når først Naddon EDI modulet har kaldt et ind-/udlæsningsobjektet (typisk en rapport), så er det helt op til udvikleren af denne rapport at afgøre i hvor høj grad objektet skal gøre brug af de funktioner der ligger i Naddon EDI modulet. Side 6
4. Naddon EDI modulet er lavet relativt åbent. Det vil sige at koden flere steder er delt op i mange del-funktioner, som kan kaldes efter behov. Hvis for eksempel en overordnet funktion ikke lige gør helt som man har brug for, så skulle det være relativt enkelt at lave sin egen funktion, der kalder de samme del-funktioner med de(n) variation(er) der er behov for. 5. Naddon EDI modulet indeholder et ekstra lag mellem standard dokument-tabellerne og ind- /udlæsningsobjektet. Det ekstra lag består et udvekslingsdokument (hoved-/linietabeller) og tilhørende funktionalitet. Når man udvikler et ind-/udlæsningsobjekt skal man kun lave kode op mod disse tabeller selvom man f.eks. både vil udlæse bogførte fakturaer og kreditnotaer. 6. Som udgangspunkt skal en indlæsning kun udfylde (uden kald af validate) de felter på udvekslingsdokumentet, der måtte være tilgængelig i filen. Valideringen foregår først efterfølgende og håndteres automatisk af Naddon EDI modulet. 7. Hvis man som udvikler ønsker at udvide/ændre den indgående valideringen og/eller overførsel, har man mulighed for at gøre dette fuldt eller delvist helt uden at rette i Naddon EDI modulet. På udvekslingsaftalen angiver man sit special-udviklede validerings-/overførselsobjekt. De(t) objekt(er) kan så evt. kalde de del-funktioner der ligger i EDI standard-valideringen der er genanvendelige. 8. Naddon EDI modulet gør at de fleste almindelige ind-/udlæsninger af dokumenter kan laves med relativt lidt kode ude i selve ind-/udlæsningsobjektet. Ideen er at objektet i videst muligt omfang kun skal håndtere de ting der er fil/kunde/leverandør specifikke. 9. Det er hensigten at man som udvikler, i vid udstrækning, skal kunne tilføje nye ind-/udlæsninger uden at skulle rette i Naddon EDI modulets objekter. 10. Naddon EDI modulet er relativt enkelt at kode-implementere, idet der kun er lavet rettelser i hovedmenuen og tilføjet nogle felter/nøgler på salgs- og købsdokument tabellerne. 11. Der er i skrivende stund lavet versioner af Naddon EDI til 4.00 SP3, 5.00, 5.00 SP1, 2009 og 2009 SP1 (classic og RTC). 12. I Naddon EDI modulet skal betegnelsen EDI opfattes som en hel generel betegnelse for udveksling af salgs- og købsdokumenter. Det skal ikke forstås som værende en begrænsning/fokusering på EDIFACT-filformatet. Side 7
Naddon EDI udvekslingsdiagram Nedenstående diagram viser overordnet, hvordan Naddon EDI udveksler dokumenter. Figur Salgstilbud Salgsordre Mapning 1 OIOXML Faktura- /Kreditnota indlæsningsobjekt. Salgsfaktura Salgskreditnota Bogført salgsleverance Bogført salgsfaktura Bogført salgskreditnota Købsrekvisition Udvekslingsdokument 1 Logning Fil og dokument poster HANCOM Faktura- /Kreditnota udlæsningsobjekt. Andre Kunde- /Leverandør-/Filspecifikke ind-/udlæsningsobjekter. Købsordre Købsfaktura Købskreditnota (Ekstern) filudveksling. Bogført købsmodtagelse Bogført købsfaktura Bogført købskreditnota FTP / SFTP Server E-mail Figur 2.1 Udvekslingsdiagram Til venstre er der alle de forskellige dokumenttyper, der kan udveksles med standard Naddon EDI. Til højre er der nogle eksempler på udvekslingsobjekter, der enten udlæser til eller indlæser fra et eller andet filformat. Der er lavet nogle standard udvekslingsobjekter til Naddon EDI, men en af grundidéerne i modulet er at man kan udvikle andre efter behov. Kernen af Naddon EDI er uafhængig af filformatet. I midten er der så kernefunktionen i selve Naddon EDI, nemlig at skabe bindeled mellem de mange forskellige dokumenttyper og de mange forskellige filformater. Udvekslingsdokumentet er Naddon EDI s repræsentation af et hvilket som helst ind/udgående dokument. Alle dokumenter ryger gennem et udvekslingsdokument under en udveksling. Mapningen sørger for at konvertere mellem interne og eksterne numre. Loggen opfanger status og fejl under en udveksling. Fil og dokumentposter dannes som historik og til sporingsformål. Side 8
Side 84