September 2004 version 1.4 E-giro anmälningsärende Teknisk manual Augusti 2002. Copyright Bankgirocentralen BGC AB 2000.
Innehåll Innehåll Inledning...3 Översikt... 3 Presentation...5 Förberedelser och kundtest...8 Checklista... 8 Kommunikation med BGC... 9 Kundtester... 14 Anmälningsärende exempel... 16 Ytterligare information...23 Om e-giro anmälningsärende... 23 Ordlista...25 Ord och begrepp i e-giro anmälningsärende... 25 Bilaga 1...27 Post- och filbeskrivning... 27 Mottagarpost... 28 Anmälningsradspost... 28 Summeringspost... 32 Slutpost... 32 Buntstruktur/filstruktur EFA 03... 32 Exempel på an/avmälningsfil... 33 Tabell för bankförkortningar och bankid... 34 E-giro anmälningsärende teknisk manual 2 (34)
Inledning Inledning Översikt Inledning E-giro anmälningsärende Underlättar för fakturautställaren att få anmälningar från internetbankerna Kan skräddarsys utifrån den information som fakturautställaren önskar att fakturamottagaren registrerar Ger möjlighet att kontrollera av fakturamottagare registrerat data utifrån valbara kontroller som min och max längd kontroll till checksiffer kontroll Ger fakturautställaren en fil innehållande avanmälningar, anmälningar, anmälningar utifrån betalning och autogiro Innehar samma format som e-faktura anmälningsärendet Fakturamottagarna anmäler sig via e-giro anmälningsärende: Med e-giro anmälningsärende får fakturautställaren en fil med kontrollerade anmälningstransationer. E-giro anmälningsärende är ett samarbete mellan Skandiabanken, Handelsbanken, SEB, Östgöta Enskilda Bank och Bankgirocentralen BGC AB. Målgrupp Detta dokument är avsett för dig som arbetar med de tekniska lösningarna kring e- giro anmälningsärende. Manualen ger dig riktlinjer för hur ekonomi- och faktureringssystemet ska anpassas. Dokumentet beskriver även de krav som ställs för anslutning till e-giro anmälningsärende. Fortsättning på nästa sida E-giro anmälningsärende teknisk manual 3 (34)
Inledning Översikt, fortsättning Frågor Om du har frågor om e-giro anmälningsärende är du välkommen att kontakta Programservice på BGC. - Telefon 08-725 60 20 Fax 08-725 71 13 e-post program.dialog@bgc.se E-giro anmälningsärende teknisk manual 4 (34)
Presentation Presentation Inledning I detta kapitel presenterar vi e-giro anmälningsärende och berättar hur det fungerar. Syftet är att ge dig en övergripande presentation av vad e-giro anmälningsärende är och hur faktura- eller dokumentutställaren kan dra nytta av e-giro anmälningsärende. Anmälan till Elektronisk faktura/e-giro E-giro anmälningsärende innebär att fakturautställaren definierar hos BGC vilket data som fakturamottagare behöver registera för att kunna bli identifierad hos fakturautställaren och få elektroniska fakturor. BGC skickar fakturautställaren en fil innehållande anmälningar utifrån ett eller flera av fakturautställaren definierade anmälningsärenden. I filen är det också valbart för fakturautställaren att ta emot avanmälningar, anmälan vid betalning eller anmälan vid autogiro som vanligtvis går via det vanliga e-giro formatet. Enkla och korrekta anmälningar Genom e-giro kan fakturautställarens kund enkelt se och registera de uppgifter som fakturautställaren behöver för att identifiera fakturamottagaren. Anmälningsärendet tar automatiskt emot personnummer och bank från internetbanken. Ett eller flera anmälningsärenden En fakturautställaren kan mot sina fakturamottagare erbjuda olika anmälningsärenden. Ett exempel då det behövs olika anmälningsärenden kan t ex vara en befintlig kund som anmäler sig för elektronisk faktura alternativ en ny kund som anmäler sig för elektronisk faktura. Ytterligare information Anmälningsärendet utseende styrs av mallar, som beslutas av utställaren. Fortsättning på nästa sida E-giro anmälningsärende teknisk manual 5 (34)
Presentation Presentation, Fortsättning Så fungerar anmälningsärendet Så här fungerar e-giro anmälningsärende, steg för steg: Fas Beskrivning 1 Fakturautställaren beslutar vilka uppgifter som fakturamottagaren behöver registrera per anmälningsärende. Per anmälningsärende kan max 10 unika fält anges förutom personnummer och banktillhörighet. En fakturautställare kan ha oberoende antal anmälningsärenden. 2 För varje anmälningsärende beslutar fakturautställaren följande delar: En av fakturautställaren unik identitet på anmälningsärendet bestäms så att fakturautställaren kan identifiera anmälningsärendet i filen Fakturautställaren definierar ett unikt namn på anmälningsärendet, vilket presenteras för fakturamottagaren om fakturautställaren innehar flera anmälningsärenden som ska visas. En av fakturautställaren unik presentationstext definieras så att fakturamottagaren läser syftet med anmälningsärendet alternativt vad fakturamottagaren måste uppfylla för att anmäla sig. Fakturautställaren kan t ex skriva att Fakturamottagaren måste vara kontoinnehavare. Länkar. Om länk till hemsida, kundtjänst eller övrigt ska visas. Om anmälningsärendet ska visas eller ej Om av fakturamottagaren registrerade anmälningarna ska lagras som test eller produktiontransaktioner Antalet fält och respektive fältnamn, vilket presenteras för fakturamottagaren. En identitet på respektive fält. Vilken min och max längd fältet ska inneha Vilken kontroll fältet ska inneha (ingen, numerisk eller 10-modul) 3 Fakturautställarens system ska inför test förberedas med de personnummer som kommer i anmälningsärendet. 4 Ankommande format. Fakturautställaren kan välja: 1. att anmälningar från anmälningsärendet skickas i EFA formatet. Avanmälningar, anmälan vid betalning och anmälan via autogiro skickas i e-giro formatet 2. att anmälningar från anmälningsärendet, avanmälningar, anmälan vid betalning och anmälan via autogiro skickas i EFA formatet. Fortsättning på nästa sida E-giro anmälningsärende teknisk manual 6 (34)
Presentation Presentation, fortsättning Kunden anmäler sig enkelt Via internetbanken: I varje internetbank, e-giro som e-faktura internetbank, presenteras fakturautställarens namn och länk till e-giro anmälningsärendet om fakturautställaren tecknat tjänsten av en e-giro bank. När fakturamottagaren klickar på anmälningsärendet så skickar internetbanken med fakturamottagarens personnummer och banktillhörighet till anmälningsärendet. Fakturamottagaren får därefter om fakturautställaren har flera anmälningsärenden som ska presenteras möjlighet att välja ett. Om fakturautställaren endast har ett anmälningsärende så presenteras registreringsformuläret direkt. Dessa kunder når fakturaeller dokumentutställaren Antalet kunder i svenska internetbanker växer snabbt. I e-giro anmälningsärende når faktura- eller dokumentutställarna kunderna i Handelsbankens, SEB:s, Skandiabankens och Östgöta Enskilda Banks internetbanker. Med början i juni 2002 kommer fakturautställarna även att nå fakturamottagare i FöreningsSparbankens och Nordeas internetbankstjänster, förutsatt att de avtalar om detta med sin bank. E-giro anmälningsärende teknisk manual 7 (34)
Presentation Förberedelser och kundtest Checklista Inledning Innan fakturautställaren kan börja använda e-giro anmälningsärende, måste vissa krav på ekonomisystemet vara uppfyllda och vissa förberedelser vara genomförda. Detta kapitel är tänkt att användas som en enkel checklista för vad fakturautställaren behöver åtgärda före start i e-giro anmälningsärende. Checklista i ii Åtgärd Hänvisning Besluta om leveranssätt till och från BGC inklusive metod för förändringsskydd. Kundregistret ska vara förberett för hantering av Anmälningar, Ev. avanmälningar Se avsnittet Kommunikation med BGC i detta kapitel. Se kapitlet Presentation iii iv v vi Utforma en eller flera anmälningsärendemallar för fakturor eller e-dokument. Besluta om val av format för anmälningsärende respektive avanmälan, anmälan vid betalning och anmälan utifrån autogiro. Skriva avtal om e-giro anmälningsärende med banken. Genomföra en godkänd kundtest för e-giro anmälningsärende. Se kapitlet Exempel Se kapitlet Presentation Se avsnittet Defaultvärden i e-giro anmälningsärende i detta kapitel. Se kapitlet kundtest E-giro anmälningsärende teknisk manual 8 (34)
Presentation Kommunikation med BGC Inledning Faktura- eller dokumentutställaren kan ta emot filer från BGC på ett flertal sätt. I detta avsnitt går vi igenom vilka metoder för kommunikation (kallas även leveranssätt) som faktura- eller dokumentutställaren kan använda, samt förutsättningarna för kommunikationen med BGC. Krav på fakturautställarens system Fakturautställarens system måste kunna Ta emot filer från BGC. valbart Förändringsskydda filer från BGC. Tillgängliga leveranssätt Följande leveranssätt kan användas för e-giro anmälningsärende: Leveranssätt BgCom (kan inte användas för anmälningsärendet) Connect:Direct Netview/FTP TCP/IP FTP via X.25 Metod för förändringsskydd (se nedan) Integrerad kommunikations- och säkerhetslösning. Nexus Elektroniskt sigill, MAA Nexus Elektroniskt sigill, MAA Nexus Elektroniskt sigill, MAA Fortsättning på nästa sida E-giro anmälningsärende teknisk manual 9 (34)
Presentation Kommunikation med BGC, fortsättning Filnamn Filer från BGC: Filer som sänds till faktura- eller dokumentutställaren kan namnsättas enligt utställarens önskemål. Om faktura- eller dokumentutställaren vill använda unika namn för varje dag används datum (DÅÅMMDD). Den 31 december 2002 skrivs exempelvis D021231. BGC kan inte använda t ex Buntid eller tid i filens namn. Produktion Test Anmälningsfil BFEP.U????.K0XXXXXX XXXXXX=Kundnummer BFET.U????.K0XXXXXX XXXXXX=Kundnummer Metod för förändringsskydd Förändringsskydd innebär att filer förses med en krypterad kontrollpost som beräknas från filens innehåll och en unik kod (även kallad sigillnyckel), innan filen sänds från BGC. BGC kontrollerar kontrollposten och kan därmed säkerställa att filen inte förändrats efter det att avsändaren förändringsskyddade den. Förändringsskydd är valfritt för fil som sänds från BGC. För närvarande används tre metoder för förändringsskydd: Metod för förändringsskydd BgCom (kan inte användas för fakturaoch dokumentunderlagsfiler) MAA (Message Authentication Algoritm) Nexus Elektroniskt sigill Anmärkning BgCom är en integrerad kommunikations- och säkerhetslösning, baserad på Elektroniskt ID-kort och stark kryptering. Fri algoritm för förändringsskydd anpassad för Bankgirot. Metod utvecklad av Nexus (före detta SÄKData). Fortsättning på nästa sida E-giro anmälningsärende teknisk manual 10 (34)
Presentation Kommunikation med BGC, fortsättning Avsnittssigill eller leveranssigill? Nexus Elektroniskt sigill och MAA kan förekomma som avsnittssigill och som leveranssigill. Följande tabell visar vilken av dessa metoder som går att använda för filerna i e-giro anmälningsärende: Anmälningsfil Filtyp Avsnitts-/helfilssigill Avsnitts- eller leveranssigill Viktigt: Vissa moduler för förändringsskydd kan ha begränsningar vad gäller postlängden. Det är därför viktigt att fakturautställaren före produktionsstart bekräftar med sin programleverantör att deras programvara för förändringsskydd fungerar för e-giro anmälningsärende. Filens uppbyggnad vid leveranssigill Vid leveranssigill skapar utställaren en start- och en slutpost för sigillet som omsluter hela leveransen oavsett hur många avsnitt filen innehåller. Startposten med transaktionskod 00 läggs allra först i filen och slutposten med transaktionskod 99, som innehåller ett framräknat kondensat, läggs allra sist. Kondensatet är för båda algoritmerna ett resultat av fyra komponenter algoritmen, regelverket, filen och sigillnyckeln. När BGC tar emot en sigillerad fil görs exakt samma sigillberäkning som skett hos utställaren med samma komponenter. De båda framräknade kondensaten jämförs och ska vara lika för att filen ska godkännas för vidare behandling. I annat fall kontaktas faktura- eller dokumentutställaren av BGC. Beräkning av startpost Vid beräkning av leveransskydd, skapas först 00-posten. Den skickas till förändringsskyddsmodulen med längden 80, samt skrivs först i filen. Övriga poster beräknas på hela postlängden (om posten är exempelvis 250 tecken ska alla 250 beräknas). Postlängd Om kommunikationsarean mellan anropande program och förändringsmodulen är kortare än posten, ska posten delas. Exempel: Om posten är 250 tecken och arean är 100 tecken, skickas först position 1-100 i posten till modulen, sedan position 101-200, båda med längd 100. Därefter skickas de återstående 50 tecknen till modulen, då med längd 50. Postavskiljare sigillberäknas inte. Fortsättning på nästa sida E-giro anmälningsärende teknisk manual 11 (34)
Presentation Kommunikation med BGC, fortsättning Beräkning av slutpost När alla poster beräknats skickas stängningsanrop till modulen, vilket ger kondensatet i retur. Detta läggs i den skapade 99-posten som skrivs sist i filen. KVV-värde MAA använder så kallade KVV-värde (Key Verification Value) för att beräkna sigillnyckeln. KVV-värde beräknas med samma algoritm och samma sigillnyckel som MAC-värdet men alltid på infilen 00000000, det vill säga åtta nollor. Detta ger möjlighet att enkelt kontrollera om utställaren och BGC använder samma sigillnyckel om filen stoppas på grund av missavstämning i kondensat. Sigillnyckel För att kunna sigillera filerna behöver faktura- och dokumentutställaren en sigillnyckel,. Sigillnycklar beställs via banken och sänds till utställaren direkt från BGC. En sigillnyckel kan bara skrivas ut en gång och sigillnyckeln kan inte läsas av BGC:s personal. Skulle utställarens sigillnyckel förkomma, måste därför ny nyckel beställas via banken. Testsigillnyckel Vid test används följande sigillnycklar: Nexus Elektroniskt sigill: 12345 67890 12345 67890 12345 67890 12345-6 MAA: 1234 5678 9012 3456-9 Observera: Sista siffran i sigillnyckeln är endast en checksiffra beräknad enligt 10-modul. Fortsättning på nästa sida E-giro anmälningsärende teknisk manual 12 (34)
Presentation Kommunikation med BGC, fortsättning Ytterligare information Leveranssätt Ytterligare information om leveranssätt och metoder för förändringsskydd finner du i Leveranssätt BgCom Connect:Direct Netview/FTP TCP/IP FTP via X.25 Dokumentets namn Leveransvägledning BgCom Leveransvägledning - Connect:Direct Leveransvägledning Netview/FTP Leveransvägledning TCP/IP FTP Dessa dokument kan du beställa från BGC Programservice. MAA förändringsskydd MAA är en öppen metod för förändringsskydd. Om du önskar information om hur du konstruerar egna moduler för MAA, kontakta BGC Programservice. E-giro anmälningsärende teknisk manual 13 (34)
Presentation Kundtester Inledning För att kunna börja använda e-giro anmälningsärende, måste fakturautställaren genomföra en kundtest. Denna kundtest bygger på att fakturautställaren går igenom tester för de funktioner som denna önskar använda. Syftet med kundtesten är att säkerställa att fakturautställaren kan hantera filformaten som används i e-giro och att de uppgifter som systemet skapar är korrekta. Delmoment i kundtestprocessen När fakturautställaren har tecknat avtal om e-giro med sin bank och beställt en kundtest av sin handläggare på BGC, görs kundtestsystemet tillgängligt för faktura- eller dokumentutställaren. Denna illustration visar de olika stegen i kundtestprocessen: Förberedelser Teckna avtal med banken Utföra kundtest Preparering av kundreskontra Val av kommunikationssätt Anmälningsförfarandet Godkänd anslutning Fastställa anmälningssida Tid Förberedelsemomenten kan genomföras oberoende av varandra. Innan kundtestmomenten kan genomföras, måste alla förberedelser vara genomförda. För att testen ska bli godkänd krävs att varje testmoment är utfört i rätt ordning och att faktura- eller dokumentutställaren använt de testdata som beskrivs i respektive avsnitt. Fortsättning på nästa sida E-giro anmälningsärende teknisk manual 14 (34)
Presentation Kundtester, fortsättning Testfall Kundtesten utgörs av ett antal fördefinierade testfall om avanmälningar, anmälningar vid betalning, anmälningar vid autogiro ska användas. Ska endast anmälningsärendet användas kan fakturautställaren själv definiera sina testfall. BGC skapar anmälningsmallen och de kontroller som önskas på respektive fält. Fakturautställaren ansvarar för att skapa testdata som BGC skickar in i anmälningsärendet. BGC skickar därefter en fil med anmälningarna till fakturautställaren. Fakturautställaren ansvarar sedan för att behandla datat i filen. Fakturautställaren ska inför test förbereda sitt system med några personnummer som ska komma i anmälningsfilen. Fakturatställaren ska också använda testdata där personnummer eller andra obligatoriska uppgifter saknas i fakturautställarens system. Krav för godkänd test När samtliga steg i kundtesten är klara och fakturautställaren blivit godkänd i samtliga testfallen, kontaktas fakturautställaren av en handläggare på BGC och meddelas resultatet. Om ett testfall misslyckas och fakturautställaren får ett annat resultat än det som beskrivs under förväntat resultat, initieras en ny test och man gör om testen eller de testfall som misslyckades. Ytterligare information För ytterligare information om testfall och testförfarande, se handledning för kundtest". E-giro anmälningsärende teknisk manual 15 (34)
Anmälningsärende exempel Inledning Nedan presenteras olika exempel på hur anmälningsärendet kan se ut för en fakturautställare. Exempel 1 Fakturautställaren har valt att använda ett anmälningsärende. Fakturautställaren har beslutat att anmälningsärendet ska innehålla följande information. Anmälningsärendet ska först användas i test. Checklista för anmälningsärendet Fakturautställarensnamn som ska presenteras i internetbanken. Det namn som är kopplat till bankgironumret. Kortnamn. Det namn som presenteras för fakturamottagaren om fakturautställaren har mer än ett anmälningsärende Unik identitet. Den identitet som fakturautställaren bestämmer för att kunna identifiera anmälningsärendet Beskrivning. Ett fritext fält för fakturautställaren. Kan beskriva anmälningsärendet för fakturamottagaren. Länk till hemsida Länk till kundtjänst Övrig länk Test eller produktion. Om registrerade anmälningar ska lagras i test eller produktion. Antal inmatningsfält 2 Telecom Beskrivning Elektronisk faktura befintligt kund 001 Det är viktigt att den som är ansluten till internetbanken är densamma som den person som äger abonnemanget hos Telecom. I annat fall kontakta våran kundtjänst. http://www.telecom.se mailto://support@telecom.se Nej Test Fortsättning på nästa sida E-giro anmälningsärende teknisk manual 16 (34)
För respektive inmatningsfält anges: Checklista per inmatningsfält Beskrivning Inmatningsfältnr 1 Unik identitet EPS Efaktura unik identitet Efaktura kort beskrivning Presentationstext. Fältnamnet som ska E-postadress presenteras mot fakturamottagaren. Min längd 0 Max längd 50 Kontroll Obligatorisk Visa. Ska fältet visas för fakturamottagaren Checklista per inmatningsfält Inmatningsfältnr 2 Unik identitet Efaktura unik identitet Efaktura kort beskrivning Presentationstext. Fältnamnet som ska presenteras mot fakturamottagaren. Min längd 8 Ingen Nej Max längd 10 Kontroll Obligatorisk Visa. Ska fältet visas för fakturamottagaren Ja KNR Kundnummer Numerisk Ja Ja Beskrivning Nedan presenteras hur anmälningsärendet presenteras för fakturamottagaren när denna länkar sig från internetbanken till anmälningsärendet. I detta exemplet sker länkningen från Skandiabanken. Obligatoriskt def. av fältet innebär att övriga kontroller ska vara uppfyllda innan datat accepteras. E-giro anmälningsärende teknisk manual 17 (34)
Bild Två inmatningsfält presenteras. Länk till kundtjänst och hemsida presenteras. E-giro anmälningsärende teknisk manual 18 (34)
Ytterligare information Exempel 010320010328EFA BGC TBGC12345678901SEB SKB 065560169095.000033333333.SEB.SE 001TELECOM 1020010327AN196905145071.SKB.SE 110018EPS clifton@swipnet.se0008knr 03023659END 1020010327AN196103125024.SKB.SE 110014EPS ammi@telia.com 0010KNR 1234567890END 1020010327AN196006055195.SKB.SE 110021EPS thomas.falt@telia.com 0009KNR 234567890END 98000000000000003000000000000000000000000000003 010320010328EFA BGC TBGC22345458901SEB FSPA065560169095.000033333333.SEB.SE 001TELECOM 1020010327AN196806055199.FSPA.SE 110009KNR 234567899END 98000000000000001000000000000000000000000000001 99000000000000001 E-giro anmälningsärende teknisk manual 19 (34)
Exempel 2 Fakturautställaren har valt att använda ett anmälningsärende. Fakturautställaren har beslutat att anmälningsärendet ska innehålla följande information. Anmälningsärendet ska användas först i test. Checklista för anmälningsärendet Fakturautställarensnamn som ska presenteras i internetbanken. Det namn som är kopplat till bankgironumret. Kortnamn. Det namn som presenteras för fakturamottagaren om fakturautställaren har mer än ett anmälningsärende Unik identitet. Den identitet som fakturautställaren bestämmer för att kunna identifiera anmälningsärendet Beskrivning. Ett fritext fält för fakturautställaren. Kan beskriva anmälningsärendet för fakturamottagaren. Länk till hemsida Länk till kundtjänst Övrig länk Test eller produktion. Om registrerade anmälningar ska lagras i test eller produktion. Antal inmatningsfält 3 Telecom Beskrivning Elektronisk faktura befintligt kund 002 Det är viktigt att den som är ansluten till internetbanken är densamma som den person som äger abonnemanget hos Telecom. I annat fall kontakta våran kundtjänst. http://www.telecom.se mailto://support@telecom.se Nej Produktion Fortsättning på nästa sida E-giro anmälningsärende teknisk manual 20 (34)
För respektive inmatningsfält anges: Checklista per inmatningsfält Beskrivning Inmatningsfältnr 1 Unik identitet EPS Efaktura unik identitet Efaktura kort beskrivning Presentationstext. Fältnamnet som ska E-postadress presenteras mot fakturamottagaren. Min längd 0 Max längd 50 Kontroll Obligatorisk Visa. Ska fältet visas för fakturamottagaren Checklista per inmatningsfält Inmatningsfältnr 2 Unik identitet Efaktura unik identitet Efaktura kort beskrivning Presentationstext. Fältnamnet som ska presenteras mot fakturamottagaren. Min längd 8 Ingen Nej Max längd 10 Kontroll Obligatorisk Visa. Ska fältet visas för fakturamottagaren Ja KNR Kundnummer Beskrivning Numerisk och 10-modul Ja Ja Checklista per inmatningsfält Inmatningsfältnr 3 Unik identitet Efaktura unik identitet Efaktura kort beskrivning Presentationstext. Fältnamnet som ska presenteras mot fakturamottagaren. KTN Min längd 10 Kortnummer Kortnummer Beskrivning E-giro anmälningsärende teknisk manual 21 (34)
Checklista per inmatningsfält Max längd 10 Kontroll Numerisk Obligatorisk Ja Visa. Ska fältet visas för fakturamottagaren Ja Beskrivning Nedan presenteras hur anmälningsärendet presenteras för fakturamottagaren när denna länkar sig från internetbanken till anmälningsärendet. I detta exemplet sker länkningen från Skandiabanken. Bild 2.1 Tre inmatningsfält presenteras. Länk till kundtjänst, övrigt och hemsida presenteras. Inamtningsfälten har andra identiteter än inmatningsfälten i exempel 1. Bild 2.2 Fakturamottagaren får kvittera inmatad information innan denna registreras. E-giro anmälningsärende teknisk manual 22 (34)
Ytterligare information Om e-giro anmälningsärende Skriftliga dokument Det finns fem skriftliga dokument om e-giro. De kan beställas från din bank eller laddas ner från e-giros webbplats. Denna tabell beskriver dokumenten: Dokumentets namn Målgrupp Innehåll Välkommen till e-giro anmälningsärende e-giro webbhotell teknisk manual e-giro webbhotell användarmanual e-giro webbhotell handledning för kundtest e-giro anmälningsärende Alla som vill veta mer om e-giro anmälningsärende Systemteknisk personal hos faktura- eller dokumentutställare och programleverantörer Handläggare hos fakturaeller dokumentutställaren De personer hos fakturaeller dokumentutställare som ansvarar för att genomföra kundtest i samband med anslutning till e-giro anmälningsärende Systemteknisk personal hos faktura- eller dokumentutställare och programleverantörer Kort beskrivning av fördelar, avtal och anpassningar som faktura- eller dokumentutställaren behöver göra. Detta dokument. Beskriver tekniska krav på faktura- eller dokumentutställarens ekonomisystem samt innehåller post- och filbeskrivningar Beskriver vad handläggaren hos faktura- eller dokumentutställaren behöver göra för att e-giro anmälningsärende ska fungera Beskriver steg för steg kundtestproceduren. Detta dokument. Beskriver tekniska krav på faktura- eller dokumentutställarens ekonomisystem samt innehåller post- och filbeskrivningar Fortsättning på nästa sida E-giro anmälningsärende teknisk manual 23 (34)
Om e-giro anmälningsärende, Fortsättning På e-giros webbplats, www.e-giro.se hittar du bland annat följande information: Senaste nytt om tjänsten Kontaktpersoner Post- och filbeskrivningar Dokument för nedladdning Internet Leveransvägle dning Vill du ha information om de olika leveranssätten, så finns följande dokumentation tillgängliga: Titel Beställningsnummer Leveransvägledning BgCom BG 2919 Leveransvägledning TCP/IP BG 2876 Leveransvägledning Netview FTP BG 2877 Leveransvägledning Connect:Direct BG 2878 Hänvisning: Du kan beställa dessa trycksaker från Programservice på BGC. E-giro anmälningsärende teknisk manual 24 (34)
Ordlista Ordlista Ord och begrepp i e-giro anmälningsärende Ordlista Här följer en lista över ord och begrepp som används i samband med e-giro anmälningsärende Anmälan Begrepp Förklaring Faktura- eller dokumentmottagaren anmäler sitt intresse att få webbfakturor eller e-dokument från faktura- eller dokumentutställaren. E-giro anmälningsärende teknisk manual 25 (34)
Bilaga 3 Bilaga 1 Post- och filbeskrivning Post- och filbeskrivning - e-giro anmälningsärende Anmälnings och avanmälningsfil i e-giro anmälningsärende Generellt EFA formatet är ett av de format som e-giro erbjuder att skicka fakturamottagares anmälningar och avanmälningar till en fakturautställare. En fil i EFA formatet innehåller en eller flera buntar av anmälningar/avanmälningar. Postlängden är 240 tecken fast blockad vilket innebär att varje post består av exakt 240 tecken. Om innehållet understiger 240 tecken fylls posten automatiskt ut med blanktecken till höger om tecknen. Utställarpost Namn Position Längd Typ Innehåll Posttyp 1-2 2 AN 01 Versionsnummer för EFA-fil 3-4 2 AN 03 Skrivdatum 5-12 8 N ÅÅÅÅMMDD Filtyp 13-16 4 AN EFA Avsändare 17-20 4 AN Den som fysiskt sänder filen t ex BGC Mottagare 21-24 4 AN Används inte Status 25 1 AN P (produktion) eller T (test) Buntidentitet 26-40 15 AN Buntidentitet (unik id för bunt) FUB 41-44 4 AN Buntens FUB, t ex SEB PB 45-48 4 AN Buntens PB, t ex FSPA. Den bank där anmälningarna eller avanmälningarna i bunten är utförda. FUI 49-80 32 AN Identitet på fakturautställaren i e- giro och e-faktura systemet. Består av organisationsnr.löpnr.bank.se t ex 065560169095.00003333333.SEB. SE E-giro anmälningsärende teknisk manual 27 (34)
Bilaga 3 Avdelning * 81-83 3 N Sekvensnummer för anmälningstyp (1..) FUNamn 84-118 35 AN FU:s namn i anmälningsärende Uppgifter markerade med * är ej obligatoriska. Mottagarpost Mottagarpost Namn Position Längd Typ Innehåll Posttyp 1-2 2 AN 10 An-/Avanmälningsdatum 3-10 8 N ÅÅÅÅMMDD Anmälningstyp 11-12 2 AN AN eller AV FMI 13-32 20 AN Id för FM Persnr.BANK.SE Anmälningsradspost Anmälningsradspost Namn Position Längd Typ Innehåll Posttyp 1-2 2 AN 11 Anmälningsinfo 3-240 238 AN Ett antal fältposter, se fältposter Anmälningsposten är i sin tur fyllda av ett antal fältposter som är packade för att fylla ut utrymmet på 240 tecken i varje post. Varje fältpost består av det som beskrivs nedan. Fältposten (11 posten) Typ Längd Kommentar Längd 4 Anger antal tecken för detta textfält Typ 3 Anger typ av textdata, treställig teckenkod Format 1 Anger format för textfält. Kan vara blankt Data n Den text som utför informationen för textfältet Fältposten fyller alltid ut anmälningsradposten helt. Som sista fältpost kommer en fältpost av typen END*, med en längd som är anpassad för att fylla ut den sista anmälningsradposten helt. E-giro anmälningsärende teknisk manual 28 (34)
Bilaga 3 Fältposter för avanmälan (gäller endast om fakturautställaren valt bort standard e-giro formatet) I öppningsposten sätts avdelning (sekvensnummer) till 099 så att fakturautställaren kan känna igen de öppningsposter som avser avanmälan. I 10-posten sätts anmälningstyp till AV. Typ Namn Längd Fälttyp Kommentar BID Bankidentitet 4 N Fakturamottagarens banks numeriska identitet BNR Bankgironummer 10 N Fakturautställarens bankgironummer (avtalsbankgironummer). BET Betalarnummer 16 A Fakturautställarens identitet på fakturamottagaren END* Slutpost Fungerar som utfyllnad för den sista anmälningsradposten Innan END* posten så anges antal tecken som återstår från END* t om 240 tecken. Fältposter för anmälningar utifrån autogiro (gäller endast om fakturautställaren valt bort standard e-giro formatet) I öppningsposten sätts avdelning (sekvensnummer) till 098 så att fakturautställaren kan känna igen de öppningsposter som avser anmälningar utifrån autogiro. I 10-posten sätts anmälningstyp till AN. Typ Namn Längd Fälttyp Kommentar BID Bankidentitet 4 N Fakturamottagarens banks numeriska identitet BNR Bankgironummer 10 N Fakturautställarens bankgironummer (avtalsbankgironummer) BET Betalarnummer 16 A Fakturautställarens identitet på fakturamottagaren END* Slutpost Fungerar som utfyllnad för den sista anmälningsradposten Innan END* posten så anges antal tecken som återstår från END* t om 240 tecken. Fältposter för anmälan vid betalning (gäller endast om fakturautställaren valt bort standard e-giro formatet) I öppningsposten sätts avdelning (sekvensnummer) till 097 så att fakturautställaren kan känna igen de öppningsposter som avser anmälningar utifrån betalning. I 10-posten sätts anmälningstyp till AN. Typ Namn Längd Fälttyp Kommentar BID Bankidentitet 4 N Fakturamottagarens banks numeriska identitet BNR Bankgironummer 10 N Fakturautställarens bankgironummer (avtalsbankgironummer) FFD Förfallodatum 8 A Fakturans förfallodatum, ååååmmdd OCR OCR nummer 25 A Fakturans OCR nummer BEL Belopp 15 N Fakturans belopp, nnnnnnnnnnnnnkk END* Slutpost Fungerar som utfyllnad för den sista anmälningsradposten E-giro anmälningsärende teknisk manual 29 (34)
Bilaga 3 Innan END* posten så anges antal tecken som återstår från END* t om 240 tecken. E-giro anmälningsärende teknisk manual 30 (34)
Bilaga 3 Fältposter för anmälningar som är registrerade via anmälningsärendet I öppningsposten sätts avdelning (sekvensnummer) till det nummer som fakturautställaren har angett i anmälningsärendet, fakturautställarens ID-begrepp. Reserverade nummer är 097-099 och får ej användas av fakturautställaren. Om fakturamottagaren anmäler sig flera gånger för samma anmälningsärende innan anmälan är sänd till fakturautställaren kommer andra anmälan och därefter lagras som en ny 11-post utan en ny 10-post brytning. I 10-posten sätts anmälningstyp till AN. Fakturautställaren kan själv för varje anmälningsärende bestämma vad varje fält ska heta och vilken kontroll som ska ske på fältet. E-giro anmälningsärendet tillhandahåller följande kontroller: - Ingen kontroll - Obligatoriskt fält - Numeriskt värde - 10-modul checksiffra - Min och max längd på datat - Om fältet ska visas för fakturamottagaren. Innan END* posten så anges antal tecken som återstår från END* t om 240 tecken. Nedan visas exempel på typdefinition. Typ Namn Längd Fälttyp Kommentar BID Bankidentitet 4 N Fakturamottagarens banks numeriska identitet. Finns alltid. NMN Namn Sätts utifrån den längd som är def. i anmälningsärendet Namn på fakturamottagaren TLF Telefon Fakturamottagarens telefonnummer EPS E-post Fakturamottagarens e-postadress END* Slutpost Fungerar som utfyllnad för den sista anmälningsradposten. Finns alltid. E-giro anmälningsärende teknisk manual 31 (34)
Bilaga 3 Summeringspost Summeringspost Namn Position Längd Typ Innehåll Posttyp 1-2 2 AN 98 Antal anmälningsposter 3-17 15 N Antalet anmälningar för denna FUI Antal avanmälningsposter 18-32 15 N Antalet avanmälningar för denna FUI Totalt antalet mottagarposter 33-47 15 N Totalt antal av- och anmälningar i FUI Slutpost Slutpost Namn Position Längd Typ Innehåll Posttyp 1-2 2 AN 99 Antal utställare 3-17 15 N Antal utställarposter (01) i denna fil. Buntstruktur/filstruktur EFA 03 01 Öppningspost 10 Mottagarpost 11 Anmälningsradspost 11 Anmälningsradspost 10 Mottagarpost 10 Mottagarpost 98 Summeringspost 01 Öppningspost 10 Mottagarpost 10 Mottagarpost 98 Summeringspost 99 Slutpost E-giro anmälningsärende teknisk manual 32 (34)
Bilaga 3 Exempel på an/avmälningsfil 010320020924EFA BGC PBGC082905002960SEB SEB 005560352287.00001607779.SEB.SE 001TEST FORETAGET 1020020924AN194906272118.FSPA.SE 110004BID 00510007KNR 78103570009TLF 08-6666660012MAILtest@jet.com0167END* 98000000000000001000000000000000000000000000001 010320020924EFA BGC PBGC082905002960SEB SEB 005560352287.00001607779.SEB.SE 097TEST FORETAGET 1020020924AN197007240116.SEB.SE 110004BID 00190010BNR 00016077790008FFD 200209050025OCR 122440505434655 0015BEL 0000000001163000126END * 98000000000000001000000000000000000000000000001 010320020924EFA BGC PBGC082905002960SEB SEB 005560352287.00001607779.SEB.SE 099TEST FORETAGET 1020020924AV197007240124.SEB.SE 110004BID 00190010BNR 00016077790016BET 00001970072401240181END* 98000000000000001000000000000000000000000000001 99000000000000003 E-giro anmälningsärende teknisk manual 33 (34)
Bilaga 3 Tabell för bankförkortningar och bankid Bank Förkortning Bankidentitet SEB SEB 000000019 Handelsbanken SHB 000000027 Östgöta Enskilda Bank OEB 000000035 SkandiaBanken SKB 000000043 Föreningssparbanken FSPA 000000051 Nordea NB 000000078 Sparbanken Finn FINN 000000086 Sparbanken Gripen* GRIP 000000094 Stadshypotek Bank SHYB 000000108 ICA Bank ICA 000000116 Länsfösäkringar Bank LFB 000000124 COOP Bank* COOP 000000132 *Sparbanken Gripen och COOP bank deltar ej ännu i e-giro, 2004-09-20. E-giro anmälningsärende teknisk manual 34 (34)