implementeringsguide
Download
Report
Transcript implementeringsguide
BSK implementeringsguide
e2b-formatet v.3.3
Bankenes felles implementeringsguide
basert på versjon 3.3 av
e2b Fakturaformat
Versjon: 1.02
23. april 2012
Bankenes Standardiseringskontor
Postboks 2644 Solli
0203 OSLO
Tlf. 23 28 45 10
E-post: [email protected]
BSK Implementasjonsguide B2B efaktura
V er s jon: 1 .0 2 0
Endringskatalog
DATO
VER
UTFØRT AV
ENDRINGER
04.02.2010
1.0
Morten Krøgenes
Vedtatt BSK IG for e2b formatet versjon 3.3
1.02.2011
1.01
Morten Krøgenes
Oppdatering knyttet til formidling av vedlegg
16.04.2012
1.02
Morten Krøgenes
Oppdatering knyttet til statens krav i EHF formatet.
Merk: Se forøvrig endringslogg sist i dokumentet
BSK
20120423 Bank IG versjon 1_02 av e2bformatet3v3
Side 2 av 63
BSK Implementasjonsguide B2B efaktura
V er s jon: 1 .0 2 0
Innholdsfortegnelse
1.
Innledning ..................................................................................................................... 4
1.1
1.2
1.3
FORUTSETNINGER ................................................................................................................. 4
MÅLGRUPPE ......................................................................................................................... 4
FORKLARING TIL TABELLENE ............................................................................................... 5
Faktura – Overordnet beskrivelse av formatet ........................................................... 6
2.
2.1
2.2
2.3
2.4
2.5
2.6
2.7
2.8
FORRETNINGSDOKUMENTER ................................................................................................ 6
BRANSJESPESIFIKKE TILLEGG............................................................................................... 7
TEKNISKE RETNINGSLINJER .................................................................................................. 7
UTFYLLING AV BELØPSFELTER ............................................................................................. 7
BRUK AV KVITTERING ........................................................................................................ 10
DUPLIKATKONTROLL ......................................................................................................... 10
VISNINGSMAL ..................................................................................................................... 10
MAPPING KNYTTET TIL EHF FORMATET (REF. STATENS KRAV KNYTTET TIL ELEKTRONISK
FAKTURA) ....................................................................................................................................... 11
Faktura – Oppbygging av meldingen .........................................................................12
3.
3.1
NAVNESTANDARD PÅ FAKTURAFIL .................................................................................... 12
3.2
STRUKTUROVERSIKT .......................................................................................................... 12
3.3
UTVEKSLING ( INTERCHANGE) ........................................................................................... 14
3.4
KONVOLUTT ( ENVELOPE) .................................................................................................. 14
3.5
FAKTURAMELDING (INVOICE) ............................................................................................ 15
3.6
FAKTURAHODE (INVOICEHEADER) ..................................................................................... 16
3.7
AKTØRINFORMASJON ......................................................................................................... 21
3.7.1
Supplier ...................................................................................................................... 21
3.7.2
Buyer .......................................................................................................................... 26
3.7.3
Factoring .................................................................................................................... 30
3.7.4
Andre aktører ............................................................................................................. 34
3.8
FAKTURADETALJER ............................................................................................................ 37
3.9
FAKTURARABATTER, TILLEGG OG AVGIFTER ..................................................................... 44
3.10 FAKTURATOTALER ............................................................................................................. 46
Vedlegg 1: Eksempel på fakturafil.....................................................................................49
Vedlegg 2: Tips vedrørende bruk av formatet ..................................................................54
1. TIPS TIL BRUK AV FORMATET ................................................................................................. 54
1.1. AKTØRER/ROLLER .............................................................................................................. 54
1.2. FELTBRUK KNYTTET TIL REFERANSER ............................................................................... 54
1.3. SPESIALFELT OG BRANSJELØSNINGER ................................................................................ 56
1.4. NIVÅER (LEVELS) ............................................................................................................... 57
1.5. SAMLEFAKTURA ................................................................................................................. 59
1.6. POSTAL OG STREET ADRESS................................................................................................ 60
1.7. MAPPINGREGLER KNYTTET TIL EHF FORMATET ............................................................... 60
BSK
20120423 Bank IG versjon 1_02 av e2bformatet3v3
Side 3 av 63
BSK Implementasjonsguide B2B efaktura
V er s jon: 1 .0 2 0
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
20120423 Bank IG versjon 1_02 av e2bformatet3v3
Side 4 av 63
BSK Implementasjonsguide B2B efaktura
V er s jon: 1 .0 2 0
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 prefiks @.
BSK
20120423 Bank IG versjon 1_02 av e2bformatet3v3
Side 5 av 63
BSK Implementasjonsguide B2B efaktura
V er s jon: 1 .0 2 0
2. Faktura – Overordnet beskrivelse av formatet
2.1 Forretningsdokumenter
Implementeringsguiden støtter følgende forretningsdokumenter:
Functional
Business
Document
Sending
role
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
Receiving
role
Description
State
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.
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 i @codetext. Kodingen for purring skal derfor være InvoiceType=380 og
@codetext ”Purring”
BSK
20120423 Bank IG versjon 1_02 av e2bformatet3v3
Side 6 av 63
BSK Implementasjonsguide B2B efaktura
V er s jon: 1 .0 2 0
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-8859-1)
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
20120423 Bank IG versjon 1_02 av e2bformatet3v3
Side 7 av 63
BSK Implementasjonsguide B2B efaktura
V er s jon: 1 .0 2 0
InvoiceDetails
LineItemPreDiscountAmount
+ ChargesAmount -
DiscountAmount + TaxAmount
0..*
0..*
ChargesTotals
Description
Amount
= LineItemAmount
0..*
InvoiceDiscountChargesAndTax
0..1
0..*
0..1
VatAmount
0..1
VatAmount
InvoiceTax 1 0..1
VatAmount
InvoiveDiscount 1
DiscountTotals
Amount
0..*
1..*
InvoiceCharges 1
Description
VatAmount
0..1
0..*
0..*
0..*
0..*
0..*
TaxTotalsInfo
Description
Amount
0..1
VatTotalsInfo 0..1
VatPercent
VatAmount
0..*
1
LineItemTotalsAmount
1
0..1
InvoiceSummary 0..1
ChargesTotalsAmount
0..1
0..1
DiscountTotalsAmount TaxTotalsAmount
0..1
1
NetAmount
0..1
0..1
VatTotalsAmount
0..1
RoundingAmount
1
0..1
1
GrossAmount
BSK
20120423 Bank IG versjon 1_02 av e2bformatet3v3
Side 8 av 63
BSK Implementasjonsguide B2B efaktura
V er s jon: 1 .0 2 0
Eksemplet under viser utregning av linjesummer, tillegg/fradrag og fakturatotaler i en e2bfaktura.
Linjenivå
XML-tag
<BaseItemDetails><Description>
<BaseItemDetails><QuantityInvoiced>
*
<BaseItemDetails><UnitPrice>
=
<BaseItemDetails><LineItemPreDiscountAmount>
*
<BaseItemDetails><Discount><Percent>
=
<BaseItemDetails><Discount><Amount>
-=
<BaseItemDetails><TaxInfo><BaseAmount>
<BaseItemDetails><TaxInfo><Percent>
*
=
<BaseItemDetails><TaxInfo><Amount>
+ = <BaseItemDetails><VatInfo><VatBaseAmount>
*
<BaseItemDetails><VatInfo><VatPercent>
=
<BaseItemDetails><VatInfo><VatAmount>
+=
Fakturanivå
<InvoiceDiscountChargesAndTax><InvoiceCharges>
<BaseAmount>
<InvoiceDiscountChargesAndTax><InvoiceCharges><Percent>
*
<InvoiceDiscountChargesAndTax><InvoiceCharges><Amount>
<InvoiceDiscountChargesAndTax><InvoiceCharges><VatInfo>
<VatBaseAmount>
=
*
=
+=
<InvoiceDiscountChargesAndTax><InvoiceCharges><VatInfo>
<VatPercent>
<InvoiceDiscountChargesAndTax><InvoiceCharges><VatInfo>
<VatAmount>
Fakturatotaler
<InvoiceSummary><InvoiceTotals><LineItemTotalsAmount>
=
<InvoiceSummary><InvoiceTotals><ChargesTotalsAmount>
=
<InvoiceSummary><InvoiceTotals><VatTotalsAmount>
+=
+
<InvoiceSummary><InvoiceTotals><RoundingAmount>
=
<InvoiceSummary><InvoiceTotals><GrossAmount>
BSK
Vare
Product1
Antall
5
Enhetspris
2,5
Total enhetspris
12,5
Rabattsats
20 %
Rabatt
2,5
Total etter rabatt
10
Miljøavgiftssats
10 %
Miljøavgift
1
Total etter miljøavgift
11
Mva-sats
25 %
Mva
2,75
Total etter mva
13,75
Fraktgrunnlag
11
Fraktsats
6%
Frakt
0,66
Mva-sats
Mva
Total etter mva
Linjesum
Tillegg
mva
Sum
Avrunding
Sum etter avrunding
20120423 Bank IG versjon 1_02 av e2bformatet3v3
25 %
0,17
0,83
11
0,66
2,92
14,58
0,02
14,60
Side 9 av 63
BSK Implementasjonsguide B2B efaktura
V er s jon: 1 .0 2 0
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)
InvoiceHeader/Supplier/PartyId
Fakturanummer
InvoiceHeader/InvoiceNumber
Fakturadato
InvoiceHeader/InvoiceDate
Fakturatype
InvoiceHeader/InvoiceType
Utsteders organisasjonsnummer
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
20120423 Bank IG versjon 1_02 av e2bformatet3v3
Side 10 av 63
BSK Implementasjonsguide B2B efaktura
V er s jon: 1 .0 2 0
2.8 Mapping knyttet til EHF formatet (ref. statens krav knyttet til elektronisk
faktura)
Statlige organisasjoner vil etter 1.7.2012 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
20120423 Bank IG versjon 1_02 av e2bformatet3v3
Side 11 av 63
BSK Implementasjonsguide B2B efaktura
V er s jon: 1 .0 2 0
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
20120423 Bank IG versjon 1_02 av e2bformatet3v3
Side 12 av 63
BSK Implementasjonsguide B2B efaktura
Utveksling
V er s jon: 1 .0 2 0
0..1
Utvekslingshode
0..1
0..*
Konvolutt
Meldingshode
1
Fakturamelding
1..*
Fakturatotaler
1..*
1
Fakturahode
0..*
Fakturadetaljer
0..*
Korthode 0..1
1
Fritekst
Fakturatillegg/Rabatter
1..*
Basisdetaljer
Forsikringshode 0..1
0..* Flerordrefaktura
Forsikringsdetaljer 0..1
Telecomhode
0..*
0..1
Reisedetaljer
Kortdetaljer 0..1
0..* Telecomdetaljer
Energihode 0..1
Energidetaljer 0..1
0..*
Bygghode
BSK
0..1
Fraktdetaljer
Byggdetaljer 0..1
0..* Transportdetaljer
20120423 Bank IG versjon 1_02 av e2bformatet3v3
Side 13 av 63
BSK Implementasjonsguide B2B efaktura
V er s jon: 1 .0 2 0
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 www.e2b.no, 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
20120423 Bank IG versjon 1_02 av e2bformatet3v3
Side 14 av 63
BSK Implementasjonsguide B2B efaktura
V er s jon: 1 .0 2 0
3.5 Fakturamelding (Invoice)
Navn på XML-element
Beskrivelse
Krav Repetisjon Type
Invoice
M
1
@MessageOwner
Meldingseier:Fast verdi: e2b
M
1
String
@MessageType
Meldingstype. Fast verdi: Invoice
M
1
String
@MessageVersion
@language
Versjon. Lovlige verdier: 3.3
Språkkode (ISO 639 two letter code)
M
K
1
0..1
String
String
MessageNumber
Meldingsnummer. Unikt nummer som identifiserer meldingen innenfor en
utveksling
K
0..1
String
MessageTimestamp
Meldingsdato. Dato og klokkeslett når meldingen er generert.
Format: YYYY-MM-DDTHH:MM:SS
(Tidsregel Rulebook)
Antall detaljlinjer i fakturaen
M
1
K
0..1
Integer
InvoiceContent
Angir om dette er en Kostnads-, Vare- eller Tjenestefaktura.
Lovlige verdier: ”K”, ”V” og ”T”
K
0..1
String
LineOfBusiness
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 varer
K
0..1
String
Kodebeskrivelse. Valgfri beskrivelse i attributt
K
0..1
String
NumberOfLines
@codetext
BSK
20120423 Bank IG versjon 1_02 av e2bformatet3v3
Side 15 av 63
DateTime
BSK Implementasjonsguide B2B efaktura
V er s jon: 1 .0 2 0
3.6 Fakturahode (Invoiceheader)
Navn på XML-element
InvoiceHeader
InvoiceType
@codetext
InvoiceStatus
@codetext
BSK
Beskrivelse
Krav
Repetisjon Type
Fakturahode
M
1
Dokumenttype: Lovlige verdier er:
380 = Faktura
381 = Kreditnota
M
1
String
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
K
1
String
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.
M
1
String
Kodebeskrivelse: Valgfri beskrivelse i attributt
K
0..1
String
InvoiceNumber
Fakturanummer eller kreditnotanummer
Påkrevet element i EHF formatet
M
1
String
InvoiceDate
Fakturadato: Dato for utstedelse av fakturaen
Påkrevet element i EHF formatet
M
1
Date
20120423 Bank IG versjon 1_02 av e2bformatet3v3
Side 16 av 63
BSK Implementasjonsguide B2B efaktura
Navn på XML-element
TaxTreatment
@codetext
DiscountTreatment
@codetext
Supplier
InvoiceIssuer
Buyer
Invoicee
OrderedBy
BSK
V er s jon: 1 .0 2 0
Beskrivelse
Krav
Repetisjon Type
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 invoice)
K
0..1
String
Kodebeskrivelse: Valgfri beskrivelse i attributt
K
0..1
String
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 discount)
K
0..1
String
Kodebeskrivelse: Valgfri beskrivelse i attributt
K
0..1
String
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.
M
1
PartyType
(ref. kapittel 3.7.1)
K
0..1
PartyType
(ref. kapittel 3.7.4)
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.
M
1
K
0..1
PartyType
(ref. kapittel 3.7.2)
PartyType
(ref. kapittel 3.7.4)
Bestilt av: Dersom innkjøp f.eks gjøres via et kjedekontor. Kan angis
dersom denne er forskjellig fra Kjøper.
K
0..1
20120423 Bank IG versjon 1_02 av e2bformatet3v3
Side 17 av 63
PartyType
(ref. kapittel 3.7.4)
BSK Implementasjonsguide B2B efaktura
Navn på XML-element
DeliveryPart
Beskrivelse
Krav
Repetisjon Type
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.
K
0..1
PartyType
(ref. kapittel 3.7.4)
K
0..1
PartyType
(ref. kapittel 3.7.4)
ShippedFrom
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.
K
0..1
PartyType
(ref. kapittel 3.7.4)
Factoring
Factoringselskap: Angis dersom Leverandøren benytter et
Factoringsselskap for å håndtere betalingstransaksjonen.
Innhold er beskrevet i kapittel 3.7.3, Factoring
Referanser
K
0..1
PartyType
(ref. kapittel 3.7.3)
K
0..1
InvoiceReferences
Type
UltimateCustomer
InvoiceReferences
BSK
V er s jon: 1 .0 2 0
BuyersOrderNumber
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.
K
0..1
String
BuyersOrderDate
Bestillingsdato: Referanse til kjøperens bestillingsdato. Obligatorisk ved
matching. Feltet anbefales brukt.
K
0..1
Date
BuyersProjectCode
Prosjektreferanse: Referanse til prosjekt hos kjøperen
K
0..1
String
InvoiceNumber
Fakturanummer: Referanse til opprinnelig faktura ved kreditnota
Påkrevet element i EHF formatet ved kreditnotaer og purring
K
0..1
String
SuppliersOrderNumber
Leverandørs ordrenummer: Referanse til leverandøres ordrenummer.
K
0..1
String
DeliveryTerms
DeliveryTermsCode
Leveringsbetingelser: Fritekst
Kode for leveringsbetingelser: For eksempel referanse til INCOTERMkode for de som benytter det.
K
K
0..1
0..1
String
String
DeliveryTermsPlace
Leveringssted: Knyttet til leveringsbetingelser
K
0..1
String
DeliveryNoteNum
Pakkseddelnummer: Ref. til pakseddelnummer
K
0..1
String
20120423 Bank IG versjon 1_02 av e2bformatet3v3
Side 18 av 63
BSK Implementasjonsguide B2B efaktura
Navn på XML-element
DeliveryDate
Payment
Beskrivelse
Krav
Leveringsdato: Dato for leveranse, ref. pakkseddelnummer
Påkrevet element i EHF formatet
Betalingsinformasjon: Må forekomme en gang
Repetisjon Type
K
0..1
M
1
Date
PaymentType
DueDate
Forfallsdato: Dato fakturaen forfaller til betaling
Påkrevet element i EHF formatet
K
0..1
Date
Currency
Valutakode: ISO Alpha kode (3 tegn) ISO 4217
Påkrevet element i EHF formatet
M
1
String
KidNumber
KID-nummer
Anbefalt element i EHF formatet
K
0..1
String
PaymentTerms
PaymentDiscount
Betalingsbetingelser: Fritekst
Kontantrabatt: Null eller mange forekomster
K
K
0..1
String
DiscountPercent
Rabattprosent:
M
1
Decimal
DiscountDays
Antall dager rabatten gjelder fra
K
0..1
Decimal
Morarente i prosent
K
0..1
Decimal
Attachments
Vedlegg: Referanse til fil med vedlegg som for eksempel bildefil eller
billetter. Kan være flere forekomster.
Se egen appendiks.
K
0..*
String
Ref
Referanse: Generelt referansefelt med kode.
Null eller mange forekomster.
K
0..*
RefWithCodeType
Code
Kode som angir type referanse.
M
1
String
Text
OverDuePercent
BSK
V er s jon: 1 .0 2 0
0..*
Selve referanseverdien
K
0..1
String
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
20120423 Bank IG versjon 1_02 av e2bformatet3v3
Side 19 av 63
BSK Implementasjonsguide B2B efaktura
Navn på XML-element
BSK
V er s jon: 1 .0 2 0
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
Energiinformasjon. Bransjespesifikt tillegg for energifakturaer
(strøm og nettleie). Innhold er beskrevet i eget dokument.
K
0..1
EnergyHeader
Type
BuildingHeader
Bygginformasjon. Bransjespesifikt tillegg for fakturaer innen bygg,
elektro og VA/VVS.
K
0..1
BuildingHeader
Type
20120423 Bank IG versjon 1_02 av e2bformatet3v3
Side 20 av 63
BSK Implementasjonsguide B2B efaktura
V er s jon: 1 .0 2 0
3.7 Aktørinformasjon
3.7.1 Supplier
Navn på XML-element
Beskrivelse
PartyType
Aktørinformasjon
M
1
Aktørnummer: Unik identifikator
Her legges enten:
M
1
IdentifierType
PartyId
efakturaId
Krav Repetisjon Type
(bygges opp som BIC og IBAN med bindestrek i mellom)
Eksempel: XXXXXXXXXXX-NOXX15020012345
eller
Organisasjonsnummer (organisasjonsnummer skal ikke inneholde
bindestrek eller mellomrom):
Eksempel: NO123456789 eller 123456789 (anbefalt)
BSK
@schemeId
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)
M
1
String
@schemeName
Navn på identifikator
Dersom efakturaId benyttes i PartyId, skal ”efakturaId” benyttes.
Dersom organisasjonsnummer benyttes i PartyId, skal
”Organisasjonsnummer” benyttes.
M
1
String
20120423 Bank IG versjon 1_02 av e2bformatet3v3
Side 21 av 63
BSK Implementasjonsguide B2B efaktura
Navn på XML-element
@schemeAgencyName
V er s jon: 1 .0 2 0
Beskrivelse
Krav Repetisjon Type
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
M
1
K
0..1
IdentifierType
@schemeId
Lokasjonsnummer: For eksempel GLN (tidligere EANlokasjonsnummer).
Identifikasjon på identifikator, for eksempel GLN
K
0..1
String
@schemeName
Navn på identifikator, for eksempel Global Localisation Number
K
0..1
String
@schemeAgency
Navn på organisasjon som administrerer identifikatoren, for eksempel
GS1
K
0..1
String
Name
Aktørnavn: Navn på selskap
Påkrevet element i EHF formatet
M
1
String
ContactInformation
Kontaktinformasjon for bedriften
K
0..1
PhoneNumber
Telefonnummer: Bedriftens telefonnummer
K
0..1
ContactInformation
Type
String
FaxNumber
Telefaksnummer: Bedriftens telefaksnummer
K
0..1
String
EmailAddress
WebAddress
E-postadresse: Bedriftens e-postadresse
Webadresse: Bedriftens webadresse
K
K
0..1
0..1
String
String
Gateadresse: Null eller en forekomst
Gate-/besøksadresse 1
K
K
0..1
0..1
AddressType
String
Address2
Gate-/besøksadresse 2
K
0..1
String
Address3
Gate-/besøksadresse 3
K
0..1
String
PostalCode
Postnummer knyttet til gateadresse
K
0..1
String
PostalDistrict
Poststed knyttet til gateadresse
K
0..1
String
CountryCode
Landkode: 2 karakters kode i henhold til ISO 3166
K
0..1
String
CountryName
Navn på land Ihht. Kode
K
0..1
String
LocationId
StreetAddress
Address1
BSK
20120423 Bank IG versjon 1_02 av e2bformatet3v3
Side 22 av 63
String
BSK Implementasjonsguide B2B efaktura
Navn på XML-element
PostalAddress
Beskrivelse
Krav Repetisjon Type
Postadresse: Null eller en forekomst
Postadresse må være med dersom faktura skal til formidles i EHF
formatet
K
0..1
AddressType
Address1
Postadresse 1
Påkrevet element i EHF formatet
K
0..1
String
Address2
Postadresse 2
Påkrevet element i EHF formatet
Postadresse 3
K
0..1
String
K
0..1
String
PostalCode
Postnummer knyttet til postadresse
Påkrevet element i EHF formatet
K
0..1
String
PostalDistrict
Poststed knyttet til postadresse
Påkrevet element i EHF formatet
K
0..1
String
CountryCode
Landkode: 2-karakters kode i henhold til ISO 31660
Påkrevet element i EHF formatet
Navn på land Ihht. Kode
K
0..1
String
K
0..1
String
Kontaktperson: Null eller mange forekomster
K
0..*
ContactPersonType
M
1
String
FirstName
Navn på kontaktperson: Anbefalt format: ”Etternavn, Fornavn
Mellomnavn”
Anbefalt element i EHF formatet
Fornavn til kontaktperson: Anbefalt format: ”Fornavn Mellomnavn”
K
0..1
String
LastName
Etternavn til kontaktperson:
K
0..1
String
Function
Funksjon til kontaktperson: Stilling, rolle
K
0..1
String
Department
Avdeling til kontaktperson.
K
0..1
String
ContactInformation
Kontaktinformasjon for kontaktperson
K
0..1
PhoneNumber
Telefonnummer til kontaktperson
K
0..1
ContactInformation
Type
String
FaxNumber
Telefaksnummer til kontaktperson
K
0..1
String
Address3
CountryName
ContactPerson
Name
BSK
V er s jon: 1 .0 2 0
20120423 Bank IG versjon 1_02 av e2bformatet3v3
Side 23 av 63
BSK Implementasjonsguide B2B efaktura
Navn på XML-element
V er s jon: 1 .0 2 0
Beskrivelse
Krav Repetisjon Type
EmailAddress
E-postadresse til kontaktperson
K
0..1
String
WebAddress
Web-adresse til kontaktperson
K
0..1
String
Organisasjonsnummer: Påkrevd for leverandør .
Eksempel: 123456789 eller NO123456789
M
1
String
Mva-nummer (14 karakterer): Påkrevd ved fakturering med mva.
Eksempel: 123456789MVA eller NO123456789MVA (ikke krav med NO
foran)
Regel: Dersom MVA nummer er oppgitt i EHF formatet, må dette også
legges inn i VatID)
Avdeling: Avdeling innen selskap
K
0..1
String
K
0..1
String
Kontoinformasjon: Informasjon om konti for nasjonal og
internasjonal betaling
K
0..1
AccountInformation
Type
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
Swiftnummer: For internasjonal betaling
K
0..1
String
K
0..1
String
K
0..1
String
ProjectRef
ContractNumber
Prosjektreferanse: Hos aktuelle aktør
Kontraktnummer
Her legges kontraktsnummer mellom selger og kjøper som faktura er
knyttet til.
Anbefalt element i EHF formatet
K
K
0..1
0..1
String
String
Ref
Generelt referansefelt med kode.
Null eller mange forekomster
K
0..*
RefWithCodeType
OrgNumber
Merk at dette blir vist på faktura. Påkrevet element i EHF formatet
Regel: Organisasjonsnummer fra EHF skal alltid mappes til OrgNumber.
VatId
Department
AccountInformation
AccountNumber
IbanNumber
SwiftNumber
BSK
20120423 Bank IG versjon 1_02 av e2bformatet3v3
Side 24 av 63
BSK Implementasjonsguide B2B efaktura
Navn på XML-element
BSK
Beskrivelse
V er s jon: 1 .0 2 0
Krav Repetisjon Type
Code
Kode: Kode som angir type referanse.
M
0..1
String
Text
Referansenummer: Selve referansenummeret
K
0..1
String
20120423 Bank IG versjon 1_02 av e2bformatet3v3
Side 25 av 63
BSK Implementasjonsguide B2B efaktura
V er s jon: 1 .0 2 0
3.7.2 Buyer
Navn på XML-element
Beskrivelse
PartyType
Aktørinformasjon
M
1
Aktørnummer: Unik identifikator
M
1
PartyId
Krav Repetisjon Type
B2B (mellom bedrifter):
Her legges enten
efakturaId (bygges opp som BIC og IBAN med bindestrek i mellom)
Eksempel: XXXXXXXXXXX-NOXX15020012345
eller
Organisasjonsnummer (organisasjonsnummer skal ikke inneholde
bindestrek eller mellomrom):
Eksempel: NO123456789 eller 123456789 (anbefalt)
Andre verdier kan avtales mellom fakturautsteder og dennes bank
B2C (mot person):
Her legges efakturareferansen.
BSK
20120423 Bank IG versjon 1_02 av e2bformatet3v3
Side 26 av 63
IdentifierType
BSK Implementasjonsguide B2B efaktura
Navn på XML-element
@schemeId
V er s jon: 1 .0 2 0
Beskrivelse
Krav Repetisjon Type
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
M
1
String
M
1
String
K
0..1
IdentifierType
@schemeId
Lokasjonsnummer: For eksempel GLN (tidligere EANlokasjonsnummer).
Anbefalt element i EHF formatet
Identifikasjon på identifikator, for eksempel GLN
K
0..1
String
@schemeName
Navn på identifikator, for eksempel Global Localisation Number
K
0..1
String
@schemeAgency
navn på organisasjon som administrerer identifikatoren, for eksempel
GS1
K
0..1
String
Aktør navn: Navn på selskap
Påkrevet element i EHF formatet
M
1
String
B2C: ”efakturaRef”
Andre verdier: Avtales mellom fakturautsteder og dennes bank.
@schemeName
Navn på identifikator
B2B: ”efakturaId” eller ”Organisasjonsnummer”
B2C: ”efakturaRef”
Andre verdier: Avtales mellom fakturautsteder og dennes bank..
@schemeAgencyName
B2B: Mottakerbanks BIC eller ”Enhetsregisteret ved
Bronnoysundregisterne”
B2C: Verdien ”BBS” benyttes.
Andre verdier: Avtales mellom fakturautsteder og dennes bank..
LocationId
Name
BSK
20120423 Bank IG versjon 1_02 av e2bformatet3v3
Side 27 av 63
BSK Implementasjonsguide B2B efaktura
Navn på XML-element
ContactInformation
Krav Repetisjon Type
Kontaktinformasjon for bedriften
K
0..1
PhoneNumber
Telefonnummer: Bedriftens telefonnummer
K
0..1
ContactInformation
Type
String
FaxNumber
Telefaksnummer: Bedriftens telefaksnummer
K
0..1
String
EmailAddress
E-postadresse: Bedriftens e-postadresse
K
0..1
String
WebAddress
Webadresse: Bedriftens webadresse
K
0..1
String
Gateadresse: Null eller en forekomst
Gate-/besøksadresse 1
K
K
0..1
0..1
AddressType
String
Address2
Gate-/besøksadresse 2
K
0..1
String
Address3
Gate-/besøksadresse 3
K
0..1
String
PostalCode
Postnummer knyttet til gateadresse
K
0..1
String
PostalDistrict
Poststed knyttet til gateadresse
K
0..1
String
CountryCode
Landkode: 2 karakters kode i henhold til ISO 3166
K
0..1
String
CountryName
Navn på land ihht. Kode
K
0..1
String
Postadresse: Null eller en forekomst
K
0..1
AddressType
Address1
Postadresse 1
Påkrevet element i EHF formatet
K
0..1
String
Address2
Postadresse 2
Påkrevet element i EHF formatet
Postadresse 3
K
0..1
String
K
0..1
String
PostalCode
Postnummer knyttet til postadresse
Påkrevet element i EHF formatet
K
0..1
String
PostalDistrict
Poststed knyttet til postadresse
Påkrevet element i EHF formatet
K
0..1
String
CountryCode
Landkode: 2-karakters kode i henhold til ISO 3166
Påkrevet element i EHF formatet
Navn på land ihht. Kode
K
0..1
String
K
0..1
String
StreetAddress
Address1
PostalAddress
Address3
CountryName
BSK
Beskrivelse
V er s jon: 1 .0 2 0
20120423 Bank IG versjon 1_02 av e2bformatet3v3
Side 28 av 63
BSK Implementasjonsguide B2B efaktura
Navn på XML-element
ContactPerson
V er s jon: 1 .0 2 0
Beskrivelse
Krav Repetisjon Type
Kontaktperson: Null eller mange forekomster
K
0..*
M
1
String
FirstName
Navn på kontaktperson: Anbefalt format: ”Etternavn, Fornavn
Mellomnavn”
Påkrevet element i EHF formatet (Deres Ref)
Fornavn til kontaktperson: Anbefalt format: ”Fornavn Mellomnavn”
K
0..1
String
LastName
Etternavn til kontaktperson:
K
0..1
String
Function
Funksjon til kontaktperson: Stilling, rolle
K
0..1
String
Department
Avdeling til kontaktperson.
K
0..1
String
ContactInformation
Kontaktinformasjon for kontaktperson
K
0..1
PhoneNumber
Telefonnummer til kontaktperson
K
0..1
ContactInformation
Type
String
FaxNumber
Telefaksnummer til kontaktpersons
K
0..1
String
EmailAddress
E-postadresse til kontaktperson
K
0..1
String
WebAddress
Webadresse til kontaktperson
K
0..1
String
Organisasjonsnummer: Feltet anbefales brukt.
Eksempel: 123456789 eller NO123456789
K
0..1
String
Mva-nummer (14 karakterer): Påkrevd ved fakturering med mva.
Eksempel: 123456789MVA eller NO123456789MVA (ikke krav med NO
foran)
Regel: Dersom MVA nummer er oppgitt i EHF formatet, må dette også
legges inn i VatID)
Avdeling: Avdeling innen selskap
K
0..1
String
K
0..1
String
Kontoinformasjon: Informasjon om konti for nasjonal og
internasjonal betaling
Bankkontonummer: Bedriftens kontonummer
K
0..1
K
0..1
AccountInformation
Type
String
Name
OrgNumber
ContactPersonType
Merk at dette blir vist på faktura. Påkrevet element i EHF formatet
Regel: Organisasjonsnummer fra EHF skal alltid mappes til OrgNumber.
VatId
Department
AccountInformation
AccountNumber
BSK
20120423 Bank IG versjon 1_02 av e2bformatet3v3
Side 29 av 63
BSK Implementasjonsguide B2B efaktura
Navn på XML-element
V er s jon: 1 .0 2 0
Beskrivelse
Krav Repetisjon Type
IbanNumber
Ibannummer: For internasjonal betaling
K
0..1
String
SwiftNumber
Swiftnummer: For internasjonal betaling
K
0..1
String
ProjectRef
Prosjektreferanse: Hos aktuelle aktør
K
0..1
String
ContractNumber
Kontraktnummer
Merknad: Kontraktsnummer mellom kjøper og selger som faktura er
knyttet til skal legges under Supplier og ikke under Buyer
K
0..1
String
Ref
Generelt referansefelt med kode.
Null eller mange forekomster
K
0..*
RefWithCodeType
Code
Kode: Kode som angir type referanse.
For eksempel Kundenummer: ”CustomerNumber”
M
1
String
Text
Referansenummer: Selve referansenummeret
For eksempel Kundenummer legges her.
K
0..1
String
3.7.3 Factoring
Navn på XML-element
Beskrivelse
PartyType
Aktørinformasjon
K
0..1
K
0..1
IdentifierType
@schemeId
Aktørnummer: Unik identifikator
Factoringsselskapets Idnummer på utsteder.
Identifikasjon på identifikator, for eksempel SuppID
K
0..1
String
@schemeName
Navn på identifikator, for eksempel leverandørs identifikasjon
K
0..1
String
@schemeAgency
Navn på organisasjon som administrerer identifikatoren, for eksempel
aktuell leverandør
K
0..1
String
Lokasjonsnummer: For eksempel GLN (tidligere EANlokasjonsnummer).
Identifikasjon på identifikator, for eksempel GLN
K
0..1
IdentifierType
K
0..1
String
PartyId
LocationId
@schemeId
BSK
20120423 Bank IG versjon 1_02 av e2bformatet3v3
Krav Repetisjon Type
Side 30 av 63
BSK Implementasjonsguide B2B efaktura
Navn på XML-element
V er s jon: 1 .0 2 0
Beskrivelse
Krav Repetisjon Type
@schemeName
Navn på identifikator, for eksempel Global Localisation Number
K
0..1
String
@schemeAgency
navn på organisasjon som administrerer identifikatoren, for eksempel
GS1
K
0..1
String
Name
Aktørnavn: Navn på selskap
M
1
String
ContactInformation
Kontaktinformasjon for bedriften
K
0..1
Telefonnummer: Bedriftens Telefonnummer
K
0..1
ContactInformation
Type
String
Telefaksnummer: Bedriftens Telefaksnummer
K
0..1
String
K
0..1
String
Webadresse: Bedriftens webadresse
K
0..1
String
Gateadresse: Null eller en forekomst
Gate-/besøksadresse 1
K
K
0..1
0..1
AddressType
String
Address2
Gate-/besøksadresse 2
K
0..1
String
Address3
Gate-/besøksadresse 3
K
0..1
String
PostalCode
Postnummer knyttet til gateadresse
K
0..1
String
PostalDistrict
Poststed knyttet til gateadresse
K
0..1
String
CountryCode
Landkode: 2-karakters kode i henhold til ISO 3166
K
0..1
String
CountryName
Navn på land ihht. Kode
K
0..1
String
Postadresse: Null eller en forekomst
K
0..1
AddressType
Address1
Postadresse 1
K
0..1
String
Address2
Address3
Postadresse 2
Postadresse 3
K
K
0..1
0..1
String
String
PostalCode
Postnummer knyttet til postadresse
K
0..1
String
PostalDistrict
Poststed knyttet til postadresse
K
0..1
String
CountryCode
Landkode: 2 karakters kode i henhold til ISO 3166
K
0..1
String
CountryName
Navn på land ihht. Kode
K
0..1
String
PhoneNumber
FaxNumber
EmailAddress
WebAddress
StreetAddress
Address1
PostalAddress
BSK
E-postadresse: Bedriftens e-postadresse
20120423 Bank IG versjon 1_02 av e2bformatet3v3
Side 31 av 63
BSK Implementasjonsguide B2B efaktura
Navn på XML-element
ContactPerson
V er s jon: 1 .0 2 0
Beskrivelse
Krav Repetisjon Type
Kontaktperson: Null eller mange forekomster
K
0..*
M
1
String
FirstName
Navn på kontaktperson: Anbefalt format: ”Etternavn, Fornavn
Mellomnavn”
Fornavn til kontaktperson: Anbefalt format: ”Fornavn Mellomnavn”
K
0..1
String
LastName
Etternavn til kontaktperson:
K
0..1
String
Function
Funksjon til kontaktperson: Stilling, rolle
K
0..1
String
Department
Avdeling til kontaktperson.
K
0..1
String
ContactInformation
Kontaktinformasjon for kontaktperson
K
0..1
PhoneNumber
Telefonnummer til kontaktperson
K
0..1
ContactInformation
Type
String
FaxNumber
Telefaksnummer til kontaktpersons
K
0..1
String
EmailAddress
E-postadresse til kontaktperson
K
0..1
String
WebAddress
Webadresse til kontaktperson
K
0..1
String
OrgNumber
Organisasjonsnummer: Påkrevd for Leverandør (9 siffer). Feltet
anbefales brukt.
K
0..1
String
VatId
Mva-nummer: Påkrevd ved fakturering med mva (14 karakterer). Feltet
anbefales brukt.
K
0..1
String
Department
Avdeling: Avdeling innen selskap
K
0..1
String
AccountInformation
Kontoinformasjon: Informasjon om konti for nasjonal og
internasjonal betaling
K
0..1
AccountInformation
Type
AccountNumber
IbanNumber
Bankkontonummer: Factoringselskapets kontonummer
Ibannummer: For internasjonal betaling
K
K
0..1
0..1
String
String
SwiftNumber
Swiftnummer: For internasjonal betaling
K
0..1
String
ProjectRef
Prosjektreferanse: Hos aktuelle aktør
K
0..1
String
ContractNumber
Kontraktnummer
K
0..1
String
Ref
Generelt referansefelt med kode.
Null eller mange forekomster
K
0..*
RefWithCodeType
Name
BSK
20120423 Bank IG versjon 1_02 av e2bformatet3v3
Side 32 av 63
ContactPersonType
BSK Implementasjonsguide B2B efaktura
Navn på XML-element
BSK
Beskrivelse
V er s jon: 1 .0 2 0
Krav Repetisjon Type
Code
Kode: Kode som angir type referanse.
Her benyttes: ”AssignedClaused”
M
0..1
String
Text
Notifikasjonstekst
K
0..1
String
20120423 Bank IG versjon 1_02 av e2bformatet3v3
Side 33 av 63
BSK Implementasjonsguide B2B efaktura
V er s jon: 1 .0 2 0
3.7.4 Andre aktører
Omfatter informasjon som gjelder InvoiceIssuer, Invoicee, DeliveryPart, OrderedBy, UltimateCustomer, ShippedFrom
Navn på XML-element
Beskrivelse
PartyType
Aktørinformasjon
K
0..1
Aktørnummer: Unik identifikator
Identifikasjon på identifikator, for eksempel SuppID
K
K
0..1
0..1
IdentifierType
String
@schemeName
Navn på identifikator, for eksempel leverandørs identifikasjon
K
0..1
String
@schemeAgency
Navn på organisasjon som administrerer identifikatoren, for eksempel
aktuell leverandør
K
0..1
String
K
0..1
IdentifierType
@schemeId
Lokasjonsnummer: For eksempel GLN (tidligere EANlokasjonsnummer).
Identifikasjon på identifikator, for eksempel GLN
K
0..1
String
@schemeName
Navn på identifikator, for eksempel Global Localisation Number
K
0..1
String
@schemeAgency
navn på organisasjon som administrerer identifikatoren, for eksempel
GS1
K
0..1
String
Name
Aktørnavn: Navn på selskap
M
1
String
ContactInformation
Kontaktinformasjon for bedriften
K
0..1
PhoneNumber
Telefonnummer: Bedriftens Telefonnummer
K
0..1
ContactInformation
Type
String
FaxNumber
Telefaksnummer: Bedriftens Telefaksnummer
K
0..1
String
EmailAddress
E-postadresse: Bedriftens E-postadresse
K
0..1
String
WebAddress
Webadresse: Bedriftens webadresse
K
0..1
String
Gateadresse: Null eller en forekomst
Gate-/besøksadresse 1
K
K
0..1
0..1
AddressType
String
Address2
Gate-/besøksadresse 2
K
0..1
String
Address3
Gate-/besøksadresse 3
K
0..1
String
PostalCode
Postnummer knyttet til gateadresse
K
0..1
String
PostalDistrict
Poststed knyttet til gateadresse
K
0..1
String
PartyId
@schemeId
LocationId
StreetAddress
Address1
BSK
20120423 Bank IG versjon 1_02 av e2bformatet3v3
Krav Repetisjon Type
Side 34 av 63
BSK Implementasjonsguide B2B efaktura
Navn på XML-element
V er s jon: 1 .0 2 0
Beskrivelse
Krav Repetisjon Type
CountryCode
Landkode: 2 karakters kode i henhold til ISO 3166
K
0..1
String
CountryName
Navn på land ihht. Kode
K
0..1
String
Postadresse: Null eller en forekomst
Postadresse 1
K
K
0..1
0..1
AddressType
String
Address2
Postadresse 2
K
0..1
String
Address3
Postadresse 3
K
0..1
String
PostalCode
Postnummer knyttet til postadresse
K
0..1
String
PostalDistrict
Poststed knyttet til postadresse
K
0..1
String
CountryCode
Landkode: 2 karakters kode i henhold til ISO 3166
K
0..1
String
CountryName
Navn på land ihht. Kode
K
0..1
String
Kontaktperson: Null eller mange forekomster
Navn på kontaktperson: Anbefalt format: ”Etternavn, Fornavn
Mellomnavn”
K
M
0..*
1
ContactPersonType
String
FirstName
Fornavn til kontaktperson: Anbefalt format: ”Fornavn Mellomnavn”
K
0..1
String
LastName
Etternavn til kontaktperson:
K
0..1
String
Function
Funksjon til kontaktperson: Stilling, rolle
K
0..1
String
Department
Avdeling til kontaktperson.
K
String
ContactInformation
Kontaktinformasjon for kontaktperson
K
0..1
0..1
PhoneNumber
Telefonnummer til kontaktperson
K
0..1
ContactInformation
Type
String
FaxNumber
Telefaksnummer til kontaktpersons
K
0..1
String
EmailAddress
E-postadresse til kontaktperson
K
0..1
String
WebAddress
Webadresse til kontaktperson
K
0..1
String
OrgNumber
Organisasjonsnummer: Påkrevd for Leverandør (9 siffer). Feltet
anbefales brukt.
K
0..1
String
VatId
Mva-nummer: Påkrevd ved fakturering med mva (14 karakterer). Feltet
anbefales brukt.
K
0..1
String
PostalAddress
Address1
ContactPerson
Name
BSK
20120423 Bank IG versjon 1_02 av e2bformatet3v3
Side 35 av 63
BSK Implementasjonsguide B2B efaktura
Navn på XML-element
V er s jon: 1 .0 2 0
Beskrivelse
Krav Repetisjon Type
Department
Avdeling: Avdeling innen selskap
K
0..1
String
AccountInformation
K
0..1
AccountNumber
Kontoinformasjon: Informasjon om konti for nasjonal og
internasjonal betaling
Bankkontonummer: Bedriftens kontonummer
K
0..1
AccountInformation
Type
String
IbanNumber
Ibannummer: For internasjonal betaling
K
0..1
String
SwiftNumber
Swiftnummer: For internasjonal betaling
K
0..1
String
ProjectRef
Prosjektreferanse: Hos aktuelle aktør
K
0..1
String
ContractNumber
Kontraktnummer
K
0..1
String
Ref
K
0..*
RefWithCodeType
Code
Generelt referansefelt med kode.
Null eller mange forekomster
Kode: Kode som angir type referanse.
M
0..1
String
Text
Referansenummer: Selve referansenummeret
K
0..1
String
BSK
20120423 Bank IG versjon 1_02 av e2bformatet3v3
Side 36 av 63
BSK Implementasjonsguide B2B efaktura
V er s jon: 1 .0 2 0
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
Krav Repetisj Type
on
Fakturadetaljer
M
1..*
Fritekst: Null eller mange forekomster
Basisdetaljer: En eller mange forekomster
K
M
0..*
String
1..*
BaseItemDetailsType
Flerordre: Generell flerordre-struktur på linjenivå
Fakturahode: Standard e2b hodeinformasjon.
K
M
0..1
1
SubInvoiceType
HeaderType
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
K
0..1
String
InvoiceDetails
FreeText
BaseItemDetails
SubInvoice
Header
Details
BSK
Beskrivelse
20120423 Bank IG versjon 1_02 av e2bformatet3v3
Side 37 av 63
BSK Implementasjonsguide B2B efaktura
Navn på XML-element
Beskrivelse
Krav Repetisj Type
on
Level
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
K
0..1
String
SuppliersProductId
Leverandørs artikkel-/produkt-/tjenestenummer
Anbefalt element i EHF formatet
K
0..1
String
Description
M
1
String
BuyersProductId
Beskrivelse av artikkel/produkt/tjeneste
Påkrevet element i EHF formatet
Kjøperens artikkel-/produkt-/tjenestenummer
K
0..1
String
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.
K
0..1
String
Enhetspris
Påkrevet element i EHF formatet
Prisbeskrivelse. Angis dersom pris oppgis i enhet forskjellig fra beløp.
K
0..1
Decimal
K
0..1
String
Pristype. Lovlige verdier er:
AAA (Nettopris med rabatt/gebyr)
AAB (Bruttopris uten rabatt/gebyr)
K
0..1
String
Kodebeskrivelse: Valgfri beskrivelse i attributt
K
0..1
String
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
UnitPrice
PriceDenomination
PriceType
@codetext
BSK
V er s jon: 1 .0 2 0
20120423 Bank IG versjon 1_02 av e2bformatet3v3
Side 38 av 63
BSK Implementasjonsguide B2B efaktura
Navn på XML-element
Beskrivelse
Krav Repetisj Type
on
LineItemAmount
Linjebeløp uten mva inkludert eventuelle gebyrer/rabatter.
Må fylles ut dersom LineItemGrossAmount ikke er utfylt.
Påkrevet element i EHF formatet
A
1
Decimal
LineItemGrossAmount
Linjebeløp inkludert mva og eventuelle gebyrer/rabatter.
Må fylles ut dersom LineItemAmount ikke er utfylt.
A
1
Decimal
QuantityInvoiced
Fakturert kvantum
Påkrevet element i EHF formatet
K
0..1
Decimal
UnitOfMeasure
Enhet i henhold til ISO standard 31
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
K
0..1
String
K
0..1
ExchangeInformationType
ExchangeInformation
Currency
Valutakode: ISO Alpha kode (3 tegn) ISO 4217
M
1
ForeignAmount
ExchangeRate
Beløp i annen valuta: For eksempel kortbruk i annen valuta
Vekslingskurs: Kurs som benyttes ved omregning til NOK
M
K
1
0..1
Decimal
Decimal
ExchangeDate
Vekslingsdato: Dato for vekslingskurs
K
0..1
Date
K
0..1
OrderAndDeliveryInfoType
UnitOfMeasure
Bestillingsinformasjon: Informasjon om kjøperens bestilling.
Null eller en forekomst
Bestillingsenhet: Dersom denne avviker fra fakturert enhet
K
0..1
String
UnitPrice
Enhetspris i bestillingen: I forhold til bestilt enhet
K
0..1
Decimal
PriceType
Pristype: I forhold til bestilt enhet
K
0..1
String
Quantity
Bestilt kvantum: I forhold til bestilt enhet
K
0..1
Decimal
LineNum
Bestillingslinjenummer: Referanse til bestillingens linjenummer
Anbefalt element i EHF formatet
K
0..1
String
OrderInformation
BSK
V er s jon: 1 .0 2 0
20120423 Bank IG versjon 1_02 av e2bformatet3v3
Side 39 av 63
String
BSK Implementasjonsguide B2B efaktura
Navn på XML-element
DeliveryInformation
V er s jon: 1 .0 2 0
Beskrivelse
Krav Repetisj Type
on
K
0..1
OrderAndDeliveryInfoType
UnitOfMeasure
Leveringsinformasjon: Informasjon om leveransen.
Null eller en forekomst
Leveringsenhet: Dersom denne avviker fra fakturert enhet
K
0..1
String
UnitPrice
Enhetspris i leveransen: I forhold til levert enhet
K
0..1
Decimal
PriceType
Pristype: I forhold til levert enhet
K
0..1
String
Quantity
Levert kvantum: I forhold til levert enhet
K
0..1
Decimal
LineNum
Pakkseddellinjenummer: Referanse til linjenummer på pakkseddel
K
0..1
String
K
0..1
OrderAndDeliveryInfoType
K
0..1
String
SuppliersOrderInformati Leverandørordreinformasjon: Informasjon om leverandørs interne
on
ordre. Null eller en forekomst
UnitOfMeasure
Enhet: Dersom denne avviker fra fakturert enhet
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
K
0..1
String
Quantity
Kvantum: I forhold til enhet i leverandørs ordre
K
0..1
Decimal
LineNum
Ordrelinjenummer: Referanse til linjenummer i leverandørs ordre
K
0..1
String
Mva-informasjon: Mva som beregnes på linjebeløpet.
Null eller mange forekomster
VatPercent eller VatBaseAmount kan ikke oppgis alene
K
0..*
VatInfoType
Mva-prosent: For eksempel 25
Påkrevet element i EHF formatet
Mva-grunnlag: Grunnlag for mva-beregningen for den aktuelle satsen
K
0..1
Decimal
K
0..1
Decimal
Mva-beløp: Beløp for den aktuelle satsen
Avgifter på linjenivå utenom mva.
Null eller mange forekomster
K
K
0..1
0..*
Decimal
DiscountChargesAndTaxType
Code
Kode for avgift ihht. Avtale
K
0..1
String
Description
Beskrivelse av type avgift, ref. Code
K
0..1
String
VatInfo
VatPercent
VatBaseAmount
VatAmount
TaxInfo
BSK
20120423 Bank IG versjon 1_02 av e2bformatet3v3
Side 40 av 63
BSK Implementasjonsguide B2B efaktura
Navn på XML-element
Beskrivelse
Krav Repetisj Type
on
Percent
Avgiftsprosent
K
0..1
Decimal
BaseAmount
Avgiftsgrunnlag
K
0..1
Decimal
Amount
Quantity
Avgiftsbeløp
Kvantum: Angis dersom avgiften er relatert til et kvantum
K
K
0..1
0..1
Decimal
Decimal
UnitOfMeasure
Enhet relatert til kvantum
K
0..1
String
RatePerUnit
Sats: Angis dersom avgiften beregnes ut fra en sats pr. enhet
K
0..1
Decimal
VatInfo
Mva som beregnes på avgiften
K
1
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
Mva-beløp: Beløp for den aktuelle satsen
Angir rekkefølge for beregning av rabatter
K
K
0..1
0..1
Decimal
String
Rabatter på linjenivå.
Null eller mange forekomster
K
0..*
DiscountChargesAndTaxType
Code
Kode for rabatt ihht. Avtale
K
0..1
String
Description
Percent
Beskrivelse av type rabatt, ref. Code
Rabattprosent
K
K
0..1
0..1
String
Decimal
BaseAmount
Rabattgrunnlag
K
0..1
Decimal
Amount
Quantity
Rabattbeløp
Kvantum: Angis dersom rabatten er relatert til et kvantum
K
K
0..1
0..1
Decimal
Decimal
UnitOfMeasure
Enhet relatert til kvantum
K
0..1
String
RatePerUnit
Sats: Angis dersom rabatten beregnes ut fra en sats pr. enhet
K
0..1
Decimal
VatInfo
VatPercent
Mva som beregnes på rabatten
Mva-prosent: Ref.: Statens gjeldende MVA satser
K
K
1
0..1
VatInfoType
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
Angir rekkefølge for beregning av rabatter
K
0..1
String
VatAmount
CalculationSequence
Discount
CalculationSequence
BSK
V er s jon: 1 .0 2 0
20120423 Bank IG versjon 1_02 av e2bformatet3v3
Side 41 av 63
VatInfoType
BSK Implementasjonsguide B2B efaktura
Navn på XML-element
Charges
Beskrivelse
Krav Repetisj Type
on
Tillegg på linjenivå.
Null eller mange forekomster
K
0..*
DiscountChargesAndTaxType
Code
Kode for tillegg ihht. Avtale
K
0..1
String
Description
Percent
Beskrivelse av type tillegg, ref. Code
Tilleggsprosent
K
K
0..1
0..1
String
Decimal
BaseAmount
Tilleggsgrunnlag
K
0..1
Decimal
Amount
Quantity
Tilleggsbeløp
Kvantum: Angis dersom tillegget er relatert til et kvantum
K
K
0..1
0..1
Decimal
Decimal
UnitOfMeasure
Enhet relatert til kvantum
K
0..1
String
RatePerUnit
Sats: Angis dersom tillegget beregnes ut fra en sats pr. enhet
K
0..1
Decimal
VatInfo
VatPercent
Mva som beregnes på tillegget
Mva-prosent: Ref.: Statens gjeldende MVA satser
K
K
1
0..1
VatInfoType
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
Angir rekkefølge for beregning av rabatter
K
0..1
String
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 (periode)
K
0..1
String
CalculationSequence
@unitCode
BSK
V er s jon: 1 .0 2 0
Enhet for varighet. Påkrevd atributt
K
0..1
String
StartDate
Startdato: Dersom behov for å angi tidsperiode
K
0..1
Date
EndDate
Sluttdato: Dersom behov for å angi tidsperiode
K
0..1
Date
20120423 Bank IG versjon 1_02 av e2bformatet3v3
Side 42 av 63
BSK Implementasjonsguide B2B efaktura
Navn på XML-element
Beskrivelse
Krav Repetisj Type
on
SpecialCond
Spesielle betingelser: Foreslåtte verdier:
1 = Kampanje
2 = Verken bonusgivende eller bonusbyggende
3 = Bonusgivende
4 = Bonusbyggende
5 = Både bonusgivende og bonusbyggende
K
0..1
String
PostingInformation
Konteringsinformasjon: Hele konteringsstrengen
K
0..1
String
PostingDetails
Konteringsdetaljer: Oppbygging av konteringsstrengen.
Null eller mange forekomster.
Dimensjon: Generelt begrep, kan for eksempel være avdeling eller
prosjekt
Anbefalt element i EHF formatet
Kode: Kode for aktuell dimensjon
K
0..*
PostingDetailsType
M
1
String
M
1
String
Dimension
PostingCode
Ref
BSK
V er s jon: 1 .0 2 0
K
0..*
Code
Referanse: Generelt referansefelt med kode.
Null eller mange forekomster.
Kode: Kode som angir type referanse.
RefWithCodeType
M
1
String
Text
Referansenummer: Selve referansenummeret
K
0..1
String
FreeText
Fritekst: Til generell informasjon som ikke kan legges i andre felter.
K
0..1
String
CardDetailsInformation
Kortdetaljer. Bransjespesifikt tillegg for kredittkortfakturaer.
K
0..1
CardDetailsInfoType
InsuranceDetails
Forsikringsdetaljer. Bransjespesifikt tillegg for faktraer relatert til
forsikringsoppgjør.
K
0..1
InsuranceDetailsType
EnergyDetails
Energidetaljer. Bransjespesifikt tillegg for energifakturaer (strøm og
nett). Innhold er beskrevet i eget dokument
K
0..1
EnergyDetailstype
BuildingDetails
Byggedetaljer. Bransjespesifikt tillegg for fakturaer innen bygg,
elektro og VA/VVS.
K
0..1
BuildingDetailstype
20120423 Bank IG versjon 1_02 av e2bformatet3v3
Side 43 av 63
BSK Implementasjonsguide B2B efaktura
V er s jon: 1 .0 2 0
3.9 Fakturarabatter, tillegg og avgifter
Navn på XML-element
Krav
Repetisjon Type
Fakturarabatter, tillegg og avgifter på fakturanivå.
K
0..1
Rabatter som gis på fakturatotalen.
Null eller mange forekomster
K
0..1
DiscountCharg
esAndTaxType
Code
Kode for rabatt ihht. Avtale
K
0..1
String
Description
Percent
Beskrivelse av type rabatt, ref. Code
Rabattprosent
K
K
0..1
0..1
String
Decimal
BaseAmount
Rabattgrunnlag
K
0..1
Decimal
Amount
Quantity
Rabattbeløp
Kvantum: Angis dersom rabatten er relatert til et kvantum
K
K
0..1
0..1
Decimal
Decimal
UnitOfMeasure
Enhet relatert til kvantum
K
0..1
String
RatePerUnit
Sats: Angis dersom rabatten beregnes ut fra en sats pr. enhet
K
0..1
Decimal
VatInfo
VatPercent
Mva som beregnes på rabatten
Mva-prosent: Ref.: Statens gjeldende MVA satser
K
K
0..1
0..1
VatInfoType
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
Angir rekkefølge for beregning av rabatter
K
0..1
String
Tillegg som kommer til fakturatotalen.
Null eller mange forekomster
K
0..1
DiscountCharg
esAndTaxType
Code
Kode for tillegg ihht. Avtale
K
0..1
String
Description
Percent
Beskrivelse av type tillegg, ref. Code
Tilleggsprosent
K
K
0..1
0..1
String
Decimal
BaseAmount
Tilleggsgrunnlag
K
0..1
Decimal
Amount
Quantity
Tilleggsbeløp
Kvantum: Angis dersom tillegget er relatert til et kvantum
K
K
0..1
0..1
Decimal
Decimal
InvoiceDiscount
ChargesAndTax
InvoiceDiscountInfo
CalculationSequence
InvoiceChargesInfo
BSK
Beskrivelse
20120423 Bank IG versjon 1_02 av e2bformatet3v3
Side 44 av 63
BSK Implementasjonsguide B2B efaktura
Navn på XML-element
Beskrivelse
Krav
Repetisjon Type
UnitOfMeasure
Enhet relatert til kvantum
K
0..1
String
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
Mva-beløp: Beløp for den aktuelle satsen
Angir rekkefølge for beregning av tillegg
K
K
0..1
0..1
Decimal
String
Statlige avgifter som kommer til fakturatotalen.
Null eller mange forekomster
K
0..*
DiscountCharg
esAndTaxType
Code
Kode for avgift ihht. Avtale
K
0..1
String
Description
Percent
Beskrivelse av type avgift, ref. Code
Avgiftsprosent
K
K
0..1
0..1
String
Decimal
BaseAmount
Avgiftsgrunnlag
K
0..1
Decimal
Amount
Quantity
Avgiftsbeløp
Kvantum: Angis dersom avgiften er relatert til et kvantum
K
K
0..1
0..1
Decimal
Decimal
UnitOfMeasure
Enhet relatert til kvantum
K
0..1
String
RatePerUnit
VatInfo
Sats: Angis dersom avgiften beregnes ut fra en sats pr. enhet
Mva som beregnes på avgiften
K
K
0..1
0..1
Decimal
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
Mva-beløp: Beløp for den aktuelle satsen
Angir rekkefølge for beregning av avgifter
K
K
0..1
0..1
Decimal
String
VatAmount
CalculationSequence
InvoiceTaxInfo
VatAmount
CalculationSequence
BSK
V er s jon: 1 .0 2 0
20120423 Bank IG versjon 1_02 av e2bformatet3v3
Side 45 av 63
BSK Implementasjonsguide B2B efaktura
V er s jon: 1 .0 2 0
3.10 Fakturatotaler
Navn på XML-element
InvoiceSummary
Krav Repetisjon Type
Fakturatotaler
M
1
FreeText
Fritekst: En eller flere linjer
K
0..*
InvoiceTotals
Totaler: Må forekommme en gang
M
1
K
0..1
Decimal
DiscountTotalsAmount
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.
Sum totalt rabatter
K
0..1
Decimal
ChargesTotalsAmount
Sum totalt tillegg
K
0..1
Decimal
TaxTotalsAmount
Sum totalt avgifter
K
0..1
Decimal
PrePaidAmount
CommissionAmount
Sum totalt forhåndsbetalt beløp. For eksempel akonto-beløp
Sum totalt provisjonsbeløp. For eksempel ved bruk av reisebyrå
K
K
0..1
0..1
Decimal
Decimal
GrossAmount
Bruttobeløp: Fakturabeløp inkludert mva.
Påkrevet element i EHF formatet
M
1
Decimal
VatTotalsAmount
Sum totalt mva-beløp
Påkrevet element i EHF formatet
M
1
Decimal
NetAmount
Nettobeløp: Fakturabeløp uten mva
Påkrevet element i EHF formatet
Øresavrunding: På totalt bruttobeløp
M
1
Decimal
K
0..1
Decimal
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
LineItemTotalsAmount
RoundingAmount
VatTotalsInfo
BSK
Beskrivelse
20120423 Bank IG versjon 1_02 av e2bformatet3v3
Side 46 av 63
String
InvoiceTotalstype
BSK Implementasjonsguide B2B efaktura
Navn på XML-element
Beskrivelse
Krav Repetisjon Type
VatPercent
Mva-prosent: For eksempel Ref.: Statens gjeldende MVA satser
Påkrevet element i EHF formatet
K
0..1
Decimal
VatBaseAmount
Mva-grunnlag: Totalt grunnlag for mva-beregningen for den aktuelle
prosentsatsen
Påkrevet element i EHF formatet
K
0..1
Decimal
VatAmount
Mva-beløp: Totalt beløp for den aktuelle prosentsatsen
Påkrevet element i EHF formatet
K
0..1
Decimal
K
0..*
TaxTotalsInfoType
TaxCode
Spesifisering av sum avgifter utover mva pr. kode/type.
Null eller mange forekomster
Kode for avgiftskode ihht. Avtale
K
0..1
String
TaxDescription
Beskrivelse av type avgift, ref. kode
K
0..1
String
TaxAmount
Avgiftsbeløp for den aktuelle koden
K
0..1
Decimal
K
0..*
Code
Spesifisering av sum rabatter pr. kode.
Null eller mange forekomster
Kode for rabatt ihht. Avtale
K
0..1
DiscountCharges
AndTaxType
String
Description
Beskrivelse av type rabatt, ref. kode
K
0..1
String
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
K
0..1
String
RatePerUnit
Sats: Angis dersom rabatten beregnes ut fra en sats pr. enhet
K
0..1
Decimal
VatInfo
VatPercent
Mva som beregnes på rabatten
Mva-prosent: P.t.. Ref.: Statens gjeldende MVA satser
K
K
0..1
0..1
VatInfoType
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
Angir rekkefølge for beregning av rabatter
K
0..1
String
TaxTotalsInfo
DiscountTotals
CalculationSequence
BSK
V er s jon: 1 .0 2 0
20120423 Bank IG versjon 1_02 av e2bformatet3v3
Side 47 av 63
BSK Implementasjonsguide B2B efaktura
Navn på XML-element
ChargesTotals
Beskrivelse
Krav Repetisjon Type
K
0..*
Code
Spesifisering av sum tillegg pr. kode.
Null eller mange forekomster
Kode for tillegg ihht. Avtale
K
0..1
DiscountCharges
AndTaxType
String
Description
Beskrivelse av type tillegg, ref. Kode
K
0..1
String
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
K
0..1
String
RatePerUnit
Sats: Angis dersom tillegget beregnes ut fra en sats pr. enhet
K
0..1
Decimal
VatInfo
VatPercent
Mva som beregnes på tillegget
Mva-prosent: P.t.. Ref.: Statens gjeldende MVA satser
K
K
0..1
0..1
VatInfoType
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
Angir rekkefølge for beregning av tillegg
K
0..1
String
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)
Valuta. ISO Alpha kode (3 tegn) ISO 4217
K
0..1
Decimal
K
0..1
String
Heltallsdel av faktisk beløp
Påkrevet element i EHF formatet
Desimaldel av faktisk beløp
Påkrevet element i EHF formatet
Moduluskode
K
0..1
Integer
K
0..1
Integer
K
0..1
String
CalculationSequence
ActualPayment
@Currency
@integerValue
@decimalValue
@modulus
BSK
V er s jon: 1 .0 2 0
20120423 Bank IG versjon 1_02 av e2bformatet3v3
Side 48 av 63
BSK Implementasjonsguide B2B efaktura
V er s jon: 1 .0 2 0
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=”http://www.w3.org/2001/XMLSchema-instance” xmlns=”http://www.e2b.no/XMLSchema”
xsi:schemaLocation=”http://www.e2b.no/XMLSchema H:\e2b_Invoice_v3p3\Schema\e2b_Invoice_Interchange_v3p3.xsd”>
<Invoice MessageVersion=”3.3” MessageOwner=”e2b” MessageType=”Invoice”>
<MessageTimestamp>2008-09-16T09:30:47.0Z</MessageTimestamp>
<NumberOfLines>1</NumberOfLines>
<InvoiceHeader>
<InvoiceType codetext=”Faktura”>380</InvoiceType>
<InvoiceStatus codetext=”Original”>9</InvoiceStatus>
<InvoiceNumber>92345</InvoiceNumber>
<I”voiceDate>2”08-04-13</Inv”iceDate>
”<Supplier>
<PartyId schemeId=””efakturaId”” schemeName=””efakturaId””
schemeAgencyName=”ESSENOKX”>ESSENOKX-NO0015020012345</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>987654321</OrgNumber>
BSK
20120423 Bank IG versjon 1_02 av e2bformatet3v3
Side 49 av 63
BSK Implementasjonsguide B2B efaktura
V er s jon: 1 .0 2 0
<VatId>MVA987654321NO</VatId>
<Department>IT</Department>
<AccountInformation>
<AccountNumber>5005051234</AccountNumber>
</AccountInformation>
<ProjectRef>Project1</ProjectRef>
<ContractNumber>54”25412</Con”ractNumber>
”
</Suppli”r>
<Buyer>
<PartyId schemeId=”efakturaId” schemeName=”efakturaId”
schemeAgencyName=”ESSENOKX”>ESSENOKX-NO0000000000000</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>998877665</OrgNumber>
<VatId>MVA998877665NO</VatId>
</Buyer>
<InvoiceReferences>
<BuyersOrderNumber>54321</BuyersOrderNumber>
<BuyersOrderDate>2008-04-10</BuyersOrderDate>
<DeliveryTerms>Fritt levert pr. bil</DeliveryTerms>
<DeliveryDate>2008-04-11</DeliveryDate>
</InvoiceReferences>
BSK
20120423 Bank IG versjon 1_02 av e2bformatet3v3
Side 50 av 63
BSK Implementasjonsguide B2B efaktura
V er s jon: 1 .0 2 0
<Payment>
<DueDate>2008-09-28</DueDate>
<Currency>NOK</Currency>
<KidNumber>123456789</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
20120423 Bank IG versjon 1_02 av e2bformatet3v3
Side 51 av 63
BSK Implementasjonsguide B2B efaktura
V er s jon: 1 .0 2 0
<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
20120423 Bank IG versjon 1_02 av e2bformatet3v3
Side 52 av 63
BSK Implementasjonsguide B2B efaktura
V er s jon: 1 .0 2 0
<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
20120423 Bank IG versjon 1_02 av e2bformatet3v3
Side 53 av 63
BSK Implementasjonsguide B2B efaktura
V er s jon: 1 .0 2
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.
1.1. 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
2 0 1 2 0 4 2 3 B a n k I G ve r s j o n 1 _ 0 2 a v
e 2 b f o r m a t e t 3 v3
Side 54 av 63
BSK Implementasjonsguide B2B efaktura
V er s jon: 1 .0 2
Type referanse
Forslag i felles IG
Kundenummer
Fakturautsteders kundenr for
fakturamottaker:
InvoiceHeader/Buyer/Ref
der
Code =”CustomerNumber” og Text
inneholder verdien
Leverandørnummer
Fakturautsteders leverandørnummer hos
fakturamottaker:
InvoiceHeader/Supplier/Ref
der
Code =”SupplierNumber” og Text
inneholder verdien for
leverandørenummer.
Vår referanse
(fakturautsteder)
InvoiceHeader/Supplier/Ref
der
Code =”OurReference” og Text
inneholder verdien for ”vår referanse”
Deres referanse
(fakturamottaker)
InvoiceHeader/Buyer /Ref
der
Code =”YourReference” og Text
inneholder verdien for ”deres referanse”.
Betalingsreferanse som
ikke er en norsk KID
InvoiceHeader/Ref
der
Code =”PaymentReference” og Text
inneholder verdien for
betalingsreferansen
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.
AvtaleGiro (B2C)
(fakturamottaker)
InvoiceHeader/Buyer /Ref
der
Code:”AvtaleGiro”
Brukes for å angi en efaktura
B2C med AvtaleGiro som
betalingsmåte ”AvtaleGiro”.
Gårds- og
bruksnummer.
InvoiceHeader/Buyer /Ref
der
Code =”GaardsBruksNr” og Text
inneholder verdien for gårds og
bruksnummer.
Internettadresser (Link)
InvoiceHeader/Supplier/Ref
BSK
2 0 1 2 0 4 2 3 B a n k I G ve r s j o n 1 _ 0 2 a v
e 2 b f o r m a t e t 3 v3
Kommentar
Dette gjelder det som
identifiserer leverandør i
kundens systemer
Side 55 av 63
BSK Implementasjonsguide B2B efaktura
Type referanse
Forslag i felles IG
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.
”http://www.test.no”)
V er s jon: 1 .0 2
Kommentar
Prinsippet for bruk av ”Ref”-felter bør også benyttes for andre referanser som ikke har
et ”naturlig” felt i formatet.
1.3. 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>40061001</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
2 0 1 2 0 4 2 3 B a n k I G ve r s j o n 1 _ 0 2 a v
e 2 b f o r m a t e t 3 v3
Side 56 av 63
BSK Implementasjonsguide B2B efaktura
V er s jon: 1 .0 2
1.4. 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
2 0 1 2 0 4 2 3 B a n k I G ve r s j o n 1 _ 0 2 a v
e 2 b f o r m a t e t 3 v3
Side 57 av 63
BSK Implementasjonsguide B2B efaktura
BSK
2 0 1 2 0 4 2 3 B a n k I G ve r s j o n 1 _ 0 2 a v
e 2 b f o r m a t e t 3 v3
V er s jon: 1 .0 2
Side 58 av 63
BSK Implementasjonsguide B2B efaktura
V er s jon: 1 .0 2
<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>
Kodeeksempel:
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
2 0 1 2 0 4 2 3 B a n k I G ve r s j o n 1 _ 0 2 a v
e 2 b f o r m a t e t 3 v3
Side 59 av 63
BSK Implementasjonsguide B2B efaktura
V er s jon: 1 .0 2
1.6. 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).
1.7. Mappingregler knyttet til EHF formatet
1.7.1.
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.
1.7.2.
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.
1.7.3. 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
2 0 1 2 0 4 2 3 B a n k I G ve r s j o n 1 _ 0 2 a v
e 2 b f o r m a t e t 3 v3
Side 60 av 63
BSK Implementasjonsguide B2B efaktura
V er s jon: 1 .0 2
1.7.4.
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.
1.7.5.
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
2 0 1 2 0 4 2 3 B a n k I G ve r s j o n 1 _ 0 2 a v
e 2 b f o r m a t e t 3 v3
Side 61 av 63
BSK Implementasjonsguide B2B efaktura
V er s jon: 1 .0 2
Endringslogg
Endringer gjort i versjon 1.01 fra versjon 1.0
Kapittel
3.2
3.2
3.3
3.6
Endring
Merknad
Følgende setning er lagt inn:
” Bruk av vedlegg er beskrevet i en egen
appendiks.”
Figur: Det er åpnet for bruk av
”Utvekslingshode” samt ”Meldingshode” i
meldingen.
Følgende setning er lagt inn:
”Bruk av Interchange Header og Message
Header er bekrevet i egne dokumenter som
kan hentes ned fra www.e2b.no, da det ikke er
identifisert et behov for BSK å beskrive disse
spesielt for bruk ifm. bankenes løsning.”
Elementet ”Attachements“ åpnet for bruk.
Endringer gjort i versjon 1.02 fra versjon 1.01
Kapittel
1.1
2.1
2.3
2.6
2.7
2.8
3.3
3.5 – 3.10
Generelt
BSK
Endring
Merknad
Revidert slik at orgnummer fremgår som mulig
adresseringsmekanisme.
Lagt inn merknad knyttet til type
forretningsdokumenter.
Lagt inn presisering om at bankene også
støtter ISO-8859-1
Revidert elementene som kan benyttes for
dublikatkontroll slik at orgnummer fremgår som
mulig adresseringsmekanisme.
Nytt kapittel med henvisning til bankenes
visningsmal
Nytt kapittel med henvisning til EHF formatet.
Lagt inn henvisning til hvordan prosessmal skal
formidles
Lagt inn henvisning til hvilke
informasjonselementer som er påkrevet og
anbefalt i EHF formatet.
Generelle rettelser uten betydning for innhold
er foretatt.
2 0 1 2 0 4 2 3 B a n k I G ve r s j o n 1 _ 0 2 a v
e 2 b f o r m a t e t 3 v3
Side 62 av 63
BSK Implementasjonsguide B2B efaktura
3.6
Feltype for ”BuyersOrderDate” er endret fra
”String” til ”Date”.
3.8/3.9/3.10
Vedlegg 2,
Kap 1.7
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.
Lagt inn merknad knyttet til mapping av
unitcodes
Lagt inn informasjon om at VatAmount må
være med dersom mottaker benytter EHF
formatet.
Lagt inn konkrete mappingregler melom e2b og
EHF formatet
Kap. 1.7.5
Nytt
3.7.1
3.7.2
3.7.1 / 3.7.2
3.8
3.9
BSK
2 0 1 2 0 4 2 3 B a n k I G ve r s j o n 1 _ 0 2 a v
e 2 b f o r m a t e t 3 v3
V er s jon: 1 .0 2
”String” er endret fra
e2b versjon 3.3 til
”Date” i versjon
3.4/3.4.1
Side 63 av 63