Invoice INVO

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

Main function

VAT-compliant electronic invoicing.

Instead of invoices per delivery or invoices per order, collective invoices are also possible - it is important to correctly reference the item (INVOICE_ITEM) to the respective order (ORDER_ID).

Note

Credit notes cannot be handled via Invoice, see:

Credit notes CH & EU

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)

XML tree view

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

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 = buyer invoice_issuer = invoice issuer (*mandatory) delivery = recipient of goods
. . . . . 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[50] BMEcat NS	Partner product key
. . . . INTERNATIONAL_PID	Must	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.30	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.60	dtNUMBER	Net price for position:Quantity * Unit Price excl. VAT plus eventual recycling fees (e.g. vRG / WEEE) or rebates= QUANTITY * PRICE_AMOUNT