eGet Fakturaformat Brukerdokumentasjon

Transcription

eGet Fakturaformat Brukerdokumentasjon
BSK implementation guide
e2b-format v.3.3
Banks common implementation guide
based on version 3.3 of the
e2b Invoice Format
Version: 1.02
3. September 2012
Bankenes Standardiseringskontor
Postbox 2644 Solli
0203 OSLO
Tel. 23 28 45 10
Email: post@bsk.no
BSK Implementation guide B2B e-invoice
V er s ion: 1 .0 1
Change log (English version)
DATE
VER
DONE BY
CHANGES
21.09.2010
1.0
Morten Krøgenes
Approved BSK IG for e2b format version 3.3 (English
translation)
01.02.2011
1.01
Morten Krøgenes
Updated in order to open the possibility for attachements
16.04.2012
1.02
Morten Krøgenes
Updated with governments requirements connected to the
EHF format
3.9.2012
1.02
Morten Krøgenes
Removed bullet in appendix 2, kap. 1.7.3 which was
connected to mapping of attachments between the EHF/e2b
format.
Note: Se change log at end of the document.
BSK
20120903 Bank IG 1v02 e2bformatet3v3 English
Side 2 av 62
BSK Implementation guide B2B e-invoice
V er s ion: 1 .0 1
Table of contents
1.
Introduction .................................................................................................................. 5
1.1
1.2
1.3
2.
PREREQUISITES .........................................................................................................................5
TARGET GROUP FOR THIS DOCUMENT ......................................................................................5
EXPLANATION OF THE TABLES .................................................................................................6
Invoice - Overall description of the format ................................................................. 7
2.1
2.2
2.3
2.4
2.5
2.6
2.7
2.8
BUSINESS DOCUMENTS ............................................................................................................7
INDUSTRY-SPECIFIC EXTENSIONS .............................................................................................8
TECHICAL GUIDELINES .............................................................................................................8
FILLING IN AMOUNT FIELDS......................................................................................................8
USE OF STATUS MESSAGE .......................................................................................................11
DUPLICATE CONTROL .............................................................................................................11
TEMPLATE VIEW .....................................................................................................................11
MAPPING RELATED TO THE EHF FORMAT (REF. THE GOVERNMENTS REQUIREMENTS
RELATING TO ELECTRONIC INVOICE) ..................................................................................................12
3.
Invoice - Structure of the message ............................................................................13
3.1
NAME STANDARD INVOICE FILES ...........................................................................................13
3.2
STRUCTURE OVERVIEW ..........................................................................................................13
3.3
INTERCHANGE ........................................................................................................................15
3.4
ENVELOPE...............................................................................................................................15
3.5
INVOICE MESSAGE..................................................................................................................16
3.6
INVOICE HEADER ....................................................................................................................17
3.7
PARTY INFORMATION .............................................................................................................21
3.7.1
Supplier ............................................................................................................................ 21
3.7.2
Buyer ................................................................................................................................ 26
3.7.3
Factoring .......................................................................................................................... 31
3.7.4
Other parties..................................................................................................................... 34
3.8
INVOICE DETAILS ....................................................................................................................38
3.9
INVOICE DISCOUNT, CHARGES AND TAX ................................................................................45
3.10 INVOICE TOTALS .....................................................................................................................47
Appendix 1: Example of an invoice file.............................................................................50
Appendix 2: Advice for using the format ..........................................................................54
1.
1.1.
1.2.
1.3.
1.4.
1.5.
1.6.
1.7.
1.7.1.
1.7.2.
1.7.3.
1.7.4.
1.7.5.
BSK
THE USE OF THE FORMAT........................................................................................................54
ACTORS/ROLES.......................................................................................................................54
USE OF FIELDS IN RELATION TO REFERENCES ........................................................................54
SPECIAL FIELDS AND INDUSTRY SPECIFIC SOLUTIONS ...........................................................56
LEVELS ...................................................................................................................................57
CONSOLIDATED INVOICE ........................................................................................................58
POSTAL AND STREET ADDRESS ...............................................................................................59
MAPPINGRULES CONNECTED TO THE EHF FORMAT...............................................................59
RULE - MAPPING OF INVOICE AMOUNT AND THE AMOUNT TO BE PAID ..................................59
RULE - MAPPING OF FACTORING PARTY (E2B) AND PAYEE PARTY (EHF) ............................59
RULE - MAPPING OF ATTACHEMENTS BETWEEN E2B AND EHF..............................................59
UNIT CODES ............................................................................................................................60
DEPENDENCIES BETWEEN THE AMOUNT FIELDS.....................................................................60
20120903 Bank IG 1v02 e2bformatet3v3 English
Side 3 av 62
BSK Implementation guide B2B e-invoice
BSK
20120903 Bank IG 1v02 e2bformatet3v3 English
V er s ion: 1 .0 1
Side 4 av 62
BSK Implementation guide B2B e-invoice
V er s ion: 1 .0 1
1. Introduction
This implementation guide is prepared by BSK.
This implementation guide describes how e2b version 3.3 format is to be used for sending
electronic invoices in the banking network. The format can be used both for B2B and B2C.
The documentation must be read in conjunction with the bank’s User Guidelines.
This document is a translation of the equivalent Norwegian documentation for the BSK
Implementation Guide for e2b-format ver. 3.3. In the event of any discrepancies between
the two versions, the Norwegian one shall be regarded as the master version and the
correct one.
1.1 Prerequisites
To be able to send e-invoices in the banking network, the following prerequisites must be
met:
1. Agreement with bank
- both the invoice recipient and invoice issuer must enter into a service
agreement with its bank
2. Addressing:
- The banks offer addressing based on e-invoice ID and organisational number.
The invoice issuer and the invoice receiver are responsible for exchanging the
address information between them.
3. Adaptions in ERP-systems:
- The addressinginformation (e-invoice ID / organisational number) for both the
invoice issuer and invoice recipient must be included in the invoice file. It may
therefore be necessary to make adjustments in the ERP system.
1.2 Target group for this document
The target group for this document is technical personnel which is responsible for the
implementation of e-invoice solutions at the organisation of the e-invoice issuer or the
organisation of the e-invoice receiver.
BSK
20120903 Bank IG 1v02 e2bformatet3v3 English
Side 5 av 62
BSK Implementation guide B2B e-invoice
V er s ion: 1 .0 1
1.3 Explanation of the tables
Below is an explanation of the columns in the tables in Chapter 3 and 6
Name of XML element refers to the actual tag name in XML
Description specifies rules for data content, legal code values, etc.
Fields in italics are not guaranteed delivered if the invoice recipient uses another format
than e2b version 3.3.
Requirement indicates whether the field is
M = Mandatory (Must be part of the message)
K = Optional (May be included in the message)
A = Dependent (Use is dependent on specific criteria)
Repetition indicates how many times the field should / can be repeated. See below:
1
Mandatory, used, only once
1..3
Mandatory, used minimum once, may be used up to 3 times
1..*
Mandatory, used minimum once, may be used many times
0..1
Optional, used maximally once
0..*
Optional, the field may be used many times
Type specifies the type of value to be transferred to the appropriate element in the XML
notation
String = Alfanumeric
Integer = Numbers
Decimal = Desimalnumbers
Date = Date (YYYY-MM-DD)
Time= Time (HH:MM:SS)
DateTime = Date+Time (YYYY-MM-DDTHH:MM:SS)
Attributes are marked with the prefix @.
BSK
20120903 Bank IG 1v02 e2bformatet3v3 English
Side 6 av 62
BSK Implementation guide B2B e-invoice
V er s ion: 1 .0 1
2. Invoice - Overall description of the format
2.1 Business Documents
The implementation Guide supports the following business documents:
Functional
Business
Document
Sending
role
Receiving
role
Description
Invoice
Supplier
Buyer
An invoice is a clear and unified sales
document that presents the seller's /
supplier's outstanding accounts towards the
Buyer and documents the Buyer’s rights to
receive products and services.
Credit Note
Supplier
Buyer
Credit Note is used by the supplier to
disclose information about the credit amount
the Buyer has against the supplier.
Reminder
Supplier
Buyer
Reminders are used by the supplier to
disclose information about the payment of
outstanding claims that has not been
received by the supplier as described in the
invoice. The solution facilitates that the
supplier may also send reminders to the
Buyer.
Notification of debt collection should be sent
via mail (formal requirements acc. Law).
Interest
invoice
Supplier
Buyer
Interest invoice is used by the supplier to
disclose information about outstanding
interest claim the supplier has on the Buyer
Electronic
invoice
State
Electronic invoice is an invoice in a unified
structured form that is transported
electronically from the invoice issuer to the
invoice recipient and which can be further
processed by machine at the invoice
recipients in-house ERP systems. It is not
sufficient that the bill is "electronic" or
machine available. The data must be
structured in such a way that the document
can "float" between different systems. This
means that a file (such as pdf or image
format) that are made on the basis of a paper
invoice, do not normally meet the definition of
electronic invoice.
Note connected to coding of the business documents in the format:
The code i InvoiceType denotes if it is an invoice, creditnote og reminder. Notice that the
same code is used for both invoice and reminder. The difference between these is
specified in @codetext. The coding for reminder is therefore be InvoiceType=380 and
@codetext “Purring”.
BSK
20120903 Bank IG 1v02 e2bformatet3v3 English
Side 7 av 62
BSK Implementation guide B2B e-invoice
V er s ion: 1 .0 1
2.2 Industry-specific extensions
All invoices must contain a minimum of basic information on the head-, detail- and
sumlevel.
In addition, an invoice can contain information related to a particular industry. This
information is necessary to describe the product or service that is the basis for billing.
Such industry-specific extensions may also be included on the head and detail.
To ensure that the structure is met in all kinds of messages, the following principles are
established for using industry-specific extensions in the format:
 If the industry-specific extension contains information on more than one level
(consolidated invoice / multi-order invoice), they must be added before the basic
details so that the base details represents a sum level of the industry-specific details.
 If the industry-specific extension contains information on one level, this should be
added directly after the base details for each invoice line.
Banks do not guarantee that the information in industry-specific extensions can be
distributed to the invoice recipient.
2.3 Techical guidelines



