Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Anchortoptop

Main functions

  1. Transmission of the invoice reference and any payment references such as the QR IBAN and the QR reference number for QR invoices in CH.

  2. Orderly clearing of the delivered items with all SHOULD elements, so that they fulfil the given rules of invoicing:

    1. Rules of invoicing in CH

    2. Rules of invoicing in the EU

Note
Info

Collective invoices

It is possible to transmit one invoice for several orders (collective invoice). For this purpose, the Galaxus purchase order number must be sent in the ORDER_ID element within the items (INVOICE_ITEM/ORDER_REFERENCE).

Info

Fees/discounts

Prepaid recycling fees (vRG in CH, in EU WEEE) other fees or item discounts must be included in the PRICE_AMOUNTs of the items. The PRICE_AMOUNTs must correspond to the purchase prices (incl. fees excl. VAT) that are provided to us in the product data feeds in the PurchasePriceExclVat column, which we also use to order in the ORDP.

Documentation

Expand
titleSchema
Image Removed

Main function

VAT-compliant electronic invoicing.

Note

Note

Credit notes cannot be handled via Invoice, see:

Credit notes CH & EU

Info

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.

Panel
panelIconId2696
panelIcon:scales:
panelIconText⚖️
bgColor#E6FCFF

VAT compliance (reference to delivery)

  • The delivery must be referenced either by delivery note reference (DELIVERYNOTE_ID) or delivery date (DELIVERY_DATE).

  • This can be done in the header or on item level (for collective invoice)

image-20240104-125953.pngImage Added

Expand
titleExample file
Code Block
languagexml
<?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>
							

<CONTACT

<FIRST_NAME xmlns="http://www.bmecat.org/bmecat/2005"

>Mustermann<

>Ulla</

CONTACT

FIRST_NAME>
							

<FIRST

<CONTACT_NAME xmlns="http://www.bmecat.org/bmecat/2005"

>Ulla<

>Mustermann</

FIRST_NAME> </CONTACT_DETAILS> <STREET xmlns="http://www.bmecat.org/bmecat/2005">Musterstrasse 200b</STREET>

CONTACT_NAME>
						</CONTACT_DETAILS>
						

<ZIP

<STREET xmlns="http://www.bmecat.org/bmecat/2005"

>8000<

>Musterstrasse 200b</

ZIP>

STREET>
						

<ZIPBOX

<ZIP xmlns="http://www.bmecat.org/bmecat/2005"

>7<

>8000</

ZIPBOX>

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.

077<

081</TAX>
					<TAX_

AMOUNT>4

AMOUNT>5.

82<

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.

20<

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.

077<

081</TAX>
				<TAX_AMOUNT>5.

59<

88</TAX_AMOUNT>
			</TAX_DETAILS_FIX>
		</TOTAL_TAX>
	</INVOICE_SUMMARY>
</INVOICE>

XML Element

M/C/S

Sample values

Data type [maxLength]

M/C/S

Description

INVOICE

Must

-

-

Must

See Namespaces regarding the correct usage of namespaces.

. INVOICE_HEADER

Must

-

-

Must

. . CONTROL_INFO

Can

-

-

Can

. . . GENERATION_DATE

Can

2017-10-09T03:26:39

dtDATETIME

Can

Document creation timestamp

. . INVOICE_INFO

Must

-

-

Must

. . . INVOICE_ID

Must

65496816584

dtSTRING[250]

Must

Unique Invoice

no

number

. . .

INVOICE_DATE

Must

2017-10-09T03:26:39

dtDATETIME

Must

Invoice date

. . . DELIVERYNOTE_ID

Must *
(see ⚖️ Info)

11720161201040841

dtSTRING[250]

Should

Delivery note reference

number (if identical with all invoice positions)

DELIVERY_DATE

-

-

Should

Delivery date (if identical with all invoice positions)

DELIVERY_START_DATE

. . . 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

