Invoice INVO

Main function

VAT-compliant electronic invoicing.

Note

Credit notes cannot be handled via Invoice, see:

Credit notes CH & EU

Fees/Discounts

Fees and discounts (e.g. vRG, VOC, WEEE) must be included in the item prices (excl. VAT) and correspond to the prices in the product data feed.

image-20240104-125953.png
XML tree view

 

<?xml version="1.0" encoding="utf-8"?> <INVOICE xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.opentrans.org/XMLSchema/2.1" version="2.1"> <INVOICE_HEADER> <CONTROL_INFO> <GENERATION_DATE>2017-10-09T03:26:39</GENERATION_DATE> </CONTROL_INFO> <INVOICE_INFO> <INVOICE_ID>65496816584</INVOICE_ID> <INVOICE_DATE>2017-10-09T03:26:39</INVOICE_DATE> <DELIVERYNOTE_ID>11720161201040841</DELIVERYNOTE_ID> <DELIVERY_DATE> <DELIVERY_START_DATE>2017-10-11</DELIVERY_START_DATE> <DELIVERY_END_DATE>2017-10-11</DELIVERY_END_DATE> </DELIVERY_DATE> <PARTIES> <PARTY> <PARTY_ROLE>buyer</PARTY_ROLE> <ADDRESS> <NAME xmlns="http://www.bmecat.org/bmecat/2005">Digitec Galaxus AG</NAME> <STREET xmlns="http://www.bmecat.org/bmecat/2005">Pfingsweidstrasse 60b</STREET> <ZIP xmlns="http://www.bmecat.org/bmecat/2005">8005</ZIP> <CITY xmlns="http://www.bmecat.org/bmecat/2005">Zürich</CITY> <COUNTRY xmlns="http://www.bmecat.org/bmecat/2005">Schweiz</COUNTRY> </ADDRESS> </PARTY> <PARTY> <PARTY_ROLE>invoice_issuer</PARTY_ROLE> <ADDRESS> <NAME xmlns="http://www.bmecat.org/bmecat/2005">Supplier company name</NAME> <STREET xmlns="http://www.bmecat.org/bmecat/2005">Supplier street</STREET> <ZIP xmlns="http://www.bmecat.org/bmecat/2005">8000</ZIP> <CITY xmlns="http://www.bmecat.org/bmecat/2005">Supplier city</CITY> <COUNTRY xmlns="http://www.bmecat.org/bmecat/2005">Schweiz</COUNTRY> <VAT_ID xmlns="http://www.bmecat.org/bmecat/2005">CHE-123.456.789 MWST</VAT_ID> </ADDRESS> </PARTY> <PARTY> <PARTY_ROLE>delivery</PARTY_ROLE> <ADDRESS> <NAME xmlns="http://www.bmecat.org/bmecat/2005">Mustermann GmbH</NAME> <NAME2 xmlns="http://www.bmecat.org/bmecat/2005">Ulla Mustermann</NAME2> <CONTACT_DETAILS> <FIRST_NAME xmlns="http://www.bmecat.org/bmecat/2005">Ulla</FIRST_NAME> <CONTACT_NAME xmlns="http://www.bmecat.org/bmecat/2005">Mustermann</CONTACT_NAME> </CONTACT_DETAILS> <STREET xmlns="http://www.bmecat.org/bmecat/2005">Musterstrasse 200b</STREET> <ZIP xmlns="http://www.bmecat.org/bmecat/2005">8000</ZIP> <CITY xmlns="http://www.bmecat.org/bmecat/2005">Zürich</CITY> <COUNTRY xmlns="http://www.bmecat.org/bmecat/2005">Schweiz</COUNTRY> </ADDRESS> </PARTY> </PARTIES> <REMARKS type="qrr">949643000000081595108367731</REMARKS> <REMARKS type="qriban">CH1230808001234567890</REMARKS> <CURRENCY xmlns="http://www.bmecat.org/bmecat/2005">CHF</CURRENCY> </INVOICE_INFO> <ORDER_HISTORY> <ORDER_ID>14609982</ORDER_ID> <SUPPLIER_ORDER_ID>B2393234</SUPPLIER_ORDER_ID> </ORDER_HISTORY> </INVOICE_HEADER> <INVOICE_ITEM_LIST> <INVOICE_ITEM> <PRODUCT_ID> <SUPPLIER_PID xmlns="http://www.bmecat.org/bmecat/2005">26355917130453</SUPPLIER_PID> <INTERNATIONAL_PID xmlns="http://www.bmecat.org/bmecat/2005">05052197017458</INTERNATIONAL_PID> <BUYER_PID xmlns="http://www.bmecat.org/bmecat/2005">5952921</BUYER_PID> </PRODUCT_ID> <QUANTITY>2</QUANTITY> <PRODUCT_PRICE_FIX> <PRICE_AMOUNT xmlns="http://www.bmecat.org/bmecat/2005">31.3</PRICE_AMOUNT> <TAX_DETAILS_FIX> <TAX xmlns="http://www.bmecat.org/bmecat/2005">0.081</TAX> <TAX_AMOUNT>5.07</TAX_AMOUNT> </TAX_DETAILS_FIX> </PRODUCT_PRICE_FIX> <PRICE_LINE_AMOUNT>62.6</PRICE_LINE_AMOUNT> <ORDER_REFERENCE> <ORDER_ID>14609982</ORDER_ID> </ORDER_REFERENCE> <DELIVERY_REFERENCE> <DELIVERYNOTE_ID>11720161201040841</DELIVERYNOTE_ID> <DELIVERY_DATE> <DELIVERY_START_DATE>2017-10-11</DELIVERY_START_DATE> <DELIVERY_END_DATE>2017-10-11</DELIVERY_END_DATE> </DELIVERY_DATE> </DELIVERY_REFERENCE> </INVOICE_ITEM> </INVOICE_ITEM_LIST> <INVOICE_SUMMARY> <NET_VALUE_GOODS>62.6</NET_VALUE_GOODS> <TOTAL_AMOUNT>78.48</TOTAL_AMOUNT> <ALLOW_OR_CHARGES_FIX> <ALLOW_OR_CHARGE type="surcharge"> <ALLOW_OR_CHARGE_TYPE>freight</ALLOW_OR_CHARGE_TYPE> <ALLOW_OR_CHARGE_VALUE> <AOC_MONETARY_AMOUNT>10</AOC_MONETARY_AMOUNT> </ALLOW_OR_CHARGE_VALUE> </ALLOW_OR_CHARGE> <ALLOW_OR_CHARGES_TOTAL_AMOUNT>10</ALLOW_OR_CHARGES_TOTAL_AMOUNT> </ALLOW_OR_CHARGES_FIX> <TOTAL_TAX> <TAX_DETAILS_FIX> <TAX xmlns="http://www.bmecat.org/bmecat/2005">0.081</TAX> <TAX_AMOUNT>5.88</TAX_AMOUNT> </TAX_DETAILS_FIX> </TOTAL_TAX> </INVOICE_SUMMARY> </INVOICE>

