Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Next »

Main functions

  1. Transmission of the invoice reference and any payment references such as the QR IBAN and the QR reference number for QR invoices in CH.

  2. Orderly clearing of the delivered items with all SHOULD elements, so that they fulfil the given rules of invoicing:

    1. Rules of invoicing in CH

    2. Rules of invoicing in the EU

Collective invoices

It is possible to transmit one invoice for several orders (collective invoice). For this purpose, the Galaxus purchase order number must be sent in the ORDER_ID element within the items (INVOICE_ITEM/ORDER_REFERENCE).

Fees/discounts

Prepaid recycling fees (vRG in CH, in EU WEEE) other fees or item discounts must be included in the PRICE_AMOUNTs of the items. The PRICE_AMOUNTs must correspond to the purchase prices (incl. fees excl. VAT) that are provided to us in the product data feeds in the PurchasePriceExclVat column, which we also use to order in the ORDP.

Documentation

 Schema
 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>
							<CONTACT_NAME xmlns="http://www.bmecat.org/bmecat/2005">Mustermann</CONTACT_NAME>
							<FIRST_NAME xmlns="http://www.bmecat.org/bmecat/2005">Ulla</FIRST_NAME>
						</CONTACT_DETAILS>
						<STREET xmlns="http://www.bmecat.org/bmecat/2005">Musterstrasse 200b</STREET>
						<ZIP xmlns="http://www.bmecat.org/bmecat/2005">8000</ZIP>
						<ZIPBOX xmlns="http://www.bmecat.org/bmecat/2005">7</ZIPBOX>
						<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 no.

INVOICE_DATE

2017-10-09T03:26:39

dtDATETIME

Must

Invoice date

DELIVERYNOTE_ID

11720161201040841

dtSTRING[250]

Should

Delivery note reference number (if identical with all invoice positions)

DELIVERY_DATE

-

-

Should

Delivery date (if identical with all invoice positions)

DELIVERY_START_DATE

2017-10-11

dtDATETIME

Should

Estimated delivery date, please provide an exact date where DELIVERY_START_DATE = DELIVERY_END_DATE

DELIVERY_END_DATE

2017-10-11

dtDATETIME

Should

Estimated delivery date, please provide an exact date with the same value as in DELIVERY_START_DATE

PARTIES

-

-

Must

PARTY

-

-

Must

PARTY_ROLE

buyer, invoice_issuer

dtSTRING[20]

Must

Three PARTY_ROLES are possible:
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

Digitec Galaxus AG, Supplier GmbH

dtMLSTRING[50]

BMEcat NS

Should

Private customer: full name
Business customer: company name

NAME2

Ulla Mustermann

dtMLSTRING[50]

BMEcat NS

Should

Contact person for business customer

CONTACT_DETAILS

-

-

Should

Must be equivalent with the CONTACT_DETAILS in our order

CONTACT_NAME

Mustermann

dtMLSTRING[50]

BMEcat NS

Should

last name of the delivery reference person

FIRST_NAME

Ulla

dtMLSTRING[50]

BMEcat NS

Should

First name of the delivery reference person

STREET

Accounting, Pfingstweidstrasse 60b

dtMLSTRING[50]

BMEcat NS

Should

Street incl. No.

ZIP

8005

dtMLSTRING[20]

BMEcat NS

Should

ZIP code

ZIPBOX

7

dtMLSTRING[20]

BMEcat NS

Should

ZIP Box

CITY

Zürich

dtMLSTRING[50]

BMEcat NS

Should

City

COUNTRY

Schweiz

dtMLSTRING[50]

BMEcat NS

Should

Country – only submitted in German

VAT_ID

CHE-123.456.789 MWST

dtSTRING[50]

BMEcat NS

Should

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

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"

CH1230808001234567890

typeMLSTRING64000[21]

Can

Only for payment transactions in CH
QR-IBAN for QR invoices

REMARKS type="scor"

RF18000000000539007547034

typeMLSTRING64000[25]

Can

For international payment transactions
Structured Creditor Reference (SCOR) acording to ISO 11649
(warning) Cannot be used in combination with QR-IBAN cf. also payment standards p. 35 and 47

CURRENCY

CHF

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

Must*

Galaxus purchase Order ID of the ORDP

SUPPLIER_ORDER_ID

B2393234

dtSTRING[250]

Can

Order ID from your ERP

INVOICE_ITEM_LIST

-

-

Must

INVOICE_ITEM

-

-

Must

PRODUCT_ID

-

-

Must

If possible do always send all three sub-elements SUPPLIER_PID, INTERNATIONAL_PID und BUYER_PID

SUPPLIER_PID

26355917130453

dtSTRING[32]

BMEcat NS

Must

Partner product key

INTERNATIONAL_PID

05052197017458

dtSTRING[14]

BMEcat NS

Can

GTIN-14 with leading zeros

BUYER_PID

5952921

dtSTRING[50]

BMEcat NS

Can

Galaxus internal product ID

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

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

-

-

Should

DELIVERYNOTE_ID

11720161201040841

dtSTRING[250]

Should

Delivery note reference number

(must be present, if not already mentioned in INVOICE_INFO, if not identical with all invoice positions)

DELIVERY_DATE

-

-

Should

Delivery date
(must be present, if not already mentioned in INVOICE_INFO, if not identical with all invoice positions)

DELIVERY_START_DATE

2017-10-11

dtDATETIME

Should

Estimated arrival date, if possible please provide an exact date where DELIVERY_START_DATE = DELIVERY_END_DATE

DELIVERY_END_DATE

2017-10-11

dtDATETIME

Should

Estimated arrival date, please provide an exact date with the same value as in DELIVERY_START_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 delivery charges / surcharges

ALLOW_OR_CHARGE

-

-

Can

Only the type="surcharge" for surcharges added to the invoice can be used.

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

dtNUMBER

BMEcat NS

Should

VAT rate

TAX_AMOUNT

5.59

dtNUMBER

Should

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

  • No labels