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

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

XML Element	Sample values	Data type [maxLength]	M/C/S	Description
INVOICE	-	-	Must	See Namespaces regarding the correct usage of namespaces.
. INVOICE_HEADER	-	-	Must
. . CONTROL_INFO	-	-	Can
. . . GENERATION_DATE	2017-10-09T03:26:39	dtDATETIME	Can	Document creation timestamp
. . INVOICE_INFO	-	-	Must
. . . INVOICE_ID	65496816584	dtSTRING[250]	Must	Unique Invoice number
. . . INVOICE_DATE	2017-10-09T03:26:39	dtDATETIME	Must	Invoice date
. . . DELIVERYNOTE_ID	11720161201040841	dtSTRING[250]	Must * (see ⚖️ Info)	Delivery note reference
. . . DELIVERY_DATE	-	-	Must * (see ⚖️ Info)
. . . . DELIVERY_START_DATE	2017-10-11	dtDATETIME	Must * (see ⚖️ Info)	Delivery date
. . . . DELIVERY_END_DATE	2017-10-11	dtDATETIME	Must * (see ⚖️ Info)	Delivery date
. . . PARTIES	-	-	Must
. . . . PARTY	-	-	Must
. . . . . PARTY_ROLE	buyer, invoice_issuer	dtSTRING[20]	Must	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	Mustermann GmbH	dtMLSTRING[50] BMEcat NS	Should	Company name
. . . . . . NAME3	Block A	dtMLSTRING[50] BMEcat NS	Should	Building
. . . . . . DEPARTMENT	Accounting	dtMLSTRING[50] BMEcat NS	Should	Department
. . . . . . CONTACT_DETAILS	-	-	Can
. . . . . . . TITLE	Mr., Ms.	dtMLSTRING[20] BMEcat NS	Should	Salutation
. . . . . . . FIRST_NAME	Ulla	dtMLSTRING[50] BMEcat NS	Should	First name
. . . . . . . CONTACT_NAME	Mustermann	dtMLSTRING[50] BMEcat NS	Should	Last name
. . . . . . STREET	Musterstrasse 200b	dtMLSTRING[50] BMEcat NS	Should	Street incl. No.
. . . . . . ZIP	8000	dtMLSTRING[20] BMEcat NS	Should	ZIP code of address or post office box
. . . . . . BOXNO	7	dtMLSTRING[20] BMEcat NS	Should	P.O. Box number
. . . . . . CITY	Zürich	dtMLSTRING[50] BMEcat NS	Should	City
. . . . . . COUNTRY	Schweiz	dtMLSTRING[50] BMEcat NS	Should	Country
. . . . . . COUNTRY_CODED	CH, DE, AT	dtCOUNTRIES BMEcat NS	Can	Country code according ISO 3166-1 ALPHA-2
. . . . . . VAT_ID	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
. . . REMARKS type="qrr"	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"	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"	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 and 47
. . . CURRENCY	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	14609982	dtSTRING[25]	Must *	Galaxus purchase Order ID of the Order Placement
. . . SUPPLIER_ORDER_ID	B2393234	dtSTRING[250]	Can	Order ID from your ERP
. INVOICE_ITEM_LIST	-	-	Must
. . INVOICE_ITEM	-	-	Must
. . . PRODUCT_ID	-	-	Must
. . . . SUPPLIER_PID	26355917130453	dtSTRING[32] BMEcat NS	Must	Partner product key
. . . . INTERNATIONAL_PID	05052197017458	dtSTRING[14] BMEcat NS	Should	GTIN-14 with leading zeros
. . . . BUYER_PID	5952921	dtSTRING[50] BMEcat NS	Can	Galaxus product key
. . . QUANTITY	2	dtNUMBER	Must	Item position quantity
. . . PRODUCT_PRICE_FIX	-	-	Must
. . . . PRICE_AMOUNT	31.3	dtNUMBER BMEcat NS	Must	Unit price excl. VAT. plus eventual recycling fees (e.g. vRG / WEEE) or rebates
. . . . TAX_DETAILS_FIX	-	-	Must
. . . . . TAX	0.077, 0.19	dtNUMBER BMEcat NS	Must	VAT-rate as decimal number
. . . . . TAX_AMOUNT	4.82	dtNUMBER	Should	VAT amount * quantity
. . . PRICE_LINE_AMOUNT	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
. . . . ORDER_ID	14609982	dtSTRING[250]	Must	Galaxus Purchase Order ID
. . . DELIVERY_REFERENCE	-	-	Must * (see ⚖️ Info)
. . . . DELIVERYNOTE_ID	11720161201040841	dtSTRING[250]	Must * (see ⚖️ Info)	Delivery note reference
. . . . DELIVERY_DATE	-	-	Must * (see ⚖️ Info)
. . . . . DELIVERY_START_DATE	2017-10-11	dtDATETIME	Must * (see ⚖️ Info)	Delivery date
. . . . . DELIVERY_END_DATE	2017-10-11	dtDATETIME	Must * (see ⚖️ Info)	Delivery date
. INVOICE_SUMMARY	-	-	Must
. . NET_VALUE_GOODS	62.6	dtNUMBER	Must	Total net sum of invoice for all positions excl. VAT. without additional fees (freight, recycling fees etc.)
. . TOTAL_AMOUNT	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	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	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
. . . . . AOC_MONETARY_AMOUNT	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	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	This element an its child-elements are iterated, if INVOICE_ITEMs with different VAT rates are present
. . . . TAX	0.077, 0.19	dtNUMBER BMEcat NS	Should	VAT rate
. . . . TAX_AMOUNT	5.59	dtNUMBER	Should	VAT amount of all positions and fees (freight, recycling fees etc.)

↑ Top