XML Element

M/C/S

Sample values

Data type [maxLength]

Description

XML Element

M/C/S

Sample values

Data type [maxLength]

Description

INVOICE

Must

-

-

See Namespaces regarding the correct usage of namespaces.

. INVOICE_HEADER

Must

-

-

 

. . CONTROL_INFO

Can

-

-

 

. . . GENERATION_DATE

Can

2017-10-09T03:26:39

dtDATETIME

Document creation timestamp

. . INVOICE_INFO

Must

-

-

 

. . . INVOICE_ID

Must

65496816584

dtSTRING[250]

Unique Invoice number

. . . INVOICE_DATE

Must

2017-10-09T03:26:39

dtDATETIME

Invoice date

. . . DELIVERYNOTE_ID

Must *
(see Info)

11720161201040841

dtSTRING[250]

Delivery note reference

. . . DELIVERY_DATE

Must *
(see Info)

-

-

 

. . . . DELIVERY_START_DATE

Must *
(see Info)

2017-10-11

dtDATETIME

Delivery date

. . . . DELIVERY_END_DATE

Must *
(see Info)

2017-10-11

dtDATETIME

Delivery date

. . . PARTIES

Must

-

-

 

. . . . PARTY

Must

-

-

 

. . . . . PARTY_ROLE

