Main functions
Transmission of the invoice reference and any payment references such as the QR IBAN and the QR reference number for QR invoices in CH.
Orderly clearing of the delivered items with all SHOULD elements, so that they fulfil the given rules of invoicing:
Rules of invoicing in CH
Rules of invoicing in the EU
Note |
---|
|
Info |
---|
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). |
Info |
---|
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
title | Schema |
---|
Anchor | ||||
---|---|---|---|---|
|
Main function
VAT-compliant electronic invoicing.
Note |
---|
Note Credit notes cannot be handled via Invoice, see: |
Info |
---|
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. |
Panel | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
VAT compliance (reference to delivery)
|
Expand | |||||
---|---|---|---|---|---|
| |||||
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
XML Element | M/C/S | Sample values | Data type [maxLength] |
---|
M/C/S
Description | |||
---|---|---|---|
INVOICE | Must | - | - |
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 | - | - |
Must
. . . INVOICE_ID | Must | 65496816584 | dtSTRING[250] |
Must
Unique Invoice |
number |
. . . |
INVOICE_DATE | Must | 2017-10-09T03:26:39 | dtDATETIME |
Must
Invoice date | |||
. . . DELIVERYNOTE_ID | Must * | 11720161201040841 | dtSTRING[250] |
Should
Delivery note reference |
DELIVERY_DATE
-
-
Should
Delivery date (if identical with all invoice positions)
DELIVERY_START_DATE
. . . DELIVERY_DATE | Must * | - | - | |
. . . . DELIVERY_START_DATE | Must * | 2017-10-11 | dtDATETIME | Delivery date |
. . . . DELIVERY_END_DATE | Must * | 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
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 |
Should
Contact person for business customer
CONTACT_DETAILS
-
-
Should
Must be equivalent with the CONTACT_DETAILS in our order
FIRST_NAME
First name | |||
. . . . . . . CONTACT_NAME | Should | Mustermann | dtMLSTRING[50] BMEcat NS |
Should
last name of the delivery reference person
STREET
Last name | |||
. . . . . . STREET | Should | Musterstrasse 200b | dtMLSTRING[50] BMEcat NS |
Should
First name of the delivery reference person
Street incl. No. | |||
. . . . . . ZIP | Should | 8000 | dtMLSTRING[ |
20] BMEcat NS |
Should
Street incl. No.
ZIP
ZIPBOX
ZIP code of address or post office box | |||
. . . . . . BOXNO | Should | 7 | dtMLSTRING[20] BMEcat NS |
Should
ZIP code
P.O. Box number | |||
. . . . . . CITY | Should | Zürich | dtMLSTRING[ |
CITY
50] BMEcat NS |
Should
ZIP Box
City | |||
. . . . . . COUNTRY | Should | Schweiz | dtMLSTRING[50] BMEcat NS |
Should
City
COUNTRY
Schweiz
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 |
Should
Company identification number (UID) |
sales tax identification number (USt-ID) in Germany
in Germany is mandatory for PARTY_ROLE=invoice_issuer to be VAT compliant | |||
. . . REMARKS type="qrr" | Can | 949643000000081595108367731 | typeMLSTRING64000[27] |
Only for payment transactions in CH | |
. . . REMARKS type="qriban" |
Can | CH1233000001234567890 | typeMLSTRING64000[21 |
Can
Only for payment transactions in CH
QR-IBAN for QR invoices
] | Only for payment transactions in CH | ||
. . . REMARKS type="scor" | Can | RF18000000000539007547034 | typeMLSTRING64000[25] |
Can
For international payment transactions |
. . . 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 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 | - | - |
Must
. . INVOICE_ITEM | Must | - | - |
Must
. . . PRODUCT_ID |
Must | - |
Must
If possible do always send all three sub-elements SUPPLIER_PID, INTERNATIONAL_PID und BUYER_PID
- | |||
. . . . 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 |
Must
Item position quantity | |||
. . . PRODUCT_PRICE_FIX | Must | - | - |
Must
. . . . PRICE_AMOUNT | Must | 31.3 | dtNUMBER BMEcat NS |
Must
Unit price excl. VAT incl. |
eventual recycling fees (e.g. vRG / WEEE) or |
position discounts | ||
. . . . TAX_DETAILS_FIX | Must | - |
-
Must
TAX
- | |||
. . . . . TAX | Must | 0.081, 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 |
Net price for position: | |||
. . . ORDER_REFERENCE | Must | - | - |
Must
. . . . ORDER_ID | Must | 14609982 | dtSTRING[250] |
Galaxus Purchase Order ID | |||
. . . DELIVERY_REFERENCE | Must * | - | - |
Should
. . . . DELIVERYNOTE_ID | Must * | 11720161201040841 | dtSTRING[250] |
Delivery note reference |
(must be present, if not already mentioned in INVOICE_INFO, if not identical with all invoice positions)
. . . . DELIVERY_DATE | Must * | - | - |
Should
Delivery date
(must be present, if not already mentioned in INVOICE_INFO, if not identical with all invoice positions)
. . . . . DELIVERY_START_DATE | Must * | 2017-10-11 | dtDATETIME |
Should
Estimated arrival date, if possible please provide an exact date where DELIVERY_START_DATE = DELIVERY_END_DATE
Delivery date | |||
. . . . . DELIVERY_END_DATE | Must * | 2017-10-11 | dtDATETIME |
Should
Estimated arrival date, please provide an exact date with the same value as in DELIVERY_START_DATE
Delivery date | |||
. INVOICE_SUMMARY | Must | - | - |
Must
. . NET_VALUE_GOODS | Must | 62.6 | dtNUMBER |
Total net sum of invoice for all positions excl. VAT. without additional fees |
like freight |
etc. |
. . TOTAL_AMOUNT | Must | 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 | Can | freight | dtSTRING[30] |
Can
Allowed values (in lower case) are: |
|
|
|
|
Recycling fees must be included in |
the purchase price PRICE_AMOUNT in each position. | |||
. . . . ALLOW_OR_CHARGE_VALUE | Can | - | - |
Can
. . . . . AOC_MONETARY_AMOUNT | Can | 10 | dtFLOAT |
The surcharge is specified by an absolute value excl. VAT. | |||
. . . 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 | - | - |
Should
. . . TAX_DETAILS_FIX | Should | - | - |
This element |
and its child-elements are iterated, if INVOICE_ITEMs with different VAT rates are present |
. . . . TAX |
Should | 0. |
081, 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.) |