Invoice INVO

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

Main function

VAT-compliant electronic invoicing.

Note

Credit notes cannot be handled via Invoice, see:

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.

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)

Example file

<?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
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: What are Galaxus' bank details?
. . . 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 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]	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.)

↑ Top