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
Delivery costs and delivery insurance may not be charged within the items (INVOICE_ITEMs), but must be charged separately in the ALLOW_OR_CHARGE block.
No credit notes or negative amounts can be transmitted via the INVO this is done manually as a PDF by e-mail also compare:
Since the after sales processes are handled manually, no EDI INVOs may be sent for them → these lead to an import error for us and must therefore be prevented on the basis of the document type at your end. See also:
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
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: |
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 |
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) |
REMARKS type="qrr" | 949643000000081595108367731 | typeMLSTRING64000[27] | Can | Only for payment transactions in CH |
REMARKS type="qriban" | CH1230808001234567890 | typeMLSTRING64000[21] | Can | Only for payment transactions in CH |
REMARKS type="scor" | RF18000000000539007547034 | typeMLSTRING64000[25] | Can | For international payment transactions |
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: |
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 |
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.) |