BSK implementeringsguide e2b-formatet v.3.3

Transkript

1 BSK implementeringsguide e2b-formatet v.3.3 Bankenes felles implementeringsguide basert på versjon 3.3 av e2b Fakturaformat Versjon: april 2012 Bankenes Standardiseringskontor Postboks 2644 Solli 0203 OSLO Tlf E-post:

2 Endringskatalog DATO VER UTFØRT AV ENDRINGER Morten Krøgenes Vedtatt BSK IG for e2b formatet versjon Morten Krøgenes Oppdatering knyttet til formidling av vedlegg Morten Krøgenes Oppdatering knyttet til statens krav i EHF formatet. Merk: Se forøvrig endringslogg sist i dokumentet BSK Bank IG versjon 1_02 av e2bformatet3v3 Side 2 av 63

3 Innholdsfortegnelse 1. Innledning FORUTSETNINGER MÅLGRUPPE FORKLARING TIL TABELLENE Faktura Overordnet beskrivelse av formatet FORRETNINGSDOKUMENTER BRANSJESPESIFIKKE TILLEGG TEKNISKE RETNINGSLINJER UTFYLLING AV BELØPSFELTER BRUK AV KVITTERING DUPLIKATKONTROLL VISNINGSMAL MAPPING KNYTTET TIL EHF FORMATET (REF. STATENS KRAV KNYTTET TIL ELEKTRONISK FAKTURA) Faktura Oppbygging av meldingen NAVNESTANDARD PÅ FAKTURAFIL STRUKTUROVERSIKT UTVEKSLING ( INTERCHANGE) KONVOLUTT ( ENVELOPE) FAKTURAMELDING (INVOICE) FAKTURAHODE (INVOICEHEADER) AKTØRINFORMASJON Supplier Buyer Factoring Andre aktører FAKTURADETALJER FAKTURARABATTER, TILLEGG OG AVGIFTER FAKTURATOTALER Vedlegg 1: Eksempel på fakturafil...49 Vedlegg 2: Tips vedrørende bruk av formatet TIPS TIL BRUK AV FORMATET AKTØRER/ROLLER FELTBRUK KNYTTET TIL REFERANSER SPESIALFELT OG BRANSJELØSNINGER NIVÅER (LEVELS) SAMLEFAKTURA POSTAL OG STREET ADRESS MAPPINGREGLER KNYTTET TIL EHF FORMATET BSK Bank IG versjon 1_02 av e2bformatet3v3 Side 3 av 63

4 1. Innledning Implementasjonsguiden er utarbeidet i regi av BSK. Denne implementasjonsguiden beskriver hvordan e2b versjon 3.3-formatet skal benyttes for formidling av elektronisk faktura i banknettverket. Formatet kan benyttes både for B2B og B2C. Denne dokumentasjonen må ses i sammenheng med bankens brukerdokumentasjon. 1.1 Forutsetninger For å kunne komme i produksjon i banknettverket må følgende forutsetninger være oppfylt 1. Avtale med bank: - både fakturamottaker og fakturautsteder må inngå en tjenesteavtale med sin bank 2. Adressering: - Bankene tilbyr adressering basert på efakturaid og organisasjonsnummer. Fakturautsteder og fakturamottaker er selv ansvarlig for å utveksle adresseinformasjonen med hverandre. 3. Tilpasninger i ERP-systemer: - Adresseringsbegrep (efakturaid / organisasjonsnummer) for både fakturautsteder og fakturamottaker må følge med i fakturafilen. Det kan derfor være nødvendig å gjøre tilpasninger i ERP-systemet. 1.2 Målgruppe Målgruppen for dokumentet er teknisk implementasjonsansvarlig hos fakturautsteder/- mottaker.. BSK Bank IG versjon 1_02 av e2bformatet3v3 Side 4 av 63

5 1.3 Forklaring til tabellene Under er en forklaring til kolonner i tabellene i kapittel 3 og 6. Navn på XML-element refererer til det faktiske tagnavn i XML. Beskrivelse angir regler for utfylling, lovlige verdier mm. Helt først i beskrivelsen finnes den teksten som tidligere var først i feltnavn. (Feltnavn er logisk, forklarende navn på det aktuelle elementet.) Felter i kursiv garanteres ikke levert til fakturamottaker dersom denne benytter annet format enn e2b versjon 3.3. Krav angir om feltet er M = Må være med i meldingen (påkrevd) K = Kan være med i meldingen (valgfritt) A = Utfylling er avhengig av gitte kriterier Repetisjon angir hvor mange ganger feltet skal/kan gjentas. Se nedenfor: 1 Feltet skal brukes, kun en gang 1..3 Feltet skal brukes, minimum en gang, kan også brukes 3 ganger 1..* Feltet skal brukes, minimum en gang, kan også brukes mange ganger 0..1 Feltet kan brukes, maksimalt en gang 0..* Feltet kan brukes mange ganger Type angir den type verdi som skal overføres for det aktuelle elementet i XMLnotasjon. String = Alfanumerisk Integer = Heltall Decimal = Desimaltall Date = Dato (YYYY-MM-DD) Time= Klokkeslett (HH:MM:SS) DateTime = Dato+Klokkeslett (YYYY-MM-DDTHH:MM:SS) Attributter er angitt med BSK Bank IG versjon 1_02 av e2bformatet3v3 Side 5 av 63

6 2. Faktura Overordnet beskrivelse av formatet 2.1 Forretningsdokumenter Implementeringsguiden støtter følgende forretningsdokumenter: Functional Business Document Sending role Receiving role Description Faktura Leverandør Kjøper En faktura er et entydig og omforent salgsdokument som presenterer selgerens/leverandørens krav og dokumenterer kundens rettigheter til å motta produkter og tjenester. Kreditnota Leverandør Kjøper Kreditnota er brukt av Leverandør til å formidle informasjon om tilgodehavende beløp som Kjøper har hos Leverandør. Purring Leverandør Kjøper Purring er brukt av Leverandør til å formidle informasjon om betaling på utestående fordringer ikke har kommet leverandør i hende som beskrevet på faktura. Løsningen åpner opp for at Leverandør også kan sende purring via løsningen. Varsel om inkasso skal sendes via post (formelt krav iht. lovverket). Rentefaktura Leverandør Kjøper Rentefaktura er brukt av Leverandør til å formidle informasjon om utestående fordringer på renter som Leverandør har på Kjøper. Elektronisk faktura Elektronisk faktura er en faktura i en omforent strukturert form som transporteres elektronisk fra fakturautsteder til fakturamottaker og som kan viderebehandles maskinelt hos fakturamottaker. Det er ikke tilstrekkelig at fakturaen er elektronisk» eller maskintilgjengelig. I tillegg må data være strukturert på en slik måte at dokumentet kan «flyte» mellom ulike systemer. Det vil si at en fil (for eksempel i pdf-format eller bildeformat) som er laget på grunnlag av en papirfaktura, ikke normalt vil tilfredsstille definisjonen av elektronisk faktura. State Merknad ved koding av forretningsdokumentene i formatet: Verdien i InvoiceType angir om det er en faktura, kreditnota eller purring. Merk at samme kode for InvoiceType benyttes for Faktura og Purring og at skillet mellom disse er spesifisert Kodingen for purring skal derfor være InvoiceType=380 Purring BSK Bank IG versjon 1_02 av e2bformatet3v3 Side 6 av 63

7 2.2 Bransjespesifikke tillegg Alle fakturaer skal inneholde et minimum av basisinformasjon på hode-, detalj- og sumnivå. I tillegg kan en faktura inneholde informasjon relatert til en spesiell bransje. Dette er informasjon som er nødvendig for å beskrive produktet eller tjenesten som er grunnlaget for faktureringen. Slike bransjespesifikke tillegg kan tas inn på hode- og detaljnivå. For å sikre at strukturen ivaretas i alle typer meldinger, er det etablert følgende prinsipper for å ta inn bransjespesifikke tillegg i formatet: Hvis det bransjespesifikke tillegget inneholder informasjon på mer enn ett nivå (samlefaktura/flerordrefaktura), skal dette legges før basisdetaljene, slik at basisdetaljene representerer et sum-nivå av bransjespesifikke detaljer. Hvis det bransjespesifikke tillegget kun inneholder informasjon på ett nivå, skal dette legges direkte etter basisdetaljene for hver fakturalinje. Bankene garanterer ikke at informasjonen i bransjespesifikke tillegg vil kunne formidles til fakturamottaker. 2.3 Tekniske retningslinjer Karaktersett: Unicode UTF-8 (bankene støtter også ISO ) Datoformat: YYYY-MM-DD Desimaltegn: Punktum 2.4 Utfylling av beløpsfelter Beløp på linjenivå som skal legges til Fakturatotalen skal være positive både for faktura og kreditnota. Beløpet på linjenivå som skal trekkes fra Fakturatotalen skal ha negativt fortegn både på faktura og kreditnota. Mva-beløp og beløp i rabatter, avgifter og tillegg skal være positive Figuren under viser sammenhengen mellom beløpene i meldingen. Det er brukt noe +,- og =. Ellers er summasjon vist med kardinalitet/hierarkiet mellom klassene. Relasjon mange-til-en betyr at mange beløp slås sammen til ett beløp. Den delen av relasjonen som er uten symbol kan gjentas flere ganger og beløpene summeres i klassen hvor relasjonen er merket med. Figuren leses best nedenfra. BSK Bank IG versjon 1_02 av e2bformatet3v3 Side 7 av 63

8 InvoiceDetails LineItemPreDiscountAmount + ChargesAmount - DiscountAmount + TaxAmount = LineItemAmount VatAmount 0..* 0..* 0..* 0..* 1..* ChargesTotals Description Amount 0..1 InvoiceDiscountChargesAndTax InvoiceCharges VatAmount 0..* DiscountTotals 0..1 Description Amount 0..* InvoiveDiscount * InvoiceTax VatAmount VatAmount 0..* 0..* 0..* TaxTotalsInfo Description Amount 0..1 VatTotalsInfo 0..1 VatPercent VatAmount InvoiceSummary 0..1 LineItemTotalsAmount ChargesTotalsAmount DiscountTotalsAmount TaxTotalsAmount VatTotalsAmount * NetAmount 1 1 GrossAmount 0..1 RoundingAmount BSK Bank IG versjon 1_02 av e2bformatet3v3 Side 8 av 63

9 Eksemplet under viser utregning av linjesummer, tillegg/fradrag og fakturatotaler i en e2bfaktura. Linjenivå XML-tag <BaseItemDetails><Description> Vare Product1 <BaseItemDetails><QuantityInvoiced> Antall 5 * <BaseItemDetails><UnitPrice> Enhetspris 2,5 = <BaseItemDetails><LineItemPreDiscountAmount> Total enhetspris 12,5 * <BaseItemDetails><Discount><Percent> Rabattsats 20 % = <BaseItemDetails><Discount><Amount> Rabatt 2,5 - = <BaseItemDetails><TaxInfo><BaseAmount> Total etter rabatt 10 * <BaseItemDetails><TaxInfo><Percent> Miljøavgiftssats 10 % = <BaseItemDetails><TaxInfo><Amount> Miljøavgift 1 + = <BaseItemDetails><VatInfo><VatBaseAmount> Total etter miljøavgift 11 * <BaseItemDetails><VatInfo><VatPercent> Mva-sats 25 % = <BaseItemDetails><VatInfo><VatAmount> Mva 2,75 + = Total etter mva 13,75 Fakturanivå <InvoiceDiscountChargesAndTax><InvoiceCharges> <BaseAmount> Fraktgrunnlag 11 <InvoiceDiscountChargesAndTax><InvoiceCharges><Percent> * Fraktsats 6 % <InvoiceDiscountChargesAndTax><InvoiceCharges><Amount> <InvoiceDiscountChargesAndTax><InvoiceCharges><VatInfo> = <VatBaseAmount> Frakt 0,66 * <InvoiceDiscountChargesAndTax><InvoiceCharges><VatInfo> <VatPercent> Mva-sats 25 % = <InvoiceDiscountChargesAndTax><InvoiceCharges><VatInfo> <VatAmount> Mva 0,17 + = Total etter mva 0,83 Fakturatotaler <InvoiceSummary><InvoiceTotals><LineItemTotalsAmount> Linjesum 11 = <InvoiceSummary><InvoiceTotals><ChargesTotalsAmount> Tillegg 0,66 = <InvoiceSummary><InvoiceTotals><VatTotalsAmount> mva 2,92 + = Sum 14,58 + <InvoiceSummary><InvoiceTotals><RoundingAmount> Avrunding 0,02 = <InvoiceSummary><InvoiceTotals><GrossAmount> Sum etter avrunding 14,60 BSK Bank IG versjon 1_02 av e2bformatet3v3 Side 9 av 63