Character set: Unicode UTF-8 (the banks also supports ISO-8859-1)
Date format: YYYY-MM-DD
Decimal character: Dot
2.4 Filling in amount fields
The amount at line level that is to be added to the invoice total must be positive in the
invoice and in the credit note.
The amount at the line level that is to be deducted from the invoice total must have a
negative sign in both the invoice and the credit note.
VAT amounts, discountamounts, taxamounts and other additional amounts must to be
positive.
The figure below shows the relationship between the amounts in the message. It is used
+, - and =. Otherwise, the summation is indicated by the cardinality / hierarchy between
classes. Relation "many-to-one" means that many amounts are merged into one amount.
That part of the relationship that has no symbol can be repeated several times and the
amounts can be summarized in the class where the relationship is marked with "♦". The
figure is best read from below.
BSK
20120903 Bank IG 1v02 e2bformatet3v3 English
Side 8 av 62
BSK Implementation guide B2B e-invoice
V er s ion: 1 .0 1
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
0..1
LineItemTotalsAmount
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
20120903 Bank IG 1v02 e2bformatet3v3 English
Side 9 av 62
BSK Implementation guide B2B e-invoice
V er s ion: 1 .0 1
The example below shows the calculation of line sums, charges / discounts and invoice
totals in an e2b invoice.
Calculation of line sums, charges/discounts and invoice totals
Line level
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>
+=
Invoice level
<InvoiceDiscountChargesAndTax><InvoiceCharges>
<BaseAmount>
<InvoiceDiscountChargesAndTax><InvoiceCharges><Percent>
*
<InvoiceDiscountChargesAndTax><InvoiceCharges><Amount>
<InvoiceDiscountChargesAndTax><InvoiceCharges><VatInfo>
<VatBaseAmount>
=
<InvoiceDiscountChargesAndTax><InvoiceCharges><VatInfo>
*
<VatPercent>
<InvoiceDiscountChargesAndTax><InvoiceCharges><VatInfo>
=
<VatAmount>
+=
Invoice totals
<InvoiceSummary><InvoiceTotals><LineItemTotalsAmount>
=
<InvoiceSummary><InvoiceTotals><ChargesTotalsAmount>
=
<InvoiceSummary><InvoiceTotals><VatTotalsAmount>
+=
+
<InvoiceSummary><InvoiceTotals><RoundingAmount>
=
<InvoiceSummary><InvoiceTotals><GrossAmount>
BSK
Product
Product1
Quantity
5
Unit price
2,5
Total unit price
12,5
Discount percentage
20 %
Discount
2,5
Total incl. discount
10
Environmental
tax
percentage
10 %
Environmental tax
percentage
Total incl.
environmental tax
VAT percentage
VAT
Total incl. VAT
1
11
25 %
2,75
13,75
Freight basis
Freight percentage
11
6%
Freight
0,66
VAT percentage
VAT
Total incl. VAT
0,17
0,83
Linesum
Additional amount
VAT
Sum
Rounding
Sum after rounding
20120903 Bank IG 1v02 e2bformatet3v3 English
25 %
11
0,66
2,92
14,58
0,02
14,60
Side 10 av 62
BSK Implementation guide B2B e-invoice
V er s ion: 1 .0 1
2.5 Use of status message
The use of status messages is in principle the same as the status message defined in the e2b
standard.
The use in the different banks may differ and the bank must be contacted for detailed user
documentation.
2.6 Duplicate control
Each invoice file is controlled for duplicate against previously submitted invoices.
The following elements may be included in the duplicate control:
Element
XML element
Address (eInvoiceID /
organisational number)
InvoiceHeader/Supplier/PartyId
Invoicenumber
InvoiceHeader/InvoiceNumber
Invoice date
InvoiceHeader/InvoiceDate
Invoice type
InvoiceHeader/InvoiceType
Suppliers organisation number
InvoiceHeader/Supplier/OrgNumber
Note: Combinations of fields must be unique.
The following items may invalidate the duplicate control:
Element
XML element
InvoiceStatus
InvoiceHeader/InvoiceStatus
2.7 Template view
Banks have prepared a joint template view for the e2b format that users can use.
Contact your bank for more information.
BSK
20120903 Bank IG 1v02 e2bformatet3v3 English
Side 11 av 62
BSK Implementation guide B2B e-invoice
V er s ion: 1 .0 1
2.8 Mapping related to the EHF format (ref. the governments requirements
relating to electronic invoice)
Governmental/public sector require (from 1. July 2012) the use of the EHF format for
receipt of invoices and credit notes in the establishment of new sales contracts. This
may mean that invoices and credit notes from issuers using BSK IG for e2b format in
many cases will have been mapped to the EHF format.
In this IG, it is added comments in information elements subject to specific
requirements given in the EHF format. As a general rule, all fields that are required in
the EHF e2b format should be used in this format. Contact the bank in the case of
further questions.
Special mapping rules related to the EHF format can also be found in Appendix 2:
Tips for using the format
Issuers should note the following regarding the document type for "Reminder":
The banks have decided not to offer automatically mapping between e2b format and
EHF format of the document type "reminder". When issuing reminder in e2b, this will
be sent to e2b recipients, while other recipients will receive the reminder as agreed
with own bankconnection. The reason for this is the following:



