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:

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)

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</TAX>
					<TAX_AMOUNT>4.82</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</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</TAX>
				<TAX_AMOUNT>5.59</TAX_AMOUNT>
			</TAX_DETAILS_FIX>
		</TOTAL_TAX>
	</INVOICE_SUMMARY>
</INVOICE>

MustCanMustMustMustMustMustMustMustShouldShouldShouldCanShouldShouldShouldShouldShouldShouldShouldCanMustCanMust Must *MustShouldMustMustMustMustCanCanCanShouldShould

XML Element	M/C/S	Sample values	Data type [maxLength]	M/C/S	Description
INVOICE	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		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	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_DATE2017-10-11	dtDATETIME	Must * (see ⚖️ Info)	2017-10-11	dtDATETIME	Delivery date
. . . PARTIES	Must	-	-
. . . . PARTY	Must	-	-
. . . . . PARTY_ROLE	Must	buyer, invoice_issuer	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
. . . . . . CITYCITY	Should	Zürich	dtMLSTRING[50] BMEcat NS	Should	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 VAT compliancePARTY_ROLE=invoice_issuer to be VAT compliant
. . . 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]		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 and 47
. . . CURRENCY	Must	CHF, EUR	dtCURRENCIES[3] BMEcat NS	Must	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]	Can	Order ID from your ERP
. INVOICE_ITEM_LIST	Must	-	-	Must
. . INVOICE_ITEM	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		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	-	-
. . . . PRICE_AMOUNT	Must	31.3	dtNUMBER BMEcat NS		Unit price excl. VAT. plus eventual recycling fees (e.g. vRG / WEEE) or rebates
. . . . TAX_DETAILS_FIX	Must	-	-	Must
. . . . . TAX	Must	0.077, 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]		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	dtDATETIMEDATE	Must * (see ⚖️ Info)	2017-10-11	dtDATETIME	Delivery date
. . . . . DELIVERY_END_DATE2017-10-11	dtDATETIME	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 (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	-	-	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	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: 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	-	-	Should	This element an its child-elements are iterated, if INVOICE_ITEMs with different VAT rates are present
. . . . TAX	Should	0.077, 0.19	dtNUMBER BMEcat NS	Should	VAT rate
. . . . TAX_AMOUNT	Should	5.59	dtNUMBER		VAT amount of all positions and fees (freight, recycling fees etc.)

↑ Top

Version	Old Version 3	New Version 4
Changes made by	Digitec Galaxus AG	Digitec Galaxus AG
Saved on	Dec 30, 2022	Jan 18, 2023

Versions Compared

Key