The program archive does not require installation: it is enough to unpack it and run the program file. Below is what happens at the first start and how to make sure there is a connection to the server.
Where to unpack it
Into a folder where the user has write rights, for example C:\cnc_client. Its working files are created next to the program: the settings, the order database and the logs. Folders like C:\Program Files are not suitable — Windows will forbid writing.
What you will see
- In the window header — the logo and the name of your firm, with the program version next to it. The logo comes from the server by the firm key; if the firm has no logo, a neutral caption remains.
- On the left in a column — the tabs, on the right — the contents of the selected one. More detail: Window overview.
- At the bottom — the status bar: the current state, the time of the next check and the clock.
- By default the program immediately starts polling the server and minimises to the taskbar. Both habits are switched off by checkboxes on the «Settings» tab.
Checking the connection in three steps
- Open the «Settings» tab and make sure that the «API key» and the «API address» are filled in. The address must end with
/api/program. - Go back to «Home» and press «Check now».
- Open the «Log» tab. It shows step by step: the connection to the server, the server response, how many orders are to be downloaded, the downloading and unpacking of each one.
How long to wait
- One new order goes the whole way — request, download, unpacking, copying to the machines, conversion — in about 10–40 seconds.
- The first round is usually the longest: the server hands over all the orders of the last days (60 by default, set in
time.txt). At a large firm that is hundreds of orders. - After that the program polls the server on a schedule: the interval is set in the settings, three minutes at the minimum.
If there is no connection
- Error 401 or 403 — the key is wrong or revoked. Download the archive from the admin panel again or enter a fresh key.
- Error 404 — the address is wrong. Check that it ends with
/api/program. - Error 500 — a problem on the server side, not in the program. Repeat later.
- «Key not specified» — the field is empty. The program will not let the polling start and will open «Settings» itself.
- The full breakdown — Common errors and what to do.
There are no orders, but there are no errors either
This is a normal situation if the files for the orders have not been generated yet. The program takes only what the server handed over as ready; orders in the waiting state are shown by a separate «Awaiting generation» counter and it will take them on one of the next rounds.
Next — Route rules: without them the files will stay in the orders folder and will not reach the machines.
If an exchange with an accounting system is also planned, the next step after the routes is Connecting the BAS / 1C add-in: the address of this computer, the port and the token, which is issued right here, on the «Products» tab.