As a connection client, the myOpenFactory EDI Connector executes the file exchange (EDI-files and, if necessary, attachments such as technical drawings etc.) between your ERP system and the myOpenFactory EDI platform. The connection client is a service that runs on your communication server and allows complete monitoring on your part. As a result, the software also meets strict compliance rules.
The EDI Connector works folder-based, it fetches document-files (e.g. an order) from a defined directory and transfers them to the myOpenFactory platform using a certificate-protected HTTPS connection (method POST).
Every minute our EDI connector checks whether documents (e.g. order confirmations) could be picked up from the myOpenFactory platform. If yes the EDI connector retrieves it using a certificate-protected HTTPS connection (method GET) and stores the file in a designated folder on your system.
If there is a problem with the file dispatch, the documents are moved to an error folder so that no documents can be lost.
The certificate that comes with the EDI connector is valid for 2 years and a new one will be sent by us in good time upon expiration. The old certificate only needs to be replaced by the new one.
The EDI connector generates a log file that logs each of the Connector’s actions. If you have your own mail server, you can be automatically notified when error entries are written to the log.
One of the following server-OS are required:
• Windows Server 2012 or higher • CentOS 7 or higher with Docker-Container-Software see e.g.: https://docs.docker.com/install/linux/docker-ce/centos/ • Ubuntu 16.04 or higher with Docker-Container-Software see e.g.: https://docs.docker.com/install/linux/docker-ce/ubuntu/
The installation and configuration is carried out by a myOpenFactory employee together with your system administrator using remote control software. Duration: approx. 40 min.
A “prod” directory with the following subfolders:
Ein „prod“ Verzeichnis mit folgenden Unterordnern: • A “prod-out” folder for the outgoing productive documents. • A “prod-in” folder in which the incoming productive documents that the EDI Connector fetches from the platform are stored. • An “error” folder for the documents that could not be successfully sent to the platform. if this occurs the EDI-Connector sends an e-mail*. After the connection has been re-established, the document can be moved to the prod-out folder. Then it will be sent to the platform automatically. • If desired, an optional “success” folder can be created in which the EDI connector stores the successfully sent documents as a copy.
A “test” directory with the following subfolders:
• A “test-out” folder for the outgoing productive documents. • A “test-in” folder in which the incoming productive documents that the EDI Connector fetches from the platform are stored. • An “error” folder for the documents that could not be successfully sent to the platform. if this occurs the EDI-Connector sends an e-mail*. After the connection has been re-established, the document can be moved to the prod-out folder. Then it will be sent to the platform automatically.
If possible, put a test message (e.g. an po or oc) in the prod-out or test-out folder so that a connectivity test can be done.
You must ensure that a permitted access is configured to access other servers within your network if the above folders are on a different server.
You must ensure that the EDI connector is equipped with the necessary permission to access the Internet. Please allow “myopenfactory.net” and “github.com” in your firewall and proxy. Any virus scanners that may be used can also affect connectivity.
If you need our IP addresses to set up the necessary approvals in your software, please contact us.
40 – 50 GB is sufficient, but if you need the Success folder, you should plan for more capacity.
Please download the suitable installation file from Github (e.g. myof-client.exe_windows_amd64.zip) and save it on the desired communication server. https://github.com/myopenfactory/client/releases
Our EDI Connector is available as an open-source project on GitHub and can be validated by you. Our updates are signature-protected. See: https://github.com/myopenfactory/client
For all the information in this guide, we assume that the EDI Connector is installed in “C: \Program Files\myOpenFactory\Client”.
Before the EDI Conenctor can be updated, it must first be stopped. To do this, switch to the Windows “Services” (press windows key and search for “Services”).
Now locate the EDI Connector with the name “myof-client” (the naming after “myof-client” may vary slightly depending on the user). Then stop the EDI connector using the context menu (right-click) and the “Stop” selection. Next to the name, the current status of the EDI Connector is displayed in the selected line. At the beginning of the procedure, it should be in the “Running” state and after successful stopping, the “Status” field should be empty.
The EDI Conenctor has a built-in update mechanism. The EDI connector searches for the latest version and updates itself to the latest version after confirmation by the user.
Example - Successful Update
Example - Failed Update
Follow the same steps as described in 5.1 to open the Windows “Services” and locate the myOpenFactory EDI Connector. Then please start the Connector via the context menu (right-click).
If, contrary to expectations, the EDI connector cannot be started, please contact our support – support@myopenfactory.com . For further questions, please keep the log files from the folder „C:\ProgramData\myOpenFactory\Client\logs“ available.
If the automatic update under 5.2 has resulted in an error, please try to install the update manually.
If you encounter problems or errors with the EDI Connector after the update, please contact our support – support@myopenfactory.com.
Sometimes, it may be helpful to reset the EDI connector to the old version. After an update, the previously installed version of the EDI Connector is stored in the program directory („C:\program files\myOpenFactory\client“) with the name .myof-client.exe.old. To install the old version, just delete the new version “myof-client.exe” and rename the old version to “myof-client.exe”. Please note that the EDI Connector must be stopped for this, see 5.2. You can proceed now to point 5.3 to restart the EDI Connector.
Solution: Please start the update using an administrative powershell.
Solution: Please perform a manual update using point 5.4.
Solution A: In the settings of Windows Explorer you can activate the display of hidden files (see: https://support.microsoft.com/en-de/help/14201/windows-show-hidden-files)
Solution B: The update was not successful. Please perform a manual update, see 5.4
Finally, verify that the certificate filename in the config.properties file matches the new certificate filename. If not, please rename the configuration in config.properties accordingly so that the certificate can be loaded on restart.
After that, restart the Connector. See 5.3
If the EDI Connector does not work properly, restarting can help, see point 5.4
If restarting the Connector does’nt solve the problem, you can search the log files. They are usually located in the installation directory of the EDI Connector under ‘ProgramData’.
Here you open the most recent log file and search for the keyword ‘ERROR’.
If the error message is not ‘speaking’ enough or there is no error message, please contact our support – support@myopenfactory.com. In any case, please send the log files of the last 3 days, we will then take care of the problem immediately.
Last modified June 16, 2025