10 2.5 Bruk av kvittering Bruken av kvitteringer følger i hovedsak den kvittering som er definert i e2b-standarden. Bankens bruk kan avvike og banken må kontaktes for detaljert brukerdokumentasjon. 2.6 Duplikatkontroll Hver enkelt fakturafil blir kontrollert med duplikatkontroll mot tidligere innsendte fakturaer. Følgende elementer kan inngå i duplikatkontrollen: Element XML element Adresse (efakturaid/organisasjonsnummer) Fakturanummer Fakturadato Fakturatype Utsteders organisasjonsnummer InvoiceHeader/Supplier/PartyId InvoiceHeader/InvoiceNumber InvoiceHeader/InvoiceDate InvoiceHeader/InvoiceType InvoiceHeader/Supplier/OrgNumber Merknad: Kombinasjoner av feltene må være unike. Følgende elementer kan oppheve duplikatkontrollen: Element XML element InvoiceStatus InvoiceHeader/InvoiceStatus 2.7 Visningsmal Bankene har utarbeidet en felles visningmal for e2b formatet som brukerne av formatet kan benytte. Kontakt banken for nærmere informasjon. BSK Bank IG versjon 1_02 av e2bformatet3v3 Side 10 av 63

11 2.8 Mapping knyttet til EHF formatet (ref. statens krav knyttet til elektronisk faktura) Statlige organisasjoner vil etter pålegge bruk av EHF formatet for mottak av fakturaer og kreditnotaer ved opprettelse av nye kjøpsavtaler. Dette kan medføre at fakturaer og kreditnotaer fra utstedere som benytter BSK IG for e2b formatet i mange tilfeller vil måtte mappes til EHF formatet. I denne IG n er det lagt inn merknader til de informasjonselementer som det i denne forbindelse vil være knyttet spesielle krav til i EHF formatet. Som en generell regel bør alle felter som er påkrevet i EHF formatet benyttes i e2b formatet. Kontakt banken ved spørsmål. Spesielle mappingregler knyttet til EHF formatet kan også finnes i Vedlegg 2: Tips for bruk av formatet Utstedere må være oppmerksom på følgende knyttet til dokumenttypen Purring : Bankene har inntil videre besluttet å ikke legge opp til automatisk mapping mellom e2b formatet og EHF formatet av dokumenttypen purring. Ved bruk av e2b purring vil denne formidles mot e2b mottakere, mens øvrige mottakere vil motta på annent måte avtalt med den enkelte bankforbindelse. Bakgrunnen for dette er følgende: Det er ikke mulig å mappe en EHF purring til et gyldig dokument i e2b formatet. Ved mapping fra en e2b purring til EHF purring vil informasjon i felter som ikke har et tilsvarende informasjonsfelt i EHF formatet ikke kunne mappes og formidles mot mottaker. Håndtering av purringer håndteres ifm. andre rutiner hos utsteder/mottaker enn fakturaer og kreditnotaer. Sett i lys av at en EHF purring kun henviser til en tidligere faktura, mens en e2b purring kan formidles på samme måte som et betalingskrav, er de forskjellige forutsetningene for generering av en purring i de to formatene en utfordring knyttet til mapping. Eventuell bruk av purring på EHF format og formidling mot EHF mottakere må avtales med den enkelte bank BSK Bank IG versjon 1_02 av e2bformatet3v3 Side 11 av 63

12 3. Faktura Oppbygging av meldingen 3.1 Navnestandard på fakturafil Avtales mellom bank og bankens kunde (fakturautsteder/fakturamottaker). 3.2 Strukturoversikt Fakturaformat (basert på e2b) er bygd opp som vist i figuren under. Innholdet i de fargede modulene inngår i basisformatet og er beskrevet i de påfølgende kapitlene. Innhold i de hvite modulene er tilleggsmoduler som er beskrevet i egne dokumenter. Felter i kursiv garanteres ikke levert til fakturamottaker dersom denne benytter annet format enn e2b versjon 3.3. Følgende notasjon er brukt for å definere krav til utfylling i figuren under: 1 = En forekomst (påkrevd) 1..* = En eller mange forekomster 0..1 = Null eller en forekomst (valgfritt) 0..* = Null eller mange forekomster Bruk av vedlegg er beskrevet i en egen appendiks. BSK Bank IG versjon 1_02 av e2bformatet3v3 Side 12 av 63

13 Utveksling 0..1 Utvekslingshode 0..1 Konvolutt 0..* Meldingshode 1..* 1 Fakturamelding 1 Fakturatotaler 1 Fakturahode 1..* Fakturadetaljer 0..* Fakturatillegg/Rabatter Korthode * 1..* Fritekst Basisdetaljer Forsikringshode * Flerordrefaktura Telecomhode 0..1 Energihode 0..1 Bygghode 0..1 Forsikringsdetaljer Kortdetaljer 0..1 Energidetaljer 0..1 Byggdetaljer * 0..* Telecomdetaljer 0..* 0..* Transportdetaljer Reisedetaljer Fraktdetaljer BSK Bank IG versjon 1_02 av e2bformatet3v3 Side 13 av 63

14 3.3 Utveksling ( interchange) Interchange pakker inn forsendelsen og er kun en tag som markerer start og slutten på filen. (Det er ingen annen elementer knyttet til denne) Bruk av Interchange Header og Message Header er beskrevet i egne dokumenter som kan hentes ned fra da det ikke er identifisert et behov for BSK å beskrive disse spesielt for bruk ifm. bankenes løsning. Henvisning til XML stilark som legges inn i den innleverte filen, for eksempel som en deklarasjon <?xml-stylesheet type= text/xsl href= EHF-faktura NO 5.xslt?> skal følge med til mottaker, Dette gir avsender mulighet til å påvirke hvordan presentasjon av fakturaen blir hos mottaker samt sikrer at avsenders informasjon blir med i mottakers visning. 3.4 Konvolutt ( envelope) Benyttes ikke. (Konvolutt fra fakturautsteder aksepteres, men konvoluttfunksjonalitet benyttes ikke). BSK Bank IG versjon 1_02 av e2bformatet3v3 Side 14 av 63

15 3.5 Fakturamelding (Invoice) Navn på XML-element Beskrivelse Krav Repetisjon Type Invoice M Meldingseier:Fast verdi: e2b M 1 Meldingstype. Fast verdi: Invoice M 1 Versjon. Lovlige verdier: 3.3 M 1 Språkkode (ISO 639 two letter code) MessageNumber MessageTimestamp Meldingsnummer. Unikt nummer som identifiserer meldingen innenfor en utveksling Meldingsdato. Dato og klokkeslett når meldingen er generert. Format: YYYY-MM-DDTHH:MM:SS (Tidsregel Rulebook) M 1 DateTime NumberOfLines Antall detaljlinjer i fakturaen K 0..1 Integer InvoiceContent LineOfBusiness Angir om dette er en Kostnads-, Vare- eller Tjenestefaktura. Lovlige verdier: K, V og T Kode som angir hvilken bransje fakturaen gjelder for: Lovlige verdier: 1=Kort, 2=Reise, 3=Telecom, 4=Transport, 5=Frakt, 6=Forsikring, 7=Energi, 8=Bygg, 9=Generelle Kodebeskrivelse. Valgfri beskrivelse i attributt BSK Bank IG versjon 1_02 av e2bformatet3v3 Side 15 av 63

16 3.6 Fakturahode (Invoiceheader) Navn på XML-element Beskrivelse Krav Repetisjon Type InvoiceHeader Fakturahode M 1 InvoiceType Dokumenttype: Lovlige verdier er: 380 = Faktura 381 = Kreditnota M 1 InvoiceStatus Kodebeskrivelse: Beskrivelse i attributt: For eksempel Faktura (380), Purring (380), Rentefaktura (380), Kreditnota (381). Andre beskrivelser kan benyttes og vil bli videreformidlet. Dersom ikke utfylt, vil denne tilsvare lovlig verdi i InvoiceType Dokumentstatus: Lovlige verdier: 9 = Original 10 = Kopi 53 = Test (mellom fakturautsteder og fakturamottaker i produksjon) Merknad: Ved bruk av kode 10=Kopi eller 53=Test, må banken kontaktes. K 1 String M 1 Kodebeskrivelse: Valgfri beskrivelse i attributt InvoiceNumber InvoiceDate Fakturanummer eller kreditnotanummer Påkrevet element i EHF formatet Fakturadato: Dato for utstedelse av fakturaen Påkrevet element i EHF formatet M 1 String M 1 Date BSK Bank IG versjon 1_02 av e2bformatet3v3 Side 16 av 63