It is not possible to map an EHF reminder to a valid document in e2B format.
The mapping from an e2b reminder to EHF reminder is not possible because EHF do not
have corresponding information fields as those presented in the e2b format.
The handling of reminders is based on different routines in the issuer / receiver systems
than invoices and credit notes. This, and the fact that EHF reminder only refer to a
previous invoice, while a e2b reminders can be communicated in the same way as an
ordinary invoice, gives unsolvable challenges related to mapping from EHF to e2b.
Note: Any use of the documenttype reminder based on the EHF format and distribution
towards recipients using EHF must be agreed with the individual bank.
BSK
20120903 Bank IG 1v02 e2bformatet3v3 English
Side 12 av 62
BSK Implementation guide B2B e-invoice
V er s ion: 1 .0 1
3. Invoice - Structure of the message
3.1 Name standard invoice files
Based on agreement between the bank and the bank's customer (invoice issuer / invoice
recipient)
3.2 Structure Overview
The invoice format (based on e2b) is built up as shown in the figure below.
The contents of the coloured modules are included in the basic format and are described
in subsequent chapters. Contents of the white modules are additions that are described in
separate documents (industry specific extensions).
Fields in italics are not guaranteed delivered to invoice recipients that use another e
invoice format than e2b version 3.3.
The following notation is used to define the requirements for filling in the chart below:
1 = One instance (mandatory)
1..* = One or many instances
0..1 = None or one instance (conditional)
0..* = None or many instances
The use of attachement is described in a separate appendix.
BSK
20120903 Bank IG 1v02 e2bformatet3v3 English
Side 13 av 62
BSK Implementation guide B2B eFaktura
V er s ion: 1 .0 2
Interchange
0..1
0..1
0..*
MessageHeader
Envelope
1..*
1
InvoiceHeader
CardHeader
0..1
InsuranceHeader
1
InvoiceMessage
1..*
InvoiceDetails
0..*
FreeText
TelecomHeader
0..1
EnergyHeader
BuildingHeader
CardDetails
0..1
InvoiceTotals
0..*
InvoiceCharges/Allowance
0..* SubInvoice
0..1
0..1
1
1..*
BaseItemDetails
InsuranceDetails
BSK
InterchangeHeader
EnergyDetails
BuildingDetails
0..1
0..1
0..1
0..1
0..* TravelDetails
0..*TelecomDetails
0..* CarrierDetails
0..*TransportDetails
20120903 Bank IG 1v02 e2bformatet3v3 English
Side 14 av 62
BSK Implementation guide B2B eFaktura
V er s ion: 1 .0 2
3.3 Interchange
“Interchange” is the package of the transfer file and is just a tag that marks the start and end of the file. (There are no other elements
related to this)
BSK have not identified the need for making bankspecific IG’s for bankspesific use of the Interchange Header and Message Header.
These documents is described in separate documents and can be collected at www.e2b.no website.
Reference to the XML style sheet that is included in your submitted file, eg. as a declaration
<?xml-stylesheet type="text/xsl"href="EHF-faktura NO 5.xslt"?>
should always be passed on to the recipient, This gives the sender the opportunity to influence how the presentation of the invoice will
done at the recipient and ensures that the sender's information is included in the recipient's view.
3.4 Envelope
Not used. (Envelope from invoice issuer may be accepted, but the envelope functions are not used).
BSK
20120903 Bank IG 1v02 e2bformatet3v3 English
Side 15 av 62
BSK Implementation guide B2B eFaktura
V er s ion: 1 .0 2
3.5 Invoice Message
Name of XML-element
Description
Req. Repetition Type
Invoice
M
1
@MessageOwner
Fixed value: e2b
M
1
String
@MessageType
Fixed value: Invoice
M
1
String
@MessageVersion
@language
Legal value: 3.3
Language code (ISO 639 two letter code)
M
K
1
0..1
String
String
MessageNumber
Unique number that identifies the message within an interchange
K
0..1
String
MessageTimestamp
Message date. Date and time when the message is generated.
Format: YYYY-MM-DDTHH:MM:SS
(Timerule Rulebook)
Number of detail lines in the invoice
States if this is an Expense (K), Product (V) or Service (T) invoice.
Legal values are: ”K”, ”V” and ”T”
Codes which state what line of business the invoices are regarded as:
Legal values:
1=Credit card, 2=Travel, 3=Telecom, 4=Transport, 5=Carrier,
6=Insurance, 7=Energy, 8=Building, 9=General goods
M
1
K
0..1
Integer
K
0..1
String
K
0..1
String
Code description. Optional description of attribute
K
0..1
String
NumberOfLines
InvoiceContent
LineOfBusiness
@codetext
BSK
20120903 Bank IG 1v02 e2bformatet3v3 English
DateTime
Side 16 av 62
BSK Implementation guide B2B eFaktura
V er s ion: 1 .0 2
3.6 Invoice header
Name of XML-element
InvoiceHeader
Req.
Repetition Type
Invoice header
M
1
Legal values are:
380 = Invoice (Faktura)
381 = Credit Note (Kreditnota)
M
1
String
Code description: Optional description in attribute:
Eg. Invoice (380) Reminders (380) Interest invoice (380), Credit Note
(381). Other Descriptions can be used and will be forwarded.
If not completed, the codetext for the code in InvoiceType is used default.
K
1
String
Document status: Legal values are:
9 = Original
10 = Copy
53 = Test (between invoice issuer and invoice recipient in production)
Note: When using code 10 Copy or code 53 Test, the bank must be
contacted.
M
1
String
Code description: Optional description in attribute
K
0..1
String
InvoiceNumber
Invoice number or Credit note number
Mandatory element in the EHF format
M
1
String
InvoiceDate
Invoice Date: Date of issue of invoice
Mandatory element in the EHF format
Suggested code values connected to tax:
NIL = Line item net amounts, invoice level tax
GIL = Line item gross amounts, invoice level tax
NLL = Line item net amounts, line-level tax
GLL = Line item gross amounts, line-level tax
NON = Tax does not apply to this invoice
M
1
Date
K
0..1
String
Code description: Optional description in attribute
Suggested code values for discount management:
K
K
0..1
0..1
String
String
InvoiceType
@codetext
InvoiceStatus
@codetext
TaxTreatment
@codetext
DiscountTreatment
BSK
Description
20120903 Bank IG 1v02 e2bformatet3v3 English
Side 17 av 62
BSK Implementation guide B2B eFaktura
Name of XML-element
V er s ion: 1 .0 2
Description
Req.
Repetition Type
UN = Line item unit price, net of discount
UG = Line item unit price, gross of discount
TN = Line item amount, net of discount
TG = Line item amount, gross of discount
@codetext
Supplier
InvoiceIssuer
Buyer
Invoicee
OrderedBy
DeliveryPart
UltimateCustomer
ShippedFrom
BSK
Code description: Optional description in attribute
K
0..1
The actor who delivers the commodity or service.
The content is described in Section 3.7.1, Actor Information.
To be used if different from Supplier.
M
1
PartyType
(ref. kapittel 3.7.1)
K
0..1
PartyType
(ref. kapittel 3.7.4)
The actor who ordered the commodity or service.
The content is described in Section 3.7.2, Buyer.
Invoice Recipient: The actor who receives the invoice/credit note. May be
stated if different from buyer.
May be stated if the procurement is made of an intermediary different
from the Buyer.
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)
Describes the actor on the place where the commodity is delivered.
May be stated if different from buyer.
Specification of the delivery address is required EHF format (street
address, zip code, city)
Describes ultimate receiver of the commodity. May be stated if different
from delivery part or buyer.
K
0..1
PartyType
(ref. kapittel 3.7.4)
K
0..1
PartyType
(ref. kapittel 3.7.4)
Describes the actor on the place where the goods are shipped from, or
brought by the Buyer (DeliveryPart). The ”ShippedFrom” may be stated
in addition to “DeliveryPart” or “UltimateCustomer“
K
0..1
PartyType
(ref. kapittel 3.7.4)
20120903 Bank IG 1v02 e2bformatet3v3 English
String
Side 18 av 62
BSK Implementation guide B2B eFaktura
Name of XML-element
Factoring
Description
Req.
0..1
PartyType
(ref. kapittel 3.7.3)
K
0..1
InvoiceReferences
Type
Order number: Reference to the buyers ordernumber. Required when
invoices are to be matched with the order (used for instance for electronic
matching). The use of this field is recommended.
Recommended element in the EHF format
Reference to the buyer’s order date. Mandatory for matching. The field
is recommended.
K
0..1
String
K
0..1
Date
BuyersProjectCode
Reference to the buyer’s project code
K
0..1
String
InvoiceNumber
Reference to original invoice in a credit note.
Mandatory element in the EHF format in relation wit creditnote and
reminder
K
0..1
String
SuppliersOrderNumber
Reference to the supplier’s order number.
K
0..1
String
DeliveryTerms
DeliveryTermsCode
Free text
Code for delivery terms: E.g. reference to INCOTERM-code for those
using this.
K
K
0..1
0..1
String
String
DeliveryTermsPlace
Delivery place associated with delivery terms
K
0..1
String
DeliveryNoteNum
Reference to the delivery note number.
K
0..1
String
DeliveryDate
Date of delivery with reference to delivery note number.
Mandatory element in the EHF format
Payment information: Must occur once
K
0..1
Date
M
1
BuyersOrderNumber
BuyersOrderDate
Payment
States if the Supplier uses Factoring to handle payment transactions.
The content is described in Section 3.7.3, Factoring.
References
Repetition Type
K
InvoiceReferences
BSK
V er s ion: 1 .0 2
PaymentType
DueDate
Date when the invoice is due to payment
Mandatory element in the EHF format
K
0..1
Date
Currency
Currency code: ISO Alpha code (3 characters) ISO 4217
Mandatory element in the EHF format
M
1
String
20120903 Bank IG 1v02 e2bformatet3v3 English
Side 19 av 62
BSK Implementation guide B2B eFaktura
Name of XML-element
Description
Req.
Repetition Type
KidNumber
KID-number (Norwegian payment identification)
Recommended element in the EHF format
K
0..1
String
PaymentTerms
PaymentDiscount
Payment terms in free text
Zero or many instances
K
K
0..1
String
DiscountPercent
Discount percent
M
1
Decimal
DiscountDays
The number of days the discount take effect from
K
0..1
Decimal
Overdue interestcharge in percent
K
0..1
Decimal
Reference to the file with attachements, for instance an image file or
tickets. Zero or many instances.
See separate appendix
Reference: General reference field with code.
Zero or many occurrences.
K
0..*
String
K
0..*
RefWithCodeType
Code
Code stating type of references.
M
1
String
Text
Reference value.
FreeText General information that cannot be placed in other fields.
Zero or many occurences.
Business specific extension on header level for credit card
invoices.
K
0..1
String
K
0..*
String
K
0..1
CardHeaderInfo
Type
OverDuePercent
Attachments
Ref
FreeText
CardHeaderInformation
0..*
InsuranceHeader
Business specific extension on header level for insurance
invoices.
K
0..1
InsuranceHeader
Type
TelecomHeader
Business specific extension on header level for telecom invoices.
K
0..1
TelecomHeader
Type
EnergyHeader
Business specific extension on header level for energy invoices
(power and power supply).
The content is described in a specific document.
Business specific extension on header level for invoices related
to building, electro and VA/VVS.
K
0..1
EnergyHeader
Type
K
0..1
BuildingHeader
Type
BuildingHeader
BSK
V er s ion: 1 .0 2
20120903 Bank IG 1v02 e2bformatet3v3 English
Side 20 av 62
BSK Implementation guide B2B eFaktura
V er s ion: 1 .0 2
3.7 Party information
3.7.1 Supplier
Name of XML-element
Description
PartyType
Actor information
M
1
Actor number: Unique identifier
M
1
IdentifierType
PartyId
Req. Repetition Type
Use of either:
”efakturaId”
(efakturaId is built up with a BIC and a IBAN with a
hyphen between):
Example: XXXXXXXXXXX-NOXX15020012345
or
Organisational number (one string, do not use space or hyphen)
Example: 123456789 (recommended) or NO123456789
BSK
@schemeId
Identification of identifier
If an efakturaId is used in PartyId, then "efakturaId" shall be used.
If an organisational number is used in PartyId, then "Orgnr" shall be
used (if only the 9 digit organization is specified in PartyId) If NO is used
in the organisation number, then "NO: Orgnr" shall be used.
M
1
String
@schemeName
Name of identifier
If an efakturaId is used in PartyId, then "efakturaId" shall be used.
If an organizational number is used in PartyId, then
"Organisasjonsnummer" shall be used
M
1
String
20120903 Bank IG 1v02 e2bformatet3v3 English
Side 21 av 62
BSK Implementation guide B2B eFaktura
Name of XML-element
@schemeAgencyName
V er s ion: 1 .0 2
Description
Req. Repetition Type
Name of organization which administrates the identifier
If efakturaId is used in PartyId, then the BIC value of the bank that have
issued the efakturaId is used in this field.
If organisation number is used in PartyId, then the text “Enhetsregisteret
ved Bronnoysundregisterne”shall be used.
M
1
Location number For example GLN (Global Localisation Number).
Identification of identifier, for example GLN
K
K
0..1
0..1
IdentifierType
String
@schemeName
Name of identifier, for example GLN
K
0..1
String
@schemeAgency
Name of organization which administrates the identifier, for example
GS1
K
0..1
String
Name
Company name
Mandatory element in the EHF format
M
1
String
ContactInformation
Contact information for the company
K
0..1
PhoneNumber
Company’s Telephone number
K
0..1
ContactInformation
Type
String
FaxNumber
Company’s Telefax number
K
0..1
String
EmailAddress
Company’s Email address
K
0..1
String
WebAddress
Company’s Web address
K
0..1
String
Street address: Zero or one occurrence
Street-/visitor address 1
K
K
0..1
0..1
AddressType
String
Address2
Street-/visitor address 2
K
0..1
String
Address3
Street-/visitor address 3
K
0..1
String
PostalCode
Post number related to the street address
K
0..1
String
PostalDistrict
Post district related to the street address
K
0..1
String
CountryCode
2 character code in accordance with ISO 3166
K
0..1
String
CountryName
Name of country in accordance with code
K
0..1
String
LocationId
@schemeId
StreetAddress
Address1
BSK
20120903 Bank IG 1v02 e2bformatet3v3 English
String
Side 22 av 62
BSK Implementation guide B2B eFaktura
Name of XML-element
PostalAddress
Description
Req. Repetition Type
Zero or one occurrence
PostalAdress must be included if invoice receiver uses the EHF
format
K
0..1
AddressType
Address1
Post adress 1
Mandatory element in the EHF format
K
0..1
String
Address2
Post adress 2
Mandatory element in the EHF format
Post adress 3
K
0..1
String
K
0..1
String
PostalCode
Postnumber related post address
Mandatory element in the EHF format
K
0..1
String
PostalDistrict
Post district related to post address
Mandatory element in the EHF format
K
0..1
String
CountryCode
2 character code in accordance with ISO 3166
Mandatory element in the EHF format
Name of country in accordance with code
K
0..1
String
K
0..1
String
Zero or many occurrence
Contact person name: Recommended format: ”Surname, First name,
Middle name”
Recommended element in the EHF format
Contact persons First name: Recommended format: ”First name
Middle name”
K
0..*
ContactPersonType
M
1
String
K
0..1
String
Address3
CountryName
ContactPerson
Name
FirstName
LastName
Contact persons Surname
K
0..1
String
Function
Contact persons Function (employment, role)
K
0..1
String
Department
Contact persons Department
K
0..1
String
ContactInformation
Contact information for contact person
K
0..1
Phone number to contact person
K
0..1
ContactInformation
Type
String
PhoneNumber
BSK
V er s ion: 1 .0 2
20120903 Bank IG 1v02 e2bformatet3v3 English
Side 23 av 62
BSK Implementation guide B2B eFaktura
Name of XML-element
Description
Req. Repetition Type
FaxNumber
Fax number to contact person
K
0..1
String
EmailAddress
Email address to contact person
K
0..1
String
WebAddress
Web address to contact person
K
0..1
String
Organization number (9 digits). Mandatory for Supplier.
Example: 123456789 or NO123456789
M
1
String
K
0..1
String
OrgNumber
VatId
Department
AccountInformation
AccountNumber
IbanNumber
SwiftNumber
ProjectRef
ContractNumber
BSK
V er s ion: 1 .0 2
Note that this will be shown on the invoice. Required element of the EHF
format
Rule: Organisation number from EHF shall always be mapped to
OrgNumber
VAT number: Mandatory when invoicing is decucted to Vat (14
characters).
Example: 123456789MVA or NO123456789MVA (the inclusion of NO is
not mandatory)
Rule: If the VAT number is specified in the EHF format, this must also be
entered in VatID)
Department within a company
Information about accounts for national and international
payments
K
0..1
String
K
0..1
AccountInformation
Type
The company’s domestic bank account number
Note! Not used when Factoring is used.
Mandatory element in the EHF format if used at this level
Account number for international payments
Mandatory element in the EHF format if IBAN is given
Swift number/BIC for international payments
K
0..1
String
K
0..1
String
K
0..1
String
Project reference
Contract number
The contract number between seller and buyer that the invoice is related
to. Recommended element in the EHF format
K
K
0..1
0..1
String
String
20120903 Bank IG 1v02 e2bformatet3v3 English
Side 24 av 62
BSK Implementation guide B2B eFaktura
Name of XML-element
Description
Req. Repetition Type
K
0..*
RefWithCodeType
Code
General reference fields with codes.
Zero or many occurrences
Code which states type of reference
M
0..1
String
Text
The actual reference number
K
0..1
String
Ref
BSK
V er s ion: 1 .0 2
20120903 Bank IG 1v02 e2bformatet3v3 English
Side 25 av 62
BSK Implementation guide B2B eFaktura
V er s ion: 1 .0 2
3.7.2 Buyer
Name of XML-element
Description
PartyType
Actor information
M
1
Actor number: Unique identifier
M
1
PartyId
Req. Repetition Type
IdentifierType
B2B (between businesses):
Use of either:
”efakturaId”
(efakturaId is built up with a BIC and a IBAN with a
hyphen between):
Example: XXXXXXXXXXX-NOXX15020012345
or
Organisational number (one string, do not use space or hyphen)
Example: 123456789 (recommended) or NO123456789
Other id’s can be agreed between the Invoice issuer and the invoice
issuers bank
B2C (business to consumers):
Here the einvoice reference (eFakturareferansen) is used.
BSK
20120903 Bank IG 1v02 e2bformatet3v3 English
Side 26 av 62
BSK Implementation guide B2B eFaktura
Name of XML-element
@schemeId
V er s ion: 1 .0 2
Description
Req. Repetition Type
Identification of identifier
M
1
String
M
1
String
M
1
String
K
0..1
IdentifierType
@schemeId
Location number For example GLN (Global Localisation Number).
Recommended element in the EHF format
Identification of identifier, for example GLN
K
0..1
String
@schemeName
Name of identifier, for example GLN
K
0..1
String
@schemeAgency
Name of organization which administrates the identifier, for example
GS1
K
0..1
String
B2B: either ”efakturaId”, “NO:ORGNR” (if NO is included in PartyId)
or "Orgnr" (if only the 9 digit organization specified in PartyId)
B2C: ”efakturaRef”
Other identifiers: Must be agreed between the invoice issuer and the
invoice issuers bank.
@schemeName
Name of identifier
B2B: ”efakturaId” or “Organisasjonsnummer”
B2C: ”efakturaRef”
Other identifiers: Must be agreed between the invoice issuer and the
invoice issuers bank.
@schemeAgencyName
Name of organization which administrates the identifier
B2B: Receiving banks BIC or ”Enhetsregisteret ved
Bronnoysundregisterne”.
B2C: ”BBS” is currently used.
Other identifiers: Must be agreed between the invoice issuer and the
invoice issuers bank.
LocationId
BSK
20120903 Bank IG 1v02 e2bformatet3v3 English
Side 27 av 62
BSK Implementation guide B2B eFaktura
Name of XML-element
V er s ion: 1 .0 2
Description
Req. Repetition Type
Name
Company name
Mandatory element in the EHF format
M
1
ContactInformation
Contact information for the company
K
0..1
PhoneNumber
Company’s Telephone number
K
0..1
ContactInformation
Type
String
FaxNumber
Company’s Telefax number
K
0..1
String
EmailAddress
Company’s Email address
K
0..1
String
WebAddress
Company’s Web address
K
0..1
String
Street address: Zero or one occurrence
Street-/visitor address 1
K
K
0..1
0..1
AddressType
String
Address2
Street-/visitor address 2
K
0..1
String
Address3
Street-/visitor address 3
K
0..1
String
PostalCode
Post number related to the street address
K
0..1
String
PostalDistrict
Post district related to the street address
K
0..1
String
CountryCode
2 character code in accordance with ISO 3166
K
0..1
String
CountryName
Name of country in accordance with code
K
0..1
String
Zero or one occurrence
K
0..1
AddressType
Address1
Post adress 1
Mandatory element in the EHF format
K
0..1
String
Address2
Post address 2
Mandatory element in the EHF format
Post address 3
K
0..1
String
K
0..1
String
PostalCode
Post number related post address
Mandatory element in the EHF format
K
0..1
String
PostalDistrict
Post district related to post address
Mandatory element in the EHF format
K
0..1
String
StreetAddress
Address1
PostalAddress
Address3
BSK
20120903 Bank IG 1v02 e2bformatet3v3 English
String
Side 28 av 62
BSK Implementation guide B2B eFaktura
Name of XML-element
CountryCode
CountryName
ContactPerson
Name
FirstName
V er s ion: 1 .0 2
Description
Req. Repetition Type
2 character code in accordance with ISO 3166
Mandatory element in the EHF format
Name of country in accordance with code
K
0..1
String
K
0..1
String
Zero or many occurrence
Contact person name: Recommended format: ”Surname, First name,
Middle name”
Mandatory element in the EHF format (“Deres Ref”)
Contact persons First name: Recommended format: ”First name
Middle name”
K
0..*
ContactPersonType
M
1
String
K
0..1
String
LastName
Contact persons Surname
K
0..1
String
Function
Contact persons Function (employment, role)
K
0..1
String
Department
Contact persons Department
K
0..1
String
ContactInformation
Contact information for contact person
K
0..1
PhoneNumber
Phone number to contact person
K
0..1
ContactInformation
Type
String
FaxNumber
Fax number to contact person
K
0..1
String
EmailAddress
Email address to contact person
K
0..1
String
WebAddress
Web address to contact person
K
0..1
String
Organization number (9 digits). Recommended used.
Example: 123456789 or NO123456789
K
0..1
String
OrgNumber
Note that this will be shown on the invoice. Required element of the EHF
format
Rule: Organisation number from EHF shall always be mapped to
OrgNumber
BSK
20120903 Bank IG 1v02 e2bformatet3v3 English
Side 29 av 62
BSK Implementation guide B2B eFaktura
Name of XML-element
VatId
Department
AccountInformation
V er s ion: 1 .0 2
Description
Req. Repetition Type
VAT number: Mandatory when invoicing is deducted to Vat (14
characters).
Example: 123456789MVA or NO123456789MVA (the inclusion of NO is
not mandatory)
Rule: If the VAT number is specified in the EHF format, this must also be
entered in VatID)
Department within a company
Information about accounts for national and international
payments
K
0..1
String
K
0..1
String
K
0..1
AccountNumber
The company’s domestic bank account number
K
0..1
AccountInformation
Type
String
IbanNumber
Account number for international payments
K
0..1
String
SwiftNumber
Swift number/BIC for international payments
K
0..1
String
ProjectRef
Project reference
K
0..1
String
ContractNumber
Contract number
Note: Contract Number between buyer and seller that the invoice is
connected to is placed under the Supplier and not under the Buyer
K
0..1
String
Ref
General reference fields with codes.
Zero or many occurrences
K
0..*
RefWithCodeType
Code
Code which states type of reference
For example “CustomerNumber” will be given here
M
1
String
Text
The actual reference number
For example “CustomerNumber” will be given here
K
0..1
String
BSK
20120903 Bank IG 1v02 e2bformatet3v3 English
Side 30 av 62
BSK Implementation guide B2B eFaktura
V er s ion: 1 .0 2
3.7.3 Factoring
Name of XML-element
Description
PartyType
Actor information
K
0..1
K
0..1
IdentifierType
@schemeId
Actor number: Unique identifier
The Factoring company’s ID number for the invoice issuer.
Identification of identifier, for example supplier identifier
K
0..1
String
@schemeName
Name of identifier, for example suppliers identifier
K
0..1
String
Name of organization which administrates the identifier, for example the
supplier
K
0..1
String
Location number For example GLN (Global Localisation Number).
Identification of identifier, for example GLN
K
K
0..1
0..1
IdentifierType
String
@schemeName
Name of identifier, for example GLN
K
0..1
String
@schemeAgency
Name of organization which administrates the identifier, for example
GS1
K
0..1
String
Name
Company name
M
1
String
ContactInformation
Contact information for the company
K
0..1
PhoneNumber
Company’s Telephone number
K
0..1
ContactInformation
Type
String
FaxNumber
Company’s Telefax number
K
0..1
String
EmailAddress
Company’s Email address
K
0..1
String
WebAddress
Company’s Web address
K
0..1
String
Street address: Zero or one occurrence
Street-/visitor address 1
K
K
0..1
0..1
AddressType
String
Address2
Street-/visitor address 2
K
0..1
String
Address3
Street-/visitor address 3
K
0..1
String
PostalCode
Post number related to the street address
K
0..1
String
PartyId
@schemeAgency
LocationId
@schemeId
StreetAddress
Address1
BSK
Req. Repetition Type
20120903 Bank IG 1v02 e2bformatet3v3 English
Side 31 av 62
BSK Implementation guide B2B eFaktura
Name of XML-element
Description
Req. Repetition Type
PostalDistrict
Post district related to the street address
K
0..1
String
CountryCode
2 character code in accordance with ISO 3166
K
0..1
String
CountryName
Name of country in accordance with code
K
0..1
String
Zero or one occurrence
K
0..1
AddressType
Address1
Post address 1
K
0..1
String
Address2
Address3
Post address 1
Post address 1
K
K
0..1
0..1
String
String
PostalCode
Post number related post address
K
0..1
String
PostalDistrict
Post district related to post address
K
0..1
String
CountryCode
CountryName
2 character code in accordance with ISO 3166
Name of country in accordance with code
K
K
0..1
0..1
String
String
Zero or many occurrence
Contact person name: Recommended format: ”Surname, First name,
Middle name”
Contact persons First name: Recommended format: ”First name
Middle name”
K
0..*
ContactPersonType
M
1
String
K
0..1
String
PostalAddress
ContactPerson
Name
FirstName
LastName
Contact persons Surname
K
0..1
String
Function
Contact persons Function (employment, role)
K
0..1
String
Department
Contact persons Department
K
0..1
String
ContactInformation
Contact information for contact person
K
0..1
PhoneNumber
Phone number to contact person
K
0..1
ContactInformation
Type
String
FaxNumber
Fax number to contact person
K
0..1
String
EmailAddress
Email address to contact person
K
0..1
String
WebAddress
Web address to contact person
K
0..1
String
Organization number (9 digits). Mandatory for Supplier. Recommended
used.
K
0..1
String
OrgNumber
BSK
V er s ion: 1 .0 2
20120903 Bank IG 1v02 e2bformatet3v3 English
Side 32 av 62
BSK Implementation guide B2B eFaktura
Name of XML-element
V er s ion: 1 .0 2
Description
Req. Repetition Type
VatId
VAT number: Mandatory when invoicing is deducted to Vat (14
characters). Recommended used.
K
0..1
String
Department
Department within a company
Information about accounts for national and international
payments
K
0..1
String
K
0..1
AccountInformation
Type
AccountNumber
IbanNumber
The factoring company’s bank account number
Account number for international payments
K
K
0..1
0..1
String
String
SwiftNumber
Swift number/BIC for international payments
K
0..1
String
Project reference
Contract number
General reference fields with codes.
Zero or many occurrences
K
0..1
String
K
0..1
String
K
0..*
RefWithCodeType
AccountInformation
ProjectRef
ContractNumber
Ref
BSK
Code
Code which states type of reference
Here ”AssignedClaused” is used.
M
0..1
String
Text
Infringement text
K
0..1
String
20120903 Bank IG 1v02 e2bformatet3v3 English
Side 33 av 62
BSK Implementation guide B2B eFaktura
V er s ion: 1 .0 2
3.7.4 Other parties
Contains information about InvoiceIssuer, Invoicee, DeliveryPart, OrderedBy, UltimateCustomer, ShippedFrom
Name of XML-element
Description
PartyType
Actor information
K
0..1
Actor number: Unique identifier
0..1
0..1
IdentifierType
String
PartyId
@schemeId
Req. Repetition Type
Identification of identifier, for example supplier identifier
K
K
@schemeName
Name of identifier, for example suppliers identifier
K
0..1
String
@schemeAgency
Name of organization which administrates the identifier, for example the
supplier
K
0..1
String
Location number For example GLN (Global Localisation Number).
Identification of identifier, for example GLN
K
K
0..1
0..1
IdentifierType
String
@schemeName
Name of identifier, for example GLN
K
0..1
String
@schemeAgency
Name of organization which administrates the identifier, for example
GS1
K
0..1
String
Name
Company name
M
1
String
ContactInformation
Contact information for the company
K
0..1
PhoneNumber
Company’s Telephone number
K
0..1
ContactInformation
Type
String
FaxNumber
Company’s Telefax number
K
0..1
String
EmailAddress
Company’s Email address
K
0..1
String
WebAddress
Company’s Web address
K
0..1
String
Street address: Zero or one occurrence
Street-/visitor address 1
K
K
0..1
0..1
AddressType
String
Address2
Street-/visitor address 2
K
0..1
String
Address3
Street-/visitor address 3
K
0..1
String
PostalCode
Post number related to the street address
K
0..1
String
PostalDistrict
Post district related to the street address
K
0..1
String
CountryCode
2 character code in accordance with ISO 3166
K
0..1
String
LocationId
@schemeId
StreetAddress
Address1
BSK
20120903 Bank IG 1v02 e2bformatet3v3 English
Side 34 av 62
BSK Implementation guide B2B eFaktura
Name of XML-element
CountryName
Description
Req. Repetition Type
Name of country in accordance with code
K
0..1
String
Zero or one occurrence
Post address 1
K
K
0..1
0..1
AddressType
String
Address2
Post address 1
K
0..1
String
Address3
Post address 1
K
0..1
String
PostalCode
Post number related post address
K
0..1
String
PostalDistrict
Post district related to post address
K
0..1
String
CountryCode
2 character code in accordance with ISO 3166
K
0..1
String
CountryName
Name of country in accordance with code
K
0..1
String
K
M
0..*
1
ContactPersonType
String
K
0..1
String
LastName
Zero or many occurrence
Contact person name: Recommended format: ”Surname, First name,
Middle name”
Contact persons First name: Recommended format: ”First name
Middle name”
Contact persons Surname
K
0..1
String
Function
Contact persons Function (employment, role)
K
0..1
String
Department
Contact persons Department
K
0..1
String
ContactInformation
Contact information for contact person
K
0..1
PhoneNumber
Phone number to contact person
K
0..1
ContactInformation
Type
String
FaxNumber
Fax number to contact person
K
0..1
String
EmailAddress
Email address to contact person
K
0..1
String
WebAddress
Web address to contact person
K
0..1
String
Organization number (9 digits). Mandatory for Supplier. Recommended
used.
VAT number: Mandatory when invoicing is decucted to Vat (14
characters). Recommended used.
K
0..1
String
K
0..1
String
Department within a company
K
0..1
String
PostalAddress
Address1
ContactPerson
Name
FirstName
OrgNumber
VatId
Department
BSK
V er s ion: 1 .0 2
20120903 Bank IG 1v02 e2bformatet3v3 English
Side 35 av 62
BSK Implementation guide B2B eFaktura
Name of XML-element
V er s ion: 1 .0 2
Description
Req. Repetition Type
Information about accounts for national and international
payments
K
0..1
AccountNumber
The company’s domestic bank account number
K
0..1
AccountInformation
Type
String
IbanNumber
Account number for international payments
K
0..1
String
SwiftNumber
Swift number/BIC for international payments
K
0..1
String
ProjectRef
Project reference
K
0..1
String
ContractNumber
K
0..1
String
K
0..*
RefWithCodeType
Code
Contract number
General reference fields with codes.
Zero or many occurrences
Code which states type of reference
M
0..1
String
Text
The actual reference number
K
0..1
String
AccountInformation
Ref
BSK
20120903 Bank IG 1v02 e2bformatet3v3 English
Side 36 av 62
BSK Implementation guide B2B eFaktura
BSK
V er s ion: 1 .0 2
20120903 Bank IG 1v02 e2bformatet3v3 English
Side 37 av 62
BSK Implementation guide B2B eFaktura
V er s ion: 1 .0 2
3.8 Invoice details
Invoice details may consist of:

