Page Comparison

Anchor

	top
	top

🇩🇪 Zur Anleitung in Deutsch wechseln / Supplier Cancel Notification (EOLN) →

Main function

VAT-compliant electronic invoicing.

Note

Note

Credit notes cannot be handled via Invoice, see:

Credit notes

handling

CH

Credit notes handling

& EU

Info

Fees/Discounts

Fees and item 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

panelIconId	2696
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 Removed

Image Added

Expand

title	Example file

Code Block

language	xml

<?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.077<081</TAX>
					<TAX_AMOUNT>4AMOUNT>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>

INVOICE

XML Element	M/C/S	Sample values	Data type [maxLength]

M/C/S

Description

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 number
. . . INVOICE_DATE	Must	2017-10-09T03:26:39	dtDATETIME

Must

	Invoice date
. . . DELIVERYNOTE_ID

11720161201040841

dtSTRING[250]

Must * (see ⚖️ Info)	11720161201040841	dtSTRING[250]	Delivery note reference
. . . DELIVERY_DATE

-

	Must * (see ⚖️ Info)	-	-
. . . . DELIVERY_START_DATE

2017-10-11

dtDATETIME

Must * (see ⚖️ Info)	2017-10-11	dtDATETIME	Delivery date
. . . . DELIVERY_END_DATE

2017-10-11

dtDATETIME

Must * (see ⚖️ Info)	2017-10-11	dtDATETIME	Delivery date
. . . PARTIES	Must	-	-

Must


. . . . PARTY	Must	-	-

Must


. . . . . PARTY_ROLE	Must	buyer, invoice_issuer, delivery	dtSTRING[20]

Must

	buyer / invoice_issuer / delivery (Goods recipient)
. . . . . ADDRESS	Must	-	-

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

Should

Company name

. . . . . . NAME3

Should

Block A

dtMLSTRING[50]

BMEcat NS

Should

Building

. . . . . . DEPARTMENT

Should

Accounting

dtMLSTRING[50]

BMEcat NS

Should

	Department
. . . . . . CONTACT_DETAILS	Can	-	-

Can

. . . . . . . TITLE

Should

Mr., Ms.

dtMLSTRING[20]

BMEcat NS

Should

Salutation

. . . . . . . FIRST_NAME

Should

Ulla

dtMLSTRING[50]

BMEcat NS

Should

First name

. . . . . . . CONTACT_NAME

Should

Mustermann

dtMLSTRING[50]

BMEcat NS

Should

	Last name
. . . . . .

STREET

Should

Musterstrasse 200b

dtMLSTRING[50]

BMEcat NS

Should

Street incl. No.

. . . . . . ZIP

Should

8000

dtMLSTRING[20]

BMEcat NS

Should

ZIP code of address or post office box

. . . . . . BOXNO

Should

7

dtMLSTRING[20]

BMEcat NS

Should

P.O. Box number

. . . . . . CITY

Should

Zürich

dtMLSTRING[50]

BMEcat NS

Should

City

. . . . . . COUNTRY

Should

Schweiz

dtMLSTRING[50]

BMEcat NS

Should

Country

. . . . . . COUNTRY_CODED

Can

CH, DE, AT

dtCOUNTRIES

BMEcat NS

Can

Country code according ISO 3166-1 ALPHA-2

. . . . . . VAT_ID

Must

CHE-123.456.789 MWST

dtSTRING[50]

BMEcat NS

Must

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

is mandatory for

VAT compliance

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"	Can	CH1233000001234567890	typeMLSTRING64000[21]

Can

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
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[25]

Must *

Galaxus purchase Order ID of the Order Placement

In the case of 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

. . . . SUPPLIER_PID

Must

26355917130453

dtSTRING[32]

BMEcat NS

Must

Partner product key

. . . . INTERNATIONAL_PID

Should

05052197017458

dtSTRING[14]

BMEcat NS

Should

GTIN-14 with leading zeros

. . . . BUYER_PID

Can

5952921

dtSTRING[50]

BMEcat NS

Can

Galaxus product 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	Must	0.

077

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

11720161201040841

dtSTRING[250]

	Must * (see ⚖️ Info)	11720161201040841	dtSTRING[250]	Delivery note reference
. . . . DELIVERY_DATE

-

	Must * (see ⚖️ Info)	-	-
. . . . . DELIVERY_START_DATE

2017-10-11

dtDATETIME

Must * (see ⚖️ Info)	2017-10-11	dtDATETIME	Delivery date
. . . . . DELIVERY_END_

DATE

2017-10-11

dtDATETIME

DATE	Must * (see ⚖️ Info)	2017-10-11	dtDATETIME	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 fees / surcharges (according to the agreed delivery cost model)
. . . ALLOW_OR_CHARGE	Can	-	-

Can

Only the type «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 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	Should	0.

077

081, 0.19

dtNUMBER

BMEcat NS

Should

VAT rate
. . . . TAX_AMOUNT	Should	5.59	dtNUMBER

Should

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

↑ Top

Version	Old Version 3	New Version Current
Changes made by	Digitec Galaxus AG	Digitec Galaxus AG
Saved on	Dec 30, 2022	Dec 13, 2024

Versions Compared

Key