Must

buyer, invoice_issuer, delivery

dtSTRING[20]

buyer / invoice_issuer / delivery (Goods recipient)

. . . . . ADDRESS

Must

-

-

The element ADDRESS in the  PARTY_ROLE delivery must be present, even without any sub-elements.

. . . . . . NAME

Should

Mustermann GmbH

dtMLSTRING[50]

BMEcat NS

Company name

. . . . . . NAME3

Should

Block A

dtMLSTRING[50]

BMEcat NS

Building

. . . . . . DEPARTMENT

Should

Accounting

dtMLSTRING[50]

BMEcat NS

Department

. . . . . . CONTACT_DETAILS

Can

-

-

 

. . . . . . . TITLE

Should

Mr., Ms.

dtMLSTRING[20]

BMEcat NS

Salutation

. . . . . . . FIRST_NAME

Should

Ulla

dtMLSTRING[50]

BMEcat NS

First name

. . . . . . . CONTACT_NAME

Should

Mustermann

dtMLSTRING[50]

BMEcat NS

Last name

. . . . . . STREET

Should

Musterstrasse 200b

dtMLSTRING[50]

BMEcat NS

Street incl. No.

. . . . . . ZIP

Should

8000

dtMLSTRING[20]

BMEcat NS

ZIP code of address or post office box

. . . . . . BOXNO

Should

7

dtMLSTRING[20]

BMEcat NS

P.O. Box number

. . . . . . CITY

Should

Zürich

dtMLSTRING[50]

BMEcat NS

City

. . . . . . COUNTRY

Should

Schweiz

dtMLSTRING[50]

BMEcat NS

Country

. . . . . . COUNTRY_CODED

Can

CH, DE, AT

dtCOUNTRIES

BMEcat NS

Country code according ISO 3166-1 ALPHA-2

. . . . . . VAT_ID

Must

CHE-123.456.789 MWST

dtSTRING[50]

BMEcat NS

Company identification number (UID)
Sales tax identification number (USt-ID) in Germany

is mandatory for PARTY_ROLE=invoice_issuer to be VAT compliant
see also our payment information: https://confdg.atlassian.net/wiki/spaces/PH/pages/169096677378

. . . REMARKS type="qrr"

Can

949643000000081595108367731

typeMLSTRING64000[27]

Only for payment transactions in CH
QR reference number for QR invoices
(Total of 27 characters)
Also compare payment standards p. 13 and 53

. . . REMARKS type="qriban"

Can

CH1233000001234567890

typeMLSTRING64000[21]

Only for payment transactions in CH
QR-IBAN for QR invoices (specific QR account of the bank only for incoming payments)
Requirement: QR-IID in the range 30000 - 31999 (positions 5-9)
See payment standard page 13: 2.11 QR-IBAN

. . . REMARKS type="scor"

Can

RF18000000000539007547034

typeMLSTRING64000[25]

For international payment transactions
Structured Creditor Reference (SCOR) acording to ISO 11649
Cannot be used in combination with QR-IBAN cf. also payment standards p. 36 and 48

. . . CURRENCY

Must

CHF, EUR

dtCURRENCIES[3]

BMEcat NS

Transaction currency according to ISO 4217:1995

. . ORDER_HISTORY

Must *

-

-

* = Mandatory if ALLOW_OR_CHARGES_FIX is used

. . . ORDER_ID

Must *

14609982

dtSTRING[25]

Galaxus purchase Order ID of the Order Placement

. . . SUPPLIER_ORDER_ID

Can

B2393234

dtSTRING[250]

Order ID from your ERP

. INVOICE_ITEM_LIST

Must

-

-

 

. . INVOICE_ITEM

Must

-

-

 

. . . PRODUCT_ID

Must

-