17 Navn på XML-element Beskrivelse Krav Repetisjon Type TaxTreatment Avgiftshåndtering: Foreslåtte verdier: NIL = Nettobeløp på linjenivå, avgift på fakturanivå (Line item net amounts, invoice level tax ) GIL = Bruttobeløp på linjenivå, avgift på fakturanivå (Line item gross amounts, invoice level tax) NLL = Nettobeløp på linjenivå, avgift på linjenivå (Line item net amounts, line level tax) GLL = Bruttobeløp på linjenivå, avgift på linjenivå (Line item gross amounts, line level tax) NON = Ingen avgifter (Tax does not apply to this Kodebeskrivelse: Valgfri beskrivelse i attributt DiscountTreatment Rabatthåndtering: Foreslåtte verdier: UN = Netto enhetspris på linjenivå (Line item unit price, net of discount) UG = Brutto enhetspris på linjenivå (Line item unit price, gross of discount) TN = Netto delsum på linjenivå (Line item amount, net of discount ) TG = Brutto delsum på linjenivå (Line item amount, gross of Kodebeskrivelse: Valgfri beskrivelse i attributt Supplier InvoiceIssuer Buyer Invoicee OrderedBy Leverandør/selger: Den som leverer varen eller tjenesten. Innhold er beskrevet i kapittel 3.7.1, Supplier Fakturautsteder: Kan angis dersom denne er forskjellig fra Leverandør/selger. Kjøper: Den som har bestilt varen eller tjenesten. Innhold er beskrevet i kapittel 3.7.2, Buyer Fakturamottaker: Aktør som skal motta fakturaen. Kan angis dersom denne er forskjellig fra Kjøper. Bestilt av: Dersom innkjøp f.eks gjøres via et kjedekontor. Kan angis dersom denne er forskjellig fra Kjøper. M 1 PartyType (ref. kapittel 3.7.1) K 0..1 PartyType (ref. kapittel 3.7.4) M 1 PartyType (ref. kapittel 3.7.2) K 0..1 PartyType (ref. kapittel 3.7.4) K 0..1 PartyType (ref. kapittel 3.7.4) BSK Bank IG versjon 1_02 av e2bformatet3v3 Side 17 av 63

18 Navn på XML-element Beskrivelse Krav Repetisjon Type DeliveryPart UltimateCustomer ShippedFrom Factoring Levert til: Beskriver aktøren på stedet der varen leveres. Kan angis dersom denne er forskjellig fra Kjøper. Angivelse av leveringsadresse er påkrevet i EHF formatet (gateadresse, postkode, poststed) Sluttmottaker: Beskriver endelig mottaker av varen. Kan angis dersom denne er forskjellig fra Leveringssted eller Kjøper. Skipes fra: Beskriver aktøren på stedet der varen skipes ut fra eller hentes av Kjøperen (hentested). Angis eventuelt i tillegg til Leveringssted og/eller Sluttmottaker. Factoringselskap: Angis dersom Leverandøren benytter et Factoringsselskap for å håndtere betalingstransaksjonen. Innhold er beskrevet i kapittel 3.7.3, Factoring K 0..1 PartyType (ref. kapittel 3.7.4) K 0..1 PartyType (ref. kapittel 3.7.4) K 0..1 PartyType (ref. kapittel 3.7.4) K 0..1 PartyType (ref. kapittel 3.7.3) InvoiceReferences Referanser K 0..1 InvoiceReferences Type BuyersOrderNumber BuyersOrderDate Bestillingsnummer: Referanse til kjøperens bestillings-/ordrenummer. Obligatorisk i de tilfeller bestilling er elektronisk (brukes til bl.a matching). Feltet anbefales brukt. Anbefalt element i EHF formatet. Bestillingsdato: Referanse til kjøperens bestillingsdato. Obligatorisk ved matching. Feltet anbefales brukt. K 0..1 Date BuyersProjectCode Prosjektreferanse: Referanse til prosjekt hos kjøperen InvoiceNumber Fakturanummer: Referanse til opprinnelig faktura ved kreditnota Påkrevet element i EHF formatet ved kreditnotaer og purring SuppliersOrderNumber Leverandørs ordrenummer: Referanse til leverandøres ordrenummer. DeliveryTerms Leveringsbetingelser: Fritekst DeliveryTermsCode Kode for leveringsbetingelser: For eksempel referanse til INCOTERMkode for de som benytter det. DeliveryTermsPlace Leveringssted: Knyttet til leveringsbetingelser DeliveryNoteNum Pakkseddelnummer: Ref. til pakseddelnummer BSK Bank IG versjon 1_02 av e2bformatet3v3 Side 18 av 63

19 Navn på XML-element Beskrivelse Krav Repetisjon Type DeliveryDate Leveringsdato: Dato for leveranse, ref. pakkseddelnummer Påkrevet element i EHF formatet K 0..1 Date Payment Betalingsinformasjon: Må forekomme en gang M 1 PaymentType DueDate Forfallsdato: Dato fakturaen forfaller til betaling Påkrevet element i EHF formatet Currency Valutakode: ISO Alpha kode (3 tegn) ISO 4217 KidNumber Påkrevet element i EHF formatet KID-nummer Anbefalt element i EHF formatet K 0..1 Date M 1 String PaymentTerms Betalingsbetingelser: Fritekst PaymentDiscount Kontantrabatt: Null eller mange forekomster K 0..* DiscountPercent Rabattprosent: M 1 Decimal DiscountDays Antall dager rabatten gjelder fra K 0..1 Decimal OverDuePercent Morarente i prosent K 0..1 Decimal Attachments Ref Vedlegg: Referanse til fil med vedlegg som for eksempel bildefil eller billetter. Kan være flere forekomster. Se egen appendiks. Referanse: Generelt referansefelt med kode. Null eller mange forekomster. K 0..* String K 0..* RefWithCodeType Code Kode som angir type referanse. M 1 String Text Selve referanseverdien FreeText Fritekst: Til generell informasjon som ikke kan legges i andre felter. Kan være flere forekomster. K 0..* String CardHeaderInformation Kortinformasjon. Bransjespesifikt tillegg for kredittkortfakturaer. K 0..1 CardHeaderInfo Type BSK Bank IG versjon 1_02 av e2bformatet3v3 Side 19 av 63

20 Navn på XML-element Beskrivelse Krav Repetisjon Type InsuranceHeader Forsikringsinformasjon. Bransjespesifikt tillegg for fakturaer relatert til forsikringsoppgjør. K 0..1 InsuranceHeader Type TelecomHeader Telecominformasjon. Bransjespesifikt tillegg for telecomfakturaer. K 0..1 TelecomHeader Type EnergyHeader BuildingHeader Energiinformasjon. Bransjespesifikt tillegg for energifakturaer (strøm og nettleie). Innhold er beskrevet i eget dokument. Bygginformasjon. Bransjespesifikt tillegg for fakturaer innen bygg, elektro og VA/VVS. K 0..1 EnergyHeader Type K 0..1 BuildingHeader Type BSK Bank IG versjon 1_02 av e2bformatet3v3 Side 20 av 63

21 3.7 Aktørinformasjon Supplier Navn på XML-element Beskrivelse Krav Repetisjon Type PartyType Aktørinformasjon M 1 PartyId Aktørnummer: Unik identifikator Her legges enten: M 1 IdentifierType efakturaid (bygges opp som BIC og IBAN med bindestrek i mellom) Eksempel: XXXXXXXXXXX-NOXX eller Organisasjonsnummer (organisasjonsnummer skal ikke inneholde bindestrek eller mellomrom): Eksempel: NO eller Identifikasjon på identifikator Dersom efakturaid benyttes i PartyId, skal efakturaid benyttes. Dersom organisasjonsnummer benyttes i PartyId, skal NO:ORGNR (dersom NO er inkludert i PartyId) eller ORGNR (dersom kun organisasjonsnummer på 9 siffer er spesifisert i PartyId) Navn på identifikator Dersom efakturaid benyttes i PartyId, skal efakturaid benyttes. Dersom organisasjonsnummer benyttes i PartyId, skal Organisasjonsnummer benyttes. M 1 String M 1 String BSK Bank IG versjon 1_02 av e2bformatet3v3 Side 21 av 63

22 Navn på XML-element Beskrivelse Krav Repetisjon LocationId Name Dersom efakturaid benyttes i PartyId, skal verdien på bankens BIC som har utstedt efakturaid benyttes Dersom organisasjonsnummer benyttes i PartyId, skal teksten Enhetsregisteret ved Bronnoysundregisterne benyttes Lokasjonsnummer: For eksempel GLN (tidligere EANlokasjonsnummer). M 1 String K 0..1 Identifikasjon på identifikator, for eksempel Navn på identifikator, for eksempel Global Localisation Navn på organisasjon som administrerer identifikatoren, for eksempel GS1 Aktørnavn: Navn på selskap Påkrevet element i EHF formatet M 1 String ContactInformation Kontaktinformasjon for bedriften K 0..1 ContactInformation Type PhoneNumber Telefonnummer: Bedriftens telefonnummer FaxNumber Telefaksnummer: Bedriftens telefaksnummer Address E-postadresse: Bedriftens e-postadresse WebAddress Webadresse: Bedriftens webadresse StreetAddress Gateadresse: Null eller en forekomst K 0..1 AddressType Address1 Gate-/besøksadresse 1 Address2 Gate-/besøksadresse 2 Address3 Gate-/besøksadresse 3 PostalCode Postnummer knyttet til gateadresse PostalDistrict Poststed knyttet til gateadresse CountryCode Landkode: 2 karakters kode i henhold til ISO 3166 CountryName Navn på land Ihht. Kode BSK Bank IG versjon 1_02 av e2bformatet3v3 Side 22 av 63

23 Navn på XML-element Beskrivelse Krav Repetisjon Type PostalAddress Address1 Postadresse 1 Address2 Postadresse 2 Postadresse: Null eller en forekomst Postadresse må være med dersom faktura skal til formidles i EHF formatet Påkrevet element i EHF formatet Påkrevet element i EHF formatet K 0..1 AddressType Address3 Postadresse 3 PostalCode PostalDistrict Postnummer knyttet til postadresse Påkrevet element i EHF formatet Poststed knyttet til postadresse Påkrevet element i EHF formatet CountryCode Landkode: 2-karakters kode i henhold til ISO Påkrevet element i EHF formatet CountryName Navn på land Ihht. Kode ContactPerson Kontaktperson: Null eller mange forekomster K 0..* ContactPersonType Name Navn på kontaktperson: Anbefalt format: Etternavn, Fornavn Mellomnavn Anbefalt element i EHF formatet M 1 String FirstName Fornavn til kontaktperson: Anbefalt format: Fornavn Mellomnavn LastName Etternavn til kontaktperson: Function Funksjon til kontaktperson: Stilling, rolle Department Avdeling til kontaktperson. ContactInformation Kontaktinformasjon for kontaktperson K 0..1 ContactInformation Type PhoneNumber Telefonnummer til kontaktperson FaxNumber Telefaksnummer til kontaktperson BSK Bank IG versjon 1_02 av e2bformatet3v3 Side 23 av 63

24 Navn på XML-element Beskrivelse Krav Repetisjon Type Address E-postadresse til kontaktperson WebAddress Web-adresse til kontaktperson OrgNumber Organisasjonsnummer: Påkrevd for leverandør. Eksempel: eller NO M 1 String VatId Merk at dette blir vist på faktura. Påkrevet element i EHF formatet Regel: Organisasjonsnummer fra EHF skal alltid mappes til OrgNumber. Mva-nummer (14 karakterer): Påkrevd ved fakturering med mva. Eksempel: MVA eller NO MVA (ikke krav med NO foran) Regel: Dersom MVA nummer er oppgitt i EHF formatet, må dette også legges inn i VatID) Department Avdeling: Avdeling innen selskap AccountInformation AccountNumber IbanNumber Kontoinformasjon: Informasjon om konti for nasjonal og internasjonal betaling Bankkontonummer: Bedriftens kontonummer Merk! Skal ikke benyttes dersom Factoring benyttes. Påkrevet element i EHF formatet dersom benyttet på dette nivå Ibannummer: For internasjonal betaling Påkrevet element i EHF formatet dersom IBAN er oppgitt K 0..1 AccountInformation Type SwiftNumber Swiftnummer: For internasjonal betaling ProjectRef Prosjektreferanse: Hos aktuelle aktør ContractNumber Ref Kontraktnummer Her legges kontraktsnummer mellom selger og kjøper som faktura er knyttet til. Anbefalt element i EHF formatet Generelt referansefelt med kode. Null eller mange forekomster K 0..* RefWithCodeType BSK Bank IG versjon 1_02 av e2bformatet3v3 Side 24 av 63

25 Navn på XML-element Beskrivelse Krav Repetisjon Type Code Kode: Kode som angir type referanse. M 0..1 String Text Referansenummer: Selve referansenummeret BSK Bank IG versjon 1_02 av e2bformatet3v3 Side 25 av 63

26 3.7.2 Buyer Navn på XML-element Beskrivelse Krav Repetisjon Type PartyType Aktørinformasjon M 1 PartyId Aktørnummer: Unik identifikator M 1 IdentifierType B2B (mellom bedrifter): Her legges enten efakturaid (bygges opp som BIC og IBAN med bindestrek i mellom) Eksempel: XXXXXXXXXXX-NOXX eller Organisasjonsnummer (organisasjonsnummer skal ikke inneholde bindestrek eller mellomrom): Eksempel: NO eller (anbefalt) Andre verdier kan avtales mellom fakturautsteder og dennes bank B2C (mot person): Her legges efakturareferansen. BSK Bank IG versjon 1_02 av e2bformatet3v3 Side 26 av 63

27 Navn på XML-element Beskrivelse Krav Repetisjon Identifikasjon på identifikator B2B: enten efakturaid, NO:ORGNR (dersom NO er inkludert i PartyId) eller ORGNR (dersom kun organisasjonsnummer på 9 siffer er spesifisert i PartyId) M 1 String B2C: Andre verdier: Avtales mellom fakturautsteder og dennes bank. Navn på identifikator B2B: efakturaid eller Organisasjonsnummer B2C: efakturaref M 1 Andre verdier: Avtales mellom fakturautsteder og dennes bank.. B2B: Mottakerbanks BIC eller Enhetsregisteret ved Bronnoysundregisterne B2C: Verdien BBS benyttes. M 1 String LocationId Name Andre verdier: Avtales mellom fakturautsteder og dennes bank.. Lokasjonsnummer: For eksempel GLN (tidligere EANlokasjonsnummer). Anbefalt element i EHF formatet K 0..1 Identifikasjon på identifikator, for eksempel Navn på identifikator, for eksempel Global Localisation navn på organisasjon som administrerer identifikatoren, for eksempel GS1 Aktør navn: Navn på selskap Påkrevet element i EHF formatet M 1 String BSK Bank IG versjon 1_02 av e2bformatet3v3 Side 27 av 63

28 Navn på XML-element Beskrivelse Krav Repetisjon Type ContactInformation Kontaktinformasjon for bedriften K 0..1 ContactInformation Type PhoneNumber Telefonnummer: Bedriftens telefonnummer FaxNumber Telefaksnummer: Bedriftens telefaksnummer Address E-postadresse: Bedriftens e-postadresse WebAddress Webadresse: Bedriftens webadresse StreetAddress Gateadresse: Null eller en forekomst K 0..1 AddressType Address1 Gate-/besøksadresse 1 Address2 Gate-/besøksadresse 2 Address3 Gate-/besøksadresse 3 PostalCode Postnummer knyttet til gateadresse PostalDistrict Poststed knyttet til gateadresse CountryCode Landkode: 2 karakters kode i henhold til ISO 3166 CountryName Navn på land ihht. Kode PostalAddress Postadresse: Null eller en forekomst K 0..1 AddressType Address1 Postadresse 1 Påkrevet element i EHF formatet Address2 Postadresse 2 Påkrevet element i EHF formatet Address3 Postadresse 3 PostalCode PostalDistrict Postnummer knyttet til postadresse Påkrevet element i EHF formatet Poststed knyttet til postadresse Påkrevet element i EHF formatet CountryCode Landkode: 2-karakters kode i henhold til ISO 3166 Påkrevet element i EHF formatet CountryName Navn på land ihht. Kode BSK Bank IG versjon 1_02 av e2bformatet3v3 Side 28 av 63

29 Navn på XML-element Beskrivelse Krav Repetisjon Type ContactPerson Kontaktperson: Null eller mange forekomster K 0..* ContactPersonType Name Navn på kontaktperson: Anbefalt format: Etternavn, Fornavn Mellomnavn Påkrevet element i EHF formatet (Deres Ref) M 1 String FirstName Fornavn til kontaktperson: Anbefalt format: Fornavn Mellomnavn LastName Etternavn til kontaktperson: Function Funksjon til kontaktperson: Stilling, rolle Department Avdeling til kontaktperson. ContactInformation Kontaktinformasjon for kontaktperson K 0..1 ContactInformation Type OrgNumber PhoneNumber Telefonnummer til kontaktperson FaxNumber Telefaksnummer til kontaktpersons Address E-postadresse til kontaktperson WebAddress Webadresse til kontaktperson Organisasjonsnummer: Feltet anbefales brukt. Eksempel: eller NO VatId Merk at dette blir vist på faktura. Påkrevet element i EHF formatet Regel: Organisasjonsnummer fra EHF skal alltid mappes til OrgNumber. Mva-nummer (14 karakterer): Påkrevd ved fakturering med mva. Eksempel: MVA eller NO MVA (ikke krav med NO foran) Regel: Dersom MVA nummer er oppgitt i EHF formatet, må dette også legges inn i VatID) Department Avdeling: Avdeling innen selskap AccountInformation Kontoinformasjon: Informasjon om konti for nasjonal og internasjonal betaling K 0..1 AccountInformation Type AccountNumber Bankkontonummer: Bedriftens kontonummer BSK Bank IG versjon 1_02 av e2bformatet3v3 Side 29 av 63

