Siewert & Kau EDI - openTRANS 2.1
Our EDI interface is based on the industry standard openTRANS version 2.1 and is exchanged as XML files via sftp servers. Since the openTRANS standard is very complex in its full breadth, we have focused on a manageable set of data that can serve the majority of user cases. As documentation for this set, we provide so-called XSD files (XML description) as well as sample XMLs.
Since we want to make this interface available to a broad base of our customers, please note that unfortunately no customisation is possible.
Specification
The specification can be found in: „SK openTRANS Spezifikation.zip“ [Download-Link]
Process of a connection
With the help of our questionnaire (see below), possible problems can already be identified before the integration. Together we will determine a rough time for the test phase in which we will run through some standard scenarios. Please send the answers to the questionnaire to your sales contact. Your contact will then establish the technical contact for the connection.
The following points will be tested:
- Address data, if necessary with different delivery addresses
- Drop shipments (optional)
- Ordering and (if necessary) confirmation of available and unavailable items
- Prices
After completion of the test phase, we will schedule with you the time for the “go-live”.
Data transfer
To ensure that the data is transferred in encrypted form, we use the sftp-protocol for data transfer. We will be happy to provide you with sFTP access as part of the connection.
As a customer you transmit your orders to us via the ORDER message. As a rule, our system checks every 5 minutes whether there is a new message on the server.
To acknowledge receipt of the order, our system can send you an automated ORDERRESPONSE.
Deliveries are notified via the DISPATCHNOTIFICATION message. This message lists on the one hand the delivered items, as well as the tracking numbers (if available) of the consignment.
In addition, our system provides invoices in the form of an INVOICE message.
All four message types contain the PARTIES segment (/ORDER/ORDER_HEADER/ORDER_INFO/PARTIES), which contains the addresses of the buyer, the supplier and the delivery. The address type is determined via the “PARTY_ROLE” (/ORDER/ORDER_HEADER/ORDER_INFO/PARTIES/PARTY/PARTY_ROLE) and can contain the following values: buyer, delivery, supplier.
At least for the buyer and supplier addresses, an identifier in the form of a GLN must be transferred (if you do not have a GLN, one can be requested from GS1 Germany: : https://www.gs1-germany.de/gs1-standards/identifikation/unternehmen-gln/ ). The GLN enables our system to assign the order to your customer account. Furthermore, this ensures that we only process orders that have been addressed to us.
The openTRANS standard expects these GLNs in addition in the following elements::
/ORDER/ORDER_HEADER/ORDER_INFO/ORDER_PARTIES_REFERENCE/BUYER_IDREF
/ORDER/ORDER_HEADER/ORDER_INFO/ORDER_PARTIES_REFERENCE/SUPPLIER_IDREF
Die GLN der Siewert & Kau lautet: 4058601000000
Please send the answers to the questions to your sales contact. He will establish the contact for the connection.
Siewert & Kau customer number:
GLN:
Have you already had experience with openTRANS in the past?
Which optional message types should be connected in addition to ORDER?
DISPATCHNOTIFICATION
INVOICE
Should the Siewert & Kau sftp server or a sftp server of your company be used for data exchange?
Own sftp server (send access data if necessary)
If you would like to send dropshipments directly to your customer via us, we will enclose a neutral delivery note.
If desired, this can be customised with up to 3 images. (see graphic on the left)
You are welcome to send us these directly with the answers to the questionnaire for connection:
– the files must be formatted as *bmp
– the delivery notes will be printed in b/w – so please send the image files in b/w as well, due to the file size.
Maximum dimensions/size:
Image link 1 – “Logo”: width 1000px / height 500px
Image link 2 – “Header”: width 650px / height 600px
Image link 3 – “Footer”: width 1800px / height 350px