Quick start – Ordizi Service

Program Purpose

Ordizi Service is a server-side data exchange service. It connects the database, mobile clients, and accounting systems, such as 1C.

Exchange with accounting systems is performed via file exchange folders. A separate folder is created for each section, inside which the service uses two service subfolders:

  • Import — Incoming files folder. The accounting system exports files here that the service needs to import.
  • Export — Outgoing files folder. The service generates files here to be transferred to the accounting system.

Important: File exchange in the service settings refers specifically to the exchange with accounting systems, such as 1C. Mobile clients connect via the HTTP/HTTPS interface of the service.

Quick Start: End-to-End Example

Below is the complete setup cycle—from unpacking the archive to loading test data and connecting the mobile app.

1. Installation and startup of the service

  • Unpack the program distribution archive into a permanent folder on the server (for example, D:\OrdiziService).
  • Run ordizi.manager.exe as an administrator.
  • In the opened manager, select “1. Set HTTPS server port” and specify the port, for example 8080.
  • Select “2. Install and start service” to install and start the service.
  • Ensure that the service status has changed to “Running”.

2. Server login and configuration

  • Open the admin panel in your browser at
    https://localhost:8080/admin (if the setup is performed locally on the server itself). The browser may block the connection because a self-signed certificate is used. Click “Advanced/Details” (the label may vary by browser) and then “Proceed to localhost”.
  • Log in using the initial credentials: username admin, password admin.
  • In the “Admin panel” block (located at the very bottom of the page), be sure to change the administrator password.
  • To configure HTTP access, enter the service address in the “Services” block. For testing on a local network, specify the server’s IP address in the same block (for example, 192.168.1.10), and for a remote server (such as a VPS), specify its external IP address or domain.
  • In the “Database connection” block, specify the connection parameters, enter the name of the new database, and click “Create DB”. Supported types include “MSSQL”, “PostgreSQL”, and “MySQL”.
  • In the “File exchange” block, select the “Local folder” mode and specify the pre-created root exchange folder (for example, D:\OrdiziExchange).
  • Click “Save settings” and “Restart application”.

3. Port opening (Firewall)

  • To connect mobile clients, make sure the selected HTTP port (8080 in our example) is open for incoming connections in the Windows Firewall (or Linux server firewall), as well as in the organization’s network firewall.

4. Demo section creation

  • Go to the “Sections” page.
  • Fill in the main section fields:
    • Section name: Demo
    • URL prefix: demo
    • Check the box next to “Active (perform data exchange)”
  • Exchange folder name: demo
  • Click “Save section”. The service will automatically create Import and Export subfolders within the section’s exchange folder.

5. Import test data

  • Take the sample files from the demo folder in the ordizi.service program directory (included in the archive). The service file update.txt containing an arbitrary string is located in the same folder.
  • Copy all of these files into the incoming files folder created by the server (Import).
  • The server will automatically pick up the newly copied data after the configured import interval. Upon successful loading into the database, the files will disappear from the exchange folder.

6. Connecting Mobile Client Ordizi-Agent

  • Download and install the “Ordizi-Agent” client application on your Android device.
  • Review the application documentation: Ordizi-Agent Quick Start
  • Configure the connection in the app and perform synchronization using the following details:
    • Link (connection endpoint):
    • http://<внешний_IP_или_IP_в_локальной_сети>:<порт>/demo_en
    • Username: Smith
    • Password 1234

Quick Checklist for Initial Setup

  1. Extract the software delivery archive into a permanent folder on the server.
  2. Run ordizi.manager.exe as administrator.
  3. Select “Set HTTP server port” and specify the service port.
  4. Select “Install and start service”.
  5. Verify that the service has Running status.
  6. Open the admin panel: https://<server_or_localhost>:<port>/admin.
  7. Log in using admin / admin.
  8. Change the administrator username and password.
  9. Specify the HTTP port and external service address.
  10. Fill in the database parameters.
  11. Create a new database or connect a restored database of the same server version.
  12. Configure the file exchange mode with the accounting system.
  13. For local mode, create the root exchange folder in advance and check service permissions.
  14. For FTP, verify the address, port, username, password, SSL, and user permissions.
  15. Click “Test Storage”.
  16. Click “Save Settings”.
  17. If required, click “Restart Application”.
  18. Open the “Sections” page.
  19. Create a section by entering the name, URL prefix, and exchange folder name.
  20. Verify the connection endpoint for “Ordizi Agent” and the Import/Export paths.
  21. Click “Save Section”.
  22. Ensure the section is saved and the Import and Export folders are prepared.
  23. Copy the connection endpoint and forward it to the “Ordizi Agent” mobile app user.
  24. Verify that the service port is open for mobile clients.

Ask a question