30 Navn på XML-element Beskrivelse Krav Repetisjon Type IbanNumber Ibannummer: For internasjonal betaling SwiftNumber Swiftnummer: For internasjonal betaling ProjectRef Prosjektreferanse: Hos aktuelle aktør ContractNumber Ref Code Text Kontraktnummer Merknad: Kontraktsnummer mellom kjøper og selger som faktura er knyttet til skal legges under Supplier og ikke under Buyer Generelt referansefelt med kode. Null eller mange forekomster Kode: Kode som angir type referanse. For eksempel Kundenummer: CustomerNumber Referansenummer: Selve referansenummeret For eksempel Kundenummer legges her. K 0..* RefWithCodeType M 1 String Factoring Navn på XML-element Beskrivelse Krav Repetisjon Type PartyType Aktørinformasjon K 0..1 PartyId Aktørnummer: Unik identifikator Factoringsselskapets Idnummer på utsteder. K 0..1 Identifikasjon på identifikator, for eksempel Navn på identifikator, for eksempel leverandørs LocationId Navn på organisasjon som administrerer identifikatoren, for eksempel aktuell leverandør Lokasjonsnummer: For eksempel GLN (tidligere EANlokasjonsnummer). K 0..1 Identifikasjon på identifikator, for eksempel GLN BSK Bank IG versjon 1_02 av e2bformatet3v3 Side 30 av 63

31 Navn på XML-element Beskrivelse Krav Repetisjon Navn på identifikator, for eksempel Global Localisation navn på organisasjon som administrerer identifikatoren, for eksempel GS1 Name Aktørnavn: Navn på selskap M 1 String ContactInformation Kontaktinformasjon for bedriften K 0..1 ContactInformation Type PhoneNumber Telefonnummer: Bedriftens Telefonnummer FaxNumber Telefaksnummer: Bedriftens Telefaksnummer Address E-postadresse: Bedriftens e-postadresse WebAddress Webadresse: Bedriftens webadresse StreetAddress Gateadresse: Null eller en forekomst K 0..1 AddressType Address1 Gate-/besøksadresse 1 Address2 Gate-/besøksadresse 2 Address3 Gate-/besøksadresse 3 PostalCode Postnummer knyttet til gateadresse PostalDistrict Poststed knyttet til gateadresse CountryCode Landkode: 2-karakters kode i henhold til ISO 3166 CountryName Navn på land ihht. Kode PostalAddress Postadresse: Null eller en forekomst K 0..1 AddressType Address1 Postadresse 1 Address2 Postadresse 2 Address3 Postadresse 3 PostalCode Postnummer knyttet til postadresse PostalDistrict Poststed knyttet til postadresse CountryCode Landkode: 2 karakters kode i henhold til ISO 3166 CountryName Navn på land ihht. Kode BSK Bank IG versjon 1_02 av e2bformatet3v3 Side 31 av 63

32 Navn på XML-element Beskrivelse Krav Repetisjon Type ContactPerson Kontaktperson: Null eller mange forekomster K 0..* ContactPersonType Name Navn på kontaktperson: Anbefalt format: Etternavn, Fornavn Mellomnavn M 1 String FirstName Fornavn til kontaktperson: Anbefalt format: Fornavn Mellomnavn LastName Etternavn til kontaktperson: Function Funksjon til kontaktperson: Stilling, rolle Department Avdeling til kontaktperson. ContactInformation Kontaktinformasjon for kontaktperson K 0..1 ContactInformation Type OrgNumber VatId PhoneNumber Telefonnummer til kontaktperson FaxNumber Telefaksnummer til kontaktpersons Address E-postadresse til kontaktperson WebAddress Webadresse til kontaktperson Organisasjonsnummer: Påkrevd for Leverandør (9 siffer). Feltet anbefales brukt. Mva-nummer: Påkrevd ved fakturering med mva (14 karakterer). Feltet anbefales brukt. Department Avdeling: Avdeling innen selskap AccountInformation Kontoinformasjon: Informasjon om konti for nasjonal og internasjonal betaling K 0..1 AccountInformation Type AccountNumber Bankkontonummer: Factoringselskapets kontonummer IbanNumber Ibannummer: For internasjonal betaling SwiftNumber Swiftnummer: For internasjonal betaling ProjectRef Prosjektreferanse: Hos aktuelle aktør ContractNumber Kontraktnummer Ref Generelt referansefelt med kode. Null eller mange forekomster K 0..* RefWithCodeType BSK Bank IG versjon 1_02 av e2bformatet3v3 Side 32 av 63

33 Navn på XML-element Beskrivelse Krav Repetisjon Type Code Kode: Kode som angir type referanse. M 0..1 String Her benyttes: AssignedClaused Text Notifikasjonstekst BSK Bank IG versjon 1_02 av e2bformatet3v3 Side 33 av 63

34 3.7.4 Andre aktører Omfatter informasjon som gjelder InvoiceIssuer, Invoicee, DeliveryPart, OrderedBy, UltimateCustomer, ShippedFrom Navn på XML-element Beskrivelse Krav Repetisjon Type PartyType Aktørinformasjon K 0..1 PartyId Aktørnummer: Unik identifikator K 0..1 Identifikasjon på identifikator, for eksempel Navn på identifikator, for eksempel leverandørs LocationId Navn på organisasjon som administrerer identifikatoren, for eksempel aktuell leverandør Lokasjonsnummer: For eksempel GLN (tidligere EANlokasjonsnummer). K 0..1 Identifikasjon på identifikator, for eksempel Navn på identifikator, for eksempel Global Localisation navn på organisasjon som administrerer identifikatoren, for eksempel GS1 Name Aktørnavn: Navn på selskap M 1 String ContactInformation Kontaktinformasjon for bedriften K 0..1 ContactInformation Type PhoneNumber Telefonnummer: Bedriftens Telefonnummer FaxNumber Telefaksnummer: Bedriftens Telefaksnummer Address E-postadresse: Bedriftens E-postadresse WebAddress Webadresse: Bedriftens webadresse StreetAddress Gateadresse: Null eller en forekomst K 0..1 AddressType Address1 Gate-/besøksadresse 1 Address2 Gate-/besøksadresse 2 Address3 Gate-/besøksadresse 3 PostalCode Postnummer knyttet til gateadresse PostalDistrict Poststed knyttet til gateadresse BSK Bank IG versjon 1_02 av e2bformatet3v3 Side 34 av 63

35 Navn på XML-element Beskrivelse Krav Repetisjon Type CountryCode Landkode: 2 karakters kode i henhold til ISO 3166 CountryName Navn på land ihht. Kode PostalAddress Postadresse: Null eller en forekomst K 0..1 AddressType Address1 Postadresse 1 Address2 Postadresse 2 Address3 Postadresse 3 PostalCode Postnummer knyttet til postadresse PostalDistrict Poststed knyttet til postadresse CountryCode Landkode: 2 karakters kode i henhold til ISO 3166 CountryName Navn på land ihht. Kode ContactPerson Kontaktperson: Null eller mange forekomster K 0..* ContactPersonType Name Navn på kontaktperson: Anbefalt format: Etternavn, Fornavn Mellomnavn M 1 String FirstName Fornavn til kontaktperson: Anbefalt format: Fornavn Mellomnavn LastName Etternavn til kontaktperson: Function Funksjon til kontaktperson: Stilling, rolle Department Avdeling til kontaktperson. ContactInformation Kontaktinformasjon for kontaktperson K 0..1 ContactInformation Type OrgNumber VatId PhoneNumber Telefonnummer til kontaktperson FaxNumber Telefaksnummer til kontaktpersons Address E-postadresse til kontaktperson WebAddress Webadresse til kontaktperson Organisasjonsnummer: Påkrevd for Leverandør (9 siffer). Feltet anbefales brukt. Mva-nummer: Påkrevd ved fakturering med mva (14 karakterer). Feltet anbefales brukt. BSK Bank IG versjon 1_02 av e2bformatet3v3 Side 35 av 63

