Siewert & Kau Technologies EDI - openTRANS 2.1
Everything about the EDI connection at Siewert & Kau
Our EDI interface is based on the industry standard openTRANS 2.1 and enables you to securely and automatically exchange orders, delivery notes, invoices, and more – directly between your system and ours.
Here you can find a concise overview of how the connection works, which formats we support, and what steps are necessary until go-live.
If you have any questions, please contact your sales representative. If you do not currently have a designated contact person, please feel free to contact us at:
📞 +49 2271 763 0
📧 sales@siewert-kau.de
If you have any in-depth questions or technical issues relating to the EDI connection, our IT department is also available to assist you:
General information
Our EDI interface is based on the industry standard openTRANS version 2.1 and is exchanged as XML files via an sFTP server. Since the full scope of the openTRANS standard is very complex, we have focused on a manageable set of data that covers most use cases. We provide XSD files (XML description) and example XMLs as documentation for this set.
As we want to make this interface available to a broad base of our customers, please note that unfortunately no customizations are possible.
Connection Process
Using our questionnaire (see below), potential problems can be identified even before integration. Together, we will set a rough timeframe for the testing phase, during which we will run through some standard scenarios. Please send your sales contact the answers to the questionnaire. They will then establish contact for the connection.
The following points will be tested:
-
Address data, possibly with different delivery addresses
-
Drop-Shipments (optional)
-
Ordering (and confirmation, if applicable) of available and unavailable items
-
Prices
After completing the test phase, we will jointly schedule the date on which we will go live with the interface.
Data Transfer
To ensure encrypted data transfer, we use the sFTP protocol. We will gladly provide you with sFTP access as part of the connection process.
Message types
As a customer, you send us your orders via the ORDER message. Our system usually checks every five minutes to see if there is a new message on the server.
To acknowledge receipt of the order, our system can send you an automated ORDER RESPONSE.
Deliveries are notified via the DISPATCHNOTIFICATION message. This message lists both the items delivered and the tracking numbers for the shipment (if available).
Darüber hinaus stellt dir unser System Rechnungen in Form einer INVOICE-Nachricht zur Verfügung.
Communication partner / address data
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 recipient of the goods (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
An identifier in the form of a GLN must be transferred at least for the buyer and supplier addresses (if you do not have a GLN, this can be requested via GS1 Germany): https://www.gs1-germany.de/gs1-standards/identifikation/unternehmen-gln/ ). Our system can assign the order to your customer account via the GLN. This also ensures that we only process orders that have been addressed to us.
The openTRANS standard also expects these GLNs 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: 4262552150008
List of questions for new connections
Bitte lass deinem vertrieblichen Ansprechpartner die Antworten auf die Fragen zukommen. Er stellt anschließend den Kontakt für die Anbindung her.
Siewert & Kau customer number:
GLN:
Have you already gained 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 one of your company’s sftp servers be used for data exchange?
Own sftp server (send access data if necessary)
Dropshipment delivery bill
If you would like to send dropshipments directly to your customers via us, we will enclose a neutral delivery note.
Auf Wunsch kann dieser mit bis zu drei Bildern individualisiert werden (siehe Grafik unten).
You are welcome to send these directly along with the answers to the questionnaire for the connection:
– the files must be in *bmp format
– the delivery notes are printed in b/w, so please also provide the image files in b/w (due to file size)
Maximale Abmessungen/Größe:
Image link 1 – “Logo”: Width 1000px / Height 500px
Image link 2 – “Header”: Width 650px / Height 600px
Image link 3 – “Footer”: Width 1800px / Height 350px
*Valid for the first-time EDI connection. 1 month free shipping from commissioning.
Exclusively for orders transmitted via EDI. Not combinable with other promotions. Subject to change and errors.