-

 

. . . . SUPPLIER_PID

Must

26355917130453

dtSTRING[32]

BMEcat NS

Partner product key

. . . . INTERNATIONAL_PID

Should

05052197017458

dtSTRING[14]

BMEcat NS

GTIN-14 with leading zeros

. . . . BUYER_PID

Can

5952921

dtSTRING[50]

BMEcat NS

Galaxus product key

. . . QUANTITY

Must

2

dtNUMBER

Item position quantity

. . . PRODUCT_PRICE_FIX

Must

-

-

 

. . . . PRICE_AMOUNT

Must

31.3

dtNUMBER

BMEcat NS

Unit price excl. VAT incl. eventual recycling fees (e.g. vRG / WEEE) or position discounts

. . . . TAX_DETAILS_FIX

Must

-

-

 

. . . . . TAX

Must

0.081, 0.19

dtNUMBER

BMEcat NS

VAT-rate as decimal number

. . . . . TAX_AMOUNT

Should

4.82

dtNUMBER

VAT amount * quantity

. . . PRICE_LINE_AMOUNT

Must

62.6

dtNUMBER

Net price for position:
Quantity * Unit Price excl. VAT plus eventual recycling fees (e.g. vRG / WEEE) or rebates
= QUANTITY * PRICE_AMOUNT

. . . ORDER_REFERENCE

Must

-

-

 

. . . . ORDER_ID

Must

14609982

dtSTRING[250]

Galaxus Purchase Order ID

. . . DELIVERY_REFERENCE

Must *
(see Info)

-

-

 

. . . . DELIVERYNOTE_ID

Must *
(see Info)

11720161201040841

dtSTRING[250]

Delivery note reference

. . . . DELIVERY_DATE

Must *
(see Info)

-

-

 

. . . . . DELIVERY_START_DATE

Must *
(see Info)

2017-10-11

dtDATETIME

Delivery date

. . . . . DELIVERY_END_DATE

Must *
(see Info)

2017-10-11

dtDATETIME

Delivery date

. INVOICE_SUMMARY

Must

-

-

 

. . NET_VALUE_GOODS

Must

62.6

dtNUMBER

Total net sum of invoice for all positions excl. VAT. without additional fees (freight, recycling fees etc.)

. . TOTAL_AMOUNT

Must

78.20

dtNUMBER

Invoice Total - Sum of all Price Line Amounts and additional fees (freight, recycling fees etc.) incl. VAT

. . ALLOW_OR_CHARGES_FIX

Can

-

-

Block for charging delivery fees / surcharges (according to the agreed delivery cost model)

. . . ALLOW_OR_CHARGE

Can

-

-

Only the type «surcharge» for surcharges added to the invoice can be used (excl. VAT)

. . . . ALLOW_OR_CHARGE_TYPE

Can

freight

dtSTRING[30]

Allowed values (in lower case) are:

  • express

  • freight

  • handling

  • insurance

  • small_order

Recycling fees must be included in the purchase price PRICE_AMOUNT in each position.

. . . . ALLOW_OR_CHARGE_VALUE

Can

-

-

 

. . . . . AOC_MONETARY_AMOUNT

Can

10

dtFLOAT

The surcharge is specified by an absolute value excl. VAT.
The currency of this value corresponds to the currency of the product price.

. . . ALLOW_OR_CHARGES_TOTAL_AMOUNT

Can

10

dtFLOAT

Sum of all surcharges (excl. VAT):

Within the calculation, all surcharges are considered, which contain a money amount in ALLOW_OR_CHARGE_VALUE/AOC_MONETARY_AMOUNT

. . TOTAL_TAX

Should

-

-

 

. . . TAX_DETAILS_FIX

Should

-

-

This element an its child-elements are iterated, if INVOICE_ITEMs with different VAT rates are present

. . . . TAX

Should

0.081, 0.19

dtNUMBER

BMEcat NS

VAT rate

. . . . TAX_AMOUNT

Should

5.59

dtNUMBER

VAT amount of all positions and fees (freight, recycling fees etc.)