Первый запуск и проверка связи

Архив программы не требует установки: распакуйте его и запустите файл программы. Ниже — что происходит при первом запуске и как убедиться, что связь с сервером есть.

Куда распаковывать

В папку, где у пользователя есть права на запись, например C:\cnc_client. Рядом с программой создаются её рабочие файлы: настройки, база заказов и журналы. Папки вроде C:\Program Files не подходят — Windows запретит запись.

Откуда программа знает вашу фирму

Ключ фирмы (KEY) и адрес сервера (API_URL) уже вписаны в файл config_gui.txt рядом с программой: их подставляет сервер, когда вы скачиваете архив из админпанели. В окне программы этих полей нет — проверить их можно только в файле. Подробнее: Вкладка «Настройки».

Что вы увидите

В шапке окна — название вашей фирмы, под ним подпись «Клиент скачивания» и номер версии. Название приходит с сервера по ключу и запоминается, поэтому в следующий раз появляется сразу. Пока ответа нет — нейтральная подпись.
Слева столбиком — вкладки, справа — содержимое выбранной. Подробнее: Обзор окна.
Внизу — строка состояния: цветная точка, текущее состояние и часы.
По умолчанию программа сразу начинает опрашивать сервер и сворачивается в панель задач. Обе привычки отключаются галочками на вкладке «Настройки».

Проверка связи за три шага

На вкладке «Главная» нажмите «↻ Проверить». Если ключ в файле пустой, программа ответит сообщением «API ключ не установлен» и опрос не начнёт.
Посмотрите на верх «Главной». Пока всё хорошо, красной полосы там нет; если сервер не принял запрос, появится полоса с причиной и кнопка «Подробности в логе».
Откройте вкладку «Лог». Там по шагам видно: адрес, на который ушёл запрос, ответ сервера, сколько заказов к загрузке, скачивание и распаковка каждого.

Сколько ждать

Один новый заказ проходит весь путь — запрос, скачивание, распаковка, копирование на станки, конвертация — примерно за 10–40 секунд.
Первый круг обычно самый долгий: сервер отдаёт все заказы за последние дни (по умолчанию 60, задаётся в time.txt). На большой фирме это сотни заказов.
Дальше программа опрашивает сервер по расписанию: интервал задаётся параметром every_minutes в config_gui.txt, минимум — три минуты.

Если связи нет

Причина показывается в красной полосе на «Главной» и в логе:

«Сервер не знает этот API-ключ» — ключ неверный или отозван. Скачайте архив из админпанели заново или впишите свежий KEY в config_gui.txt и перезапустите программу.
«Сервер просит слать запросы на другой адрес» — нажмите «Взять этот адрес» в полосе: программа сама запишет новый API_URL и предложит повторить проверку.
«Адрес не найден», «Сервер не ответил вовремя», «Не удаётся подключиться» — проблема с сетью или адресом. Проверьте интернет и API_URL в файле.
«Сервер ответил кодом 500» — проблема на стороне сервера, не в программе. Повторите позже.
«API-ключ не указан» — параметр KEY в файле пустой, опрос не стартует.
Полный разбор — Частые ошибки и что делать.

Заказов нет, а ошибок тоже нет

Это нормальная ситуация, если по заказам ещё не сгенерированы файлы. Программа забирает только то, что сервер отдал как готовое; заказы в состоянии ожидания она показывает отдельным счётчиком «Генерация» и заберёт их на одном из следующих кругов.

Дальше — Правила маршрутов: без них файлы останутся лежать в папке заказов и до станков не доедут.

Если в планах ещё и обмен с учётной системой, следующий шаг после маршрутов — Подключение обработки BAS / 1С: адрес этого компьютера, порт и токен, который выдаётся здесь же, кнопкой «API для 1С» на вкладке «Товары».