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 | 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 | dtCOUNTRIES BMEcat NS | Can | Country code according ISO 3166-1 ALPHA-2 |
. . . . . . VAT_ID | CHE-123.456.789 MWST | dtSTRING[50] BMEcat NS | Should * | Company identification number (UID) * = Required for VAT compliance |
. . . REMARKS type="qrr" | 949643000000081595108367731 | typeMLSTRING64000[27] | Can | Only for payment transactions in CH |
. . . REMARKS type="qriban" | CH1233000001234567890 | 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 | Should | 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 * = DELIVERYNOTE_ID or DELIVERY_DATE mandatory for VAT compliance |
. . . . DELIVERY_DATE | - | - | Should * | Delivery date * = DELIVERY_DATE or DELIVERYNOTE_ID mandatory for VAT compliance |
. . . . . 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.) |