Purchase order
EDI order
The purchase order (also referred to as the order) contains all information on ordering the items and the – possibly deviating – delivery address.
There are several details that are absolutely necessary for the purchase order.
Test-Flag (test_flag)
To ensure that we do not process the order as a regular order, we need the test_flag = 1 for testing.
Please send this to us in the first test orders and every further test.
Customer number (LPAN)
So that we can assign the order to your customer account, we need your customer number.
You can obtain it from your customer advisor.
Order reference (BORN)
The order reference can be used to assign the order later in your system.
We also provide the order reference with the other documents (order confirmation, delivery confirmation and invoice).
Delivery address
The delivery address can be either your own address or a deviating delivery address.
Confirmation email address (email_confirmation)
We will also send the PDF files for the order confirmation, delivery confirmation and invoice to you at the confirmation email address you have entered if required (otherwise leave it blank).
Complete delivery (SHCF)
If not all items are available in a sufficient quantity in stock, the complete delivery option allows you to choose whether the order should be sent as a complete delivery (Y), as a partial delivery in 2 parts (N) or as a multi-part delivery (M).
Additional costs may apply for partial deliveries.
Budget line item number (BLIN)
The budget line item number should be a sequential number and may only occur once in the order.
Item number (LITM)
In the item number field, please enter our item number.
You can find it in the price list or in our online shop. The item number is strictly numerical.
Quantity (OQTY)
The quantity corresponds to the number of pieces of the corresponding item that you want to order.
Unit price excluding VAT (UPRC)
In order for us to process the order automatically, we need the correct and up-to-date purchase price from you.
We will be happy to provide you with an article export containing price data for this.
The XML order is uploaded to the /ediinput folder on the SFTP in our company. Please use unique names and use your customer number as the prefix. For example, the file could be xxxxxxx_abc1234567.xml, where xxxxxxx is your customer number.
An example of an XML file including XSD validation can be found here.
Description | Data type | Length/format | Sample XML content | |||||||
---|---|---|---|---|---|---|---|---|---|---|
<?xml version="1.0" encoding="UTF-8"?> | ||||||||||
<order> | ||||||||||
Sender name | String | 50 | <message_header source="Ihre Firma" | |||||||
Company code ( 10=Brack, 20=Alltron) | Integer | destination="20" | ||||||||
Personal code | String | 50 | accesscode="" | |||||||
0 = Live, 1 = Test | Integer | test_flag="0" | ||||||||
Document type (fixed: order) | String | 50 | message_type="order" | |||||||
Document version date | String | 10 / dd.mm.yyyy | document_version_date="03.05.2005" | |||||||
Document version | String | 10 | document_version="2.30" | |||||||
Document creation date | String | 10 / dd.mm.yyyy | generation_date="24.07.2018" | |||||||
Document creation time | String | 8 / hh:mm:ss | generation_time="09:23:58" | |||||||
Confirmation email address | String | 50 | eMail_confirmation="info@muster.ch"/> | |||||||
<order_header> | ||||||||||
<order_reference> | ||||||||||
Your order number | String | 40 | <BORN>987654321</BORN> | |||||||
Order date | String | 10 / dd.mm.yyyy | <BORD>24.07.2018</BORD> | |||||||
<order_party> | ||||||||||
<buyer_party> | ||||||||||
<party_id> | ||||||||||
Your customer number with us | String | 10 | <LPAN>X123456</LPAN> | |||||||
<ship_to_party> | ||||||||||
<party_id> | ||||||||||
End customer number | String | 10 | <LPAN/> | |||||||
<name_address> | ||||||||||
Delivery address name | String | 41 | <PNA1>Hans Muster</PNA1> | |||||||
Delivery address name | String | 35 | <PNA2/> | |||||||
Delivery address reference | String | 35 | <PNA3/> | |||||||
Delivery address reference | String | 29 | <PRFF/> | |||||||
Delivery address no. | String | 41 | <PSTR>Auf dem Holzweg 1</PSTR> | |||||||
PO box | String | 41 | <PPOB/> | |||||||
Delivery address city | String | 35 | <PCTY>Musterhausen</PCTY> | |||||||
Delivery address postcode | String | 10 | <PPOC>1234</PPOC> | |||||||
Delivery address country | String | 3 | <PCTR>CH</PCTR> | |||||||
<order_information> | ||||||||||
<additional_information> | ||||||||||
Phonenumber | String | 30 | <CCOM/> | |||||||
Reference | String | 25 | <CREF/> | |||||||
End customer name | String | 25 | <ECUN/> | |||||||
Language (G = German, F = French) | String | 2 | <LNGC>G</LNGC> | |||||||
Complete delivery (Y/N, M = multi) | String | 1 | <SHCF>Y</SHCF> | |||||||
Fixed delivery date (Y/N) | String | 1 | <SFDF>N</SFDF> | |||||||
Desired fixed delivery date | String | 10 / dd.mm.yyyy | <RDDT>24.07.2018</RDDT> | |||||||
Contact name | String | 25 | <CCNA/> | |||||||
Delivery code | Integer | 25 | <CARC/> | |||||||
Information text | String | 25 | <ITXT/> | |||||||
<order_body> | ||||||||||
<line_item_number> | ||||||||||
Budget line item number | Integer | <BLIN>1</BLIN> | ||||||||
<part_number> | ||||||||||
Item number (ours) | String | 30 | <LITM>61797</LITM> | |||||||
Item number (yours) | String | 40 | <MITM>yourCode</MITM> | |||||||
<additional_line_information> | ||||||||||
Line item text | String | 40 | <PTXT/> | |||||||
Special offer number | String | 40 | <SBNR/> | |||||||
End customer email | String | 40 | <EUEA/> | |||||||
End customer name | String | 40 | <EUCN/> | |||||||
Row reference | String | 100 | <LREF/> | |||||||
<quantity> | ||||||||||
<quantity_value> | ||||||||||
Quantity | Decimal | <OQTY>1</OQTY> | ||||||||
<price> | ||||||||||
Unit price excluding VAT | Decimal | <UPRC>59.85</UPRC> |