Выгрузка заказов в ККМ-Агент

8 мин
Продолжительность урока
В этой статье мы подробно обсудим процесс выгрузки заказов в ККМ Агент

Для начала нам необходимо установить и настроить ККМ Агент для обычной работы.
Проверка IP адреса
Первым делом необходимо проверить соответствие IP адреса в настройках подразделения с IP адресом устройства, где стоит ККМ Агент

Для этого, в разделе Справочники, выбираем Подразделения.
В сводной таблице выбираем необходимое подразделение и кликаем на Редактировать (карандаш справа).
Проверяем, есть ли в графе "Подсеть" IP адрес компьютера, на котором установлен ККМ Агент.
Проверить IP Адрес компьютера можно на сайте https://2ip.ru/
Если IP адреса нет в настройках подразделения, то необходимо внести его в графу Подсеть. IP адресов может быть уже указано несколько, при внесении нового, необходимо его внести с новой строки
После внесения изменений необходимо сохранить их, нажав снизу страницы на Сохранить
Как посмотреть заказы в ККМ Агенте?
Чтобы посмотреть заказы, необходимо кликнуть на значок ККМ Агент правой кнопкой мыши и выбрать "Заказы"
В открывшейся таблице будут отображены все заказы в статусе Принят данного подразделения.
В таблице отображается номер заказа, тип заказа, адрес доставки заказа, время приготовления, время доставки, тип оплаты и сумму заказа.
Кликнув на заказ справа отобразится список блюд в заказе
Заказы можно распечатать, нажав на "Печать" в столбике "Бланк А4"
  • Турбо
    Если у вас стоит версия ККМ Агента от 3 марта 2025 года, то никаких действий далее по инструкции делать дополнительно делать не нужно, только проверить соответствие IP адреса в Подсети подразделения с IP адресом устройства, где стоит ККМ Агент
Если версия ККМ Агента была установлена ранее, чем 3 марта 2025 года, то необходимо выгрузить заказы вручную, о вариантах выгрузки рассказываем далее в статье
Первый вариант выгрузки
Этот вариант является приоритетным.

Для того, чтобы настроить выгрузку заказов в ККМ Агент, необходимо внести изменения в KKMAgent.exe.config. Для этого заходим в папку ККМ агента, которая находится на компьютере.

Путь хранения папки:
Мой компьютер -> Диск C -> Пользователи -> Папка с именем компьютера-> AppData -> Roaming - > KKMAgent -> Ищем интересующий нас файл KKMAgent.exe.config

Если папки AppData нет, то в настройках папки во вкладке "вид" поставить галочку "скрытые элементы" и она появится
Открываем файл через приложение "Блокнот" - кликаем на правую кнопку мыши по этому файлу и выбираем Открыть с помощью -> Блокнот. Это даст нам возможность редактировать настройки.

Находим параметр <add key="OrderListUrl" value=""/>. В открывшемся файле нужно прокрутить вниз или мы можем использовать комбинацию клавиш Ctrl + F, чтобы открыть поиск. Вводим OrderListUrl и нажимаем Enter, чтобы найти нужную строку.

Затем нам необходимо найти ту часть URL, которая начинается с key=. Например, она может выглядеть так: key=HjkasdashUnqg13;amp;kkm={0}"/>.
Удаляем все, что идет после знака “равно” до "/> и заменяем на 1234567

Итоговый вариант должен выглядеть так: <add key="OrderListUrl" value="https://company.goulash.tech/api/department/orders?_key=1234567”/>, где вместо company - название вашей системы
После внесения всех изменений нажимаем Файл → Сохранить или используем комбинацию клавиш Ctrl + S, чтобы сохранить файл.
Важно! Если в файле ККМ отсутствует строка key, это может означать, что версия программного обеспечения устарела, необходимо обновить версию KKM Агента

Можно обратиться в техподдержку Goulash.tech с запросом обновить программное обеспечение ККМ. Или можно попытаться добавить строку key в конфигурационный файл самостоятельно.
После сохранения файла ждем около 15 минут и проверяем заказы в ККМ Агенте
Если таблица заказов так и не появилась, нужно подождать еще немного.
Если заказы не появились через полчаса, нужно проверить работу ссылки по второму способу (см. ниже).
Если заказы есть по ссылке, но не отображаются в ККМ, это может говорить о проблемах на предыдущих этапах.
В таблице представлены все заказы, которые были приняты на данный момент для выбранного подразделения (того, IP которого мы указали в подсети).

Обновление таблицы происходит раз в 15-20 минут.

Важно! Если ip прописан в нескольких подразделениях - информация будет отображаться по последнему подразделению, куда указали ip.

Второй вариант выгрузки
Работает только в том случае, когда система Goulash доступна.

Необходимо сделать следующее действие:

Вставить в адресную строку любого браузер ссылку https://company.goulash.tech/api/department/orders?_key=1234567, где вместо company - название вашей системы, вставляем в любой браузер.

Если заказов много, таблица будет грузиться некоторое время.

Сначала данные загрузятся полностью сплошным текстом. Если нажмем Автоформатировать, они станут более понятными и удобными для восприятия.
Важно!
При включенном VPN или изменении IP, функция перестанет работать, пока устройство не подключится к сети с IP, указанным в разделе Подсеть.

Заказы загрузятся только те, которые были в системе на момент перехода по ссылке. Новые заказы не появятся, нужно заново запустить "загрузку", т.е. обновить страницу. Рекомендуем делать не чаще 1 раза в 15 минут, чтобы не копилась очередь на загрузку

Так же может быть задержка минут 15 с выгрузкой заказов.
Например, заказ пришел в 15-00, ссылку открыли в 15-10, но заказа нет, он появится когда пройдёт команда
Понравился материал?
Goulash