Should

Estimated delivery date, please provide an exact date where DELIVERY_START_DATE = DELIVERY_END_DATE

DELIVERY_END_DATE

2017-10-11

dtDATETIME

Should

Estimated delivery date, please provide an exact date with the same value as in DELIVERY_START_DATE

PARTIES

-

-

Must

PARTY

-

-

Must

PARTY_ROLE

buyer, invoice_issuer

dtSTRING[20]

Must

Three PARTY_ROLES are possible:
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

Digitec Galaxus AG, Supplier GmbH

dtMLSTRING[50]

BMEcat NS

Should

Private customer: full name
Business customer: company name

NAME2

Ulla Mustermann

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

Should

Contact person for business customer

CONTACT_DETAILS

-

-

Should

Must be equivalent with the CONTACT_DETAILS in our order

FIRST_NAME

Ulla

First name

. . . . . . . CONTACT_NAME

Should

Mustermann

dtMLSTRING[50]

BMEcat NS

Should

last name of the delivery reference person

STREET

Accounting, Pfingstweidstrasse 60b

Last name

. . . . . . STREET

Should

Musterstrasse 200b

dtMLSTRING[50]

BMEcat NS

Should

First name of the delivery reference person

Street incl. No.

. . . . . . ZIP

Should

8000

dtMLSTRING[

50

20]

BMEcat NS

Should

Street incl. No.

ZIP

8005

ZIPBOX

7

ZIP code of address or post office box

. . . . . . BOXNO

Should

7

dtMLSTRING[20]

BMEcat NS

Should

ZIP code

P.O. Box number

. . . . . . CITY

Should

Zürich

dtMLSTRING[

20

CITY

Zürich

50]

BMEcat NS

Should

ZIP Box

dtMLSTRING[50]

City

. . . . . . COUNTRY

Should

Schweiz

dtMLSTRING[50]

BMEcat NS

Should

City

COUNTRY

Schweiz

Country

. . . . . . COUNTRY_CODED

Can

CH, DE, AT

dtCOUNTRIES

BMEcat NS

Should

Country

– only submitted in German

code according ISO 3166-1 ALPHA-2

. . . . . . VAT_ID

Must

CHE-123.456.789 MWST

dtSTRING[50]

BMEcat NS

Should

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


sales tax identification number (USt-ID) in Germany

in Germany

is mandatory for PARTY_ROLE=invoice_issuer to be VAT compliant
see also our payment information: What are Galaxus' bank details?

. . . REMARKS type="qrr"

Can

949643000000081595108367731

typeMLSTRING64000[27]

Can

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"

CH1230808001234567890

Can

CH1233000001234567890

typeMLSTRING64000[21

]

Can

Only for payment transactions in CH
QR-IBAN for QR invoices

]

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]

Can

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

35

36 and

47

48

. . . CURRENCY

Must

CHF, EUR

dtCURRENCIES[3]

BMEcat NS

Must

Transaction currency according to ISO 4217:1995

. . ORDER_HISTORY

Must *

-

-

Must

*

*

= Mandatory if ALLOW_OR_CHARGES_FIX is used

. .

. ORDER_ID

Must *

14609982

dtSTRING[

250

25]

Must*

Galaxus purchase Order ID of the Order Placement

In the case of

the ORDP

collective invoices, one of the affected order numbers must be specified, e.g. the first

. . . SUPPLIER_ORDER_ID

Can

B2393234

dtSTRING[250]

Can

Order ID from your ERP

. INVOICE_ITEM_LIST

Must

-

-

Must

. . INVOICE_ITEM

Must

-

-

Must

. . . PRODUCT_ID

-

Must

-

Must

If possible do always send all three sub-elements SUPPLIER_PID, INTERNATIONAL_PID und BUYER_PID

-

. . . . SUPPLIER_PID

Must

26355917130453

dtSTRING[32]

BMEcat NS

Must

