Anchor | ||||
---|---|---|---|---|
|
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 |
---|
function
VAT-compliant electronic invoicing.
Note |
---|
Note Credit notes cannot be handled via Invoice, see: |
Info |
---|
Fees/Discounts Fees and item 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 | 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.number | ||
. . . INVOICE_DATE | 2017-10-09T03:26:39 | dtDATETIME | Must | Invoice date | ||
. . . DELIVERYNOTE_ID | 11720161201040841 | dtSTRING[250] | ShouldMust * | Delivery note reference number (if identical with all invoice positions) | ||
. . . DELIVERY_DATE | - | - | ShouldMust * | Delivery date (if identical with all invoice positions(see ⚖️ Info) | ||
. . . . DELIVERY_START_DATE | 2017-10-11 | dtDATETIME | Should | Estimated delivery date, please provide an exact date where DELIVERY_START_DATE = DELIVERY_END_DATE | Must * | Delivery 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 | Must * | Delivery date |
. . . PARTIES | - | - | Must | |||
. . . . PARTY | - | - | Must | |||
. . . . . PARTY_ROLE | buyer, invoice_issuer | dtSTRING[20] | Must | Three PARTY_ROLES are possible:] | Must | buyer |
. . . . . 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, DE, AT | dtCOUNTRIES BMEcat NS | Can | Country code according ISO 3166-1 ALPHA-2 | ||
. . . . . . VAT_ID | CHE-123.456.789 MWST | dtSTRING[50] BMEcat NS | Should *Must | Company identification number (UID) * = Required is mandatory 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, 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 | 14609982 | dtSTRING[25025] | Must * | Galaxus purchase Order ID of the ORDP Order Placement | ||
. . . 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- | Must | ||
. . . . 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 IDkey | ||
. . . 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, 0.19 | 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 | - | - | ShouldMust * | |||
. . . . DELIVERYNOTE_ID | 11720161201040841 | dtSTRING[250] | Should Must * |
| Delivery note reference | |
. . . . DELIVERY_DATE | - | - | Should Must * | (see ⚖️ Info) | ||
. . . . . DELIVERY_START_DATE | 2017-10-11 | dtDATETIME | Should | Estimated arrival date, if possible please provide an exact date where DELIVERY_START_DATE = DELIVERY_END_DATEMust * | Delivery 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 | Must * | Delivery 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 charging delivery charges fees / surcharges (according to the agreed delivery cost model) | ||
. . . ALLOW_OR_CHARGE | - | - | Can | Only the type ="surcharge" «surcharge» for surcharges added to the invoice can be used (excl. VAT) | ||
. . . . ALLOW_OR_CHARGE_TYPE | freight | dtSTRING[30] | Can | Allowed values (in lower case) are:·
Recycling fees must be included in the purchase 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. | ||
. . . 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, 0.19 | 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.) |