Order Reception
In the Order Receipt section within Interfaces, you can define how incoming orders are transmitted and processed.
Table of Contents
- Overview of order formats
- Plain text / text format
- openTRANS 1.0 and 2.1
- S2XML
- cXML
- Transmission methods for order receipt
- Documentation and example files
- FAQ
- Video tutorial
To ensure a smooth exchange of order data with simple system, please add the domain simplesystem.com to your list of trusted senders or mark noreply@simplesystem.com as a safe sender. In addition, please exclude the following IP addresses of our mail servers from your spam filter: 3.68.161.150 / 3.69.123.149 / 18.198.77.236
Overview of order formats
Orders can be provided on the platform in various formats.
Both simple and standardized XML formats are available. Depending on the vendor's level of integration, these can be received via different technical methods.
The following formats are supported:
- Plain text / text format
- openTRANS 1.0
- openTRANS 2.1
- S2XML
- cXML
Plain text / text format
Orders in plain text format are transmitted exclusively by email.
The order email is structured as follows:
- Sender
noreply@simplesystem.com - Subject
simple system Order: [order number] - File attachment
simplesystem_[order number].xml -
Email content:
Dear Sir or Madam,
please find your order with simple system attached.
Best regards,
Your simple system team
The order number in the subject line and file name is a unique number and changes with every order.
Please note that the order email cannot be customized.
To ensure orders are delivered reliably, the sender address noreply@simplesystem.com should be allowlisted in your IT infrastructure.
openTRANS 1.0 and openTRANS 2.1
openTRANS is a standardized, XML-based format for electronic orders, developed by the Fraunhofer Institute.
The openTRANS 1.0 and openTRANS 2.1 formats are supported by many ERP systems and can therefore often be integrated directly into existing processes.
The technical documentation, including XSD files, is available on the platform.
S2XML
S2XML is simple system's own proprietary XML order format.
This format supports all existing and future features of the platform and therefore offers more flexibility than standardized formats.
One advantage of S2XML is that additional information can be transmitted that can only be mapped to a limited extent in the standard openTRANS formats.
This includes, for example, certain cost accounting information that customers use in their purchasing processes.
If customers want such information to be transmitted in full, using this format is recommended.
Documentation for the format is also available via the platform.
cXML
cXML is an XML format developed specifically for B2B procurement.
It is widely used in procurement systems and electronic purchasing platforms and enables standardized integration between purchasing and vendor systems.
Technical documentation is also available for this format.
Transmission methods for order receipt
In addition to the various data formats, several technical methods are available for transmitting orders.
Documentation for the format is also available via the platform.
Transmission by email
All supported order formats can be transmitted by email.
The following applies:
- With the plain text format, the order is contained in the email body
- With XML formats, transmission takes place as a file attachment
HTTPS POST
Orders can also be received via an HTTPS POST interface.
To do this, a corresponding URL and any necessary login credentials must be stored in the Interfaces section of the platform.
If no authentication is required, a period can be entered as both the username and password.
The default encoding of the transmitted data is UTF-8.
FTP / S-FTP push
With this transmission method, simple system sends orders directly to an FTP or S-FTP server operated by the vendor.
The following information must be stored in the portal for this:
- Server URL (e.g. orders.example.com, not an IP address)
- Port
- Login credentials
- Target directory
FTP / S-FTP pull
Alternatively, vendors can retrieve their orders themselves from an FTP server provided by simple system.
The required login credentials are displayed in the Interfaces section once this transmission method has been selected.
IP addresses to be allowlisted
If orders are transmitted via HTTPS POST or FTP / S-FTP push, the following IP addresses must be allowlisted:
-
3.68.161.150
-
3.69.123.149
-
18.198.77.236
This ensures that orders can be delivered correctly.
Documentation and example files
Here you will find example files for the available formats:
You will find documentation directly on the platform in the corresponding section.
FAQ
Which order format should I use?
This depends on your technical integration. S2XML is often recommended for maximum functionality.
Can I still receive orders by email?
Yes. All formats can also be received by email.
Which encoding is used?
The default encoding for interface transmissions is UTF-8.
Where do I configure the transmission method?
Configuration takes place in the Interfaces section within your platform account.
Video tutorial
You can see exactly how order transmission works on the platform here step by step.
Need help?
Do you have technical questions or problems receiving orders? Our technical support team will be happy to help.
Email: support@simplesystem.com
Phone: +49 (0) 89 / 998 2987 00
Phone service hours
Monday–Thursday: 8:00 am–4:00 pm
Friday: 8:00 am–3:00 pm