Partner product key

. . . . INTERNATIONAL_PID

Should

05052197017458

dtSTRING[14]

BMEcat NS

Can

GTIN-14 with leading zeros

. . . . BUYER_PID

Can

5952921

dtSTRING[50]

BMEcat NS

Can

Galaxus

internal

product

ID

key

. . . QUANTITY

Must

2

dtNUMBER

Must

Item position quantity

. . . PRODUCT_PRICE_FIX

Must

-

-

Must

. . . . PRICE_AMOUNT

Must

31.3

dtNUMBER

BMEcat NS

Must

Unit price excl. VAT incl.

plus

eventual recycling fees (e.g. vRG / WEEE) or

rebates

position discounts

. . . . TAX_DETAILS_FIX

Must

-

-

Must

TAX

0.077

-

. . . . . TAX

Must

0.081, 0.19

dtNUMBER

BMEcat NS

Must

VAT-rate as decimal number

. . . . . TAX_AMOUNT

Should

4.82

dtNUMBER

Should

VAT amount * quantity

. . . PRICE_LINE_AMOUNT

Must

62.6

dtNUMBER

Must

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

-

-

Must

. . . . ORDER_ID

Must

14609982

dtSTRING[250]

Must

Galaxus Purchase Order ID

. . . DELIVERY_REFERENCE

Must *
(see ⚖️ Info)

-

-

Should

. . . . DELIVERYNOTE_ID

Must *
(see ⚖️ Info)

11720161201040841

dtSTRING[250]

Should

Delivery note reference

number

(must be present, if not already mentioned in INVOICE_INFO, if not identical with all invoice positions)

. . . . DELIVERY_DATE

Must *
(see ⚖️ Info)

-

-

Should

Delivery date
(must be present, if not already mentioned in INVOICE_INFO, if not identical with all invoice positions)

DELIVERY_END_DATE

. . . . . DELIVERY_START_DATE

Must *
(see ⚖️ Info)

2017-10-11

dtDATETIME

Should

Estimated arrival date, if possible please provide an exact date where DELIVERY_START_DATE = DELIVERY_END_DATE

Delivery date

. . . . . DELIVERY_END_DATE

Must *
(see ⚖️ Info)

2017-10-11

dtDATETIME

Should

Estimated arrival date, please provide an exact date with the same value as in DELIVERY_START_DATE

Delivery date

. INVOICE_SUMMARY

Must

-

-

Must

. . NET_VALUE_GOODS

Must

62.6

dtNUMBER

Must

Total net sum of invoice for all positions excl. VAT. without additional fees

(

like freight

, recycling fees

etc.

)

. . TOTAL_AMOUNT

Must

78.20

dtNUMBER

Must

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

. . ALLOW_OR_CHARGES_FIX

Can

-

-

Can

Block for charging delivery

charges

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

. . . ALLOW_OR_CHARGE

Can

-

-

Can

Only the type

="surcharge"

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

. . . . ALLOW_OR_CHARGE_TYPE

Can

freight

dtSTRING[30]

Can

Allowed values (in lower case) are:

·        
  • express

·        
  • freight

·        
  • handling

·        
  • insurance

·        
  • small_order

Recycling fees must be included in

the  purchase

the purchase price PRICE_AMOUNT in each position.

. . . . ALLOW_OR_CHARGE_VALUE

Can

-

-

Can

. . . . . AOC_MONETARY_AMOUNT

Can

10

dtFLOAT

Can

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

Can

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

-

-

Should

. . . TAX_DETAILS_FIX

Should

-

-

Should

This element

an

and its child-elements are iterated, if INVOICE_ITEMs with different VAT rates are present

. . . . TAX

TAX

Should

0.

077

081, 0.19

dtNUMBER

BMEcat NS

Should

VAT rate

. . . . TAX_AMOUNT

Should

5.59

dtNUMBER

Should

VAT amount

of all

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