36 Navn på XML-element Beskrivelse Krav Repetisjon Type Department Avdeling: Avdeling innen selskap AccountInformation Kontoinformasjon: Informasjon om konti for nasjonal og internasjonal betaling K 0..1 AccountInformation Type AccountNumber Bankkontonummer: Bedriftens kontonummer IbanNumber Ibannummer: For internasjonal betaling SwiftNumber Swiftnummer: For internasjonal betaling ProjectRef Prosjektreferanse: Hos aktuelle aktør ContractNumber Kontraktnummer Ref Generelt referansefelt med kode. Null eller mange forekomster K 0..* RefWithCodeType Code Kode: Kode som angir type referanse. M 0..1 String Text Referansenummer: Selve referansenummeret BSK Bank IG versjon 1_02 av e2bformatet3v3 Side 36 av 63

37 3.8 Fakturadetaljer Fakturadetaljer kan inneholde Fritekst som er en tekstlig beskrivelse/spesifikasjon av en fakturalinje. Basisdetaljer er en generell fakturalinje som inneholder tilstrekkelig informasjon for de fleste bransjer og anvendelser. Dette er detaljer som skal importeres av de fleste fakturamottakerne. Det er derfor viktig at dette informasjonselementet er plassert på samme sted i meldingsstrukturen uavhengig av hvordan meldingen for øvrig er bygget opp. Til basisdetaljene kan det knyttes bransjespesifikke tillegg etter behov. For å sikre at basisdetaljer er plassert på samme sted i meldingen uavhengig av meldingens øvrige struktur, er det laget noen regler for plassering av bransjespesifikke tillegg (se også kapittel 2.2): Bransjespesifikke tillegg som har en flerordrestruktur eller består av informasjon på flere nivåer plasseres før basisdetaljene Bransjespesifikke tillegg som består av informasjon på ett nivå plasseres etter basisdetaljene Navn på XML-element Beskrivelse Krav Repetisj on Type InvoiceDetails Fakturadetaljer M 1..* FreeText Fritekst: Null eller mange forekomster K 0..* String BaseItemDetails Basisdetaljer: En eller mange forekomster M 1..* BaseItemDetailsType SubInvoice Flerordre: Generell flerordre-struktur på linjenivå K 0..1 SubInvoiceType Header Fakturahode: Standard e2b hodeinformasjon. M 1 HeaderType Details Basisdetaljer: Standard e2b basisdetaljer. En eller mange forekomster. M 1..* DetailsType TravelDetails Reisedetaljer. Bransjespesifikt tillegg for reisefakturaer. K 0..1 TravelDetailsType TelecomDetails Telecomdetaljer. Bransjespesifikt tillegg for telecomfakturaer. K 0..1 TelecomDetailsType TransportDetails Transportdetaljer. Bransjespesifikt tillegg for transportfakturaer. K 0..1 TransportDetailsType CarrierDetails Fraktdetaljer. Bransjespesifikt tillegg for fraktfakturaer. K 0..1 CarrierDetailsType LineItemNum Linjenummer på faktura. Fortløpende fra fakturautsteder Påkrevet element i EHF formatet BSK Bank IG versjon 1_02 av e2bformatet3v3 Side 37 av 63

