Invoice INVO
Main function
VAT-compliant electronic invoicing.
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.
XML Element | M/C/S | Sample values | Data type [maxLength] | Description |
---|---|---|---|---|
INVOICE | Must | - | - | See Namespaces regarding the correct usage of namespaces. |
. INVOICE_HEADER | Must | - | - |
|
. . CONTROL_INFO | Can | - | - |
|
. . . GENERATION_DATE | Can | 2017-10-09T03:26:39 | dtDATETIME | Document creation timestamp |
. . INVOICE_INFO | Must | - | - |
|
. . . INVOICE_ID | Must | 65496816584 | dtSTRING[250] | Unique Invoice number |
. . . INVOICE_DATE | Must | 2017-10-09T03:26:39 | dtDATETIME | Invoice date |
. . . DELIVERYNOTE_ID | Must * | 11720161201040841 | dtSTRING[250] | Delivery note reference |
. . . DELIVERY_DATE | Must * | - | - |
|
. . . . DELIVERY_START_DATE | Must * | 2017-10-11 | dtDATETIME | Delivery date |
. . . . DELIVERY_END_DATE | Must * | 2017-10-11 | dtDATETIME | 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 | First name |
. . . . . . . CONTACT_NAME | Should | Mustermann | dtMLSTRING[50] BMEcat NS | Last name |
. . . . . . STREET | Should | Musterstrasse 200b | dtMLSTRING[50] BMEcat NS | Street incl. No. |
. . . . . . ZIP | Should | 8000 | dtMLSTRING[20] BMEcat NS | ZIP code of address or post office box |
. . . . . . BOXNO | Should | 7 | dtMLSTRING[20] BMEcat NS | P.O. Box number |
. . . . . . CITY | Should | Zürich | dtMLSTRING[50] BMEcat NS | City |
. . . . . . COUNTRY | Should | Schweiz | dtMLSTRING[50] BMEcat NS | 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 | Company identification number (UID) 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] | Only for payment transactions in CH |
. . . REMARKS type="scor" | Can | RF18000000000539007547034 | typeMLSTRING64000[25] | For international payment transactions |
. . . CURRENCY | Must | CHF, EUR | dtCURRENCIES[3] BMEcat NS | 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 | - | - |
|
. . INVOICE_ITEM | Must | - | - |
|
. . . PRODUCT_ID | Must | - | - |
|
. . . . 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 | Item position quantity |
. . . PRODUCT_PRICE_FIX | Must | - | - |
|
. . . . PRICE_AMOUNT | Must | 31.3 | dtNUMBER BMEcat NS | Unit price excl. VAT incl. eventual recycling fees (e.g. vRG / WEEE) or position discounts |
. . . . TAX_DETAILS_FIX | Must | - | - |
|
. . . . . TAX | Must | 0.081, 0.19 | dtNUMBER BMEcat NS | VAT-rate as decimal number |
. . . . . TAX_AMOUNT | Should | 4.82 | dtNUMBER | VAT amount * quantity |
. . . PRICE_LINE_AMOUNT | Must | 62.6 | dtNUMBER | Net price for position: |
. . . ORDER_REFERENCE | Must | - | - |
|
. . . . ORDER_ID | Must | 14609982 | dtSTRING[250] | Galaxus Purchase Order ID |
. . . DELIVERY_REFERENCE | Must * | - | - |
|
. . . . DELIVERYNOTE_ID | Must * | 11720161201040841 | dtSTRING[250] | Delivery note reference |
. . . . DELIVERY_DATE | Must * | - | - |
|
. . . . . DELIVERY_START_DATE | Must * | 2017-10-11 | dtDATETIME | Delivery date |
. . . . . DELIVERY_END_DATE | Must * | 2017-10-11 | dtDATETIME | Delivery date |
. INVOICE_SUMMARY | 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 | 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] | 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 | - | - |
|
. . . . . 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 | - | - |
|
. . . TAX_DETAILS_FIX | Should | - | - | This element an its child-elements are iterated, if INVOICE_ITEMs with different VAT rates are present |
. . . . TAX | Should | 0.081, 0.19 | dtNUMBER BMEcat NS | VAT rate |
. . . . TAX_AMOUNT | Should | 5.59 | dtNUMBER | VAT amount of all positions and fees (freight, recycling fees etc.) |