Free text. A description/specification of an invoice line

Base item details. A general invoice line containing sufficient information for most business sectors and applications
The base item details are normally imported by all recipients. It is therefore important that these information elements is placed at the
same place in the message structure, regardless how the rest of the message is structured. In addition to the base item details, different
business sectors may require specific information to be sent on detail level. This information is defined in separate business specific
extensions which are conditional to use. The following rules are applicable for the definition of business specific extension in e2b on
details level (see also chapter 2.2):
 Business specific extensions that have multi order structure or consists of information on more than one level, is placed before the
base item details
 Business specific extensions that consists of information on one level only, is placed after the base item details
Name of XML-element
Req. Repetition Type
Invoice details
M
1..*
Zero or many occurrences
Zero or many occurrences
SubInvoice: General multi order structure on line level
Invoice header: Standard e2b header information.
K
M
0..*
String
1..*
BaseItemDetailsType
K
M
0..1
1
SubInvoiceType
HeaderType
Details: Standard e2b base of details.
One or many occurrences.
M
1..*
DetailsType
TravelDetails
Business specific extension for travel invoices.
K
0..1
TravelDetailsType
TelecomDetails
Business specific extension for telecom invoices.
K
0..1
TelecomDetailsType
TransportDetails
Business specific extension for transport invoices.
K
0..1
TransportDetailsType
CarrierDetails
Business specific extension for carrier invoices.
K
0..1
CarrierDetailsType
InvoiceDetails
FreeText
BaseItemDetails
SubInvoice
Header
Details
BSK
Description
20120903 Bank IG 1v02 e2bformatet3v3 English
Side 38 av 62
BSK Implementation guide B2B eFaktura
Name of XML-element
LineItemNum
Description
Req. Repetition Type
Line number in the invoice. Numbers in serial order from issuer.
States the level in the invoice and can be used to aggregation / subinvoicing
Only integer numbers is to be used: 1, 2, 3, ...etc.
Se detailed description in Appendix 2, chapter 1.4
K
0..1
String
K
0..1
String
SuppliersProductId
Supplier’s article-/product-/service number
Recommended element in the EHF format
K
0..1
String
Description
Description of a article/product/service
Mandatory element in the EHF format
M
1
String
BuyersProductId
The Buyer’s article-/product-/service number
Additional product identification:
Zero or many occurrences
Can be a reference to a product code in a procurement portal
or a trade specific code i.e. EPD, GTIN (previous EAN article
number) or NOBB.
K
0..1
String
K
0..*
AdditionalProductIdType
M
1
String
ProductId: Actual value.
K
0..1
String
Based on pricetype
Mandatory element in the EHF format
Price description. Will be stated if price is given in a unit
different from amount.
Legal values are:
AAA (Net price including allowance/charge)
AAB (Gross price without allowance/charge)
K
0..1
Decimal
K
0..1
String
K
0..1
String
Code description. Optional description in attribute
K
0..1
String
PerQuantity
Price per. quantity which unit price passes for
K
0..1
Decimal
LineItemPreDiscount
Amount
Line amount before allowance/charge
K
0..1
Decimal
PrePaidAmount
Contains amount paid in advance
K
0..1
Decimal
Level
AdditionalProductId
Code
Text
UnitPrice
PriceDenomination
PriceType
@codetext
BSK
V er s ion: 1 .0 2
20120903 Bank IG 1v02 e2bformatet3v3 English
Side 39 av 62
BSK Implementation guide B2B eFaktura
Name of XML-element
CommissionAmount
LineItemAmount
LineItemGrossAmount
QuantityInvoiced
UnitOfMeasure
ExchangeInformation
Currency
Description
Req. Repetition Type
For instance in connection with the use of traveling bureaus
Line amount without VAT, but included possible
allowances/charges. Either LineItemAmount or
LineItemGrossAmount must be sent.
Mandatory element in the EHF format
Line item amount included VAT and possible
allowances/charges. Either LineItemGrossAmount or
LineItemAmount must be sent.
Invoiced quantity
Mandatory element in the EHF format
Unit in accordance with ISO standard 31
UNECE Recommendation No.20 is an extended list of unit values,
based on the ISO standard 31 It is recommended that
Recommendation No. 20 is used for mapping from the EHF format to
the e2b format. See Appendix 1 (1.7.4).
Recommended element in the EHF format (DIFI has prepared a
mappingtball of the most common unit codes thta can be downloaded
from their website).
Information about amount in different currency.
Zero or one occurrence
Currency code: ISO Alpha code (3 characters) ISO 4217
K
0..1
Decimal
A
1
Decimal
A
1
Decimal
K
0..1
Decimal
K
0..1
String
K
0..1
ExchangeInformationType
M
1
String
M
1
Decimal
ExchangeRate
Amount in another currency: i.e. use of bankcards in a foreign
currency
Exchange rate used by conversion to NOK
K
0..1
Decimal
ExchangeDate
Valid date for exchange rate
K
0..1
Date
Information about the buyers order.
Zero or one occurrence
K
0..1
OrderAndDeliveryInfoType
UnitOfMeasure
If different from invoiced unit
K
0..1
String
UnitPrice
Unit price for the ordered unit
K
0..1
Decimal
PriceType
Price type for the ordered unit
K
0..1
String
ForeignAmount
OrderInformation
BSK
V er s ion: 1 .0 2
20120903 Bank IG 1v02 e2bformatet3v3 English
Side 40 av 62
BSK Implementation guide B2B eFaktura
Name of XML-element
V er s ion: 1 .0 2
Description
Req. Repetition Type
Quantity
Ordered quantity related to the ordered unit
K
0..1
Decimal
LineNum
Reference to the order’s line number
Recommended element in the EHF format
Information about de delivery.
Zero or one occurrence
K
0..1
String
K
0..1
OrderAndDeliveryInfoType
DeliveryInformation
UnitOfMeasure
Unit delivered: If different from invoiced unit
K
0..1
String
UnitPrice
Unit price for the delivered unit
K
0..1
Decimal
PriceType
Price type for the delivered unit
K
0..1
String
Quantity
Delivered quantity
K
0..1
Decimal
K
0..1
String
K
0..1
OrderAndDeliveryInfoType
LineNum
Reference to the line number on the list of contents
SuppliersOrderInformati Information about the supplier’s internal orders.
Zero or one occurrence
on
UnitOfMeasure
If different from invoiced unit of measure.
K
0..1
String
UnitPrice
Unit price in the supplier’s order
K
0..1
Decimal
PriceType
Price type in the supplier’s order
K
0..1
String
Quantity
Quantity in the supplier’s order
K
0..1
Decimal
LineNum
Reference to line number in the supplier’s order
VAT which is calculated on the line amount.
Zero or many occurrences
Note: VatPercent or VatBaseAmount can not be given alone
K
0..1
String
K
0..*
VatInfoType
VAT-percent: Eg. 25
Mandatory element in the EHF format
Basis for the VAT calculation for the particular rate.
K
0..1
Decimal
K
0..1
Decimal
Amount for the particular rate
Taxes on line level except VAT.
Zero or many occurrences
K
K
0..1
0..*
Decimal
DiscountChargesAndTaxType
Code
Code for tax in accordance with contract.
K
0..1
String
Description
Description of type of tax, ref. Code
K
0..1
String
VatInfo
VatPercent
VatBaseAmount
VatAmount
TaxInfo
BSK
20120903 Bank IG 1v02 e2bformatet3v3 English
Side 41 av 62
BSK Implementation guide B2B eFaktura
Name of XML-element
Description
Req. Repetition Type
Percent
Tax Percent
K
0..1
Decimal
BaseAmount
Base amount for calculation of tax
K
0..1
Decimal
Amount
Quantity
Tax amount
To be used if tax is related to quantity
K
K
0..1
0..1
Decimal
Decimal
UnitOfMeasure
Unit related to quantity
K
0..1
String
RatePerUnit
To be used if tax is calculated based on rate per unit.
K
0..1
Decimal
VatInfo
VAT which is calculated on the tax
K
1
VatPercent
Vat-percent Ref. Standing rates issued by the Norwegian government.
K
0..1
Decimal
VatBaseAmount
Basis for the Vat calculation for the particular rate
K
0..1
Decimal
Amount for the particular rate
States the sequence for calculation if more than one tax
Discount on line level.
Zero or many occurrences
K
K
0..1
0..1
Decimal
String
K
0..*
DiscountChargesAndTaxType
VatAmount
CalculationSequence
Discount
VatInfoType
Code
Code for discount in accordance with contract.
K
0..1
String
Description
Percent
Description of type of discount, ref. Code
Discount percent
K
K
0..1
0..1
String
Decimal
BaseAmount
Base amount for discount calculation
K
0..1
Decimal
Amount
Quantity
Discount amount
To be used if the discount is related to quantity.
K
K
0..1
0..1
Decimal
Decimal
UnitOfMeasure
Unit related to quantity
K
0..1
String
RatePerUnit
To be used if discount is calculated based on rate per unit.
K
0..1
Decimal
VatInfo
VatPercent
VAT which is calculated on the discount
Vat-percent: Ref. Standing rates issued by the Norwegian government.
K
K
1
0..1
VatInfoType
Decimal
VatBaseAmount
Basis for the Vat calculation for the particular rate
K
0..1
Decimal
VatAmount
Amount for the particular rate
K
0..1
Decimal
States the sequence for calculation if more than one discount
K
0..1
String
CalculationSequence
BSK
V er s ion: 1 .0 2
20120903 Bank IG 1v02 e2bformatet3v3 English
Side 42 av 62
BSK Implementation guide B2B eFaktura
Name of XML-element
Description
Req. Repetition Type
Charges on line level.
Zero or many occurrences
K
0..*
DiscountChargesAndTaxType
Code
Code for charges in accordance with contract
K
0..1
String
Description
Percent
Description of type of charges, ref. code
Charge percent
K
K
0..1
0..1
String
Decimal
BaseAmount
Base amount for calculation of charge
K
0..1
Decimal
Amount
Quantity
Charge amount
To be used if charge is related to quantity
K
K
0..1
0..1
Decimal
Decimal
UnitOfMeasure
Unit related to quantity
K
0..1
String
RatePerUnit
To be used if the charge is calculated based on a rate per unit.
K
0..1
Decimal
VatInfo
VatPercent
VAT which is calculated on the addition
Vat-percent Ref. Standing rates issued by the Norwegian government.
K
K
1
0..1
VatInfoType
Decimal
VatBaseAmount
Basis for the Vat calculation for the particular rate
K
0..1
Decimal
VatAmount
Amount for the particular rate
K
0..1
Decimal
States the sequence for calculation if more than one charge
K
0..1
String
Invoicee
Invoice receiver: If Invoicee must be stated on Invoice line.
K
0..1
PartyType
(ref. chapter 3.7)
Licencee
If Licensee is different from Supplier/Seller
K
0..1
PartyType
(ref. chapter 3.7)
Duration
Duration, e.g. weeks or days
K
0..1
String
Unit for duration. Mandatory attribute
Start date for periodic invoicing
K
0..1
String
StartDate
K
0..1
Date
EndDate
End date for periodic invoicing
K
0..1
Date
SpecialCond
Special conditions. Suggested conditions are:
1 = Campaign
2 = Neither subject to bonus nor subject to commission
3 = Subject to bonus
4 = Subject to commission
5 = Both subject to bonus and subject to commission
K
0..1
String
Charges
CalculationSequence
@unitCode
BSK
V er s ion: 1 .0 2
20120903 Bank IG 1v02 e2bformatet3v3 English
Side 43 av 62
BSK Implementation guide B2B eFaktura
Name of XML-element
PostingInformation
Description
Req. Repetition Type
Code
The complete posting string defined by the Buyer
The content of the posting string.
Zero or many occurrences.
General concept, for instance a department or project.
Recommended element in the EHF format
Code for relevant dimension
Reference: General reference fields with codes.
Zero or many occurrences.
Code which states type of reference.
M
1
String
Text
The actual reference number
K
0..1
String
Free text: General information which cannot be placed in other fields.
Business specific extension for credit card invoices.
K
0..1
String
K
0..1
CardDetailsInfoType
K
0..1
InsuranceDetailsType
K
0..1
EnergyDetailstype
K
0..1
BuildingDetailstype
PostingDetails
Dimension
PostingCode
Ref
FreeText
CardDetailsInformation
InsuranceDetails
EnergyDetails
BuildingDetails
BSK
V er s ion: 1 .0 2
Business specific extension for invoices related to an
insurance settlement.
Business specific extension for energy invoices (power,
power supply). The content is described in a specific document.
Business specific extension for invoices related to
building, electro and water, sewage and plumbing.
20120903 Bank IG 1v02 e2bformatet3v3 English
K
0..1
String
K
0..*
PostingDetailsType
M
1
String
M
1
String
K
0..*
RefWithCodeType
Side 44 av 62
BSK Implementation guide B2B eFaktura
V er s ion: 1 .0 2
3.9 Invoice discount, charges and tax
Name of XML-element
Req.
Repetition Type
Invoice discounts, charges and tax on invoice level.
K
0..1
Discounts on invoice total.
Zero or many occurrences
K
0..1
DiscountCharg
esAndTaxType
Code
Code for discount in accordance with contract.
K
0..1
String
Description
Percent
Description of type of discount, ref. Code
Discount percent
K
K
0..1
0..1
String
Decimal
BaseAmount
Base amount for discount calculation
K
0..1
Decimal
Amount
Quantity
Discount amount
To be used if the discount is related to quantity.
K
K
0..1
0..1
Decimal
Decimal
UnitOfMeasure
Unit related to quantity
K
0..1
String
RatePerUnit
To be used if discount is calculated based on rate per unit.
K
0..1
Decimal
VatInfo
VatPercent
VAT which is calculated on the discount
Vat-percent: Ref. Standing rates issued by the Norwegian government.
K
K
0..1
0..1
VatInfoType
Decimal
VatBaseAmount
Basis for the Vat calculation for the particular rate
K
0..1
Decimal
VatAmount
Amount for the particular rate
K
0..1
Decimal
States the sequence for calculation if more than one discount
Charges added to the invoice total.
Zero or many occurrences.
K
0..1
String
K
0..1
DiscountCharg
esAndTaxType
Code
Code for charges in accordance with contract
K
0..1
String
Description
Percent
Description of type of charges, ref. code
Charge percent
K
K
0..1
0..1
String
Decimal
BaseAmount
Base amount for calculation of charge
K
0..1
Decimal
Amount
Quantity
Charge amount
To be used if charge is related to quantity
K
K
0..1
0..1
Decimal
Decimal
InvoiceDiscount
ChargesAndTax
InvoiceDiscountInfo
CalculationSequence
InvoiceChargesInfo
BSK
Description
20120903 Bank IG 1v02 e2bformatet3v3 English
Side 45 av 62
BSK Implementation guide B2B eFaktura
Name of XML-element
Description
Req.
Repetition Type
UnitOfMeasure
Unit related to quantity
K
0..1
String
RatePerUnit
To be used if charges are calculated based on rate per unit.
K
0..1
Decimal
VatInfo
VAT calculation based on charges
Vat-percent: Ref. Standing rates issued by the Norwegian government.
K
0..1
VatInfoType
VatPercent
K
0..1
Decimal
VatBaseAmount
Basis for the Vat calculation for the particular rate
K
0..1
Decimal
Amount for the particular rate
States the sequence for calculation if more than one charge
Governmental tax added to the invoice total.
Zero or many occurrences.
K
K
0..1
0..1
Decimal
String
K
0..*
DiscountCharg
esAndTaxType
VatAmount
CalculationSequence
InvoiceTaxInfo
Code
Code for charges in accordance with contract
K
0..1
String
Description
Percent
Description of type of charges, ref. code
Charge percent
K
K
0..1
0..1
String
Decimal
BaseAmount
Base amount for calculation of charge
K
0..1
Decimal
Amount
Quantity
Charge amount
To be used if charge is related to quantity
K
K
0..1
0..1
Decimal
Decimal
UnitOfMeasure
Unit related to quantity
K
0..1
String
RatePerUnit
VatInfo
To be used if charges are calculated based on rate per unit.
VAT which is calculated on the tax.
K
K
0..1
0..1
Decimal
VatInfoType
VatPercent
Vat-percent: Ref. Standing rates issued by the Norwegian government.
K
0..1
Decimal
VatBaseAmount
Basis for the Vat calculation for the particular rate
K
0..1
Decimal
Amount for the particular rate
States the sequence for calculation if more than one charge
K
K
0..1
0..1
Decimal
String
VatAmount
CalculationSequence
BSK
V er s ion: 1 .0 2
20120903 Bank IG 1v02 e2bformatet3v3 English
Side 46 av 62
BSK Implementation guide B2B eFaktura
V er s ion: 1 .0 2
3.10 Invoice totals
Name of XML-element
InvoiceSummary
Req. Repetition Type
Invoice totals
M
1
FreeText
One or more lines
K
0..*
InvoiceTotals
Must occur once
M
1
LineItemTotalsAmount
Sum total line amount
Required element in the EHF format. The element is recommended to
always be used. If this element is not included, the invoice may be in risk
of being rejected.
K
0..1
Decimal
DiscountTotalsAmount
Sum total discounts on detail and invoice level
K
0..1
Decimal
ChargesTotalsAmount
Sum total charges on detail and invoice level
K
0..1
Decimal
TaxTotalsAmount
Sum total taxes on detail and invoice level
K
0..1
Decimal
PrePaidAmount
CommissionAmount
Sum total prepaid amount. For instance pay on account
Sum total commission amount. For instance, the use of a travelling
agency
K
K
0..1
0..1
Decimal
Decimal
GrossAmount
Invoice amount included VAT
Mandatory element in the EHF format
M
1
Decimal
VatTotalsAmount
Sum total VAT amount
Mandatory element in the EHF format
M
1
Decimal
NetAmount
Invoice amount excluded VAT
Mandatory element in the EHF format
Rounding off to the nearest ”øre”: On total gross amount
VAT-specification: Specification of total VAT per rate.
Zero or many occurrences. It is recommended in addition to include
sum for VAT rate 0 (zero) when the element is used.
Required element if the receiver uses the EHF format (i.e. governmental
organisastions). If this element is not included, the invoice may be in risk
of being rejected.
M
1
Decimal
K
0..1
Decimal
0..*
VatInfoType
RoundingAmount
VatTotalsInfo
BSK
Description
20120903 Bank IG 1v02 e2bformatet3v3 English
K
String
InvoiceTotalstype
Side 47 av 62
BSK Implementation guide B2B eFaktura
Name of XML-element
Description
Req. Repetition Type
VatPercent
Vat-percent: Ref. Standing rates issued by the Norwegian government.
Mandatory element in the EHF format
K
0..1
Decimal
VatBaseAmount
The total basis for VAT calculation for this particular rate
Mandatory element in the EHF format
K
0..1
Decimal
VatAmount
K
0..1
Decimal
K
0..*
TaxTotalsInfoType
TaxCode
Amount for the particular rate
Mandatory element in the EHF format
Specification of total taxes beyond VAT per code/type.
Zero or many occurrences.
Code for tax code in accordance with contract
K
0..1
String
TaxDescription
Description of type of tax, ref. code.
K
0..1
String
TaxAmount
Tax amount for this particular code.
Specification of total discount per code.
Zero or many occurrences.
K
0..1
Decimal
K
0..*
Code
Code for discount in accordance with contract
K
0..1
DiscountCharges
AndTaxType
String
Description
Description of type of tax, ref. code.
K
0..1
String
Percent
Discount percent
K
0..1
Decimal
BaseAmount
Base amount for discount calculation
K
0..1
Decimal
Amount
Discount amount
K
0..1
Decimal
Quantity
To be used if discount is related to quantity.
K
0..1
Decimal
UnitOfMeasure
Unit related to quantity
K
0..1
String
RatePerUnit
To be used if discounts are calculated based on rate per unit
K
0..1
Decimal
VatInfo
VatPercent
VAT calculated on the discount.
Vat-percent: Ref. Standing rates issued by the Norwegian government
K
K
0..1
0..1
VatInfoType
Decimal
VatBaseAmount
The total basis for VAT calculation for this particular rate
K
0..1
Decimal
VatAmount
Amount for the particular rate
K
0..1
Decimal
Sequence for calculation if more than one discount (not relevant for
totals)
K
0..1
String
TaxTotalsInfo
DiscountTotals
CalculationSequence
BSK
V er s ion: 1 .0 2
20120903 Bank IG 1v02 e2bformatet3v3 English
Side 48 av 62
BSK Implementation guide B2B eFaktura
Name of XML-element
Description
Req. Repetition Type
Specification of total charges per code.
Zero or many occurrences.
K
0..*
Code
Codes for charges in accordance with contract.
K
0..1
DiscountCharges
AndTaxType
String
Description
Description of type of charges, ref. Code
K
0..1
String
Percent
Charge percent
K
0..1
Decimal
BaseAmount
Base amount for calculation of charge
K
0..1
Decimal
Amount
Charge amount
K
0..1
Decimal
Quantity
To be used if charges are related to quantity.
K
0..1
Decimal
UnitOfMeasure
Unit related to quantity
K
0..1
String
RatePerUnit
To be used if charges are calculated based on rate per unit.
K
0..1
Decimal
VatInfo
VatPercent
VAT which are calculated on the charge
Vat-percent: Ref. Standing rates issued by the Norwegian government
K
K
0..1
0..1
VatInfoType
Decimal
VatBaseAmount
The total basis for VAT calculation for this particular rate
K
0..1
Decimal
VatAmount
Amount for the particular rate
K
0..1
Decimal
Sequence for calculation if more than one discount (not relevant for
totals)
To be used if payment shall be done in a different currency than
invoiced amount.
Mandatory element in the EHF format (mapping rules i described in
appendix 2)
ISO Alpha Code (3 characters) ISO 4217
K
0..1
String
K
0..1
Decimal
K
0..1
String
K
0..1
Integer
K
0..1
–nteger
K
0..1
String
ChargesTotals
CalculationSequence
ActualPayment
@Currency
@integerValue
@decimalValue
@modulus
BSK
V er s ion: 1 .0 2
Integer value of real amount
Mandatory element in the EHF format
Decimal value of real amount
Mandatory element in the EHF format
Modulus code
20120903 Bank IG 1v02 e2bformatet3v3 English
Side 49 av 62
BSK Implementation guide B2B eFaktura
V er s ion: 1 .0 2
Appendix 1: Example of an invoice file
The example shows an invoice sent from Invoice Issuer AS, PO Box 234, 0253 OSLO using a bank that is connected to a service provider to the Recipient
Company AS, PO Box 12, 1370 ASKER that is using a bank that is linked to another service provider.
<?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>
<InvoiceDate>2008-04-13</InvoiceDate>
<Supplier>
<PartyId schemeId="efakturaId" schemeName="efakturaId" schemeAgencyName="ESSENOKX">ESSENOKXNO0015020012345</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>
<VatId>MVA987654321NO</VatId>
<Department>IT</Department>
<AccountInformation>
<AccountNumber>5005051234</AccountNumber>
</AccountInformation>
<ProjectRef>Project1</ProjectRef>
BSK
20120903 Bank IG 1v02 e2bformatet3v3 English
Side 50 av 62
BSK Implementation guide B2B eFaktura
V er s ion: 1 .0 2
<ContractNumber>54125412</ContractNumber>
</Supplier>
<Buyer>
<PartyId schemeId="efakturaId" schemeName="" 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>
<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>
BSK
20120903 Bank IG 1v02 e2bformatet3v3 English
Side 51 av 62
BSK Implementation guide B2B eFaktura
V er s ion: 1 .0 2
<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>
<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>
BSK
20120903 Bank IG 1v02 e2bformatet3v3 English
Side 52 av 62
BSK Implementation guide B2B eFaktura
V er s ion: 1 .0 2
<VatBaseAmount>0.66</VatBaseAmount>
<VatAmount>0.17</VatAmount>
</VatInfo>
</InvoiceCharges>
</InvoiceDiscountChargesAndTax>
<InvoiceSummary>
<InvoiceTotals>
<LineItemTotalsAmount>11</LineItemTotalsAmount>
<DiscountTotalsAmount>0</DiscountTotalsAmount>
<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
20120903 Bank IG 1v02 e2bformatet3v3 English
Side 53 av 62
BSK Implementationguide B2B efaktura
V er s ion: 1 .0 2
Appendix 2: Advice for using the format
1. The use of the format
This appendix describes some of the information items in the format and gives advice
about how to use the fields and what information to be placed in the field to ensure the
precise distribution. The goal is that it should be easier for the invoice issuer to
generate files and easier for the invoice recipient to receive files from different invoice
issuers. Equal use of the different information elements prevents that the invoice
recipient must analyze the files received from different issuers every time.
1.1. Actors/Roles
Actor/Roles
E2b
Comment
Supplier
Supplier
Invoice Issuer - is the part the supplies the
purchased goods/services and who has
entered into an agreement with its bank
about the role of "Invoice issuer".
Buyer
Buyer
Invoice Recipient - the part who is the
customer and who has entered into an
agreement with their bank about the role as
"invoice recipient".
Invoice issuer
InvoiceIssuer
Invoice Sender - the part that has sent the
invoice on behalf of themselves or others
who have signed an agreement with their
bank about the role of "Invoice issuer". May
be a technical part defined in the service
agreement the "Supplier" has signed with its
bank.
Invoice receiver
Invoicee
Invoice Recipient - the part that receives the
invoice on behalf of themselves or others
and who have signed an agreement with
their bank about the role as "Invoice issuer".
May be a technical part defined in the
service agreement the "Buyer" has signed
with its bank
Factoring
Factoring
Factoring - the part that shall receive the
payment from the buyer / invoice recipient
1.2. Use of fields in relation to references
Invoice issuer and invoice recipient needs to enter the various references in the invoice
when communicating with each other. This may for instance be related to a customer
number, an order number or project number. In those cases where the reference has a
unique field in e2b format (eg. order number) the specific field shall be used. But for other
required references this is not the case. The table below shows some references that have
no unique field in the e2b format. For these references, the banks recommend the following
use:
BSK
2 0 1 2 0 9 0 3 B a n k I G 1 v0 2 e 2 b f o r m a t e t 3 v3 E n g l i s h
Side 54 av 62
BSK Implementationguide B2B efaktura
V er s ion: 1 .0 2
Type of reference
Recommended use in the common bank
IG
Comments
Customer number
The invoice issuer’s customer number for
invoice receiver:
InvoiceHeader/Buyer/Ref
where the Code = ”CustomerNumber” and
Text contains the actual customer number
Supplier number
The invoice issuer’s supplier number at the
invoice receiver:
InvoiceHeader/Supplier/Ref
where the Code = ”SupplierNumber” and
Text contains the value for the supplier
number.
Our reference (invoice
issuer)
InvoiceHeader/Supplier/Ref
where the Code = ”OurReference” and Text
contains the value for ”Our reference”.
Your reference (invoice
receiver)
InvoiceHeader/Buyer /Ref
where the Code = ”YourReference” and Text
contains the value for ”Your reference”.
Payment reference that is
not a Norwegian KID
InvoiceHeader/Ref
where the Code = ”PaymentReference” and
Text contains the value for the “Payment
reference”.
The Norwegian KID shall be
given in
“InvoiceHeader/Payment/KidNu
mber.”
The field is also used in relation
with cross border invoicing.
Note that information that is
given in other unique fields in
the format shall NOT be
duplicated in this field (Payment
reference).
AvtaleGiro (B2C) (invoice
receiver)
InvoiceHeader/Buyer /Ref
where the Code = ”AvtaleGiro”
This is used for the B2C
solution in Norway to indicate
that this is an ”AvtaleGiro”.
Property identification
number
(Gårds- og bruksnummer.)
InvoiceHeader/Buyer /Ref
where the Code = ”GaardsBruksNr” and
Text contains the value for the property
identification number (gårds- og
bruksnummer).
Internet address (Link)
InvoiceHeader/Supplier/Ref
where the Code equals ”Linknr” (for identify
viewing etc.) and the linktext is the URL (eg.
http://www.test.no).
The supplier number identifies
the supplier in the buyers
internal systems.
The principle for the use of ”Ref”-fields should also be followed for other references that
do not have an unique field in the format.
BSK
2 0 1 2 0 9 0 3 B a n k I G 1 v0 2 e 2 b f o r m a t e t 3 v3 E n g l i s h
Side 55 av 62
BSK Implementationguide B2B efaktura
V er s ion: 1 .0 2
1.3. Special fields and industry specific solutions
It is many types of businesses that have ”special fields”. Industry specific fields give for
example insurance number, meter identification, card number, property identification
number etc. Even if there is industry specific extensions for many of these special
fields, there is very few invoice receivers that have implemented solutions in their
systems for receiving and process these industry specific extensions.
Therefore, it is recommended that any invoice issuers use of industry specific fields is
agreed with the respective invoice receiver. If it is not possible to make an agreement
or the invoice receiver cannot receive a business specific extension, it is recommended
that the “special field” information is put into the general “Ref”-fields. In the e2b format
(InvoiceHeader/Ref), this recommends to be used as follows:
Example:
<Ref>
<Code>card number</Code>
<Text>40061001</Text>
</Ref>
Note! It is important to limit the number of ”Ref”-fields to a minimum. All information
elements that can be put in unique fields in the e2b standard, shall not be put in the
general ”Ref”-field.
It is recommended that the invoice receiver always makes ready space for additional
Ref fields in their style sheet so they can view any additional references that may be
given in the invoice.
BSK
2 0 1 2 0 9 0 3 B a n k I G 1 v0 2 e 2 b f o r m a t e t 3 v3 E n g l i s h
Side 56 av 62
BSK Implementationguide B2B efaktura
V er s ion: 1 .0 2
1.4. Levels
The general use of Levels will be as follows:
 Level 1 is the least detailed product line level (Summary) and Level 4 is the most
detailed level (”productline”).
 Level 2 and 3 is used for specifying different groupings.

Level 1 is summary of all the following Levels 2, 3 and 4.
o Level 2 is summary of all the following Levels 3 and 4.
 Level 3 is summary of Level 4.
 Level 4 is the actual product lines.
Note: For energy invoice (LineOfBusiness=7), only Level 1 and Level 2 is used for product
lines, and Level “Maalerstand” is used for reporting meter stand (B2C).
Kode example:
BSK
2 0 1 2 0 9 0 3 B a n k I G 1 v0 2 e 2 b f o r m a t e t 3 v3 E n g l i s h
Side 57 av 62
BSK Implementationguide B2B efaktura
V er s ion: 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>
1.5. Consolidated Invoice
The term ”Consolidated invoice” is used for different types of invoices:
 The e2b format implies that an invoice only has ONE (1) order number since order
number is defined at the invoice level and not at the row level. If it is not necessary
to include the order number, it is possible to give on order per row
(InvoiceDetails/BaseItemDetails) in the invoice. An example is pizza deliveries
where each delivery (order) in a certain period of time or to a specific department
can be specified as one row in an invoice.
 A consolidated invoice that demands the use of sub rows
(InvoiceDetails/BaseItemDetails/SubInvoice) should not be used/distributed.
Instead, it is recommended that Levels is used, as specified in chapter 1.4 above.
 For the energy industry, it is only permitted one Meter ID (MålerpunktID) per
invoice.
BSK
2 0 1 2 0 9 0 3 B a n k I G 1 v0 2 e 2 b f o r m a t e t 3 v3 E n g l i s h
Side 58 av 62
BSK Implementationguide B2B efaktura
V er s ion: 1 .0 2
1.6. Postal and street address
In those cases when the format contains both a postal address and a street address, it
will be the postal address that is selected when mapping the information to other
systems and in the case of printing. It is therefore recommended that the postal
address is used if the format gives an option.
In e2b, address 1, 2 and 3 is used. It is not stated in the format what part of the
address is to be given in the different line. In this solution, the following rule is followed:
 Address 1 is the street address (ex. Firmaveien 12)
 Address 2 is optional.
 Address 3 is used for the post box address (ex. Postboks 123 Solli).
1.7. Mappingrules connected to the EHF format
1.7.1. Rule - mapping of invoice amount and the amount to be paid
Both invoice amount and amount to be paid requires content in the EHF format and
can either contain the same amount (most commonly) or different (such as invoices
related to the credit card).
 When mapping from the EHF to e2b, the respective amount values is put in the fields of
Gross Amount (Monetary Total. Inclusive Tax Amount. Amount) and ActualPayment
(Monetary Total. Payable_ Amount. Amount). Note that PayableAmount in e2b is
divided into separate fields for amount and desimals and that this must be taken into
account whn mapping the Payable Amount.
 If ActualPayment (optional element) is missing when mapping from e2b to EHF, then
the same “GrossAmount” is to be mapped to both "Monetary Total. Tax Inclusive
Amount. Amount” and" Monetary Total. Payable Amount. Amount" as both fields are
required.
 Note that in ActualAmount in the e2b format is divided into separate fields for amount
and desimals and that this must be taken into account in the mapping.
1.7.2. Rule - mapping of Factoring Party (e2b) and Payee Party (EHF)
When mapping from e2b to the EHF format, the Factoring Party will be mapped to
Payee Party in the EHF format. If the Payee Party is used in the EHF format, then
the Party information must be mapped to the Factoring Party in e2b, as it is not
possible to separate if the Party is related to Factoring Party or Party Payee.
1.7.3. Rule - mapping of attachements between e2b and EHF
When mapping invoices with attachments between e2b format and the EHF format,
the following factors has to be taken into account:
 The EHF format supports specified file types as attachements. e2b supports all
file types, but with invoices relevant for mapping from e2b to the EHF format
the relevant issuer must pay attention to which filetypes that can be sent with
the EHF format.
BSK
2 0 1 2 0 9 0 3 B a n k I G 1 v0 2 e 2 b f o r m a t e t 3 v3 E n g l i s h
Side 59 av 62
BSK Implementationguide B2B efaktura
V er s ion: 1 .0 2
1.7.4. Unit codes
Unit codes according to ISO31 are in practice not used in the e2b format. Freetext
format is common practice. In other words, anything may occur as a unit code in the
e2b format.
In EHF, unit codes are used according to the UNECE Recommendation 20. Note
that all the codes defined in ISO 31 is covered by UNECE Recommendation 20, but
not the other way around.
It is an advantage that users of the e2b format are used in accordance with device
codes. ISO 31 or the Norwegian term specified in the mapping table published by
DIFI. If the other device codes in text format are used, these will be converted
according to. list defined in the agreement a bank or a default code such pieces.
1.7.5. Dependencies between the amount fields
Note: In some cases, there are added a control whether the amount sum adds up
correctly against the various line amounts in the EHF invoices, for example the
corresponding fields for the e2b field "Invoice / InvoiceSummary / InvoiceTotals /
NetAmount". Thus this control should be implemented in the e2b message for these
fields.
BSK
2 0 1 2 0 9 0 3 B a n k I G 1 v0 2 e 2 b f o r m a t e t 3 v3 E n g l i s h
Side 60 av 62
BSK Implementationguide B2B efaktura
V er s ion: 1 .0 1
Change log
Changes done in version 1.01 from version 1.0
Chapter
3.2
3.2
3.3
3.6
Change
Note
The following sentence is included:
”The use of attachment is described in a
separate appendix.”
Figure: It is opened for use of ”Interchange
Header”and ”Message Header”.
The following sentence is included:
” BSK have not identified the need for making
bank specific IG’s for banks use of the
Interchange Header and Message Header.
These documents are described in separate
documents and can be collected at
www.e2b.no website.”
The elementet ”Attachements“ is opened for
use.
Changes done in version 1.02 from version 1.01
Chapter
1.1
2.1
2.3
2.6
2.7
2.8
3.3
3.5 - 3.10
General
changes
BSK
Change
Note
Revised so that orgnummer is included as
possible addressing mechanism.
Added note related to the type of business
documents.
Added clarification that banks also supports
ISO-8859-1
Revised elements that can be used for
duplication control by adding orgnummer as an
element.
New chapter with regard to banks' template
view
New chapter with reference to the EHF format.
Added reference to how process template is to
be included
Added reference to the information elements
that are required and recommended in the EHF
format.
General corrections that do not affect the
content meaning are made .
2 0 1 2 0 9 0 3 B a n k I G 1 v0 2 e 2 b f o r m a t e t 3 v3 E n g l i s h
Side 61 av 62
BSK Implementationguide B2B efaktura
3.6
Field type for ”BuyersOrderDate” is changes
from ”String” to ”Date”.
3.8/3.9/3.10
Appendix 2,
chap 1.7
Changed text connected to valid codes for VAT
to a general text ” Ref.: Statens gjeldende MVA
satser”
Supplier PartyID updated in order to also
handle adressing with organisastional number
Buyer PartyID updated in order to also handle
adressing with organisastional number
It is specified that contract number between
buyer and seller that the invoice is connected
to, is to be placed under Supplier and not
under Buyer.
Note connected to mapping of unitcodes
added.
Included information that VatAmount must be
included if the receiver uses the EHF format
Included specific mapping rules between the
e2b and the EHF format.
Appendix 2,
chap. 1.7.3
Last bulletpoint deleted. It is possible to send
more than one attachment in the EHF format.
Appendix 2,
chap. 1.7.5
New
3.7.1
3.7.2
3.7.1 / 3.7.2
3.8
3.9
BSK
V er s ion: 1 .0 1
”String” is changed
from e2b version 3.3
to ”Date” in version
3.4/3.4.1
2 0 1 2 0 9 0 3 B a n k I G 1 v0 2 e 2 b f o r m a t e t 3 v3 E n g l i s h
Side 62 av 62