38 Navn på XML-element Beskrivelse Krav Repetisj on Type Level SuppliersProductId Description Angir nivå i fakturaen og kan benyttes til aggregering/samlefakturering Heltall benyttes: 1 er øverste, 2 neste, osv. For nærmere beskrivelse se vedlegg 2 kap 1.4 Leverandørs artikkel-/produkt-/tjenestenummer Anbefalt element i EHF formatet Beskrivelse av artikkel/produkt/tjeneste Påkrevet element i EHF formatet M 1 String BuyersProductId Kjøperens artikkel-/produkt-/tjenestenummer AdditionalProductId Ekstra produktidentifikasjon: Null eller mange forekomster K 0..* AdditionalProductIdType Code F.eks: EPD, GTIN (tidligere EAN-artikkelnummer), NOBB M 1 String Text ProduktId: Faktisk verdi. UnitPrice Enhetspris Påkrevet element i EHF formatet K 0..1 Decimal PriceDenomination Prisbeskrivelse. Angis dersom pris oppgis i enhet forskjellig fra beløp. PriceType Pristype. Lovlige verdier er: AAA (Nettopris med rabatt/gebyr) AAB (Bruttopris uten Kodebeskrivelse: Valgfri beskrivelse i attributt PerQuantity Pris pr.: Kvantum som enhetspris gjelder for K 0..1 Decimal LineItemPreDiscount Amount Linjebeløp før gebyr/rabatt: Linjebeløp før gebyr/rabatt K 0..1 Decimal PrePaidAmount Forhåndsbetalt beløp: For eksempel akonto-beløp K 0..1 Decimal CommissionAmount Provisjonsbeløp: Provisjonsbeløp for eksempel ved bruk av reisebyrå K 0..1 Decimal BSK Bank IG versjon 1_02 av e2bformatet3v3 Side 38 av 63

39 Navn på XML-element Beskrivelse Krav Repetisj on Type LineItemAmount LineItemGrossAmount QuantityInvoiced Linjebeløp uten mva inkludert eventuelle gebyrer/rabatter. Må fylles ut dersom LineItemGrossAmount ikke er utfylt. Påkrevet element i EHF formatet Linjebeløp inkludert mva og eventuelle gebyrer/rabatter. Må fylles ut dersom LineItemAmount ikke er utfylt. Fakturert kvantum Påkrevet element i EHF formatet UnitOfMeasure Enhet i henhold til ISO standard 31 ExchangeInformation UNECE Recommendation No.20 er en utvidet tabell som inneholder enhetsverdiene i ISO standard 31. Det anbefales at Recommendation No. 20 legges til grunn ved mapping fra EHF formatet til e2b formatet. Se vedlegg 1 (1.7.4) Anbefalt element i EHF formatet (DIFI har utarbeidet en mappingtball over de vanligste enhetskodene). Vekslingsinformasjon: Informasjon om beløp i annen valuta. Null eller en forekomst A 1 Decimal A 1 Decimal K 0..1 Decimal Currency Valutakode: ISO Alpha kode (3 tegn) ISO 4217 M 1 String K 0..1 ExchangeInformationType ForeignAmount Beløp i annen valuta: For eksempel kortbruk i annen valuta M 1 Decimal ExchangeRate Vekslingskurs: Kurs som benyttes ved omregning til NOK K 0..1 Decimal ExchangeDate Vekslingsdato: Dato for vekslingskurs K 0..1 Date OrderInformation Bestillingsinformasjon: Informasjon om kjøperens bestilling. Null eller en forekomst UnitOfMeasure Bestillingsenhet: Dersom denne avviker fra fakturert enhet K 0..1 OrderAndDeliveryInfoType UnitPrice Enhetspris i bestillingen: I forhold til bestilt enhet K 0..1 Decimal PriceType Pristype: I forhold til bestilt enhet Quantity Bestilt kvantum: I forhold til bestilt enhet K 0..1 Decimal LineNum Bestillingslinjenummer: Referanse til bestillingens linjenummer Anbefalt element i EHF formatet BSK Bank IG versjon 1_02 av e2bformatet3v3 Side 39 av 63

40 Navn på XML-element Beskrivelse Krav Repetisj on Type DeliveryInformation Leveringsinformasjon: Informasjon om leveransen. Null eller en forekomst UnitOfMeasure Leveringsenhet: Dersom denne avviker fra fakturert enhet K 0..1 OrderAndDeliveryInfoType UnitPrice Enhetspris i leveransen: I forhold til levert enhet K 0..1 Decimal PriceType Pristype: I forhold til levert enhet Quantity Levert kvantum: I forhold til levert enhet K 0..1 Decimal LineNum Pakkseddellinjenummer: Referanse til linjenummer på pakkseddel SuppliersOrderInformati on Leverandørordreinformasjon: Informasjon om leverandørs interne ordre. Null eller en forekomst UnitOfMeasure Enhet: Dersom denne avviker fra fakturert enhet K 0..1 OrderAndDeliveryInfoType UnitPrice Enhetspris i ordren: I forhold til enhet i leverandørs ordre K 0..1 Decimal PriceType Pristype:I forhold til enhet i leverandørs ordre Quantity Kvantum: I forhold til enhet i leverandørs ordre K 0..1 Decimal LineNum Ordrelinjenummer: Referanse til linjenummer i leverandørs ordre VatInfo Mva-informasjon: Mva som beregnes på linjebeløpet. Null eller mange forekomster VatPercent eller VatBaseAmount kan ikke oppgis alene K 0..* VatInfoType VatPercent Mva-prosent: For eksempel 25 K 0..1 Decimal Påkrevet element i EHF formatet VatBaseAmount Mva-grunnlag: Grunnlag for mva-beregningen for den aktuelle satsen K 0..1 Decimal VatAmount Mva-beløp: Beløp for den aktuelle satsen K 0..1 Decimal TaxInfo Avgifter på linjenivå utenom mva. K 0..* DiscountChargesAndTaxType Null eller mange forekomster Code Kode for avgift ihht. Avtale Description Beskrivelse av type avgift, ref. Code BSK Bank IG versjon 1_02 av e2bformatet3v3 Side 40 av 63

41 Navn på XML-element Beskrivelse Krav Repetisj on Type Percent Avgiftsprosent K 0..1 Decimal BaseAmount Avgiftsgrunnlag K 0..1 Decimal Amount Avgiftsbeløp K 0..1 Decimal Quantity Kvantum: Angis dersom avgiften er relatert til et kvantum K 0..1 Decimal UnitOfMeasure Enhet relatert til kvantum RatePerUnit Sats: Angis dersom avgiften beregnes ut fra en sats pr. enhet K 0..1 Decimal VatInfo Mva som beregnes på avgiften K 1 VatInfoType VatPercent Mva-prosent: Ref.: Statens gjeldende MVA satser K 0..1 Decimal VatBaseAmount Mva-grunnlag: Grunnlag for mva-beregningen for den aktuelle satsen K 0..1 Decimal VatAmount Mva-beløp: Beløp for den aktuelle satsen K 0..1 Decimal CalculationSequence Angir rekkefølge for beregning av rabatter Discount Rabatter på linjenivå. Null eller mange forekomster Code Kode for rabatt ihht. Avtale Description Beskrivelse av type rabatt, ref. Code Percent Rabattprosent K 0..1 Decimal BaseAmount Rabattgrunnlag K 0..1 Decimal Amount Rabattbeløp K 0..1 Decimal Quantity Kvantum: Angis dersom rabatten er relatert til et kvantum K 0..1 Decimal UnitOfMeasure Enhet relatert til kvantum RatePerUnit Sats: Angis dersom rabatten beregnes ut fra en sats pr. enhet K 0..1 Decimal K 0..* DiscountChargesAndTaxType VatInfo Mva som beregnes på rabatten K 1 VatInfoType VatPercent Mva-prosent: Ref.: Statens gjeldende MVA satser K 0..1 Decimal VatBaseAmount Mva-grunnlag: Grunnlag for mva-beregningen for den aktuelle satsen K 0..1 Decimal VatAmount Mva-beløp: Beløp for den aktuelle satsen K 0..1 Decimal CalculationSequence Angir rekkefølge for beregning av rabatter BSK Bank IG versjon 1_02 av e2bformatet3v3 Side 41 av 63

42 Navn på XML-element Beskrivelse Krav Repetisj on Type Charges Tillegg på linjenivå. Null eller mange forekomster Code Kode for tillegg ihht. Avtale Description Beskrivelse av type tillegg, ref. Code Percent Tilleggsprosent K 0..1 Decimal BaseAmount Tilleggsgrunnlag K 0..1 Decimal Amount Tilleggsbeløp K 0..1 Decimal Quantity Kvantum: Angis dersom tillegget er relatert til et kvantum K 0..1 Decimal UnitOfMeasure Enhet relatert til kvantum RatePerUnit Sats: Angis dersom tillegget beregnes ut fra en sats pr. enhet K 0..1 Decimal K 0..* DiscountChargesAndTaxType VatInfo Mva som beregnes på tillegget K 1 VatInfoType VatPercent Mva-prosent: Ref.: Statens gjeldende MVA satser K 0..1 Decimal VatBaseAmount Mva-grunnlag: Grunnlag for mva-beregningen for den aktuelle satsen K 0..1 Decimal VatAmount Mva-beløp: Beløp for den aktuelle satsen K 0..1 Decimal CalculationSequence Angir rekkefølge for beregning av rabatter Invoicee Fakturamottaker: Dersom denne må angis pr. fakturalinje. K 0..1 PartyType (ref. kapittel 4.8) Licencee Bevillingshaver: Dersom denne er en annen enn leverandør/selger K 0..1 PartyType (ref. kapittel 4.8) Duration Varighet Enhet for varighet. Påkrevd atributt StartDate Startdato: Dersom behov for å angi tidsperiode K 0..1 Date EndDate Sluttdato: Dersom behov for å angi tidsperiode K 0..1 Date BSK Bank IG versjon 1_02 av e2bformatet3v3 Side 42 av 63

43 Navn på XML-element Beskrivelse Krav Repetisj on Type SpecialCond Spesielle betingelser: Foreslåtte verdier: 1 = Kampanje 2 = Verken bonusgivende eller bonusbyggende 3 = Bonusgivende 4 = Bonusbyggende 5 = Både bonusgivende og bonusbyggende PostingInformation Konteringsinformasjon: Hele konteringsstrengen PostingDetails Ref Dimension Konteringsdetaljer: Oppbygging av konteringsstrengen. Null eller mange forekomster. Dimensjon: Generelt begrep, kan for eksempel være avdeling eller prosjekt Anbefalt element i EHF formatet K 0..* PostingDetailsType M 1 String PostingCode Kode: Kode for aktuell dimensjon M 1 String Referanse: Generelt referansefelt med kode. Null eller mange forekomster. K 0..* RefWithCodeType Code Kode: Kode som angir type referanse. M 1 String Text Referansenummer: Selve referansenummeret FreeText Fritekst: Til generell informasjon som ikke kan legges i andre felter. CardDetailsInformation Kortdetaljer. Bransjespesifikt tillegg for kredittkortfakturaer. K 0..1 CardDetailsInfoType InsuranceDetails EnergyDetails BuildingDetails Forsikringsdetaljer. Bransjespesifikt tillegg for faktraer relatert til forsikringsoppgjør. Energidetaljer. Bransjespesifikt tillegg for energifakturaer (strøm og nett). Innhold er beskrevet i eget dokument Byggedetaljer. Bransjespesifikt tillegg for fakturaer innen bygg, elektro og VA/VVS. K 0..1 InsuranceDetailsType K 0..1 EnergyDetailstype K 0..1 BuildingDetailstype BSK Bank IG versjon 1_02 av e2bformatet3v3 Side 43 av 63

44 3.9 Fakturarabatter, tillegg og avgifter Navn på XML-element Beskrivelse Krav Repetisjon Type InvoiceDiscount ChargesAndTax Fakturarabatter, tillegg og avgifter på fakturanivå. K 0..1 InvoiceDiscountInfo Rabatter som gis på fakturatotalen. Null eller mange forekomster K 0..1 DiscountCharg esandtaxtype Code Kode for rabatt ihht. Avtale Description Beskrivelse av type rabatt, ref. Code Percent Rabattprosent K 0..1 Decimal BaseAmount Rabattgrunnlag K 0..1 Decimal Amount Rabattbeløp K 0..1 Decimal Quantity Kvantum: Angis dersom rabatten er relatert til et kvantum K 0..1 Decimal UnitOfMeasure Enhet relatert til kvantum RatePerUnit Sats: Angis dersom rabatten beregnes ut fra en sats pr. enhet K 0..1 Decimal VatInfo Mva som beregnes på rabatten K 0..1 VatInfoType VatPercent Mva-prosent: Ref.: Statens gjeldende MVA satser K 0..1 Decimal VatBaseAmount Mva-grunnlag: Grunnlag for mva-beregningen for den aktuelle satsen K 0..1 Decimal VatAmount Mva-beløp: Beløp for den aktuelle satsen K 0..1 Decimal CalculationSequence Angir rekkefølge for beregning av rabatter InvoiceChargesInfo Tillegg som kommer til fakturatotalen. Null eller mange forekomster K 0..1 DiscountCharg esandtaxtype Code Kode for tillegg ihht. Avtale Description Beskrivelse av type tillegg, ref. Code Percent Tilleggsprosent K 0..1 Decimal BaseAmount Tilleggsgrunnlag K 0..1 Decimal Amount Tilleggsbeløp K 0..1 Decimal Quantity Kvantum: Angis dersom tillegget er relatert til et kvantum K 0..1 Decimal BSK Bank IG versjon 1_02 av e2bformatet3v3 Side 44 av 63

45 Navn på XML-element Beskrivelse Krav Repetisjon Type UnitOfMeasure Enhet relatert til kvantum RatePerUnit Sats: Angis dersom tillegget beregnes ut fra en sats pr. enhet K 0..1 Decimal VatInfo Mva som beregnes på tillegget K 0..1 VatInfoType VatPercent Mva-prosent: Ref.: Statens gjeldende MVA satser K 0..1 Decimal VatBaseAmount Mva-grunnlag: Grunnlag for mva-beregningen for den aktuelle satsen K 0..1 Decimal VatAmount Mva-beløp: Beløp for den aktuelle satsen K 0..1 Decimal CalculationSequence Angir rekkefølge for beregning av tillegg InvoiceTaxInfo Statlige avgifter som kommer til fakturatotalen. Null eller mange forekomster K 0..* DiscountCharg esandtaxtype Code Kode for avgift ihht. Avtale Description Beskrivelse av type avgift, ref. Code Percent Avgiftsprosent K 0..1 Decimal BaseAmount Avgiftsgrunnlag K 0..1 Decimal Amount Avgiftsbeløp K 0..1 Decimal Quantity Kvantum: Angis dersom avgiften er relatert til et kvantum K 0..1 Decimal UnitOfMeasure Enhet relatert til kvantum RatePerUnit Sats: Angis dersom avgiften beregnes ut fra en sats pr. enhet K 0..1 Decimal VatInfo Mva som beregnes på avgiften K 0..1 VatInfoType VatPercent Mva-prosent: Ref.: Statens gjeldende MVA satser K 0..1 Decimal VatBaseAmount Mva-grunnlag: Grunnlag for mva-beregningen for den aktuelle satsen K 0..1 Decimal VatAmount Mva-beløp: Beløp for den aktuelle satsen K 0..1 Decimal CalculationSequence Angir rekkefølge for beregning av avgifter BSK Bank IG versjon 1_02 av e2bformatet3v3 Side 45 av 63

46 3.10 Fakturatotaler Navn på XML-element Beskrivelse Krav Repetisjon Type InvoiceSummary Fakturatotaler M 1 FreeText Fritekst: En eller flere linjer K 0..* String InvoiceTotals Totaler: Må forekommme en gang M 1 InvoiceTotalstype LineItemTotalsAmount Sum totalt linjebeløp Påkrevet element i EHF formatet og anbefales av denne grunn til alltid å benyttes. Dersom ikke dette elementet er med, kan fakturaen risikere å bli avvist. K 0..1 Decimal DiscountTotalsAmount Sum totalt rabatter K 0..1 Decimal ChargesTotalsAmount Sum totalt tillegg K 0..1 Decimal TaxTotalsAmount Sum totalt avgifter K 0..1 Decimal PrePaidAmount Sum totalt forhåndsbetalt beløp. For eksempel akonto-beløp K 0..1 Decimal CommissionAmount Sum totalt provisjonsbeløp. For eksempel ved bruk av reisebyrå K 0..1 Decimal GrossAmount VatTotalsAmount NetAmount Bruttobeløp: Fakturabeløp inkludert mva. Påkrevet element i EHF formatet Sum totalt mva-beløp Påkrevet element i EHF formatet Nettobeløp: Fakturabeløp uten mva Påkrevet element i EHF formatet M 1 Decimal M 1 Decimal M 1 Decimal RoundingAmount Øresavrunding: På totalt bruttobeløp K 0..1 Decimal VatTotalsInfo Mva-spesifikasjon: Spesifisering av sum mva pr. sats. Null eller mange forekomster. Det anbefales at man også inkluderer sum for mva-sats 0 (null) når man bruker element Påkrevet element dersom mottaker benyttes EHF formatet (Bl.a. statlige enheter. Dersom ikke dette elementet er med, kan fakturaen risikere å bli avvist. K 0..* VatInfoType BSK Bank IG versjon 1_02 av e2bformatet3v3 Side 46 av 63

47 Navn på XML-element Beskrivelse Krav Repetisjon Type VatPercent VatBaseAmount VatAmount TaxTotalsInfo Mva-prosent: For eksempel Ref.: Statens gjeldende MVA satser Påkrevet element i EHF formatet Mva-grunnlag: Totalt grunnlag for mva-beregningen for den aktuelle prosentsatsen Påkrevet element i EHF formatet Mva-beløp: Totalt beløp for den aktuelle prosentsatsen Påkrevet element i EHF formatet Spesifisering av sum avgifter utover mva pr. kode/type. Null eller mange forekomster K 0..1 Decimal K 0..1 Decimal K 0..1 Decimal K 0..* TaxTotalsInfoType TaxCode Kode for avgiftskode ihht. Avtale TaxDescription Beskrivelse av type avgift, ref. kode TaxAmount Avgiftsbeløp for den aktuelle koden K 0..1 Decimal DiscountTotals Spesifisering av sum rabatter pr. kode. Null eller mange forekomster K 0..* DiscountCharges AndTaxType Code Kode for rabatt ihht. Avtale Description Beskrivelse av type rabatt, ref. kode Percent Rabattprosent K 0..1 Decimal BaseAmount Rabattgrunnlag K 0..1 Decimal Amount Rabattbeløp K 0..1 Decimal Quantity Kvantum: Angis dersom rabatten er relatert til et kvantum K 0..1 Decimal UnitOfMeasure Enhet relatert til kvantum RatePerUnit Sats: Angis dersom rabatten beregnes ut fra en sats pr. enhet K 0..1 Decimal VatInfo Mva som beregnes på rabatten K 0..1 VatInfoType VatPercent Mva-prosent: P.t.. Ref.: Statens gjeldende MVA satser K 0..1 Decimal VatBaseAmount Mva-grunnlag: Grunnlag for mva-beregningen for den aktuelle satsen K 0..1 Decimal VatAmount Mva-beløp: Beløp for den aktuelle satsen K 0..1 Decimal CalculationSequence Angir rekkefølge for beregning av rabatter BSK Bank IG versjon 1_02 av e2bformatet3v3 Side 47 av 63

48 Navn på XML-element Beskrivelse Krav Repetisjon Type ChargesTotals Spesifisering av sum tillegg pr. kode. Null eller mange forekomster K 0..* DiscountCharges AndTaxType Code Kode for tillegg ihht. Avtale Description Beskrivelse av type tillegg, ref. Kode Percent Tilleggsprosent K 0..1 Decimal BaseAmount Tilleggsgrunnlag K 0..1 Decimal Amount Tilleggsbeløp K 0..1 Decimal Quantity Kvantum: Angis dersom tillegget er relatert til et kvantum K 0..1 Decimal UnitOfMeasure Enhet relatert til kvantum RatePerUnit Sats: Angis dersom tillegget beregnes ut fra en sats pr. enhet K 0..1 Decimal VatInfo Mva som beregnes på tillegget K 0..1 VatInfoType VatPercent Mva-prosent: P.t.. Ref.: Statens gjeldende MVA satser K 0..1 Decimal VatBaseAmount Mva-grunnlag: Grunnlag for mva-beregningen for den aktuelle satsen K 0..1 Decimal VatAmount Mva-beløp: Beløp for den aktuelle satsen K 0..1 Decimal CalculationSequence Angir rekkefølge for beregning av tillegg ActualPayment Faktisk beløp å betale: Angis dersom beløp å betale er forskjellig fra fakturert beløp. Påkrevet element i EHF formatet (mappingregler beskrevet i Vedlegg 2) K 0..1 Valuta. ISO Alpha kode (3 tegn) Heltallsdel av faktisk beløp Påkrevet element i EHF formatet Desimaldel av faktisk beløp Påkrevet element i EHF formatet K 0..1 Integer K 0..1 Moduluskode BSK Bank IG versjon 1_02 av e2bformatet3v3 Side 48 av 63

49 Vedlegg 1: Eksempel på fakturafil Eksemplet viser en faktura sendt fra Fakturautsteder AS, Postboks 234, 0253 OSLO som benytter en bank knyttet mot en datasentral til Mottakerbedrift AS, Postboks 12, 1370 ASKER som benytter en bank som er knyttet mot en annen datasentral. <?xml version= 1.0 encoding= UTF-8?> <Interchange xmlns:xsi= xmlns= xsi:schemalocation= H:\e2b_Invoice_v3p3\Schema\e2b_Invoice_Interchange_v3p3.xsd > <Invoice MessageVersion= 3.3 MessageOwner= e2b MessageType= Invoice > <MessageTimestamp> T09:30:47.0Z</MessageTimestamp> <NumberOfLines>1</NumberOfLines> <InvoiceHeader> <InvoiceType codetext= Faktura >380</InvoiceType> <InvoiceStatus codetext= Original >9</InvoiceStatus> <InvoiceNumber>92345</InvoiceNumber> <I voicedate> </Inv icedate> <Supplier> <PartyId schemeid= efakturaid schemename= efakturaid schemeagencyname= ESSENOKX >ESSENOKX-NO </PartyId> <Name>Fakturautsteder AS</Name> <PostalAddress> <Address1>Postboks 234</Address1> <PostalCode>0203</PostalCode> <PostalDistrict>Oslo</PostalDistrict> <CountryCode>NO</CountryCode> </PostalAddress> <ContactPerson> <Name>Ole Olsen</Name> </ContactPerson> <OrgNumber> </OrgNumber> BSK Bank IG versjon 1_02 av e2bformatet3v3 Side 49 av 63

50 <VatId>MVA NO</VatId> <Department>IT</Department> <AccountInformation> <AccountNumber> </AccountNumber> </AccountInformation> <ProjectRef>Project1</ProjectRef> <ContractNumber> </Con ractnumber> </Suppli r> <Buyer> <PartyId schemeid= efakturaid schemename= efakturaid schemeagencyname= ESSENOKX >ESSENOKX-NO </PartyId> <Name>Mottakerbedrift AS</Name> <PostalAddress> <Address1>Postboks 12</Address1> <PostalCode>1370</PostalCode> <PostalDistrict>ASKER</PostalDistrict> <CountryCode>NO</CountryCode> </PostalAddress> <ContactPerson> <Name>Hanne Hansen</Name> </ContactPerson> <OrgNumber> </OrgNumber> <VatId>MVA NO</VatId> </Buyer> <InvoiceReferences> <BuyersOrderNumber>54321</BuyersOrderNumber> <BuyersOrderDate> </BuyersOrderDate> <DeliveryTerms>Fritt levert pr. bil</deliveryterms> <DeliveryDate> </DeliveryDate> </InvoiceReferences> BSK Bank IG versjon 1_02 av e2bformatet3v3 Side 50 av 63

51 <Payment> <DueDate> </DueDate> <Currency>NOK</Currency> <KidNumber> </KidNumber> <PaymentTerms>14 dager</paymentterms> <PaymentDiscount> <DiscountPercent>2</DiscountPercent> <DiscountDays>10</DiscountDays> </PaymentDiscount> <OverDuePercent>2.5</OverDuePercent> </Payment> <Attachments>String</Attachments> </InvoiceHeader> <InvoiceDetails> <BaseItemDetails> <Level>1</Level> <SuppliersProductId>55555</SuppliersProductId> <Description>Product1</Description> <UnitPrice>2.5</UnitPrice> <PriceType>AAB</PriceType> <LineItemPreDiscountAmount>12.5</LineItemPreDiscountAmount> <LineItemAmount>10</LineItemAmount> <QuantityInvoiced>5</QuantityInvoiced> <UnitOfMeasure>Stk</UnitOfMeasure> <VatInfo> <VatPercent>25</VatPercent> <VatBaseAmount>11</VatBaseAmount> <VatAmount>2.75</VatAmount> </VatInfo> <TaxInfo> BSK Bank IG versjon 1_02 av e2bformatet3v3 Side 51 av 63

52 <Description>Miljøavgift</Description> <Percent>10</Percent> <BaseAmount>10</BaseAmount> <Amount>1</Amount> </TaxInfo> <Discount> <Description>Konsern</Description> <Percent>20</Percent> <BaseAmount>12.5</BaseAmount> <Amount>2.5</Amount> </Discount> </BaseItemDetails> </InvoiceDetails> <InvoiceDiscountChargesAndTax> <InvoiceCharges> <Description>Frakt</Description> <Percent>6</Percent> <BaseAmount>11</BaseAmount> <Amount>0.66</Amount> <VatInfo> <VatPercent>25</VatPercent> <VatBaseAmount>0.66</VatBaseAmount> <VatAmount>0.17</VatAmount> </VatInfo> </InvoiceCharges> </InvoiceDiscountChargesAndTax> <InvoiceSummary> <InvoiceTotals> <LineItemTotalsAmount>11</LineItemTotalsAmount> <DiscountTotalsAmount>0</DiscountTotalsAmount> BSK Bank IG versjon 1_02 av e2bformatet3v3 Side 52 av 63

53 <ChargesTotalsAmount>0.66</ChargesTotalsAmount> <TaxTotalsAmount>0</TaxTotalsAmount> <GrossAmount>14.60</GrossAmount> <VatTotalsAmount>2.92</VatTotalsAmount> <NetAmount>11.66</NetAmount> <RoundingAmount>0.02</RoundingAmount> </InvoiceTotals> <VatTotalsInfo> <VatPercent>25</VatPercent> <VatBaseAmount>11.66</VatBaseAmount> <VatAmount>2.92</VatAmount> </VatTotalsInfo> <TaxTotalsInfo> <TaxDescription>Miljøavgift</TaxDescription> <TaxAmount>1</TaxAmount> </TaxTotalsInfo> <DiscountTotals> <Description>Rabatt</Description> <Amount>2.5</Amount> </DiscountTotals> </InvoiceSummary> </Invoice> </Interchange> BSK Bank IG versjon 1_02 av e2bformatet3v3 Side 53 av 63

54 BSK Implementasjonsguide B2B efaktura Versjon: 1.02 Vedlegg 2: Tips vedrørende bruk av formatet 1. Tips til bruk av formatet I dette vedlegget er noen informasjonselementer beskrevet og det gis råd om hvilket felt som skal benyttes og hvilken informasjon som legges i feltet for å sikre entydig distribusjon. Målet er at det skal være lettere for fakturautsteder å tilrettelegge sin fil og lettere for fakturamottakeren å motta filer fra flere forskjellige fakturautstedere uten at fakturamottaker må analysere mottatt fil hver gang Aktører/Roller Aktør/Roller E2b Kommentar Fakturautsteder Supplier Fakturautsteder er den part som er leverandør og som har inngått avtale med sin bank om rollen fakturautsteder. Fakturamottaker Buyer Fakturamottaker er den part som er kunde og som har inngått avtale med sin bank om rollen fakturamottaker. Fakturasender InvoiceIssuer Fakturasender er den part som har sendt fakturaen på vegne av seg selv eller andre som har inngått avtale med sin bank om rollen fakturautsteder. Kan være en teknisk part definert inn i tjenesteavtalen fakturautsteder har inngått med sin bank. Fakturamottaker Invoicee Fakturamottaker er den part som mottar fakturaen på vegne av seg selv eller andre som har inngått avtale med sin bank om rollen fakturamottaker. Kan være en tekniske part definert inn i tjenesteavtalen fakturamottaker har inngått med sin bank Faktoring Factoring Faktoring er den part som skal motta betalingen fra kjøper/fakturamottaker 1.2. Feltbruk knyttet til referanser Fakturautsteder og fakturamottaker har i sin kommunikasjon behov for å legge inn ulike referanser i fakturaen, det være seg henvisning til for eksempel et kundenummer, et ordrenummer eller et prosjektnummer. I de tilfeller hvor referansen har et klart felt i e2b-formatet (f.eks ordrenummer) benyttes dette feltet. Tabellen under viser noen referanser hvor det ikke finnes noe naturlig felt i e2bformatet. Bankene anbefaler følgende bruk: BSK Bank IG versjon 1_02 av e2bformatet3v3 Side 54 av 63

55 BSK Implementasjonsguide B2B efaktura Versjon: 1.02 Type referanse Forslag i felles IG Kommentar Kundenummer Leverandørnummer Vår referanse (fakturautsteder) Deres referanse (fakturamottaker) Betalingsreferanse som ikke er en norsk KID AvtaleGiro (B2C) (fakturamottaker) Gårds- og bruksnummer. Internettadresser (Link) Fakturautsteders kundenr for fakturamottaker: InvoiceHeader/Buyer/Ref der Code = CustomerNumber og Text inneholder verdien Fakturautsteders leverandørnummer hos fakturamottaker: InvoiceHeader/Supplier/Ref der Code = SupplierNumber og Text inneholder verdien for leverandørenummer. InvoiceHeader/Supplier/Ref der Code = OurReference og Text inneholder verdien for vår referanse InvoiceHeader/Buyer /Ref der Code = YourReference og Text inneholder verdien for deres referanse. InvoiceHeader/Ref der Code = PaymentReference og Text inneholder verdien for betalingsreferansen InvoiceHeader/Buyer /Ref der Code: AvtaleGiro InvoiceHeader/Buyer /Ref der Code = GaardsBruksNr og Text inneholder verdien for gårds og bruksnummer. InvoiceHeader/Supplier/Ref Dette gjelder det som identifiserer leverandør i kundens systemer Norsk KID legges i feltet InvoiceHeader/Payment/Kid Number. Feltet er naturlig benyttet ifm. fakturering på tvers av landegrenser. Merk at informasjon som ligger i andre spesifikke felt i formatet ikke skal dupliseres i dette feltet. Brukes for å angi en efaktura B2C med AvtaleGiro som betalingsmåte AvtaleGiro. BSK Bank IG versjon 1_02 av e2bformatet3v3 Side 55 av 63

56 BSK Implementasjonsguide B2B efaktura Versjon: 1.02 Type referanse Forslag i felles IG Kommentar der Code er Linknr (for identifisering i visning etc) og linkteksten som skal vises (f. eks. Link04 Link til hjemmesiden vår ) og Text er selve linken (URL) (f. eks. ) Prinsippet for bruk av Ref -felter bør også benyttes for andre referanser som ikke har et naturlig felt i formatet Spesialfelt og bransjeløsninger Det er mange typer bedrifter som har spesialfelt. Med det menes bransjespesifikke informasjonselement som f.eks forsikringsnummer, målerid, kortnummer, bruks- og gårdsnummer osv. Selv om det finnes bransjetillegg for mange av disse spesialfeltene så er det relativt få fakturamottakere som har lagt til rette for å motta og behandle disse. Det anbefales derfor å avtale eventuelt bruk av bransjefelt med den enkelte fakturamottaker. I de tilfellene hvor dette er vanskelig eller fakturamottaker ikke har tilrettelagt for bransjetillegg anbefales det å legge de nødvendige feltene inn i generelle ref-felter. I e2b-formatet kan dette gjøres via Ref-feltet : InvoiceHeader/Ref på følgende måte. Eks.: <Ref> <Code>kortnummer</Code> <Text> </Text> </Ref> NB! Det er viktig å begrense antall Ref-felt til et minimum. Alle informasjonselementer som kan legges inn i definerte felter i standard -e2b, skal legges inn på disse elementene og ikke i Ref-feltet. Fakturamottaker anbefales å alltid avsette noe plass til Ref-felter på sin visningsmal. BSK Bank IG versjon 1_02 av e2bformatet3v3 Side 56 av 63

57 BSK Implementasjonsguide B2B efaktura Versjon: Nivåer (Levels) Generell bruk av Levels vil være som følger: Level 1 er det minst detaljerte varelinjenivået (Sammendrag) og Level 4 det mest detaljerte nivået ( varelinje ). Nivå 2 og 3 er mellomnivåer som kan brukes til å spesifisere grupperinger. Level 1 er sammendrag av alle Level 2,3,4 under seg. o Level 2 er sammendrag av alle Level 3,4 under seg. Level 3 er sammendrag av alle Level 4 under seg. Level 4 er faktiske varelinjer. Merk: For energifaktura (LineOfBusiness=7) brukes kun Levels 1 og 2 for varelinjer, samt Level Maalerstand for rapportering av målerstand (B2C). BSK Bank IG versjon 1_02 av e2bformatet3v3 Side 57 av 63

58 BSK Implementasjonsguide B2B efaktura Versjon: 1.02 BSK Bank IG versjon 1_02 av e2bformatet3v3 Side 58 av 63

59 BSK Implementasjonsguide B2B efaktura Versjon: 1.02 Kodeeksempel: <InvoiceDetails> <BaseItemDetails> <Level>1</Level> <Description>Prosjekt</Description> <LineItemAmount>100</LineItemAmount> </BaseItemDetails> <BaseItemDetails> <Level>2</Level> <Description>Underprosjekt</Description> <LineItemAmount>100</LineItemAmount> </BaseItemDetails> <BaseItemDetails> <Level>3</Level> <Description>Aktivitet</Description> <LineItemAmount>100</LineItemAmount> </BaseItemDetails> <BaseItemDetails> <Level>4</Level> <Description>Tjeneste 1</Description> <LineItemAmount>50</LineItemAmount> </BaseItemDetails> <BaseItemDetails> <Level>4</Level> <Description>Tjeneste 2</Description> <LineItemAmount>50</LineItemAmount> </BaseItemDetails> </InvoiceDetails> 1.5. Samlefaktura Ordet samlefaktura blir brukt om ulike typer fakturaer: E2b forutsetter at en faktura kun har ett ordrenummer siden ordrenummer er definert på fakturanivå og ikke på rad-nivå. Hvis ordrenummeret imidlertid ikke er nøvendig å inkludere, kan man likevel legge inn en ordre pr rad (InvoiceDetails/BaseItemDetails) i fakturaen. Et eksempel er en pizza-leveranse hvor hver bestilling innenfor en tidsperiode/avdeling kan legges inn på en faktura gjennom at hver leveranse får en rad. En samlefaktura som forutsetter bruk av underrader/subrader(invoicedetails/baseitemdetails/subinvoice) bør ikke distribueres. Isteden kan levels benyttes se Vedlegg 2 kap 1.4 over. For energibransjen tillates kun en målerpunktid pr. faktura. BSK Bank IG versjon 1_02 av e2bformatet3v3 Side 59 av 63

60 BSK Implementasjonsguide B2B efaktura Versjon: Postal og street adress I de tilfellene hvor formatet har både en postal address og en street address, vil det være postaladress som prioriteres ved en konvertering og ved print. Bedriften anbefales derfor å benytte postal adress hvis formatet angir en valgfrihet. I e2b angis address 1,2 og 3. Det er i formatet ikke angitt hva disse skal brukes til. I denne løsningen tolkes disse tre adressene som følger: Adresse 1 er gateadressen (eks. Firmaveien 12) Adresse 2 er valgfri. Adresse 3 blir brukt til postboks adresse (eks. Postboks 123 Solli) Mappingregler knyttet til EHF formatet Regel knyttet til mapping av fakturabeløp og beløp som skal betales: Begge beløpstypene krever innhold i EHF formatet og kan dermed enten innholde likt beløp (vanligst) eller forskjellig (for eksempel faktura knyttet til kredittkort). Ved mapping fra EHF til e2b legges respektive verdier i felt for Gross Amount (Monetary Total. Tax Inclusive Amount. Amount) og ActualPayment (Monetary Total. Payable_ Amount. Amount). Merk at PayableAmount I e2b er oppdelt i separate felt for kronebeløp og desimalbeløp og at dette må tas hensyn til i mappingen. Ved mapping fra e2b til EHF der ActualPayment ikke er benyttet (valgfritt felt), mappes GrossAmount til både Monetary Total. Tax Inclusive Amount. Amount og Monetary Total. Payable_ Amount. Amount da begge feltene er obligatoriske. Merk at ActualAmount i e2b formatet er oppdelt i separate felt for kronebeløp og desimalbeløp og at dette må tas hensyn til i mappingen Regel knyttet til mapping av Factoring Party (e2b) og Payee Party (EHF) Ved mapping fra e2b til EHF vil Factoring Party bli mappet til Payee Party i EHF. Dersom Payee Party er benyttet i EHF, skal den mappes til Factoring Party i e2b, da det ikke er mulig å skille om Party mappes som Factoring Party eller Payee Party Regel knyttet til mapping av vedlegg mellom e2b og EHF Ved mapping av fakturaer med vedlegg mellom e2b formatet og EHF formatet vil det måtte ta hensyn til følgende momenter: EHF støtter helt konkret spesifiserte filtyper. E2b støtter alle filtypene, men ved fakturaer der konvertering fra e2b til EHF er relevant må utsteder ta hensyn til hva som kan formidles i EHF formatet. EHF støtter kun et vedlegg pr. faktura, mens e2b støtter flere. Ved konvertering fra e2b til EHF vil kun en fil bli videresendt mens øvrige vil bli ignorert. BSK Bank IG versjon 1_02 av e2bformatet3v3 Side 60 av 63

61 BSK Implementasjonsguide B2B efaktura Versjon: Enhetskoder I praksis benyttes ikke enhetskoder iht. ISO 31 i e2b formatet, men fritekstformat. Med andre ord kan hva som helst komme i e2b formatet. I EHF benyttes enhetskoder iht UNECE Recommendation 20. Alle kodene definert i ISO 31 dekkes av UNECE Recommendation 20, men ikke motsatt vei. Det er en fordel at brukere av e2b formatet benyttes enhetskoder iht. ISO 31 eller den norske benevnelsen som er spesifisert i mappingtabell utgitt av DIFI. Dersom andre enhetskoder i fritekstformat benyttes, vil disse bli konvertert iht. liste definert i avtalebank eller til en default kode, for eksempel stykk Avhengigheter mellom beløpsfelt Merk at det i noen sammenhenger er lagt inn kontroll på om summer stemmer mot de enkelte 61injesummeri fm. EHF fakturaer, for eksempel motsvarende felt som e2b elementet Invoice/InvoiceSummary/InvoiceTotals/NetAmount. Dette forutsetter at denne kontrollen stemmer i en e2b melding for disse feltene. BSK Bank IG versjon 1_02 av e2bformatet3v3 Side 61 av 63

62 BSK Implementasjonsguide B2B efaktura Versjon: 1.02 Endringslogg Endringer gjort i versjon 1.01 fra versjon 1.0 Kapittel Endring Merknad 3.2 Følgende setning er lagt inn: Bruk av vedlegg er beskrevet i en egen appendiks. 3.2 Figur: Det er åpnet for bruk av Utvekslingshode samt Meldingshode i meldingen. 3.3 Følgende setning er lagt inn: Bruk av Interchange Header og Message Header er bekrevet i egne dokumenter som kan hentes ned fra da det ikke er identifisert et behov for BSK å beskrive disse spesielt for bruk ifm. bankenes løsning. 3.6 Elementet Attachements åpnet for bruk. Endringer gjort i versjon 1.02 fra versjon 1.01 Kapittel Endring Merknad 1.1 Revidert slik at orgnummer fremgår som mulig adresseringsmekanisme. 2.1 Lagt inn merknad knyttet til type forretningsdokumenter. 2.3 Lagt inn presisering om at bankene også støtter ISO Revidert elementene som kan benyttes for dublikatkontroll slik at orgnummer fremgår som mulig adresseringsmekanisme. 2.7 Nytt kapittel med henvisning til bankenes visningsmal 2.8 Nytt kapittel med henvisning til EHF formatet. 3.3 Lagt inn henvisning til hvordan prosessmal skal formidles Generelt Lagt inn henvisning til hvilke informasjonselementer som er påkrevet og anbefalt i EHF formatet. Generelle rettelser uten betydning for innhold er foretatt. BSK Bank IG versjon 1_02 av e2bformatet3v3 Side 62 av 63

63 BSK Implementasjonsguide B2B efaktura Versjon: Feltype for BuyersOrderDate er endret fra String til Date. 3.8/3.9/3.10 Korrigert tekst ifm. gyldige verdier for VAT til en generell tekst Ref.: Statens gjeldende MVA satser Supplier PartyID oppdatert for å kunne ivareta adressering med organisasjonsnummer Buyer PartyID oppdatert for å kunne ivareta adressering med organisasjonsnummer / Det er spesifisert at kontraktsnummer mellom kjøper og selger som faktura er knyttet til, skal legges under Supplier og ikke under Buyer. 3.8 Lagt inn merknad knyttet til mapping av unitcodes 3.9 Lagt inn informasjon om at VatAmount må være med dersom mottaker benytter EHF formatet. Vedlegg 2, Kap 1.7 Kap Lagt inn konkrete mappingregler melom e2b og EHF formatet Nytt String er endret fra e2b versjon 3.3 til Date i versjon 3.4/3.4.1 BSK Bank IG versjon 1_02 av e2bformatet3v3 Side 63 av 63