Возможные ошибки при работе программы KKM-agent
9 мин
Продолжительность урока
KKM-Аgent - важная программа, которая соединяет фискальный принтер с компьютером и системой Гуляш. В данной статье мы рассмотрим частые ошибки, которые возникают при работе с КММ-Agent.
В основном, уведомления об ошибках отображается в центре уведомлений Win, либо текст ошибки будет показан при наведении курсора мыши на приложении ККМ-Agent.
В основном, уведомления об ошибках отображается в центре уведомлений Win, либо текст ошибки будет показан при наведении курсора мыши на приложении ККМ-Agent.
1. Проверка фискального накопителя.
Ошибка 3. Порт занят.
Ошибка 3. Порт занят.
Чтобы решить эту проблему, нужно проверить фискальный накопитель. Для этого необходимо закрыть КММ-Agent, открыть Драйвер ККТ и перейти в раздел Свойства, а затем Тест связи.
Если имеются связь с фискальным накопителем и подключение к ПК, то тест прошел успешно. Если выдает ошибку “-3 порт занят”, значит к фискальному накопителю в данный момент подключена другая программа. Для того чтобы решить эту проблему, необходимо открыть диспетчер задач и проверить какие программы могут перехватывать фискальный накопитель. Этими программами могут быть Айко, Фронт-пад или открытый ККМ-Agent. Далее нужно закрыть эти программы, а во вкладке Автозагрузка в диспетчере задач выключить Айко и Фронт-пад, если они включены.
Помимо этих программ, фискальный накопитель может перехватывать Атол-веб сервер, который запускается, когда в браузере включают плагин Фронт-пада. Следовательно, нужно отключить плагин Фронт-пада, а затем отключить службу Атол-веб сервера через диспетчер задач.
После всех этих действий необходимо снова провести тест связи в Драйвере ККТ. В большинстве случаев достаточно просто заново запустить ККМ-Agent, чтобы он подключился к фискальному накопителю.
Если ККМ-Agent по прежнему не подключается к фискальному накопителю, нужно проверить версию ККМ, для этого необходимо просто навести на программу курсор мыши, и установить последнюю доступную версию по ссылке: https://имясистемы.goulash.tech/dist/kkm/.
Если имеются связь с фискальным накопителем и подключение к ПК, то тест прошел успешно. Если выдает ошибку “-3 порт занят”, значит к фискальному накопителю в данный момент подключена другая программа. Для того чтобы решить эту проблему, необходимо открыть диспетчер задач и проверить какие программы могут перехватывать фискальный накопитель. Этими программами могут быть Айко, Фронт-пад или открытый ККМ-Agent. Далее нужно закрыть эти программы, а во вкладке Автозагрузка в диспетчере задач выключить Айко и Фронт-пад, если они включены.
Помимо этих программ, фискальный накопитель может перехватывать Атол-веб сервер, который запускается, когда в браузере включают плагин Фронт-пада. Следовательно, нужно отключить плагин Фронт-пада, а затем отключить службу Атол-веб сервера через диспетчер задач.
После всех этих действий необходимо снова провести тест связи в Драйвере ККТ. В большинстве случаев достаточно просто заново запустить ККМ-Agent, чтобы он подключился к фискальному накопителю.
Если ККМ-Agent по прежнему не подключается к фискальному накопителю, нужно проверить версию ККМ, для этого необходимо просто навести на программу курсор мыши, и установить последнюю доступную версию по ссылке: https://имясистемы.goulash.tech/dist/kkm/.
2. Проверка фискального накопителя.
Ошибка 4. Порт недоступен.
Ошибка 4. Порт недоступен.
Чтобы решить данную ошибку, нужно проверить фискальный накопитель. Для этого нужно закрыть ККМ-Agent и открыть драйвер ККТ, перейти в Свойства и выбрать Тест связи.
При тест обязательно должен быть выбрать канал связи USB. Если появляется Ошибка 4. Порт недоступен, значит ПК не видит фискальный накопитель. Также нужно проверить, чтобы были установлены последние драйвера, а также, что фискальный накопитель корректно подключен к ПК через USB. Чтобы решить проблему, можно попробовать подключить фискальный накопитель к другим USB-портам и провести тест связи снова. Также можно просто перезагрузить ПК и фискальный накопитель, потому что иногда бывает, что порты ПК зависают. Помимо этого, частой причиной возникновения этой ошибки является неисправный кабель для подключения, то есть с фискальным накопителем и ПК все в порядке, но шнур не позволяет подключиться из-за того, что сломан. Чтобы решить эту проблему нужно просто использовать другой кабель.
При тест обязательно должен быть выбрать канал связи USB. Если появляется Ошибка 4. Порт недоступен, значит ПК не видит фискальный накопитель. Также нужно проверить, чтобы были установлены последние драйвера, а также, что фискальный накопитель корректно подключен к ПК через USB. Чтобы решить проблему, можно попробовать подключить фискальный накопитель к другим USB-портам и провести тест связи снова. Также можно просто перезагрузить ПК и фискальный накопитель, потому что иногда бывает, что порты ПК зависают. Помимо этого, частой причиной возникновения этой ошибки является неисправный кабель для подключения, то есть с фискальным накопителем и ПК все в порядке, но шнур не позволяет подключиться из-за того, что сломан. Чтобы решить эту проблему нужно просто использовать другой кабель.
3. Проблема с печатью чеков.
Проблема заключается в том, что чеки печатаются с большой задержкой или вовсе печатаются через раз. Эта проблема возникает из-за того, что происходит подключение к очереди печати с двух устройств. Чтобы решить эту проблему, нужно сменить идентификатор ККМ в настройках подразделения в разделе Кассы. Затем необходимо поменять идентификатор в ККМ-Agent и перезапустить программу. После этого будет создана новая очередь печати чеков. К сожалению, чеки из старой очереди не будут загружены в новую, поэтому не распечатанные чеки нужно будет пробить повторно вручную.
4. Отсутствует подключение к очереди сообщений.
Чтобы решить эту проблему, необходимо удостовериться, что в ККМ и в подразделении указан одинаковый идентификатор. Если идентификатор один и тот же, нужно проверить возможность доступа в rabbit с используемого ПК по ссылке: http://rabbit-21.goulash.tech:15672/#/queues. Если доступ в rabbit имеется, далее следует проверить файл config. Данный файл можно найти в "%Appdata% - KKMAagent - KKMAgent.exe.config". В этом файле нужно найти строку "<connectionStrings><add name="MQ" connectionString="amqp:" В этой строке указан логин и пароль для доступа в rabbit. В пароле не должно быть спецсимволов, так как их нужно экранировать. Если они есть, следует обратится к SRE для подготовки нового файла config, либо экранировать самостоятельно, а затем заменить файл на ПК.
5. Не удалось получить фабрику класс.
Проблема заключается в том, что в ККМ-Agent в блоке Драйвер ККМ был выбран неправильный фискальный принтер. Для решения этой проблемы необходимо сменить фискальный накопитель на другой, который установлен на вашем подразделении. Также стоит уточнить, что чеки будут сохраняться в папку ККМ Print и будут весить 0 кб.
6. Ссылка на объект не указывает на экземпляр объекта.
В основном данная ошибка возникает из-за того, что на ПК недостаточно места. Для корректной работы требуется минимум 500 мб свободного места на диске.
7. Ошибка 65. Переполнение буфера ЭЖ.
Чтобы решить данную проблему, необходимо провести техобнуление на ККТ.
8. Ошибка 143. Некорректная СНО.
Данная ошибка возникает после техобнуления. Чтобы решить данную проблему, необходимо пройти следующий путь:
1. Отметить галочку Включено.
2. Зайти во вкладку Регистрация ККТ.
3. Нажать кнопку Считать.
4. В графе Причина перерегистрации выбрать Изменение настроек ККТ.
5. Нажать на Причины изменения сведений о ККТ (не ОФД).
6. Нажать ОК.
7. В разделе Системы налогообложения выставить галочку у того налога, на который вы переходите и убрать галочку с того налога, с которого вы уходите.
8. Если у вас двойная система налогообложения, то в графе По умолчанию необходимо установить основной налог - этот налог будет печататься на чеках у всех товаров и услуг, если к ним не привязан свой налог в базе товаров и услуг.
9. Нажать Перерегистрация.
1. Отметить галочку Включено.
2. Зайти во вкладку Регистрация ККТ.
3. Нажать кнопку Считать.
4. В графе Причина перерегистрации выбрать Изменение настроек ККТ.
5. Нажать на Причины изменения сведений о ККТ (не ОФД).
6. Нажать ОК.
7. В разделе Системы налогообложения выставить галочку у того налога, на который вы переходите и убрать галочку с того налога, с которого вы уходите.
8. Если у вас двойная система налогообложения, то в графе По умолчанию необходимо установить основной налог - этот налог будет печататься на чеках у всех товаров и услуг, если к ним не привязан свой налог в базе товаров и услуг.
9. Нажать Перерегистрация.
9. Ошибка 235.
Данная ошибка возникает тогда, когда документы не передаются в ОФД. Фискальный накопитель хранит дату первого из не переданных документов и ожидает 30 дней. Если документ не отправляется, фискальный накопитель перестает выдавать фискальный признак и касса выдает ошибку 235.
10. Обновление ККМ-Agent или изменение настроек ФН.
При обновлении ККМ-Agent или изменении настроек фискального накопителя, ККМ-Agent нужно обязательно повторно перезагрузить. При настройке с терминалом необходимо также повторно перезагрузить ККМ-Agent и ПК.
11. Ошибка 4. Порт недоступен.
Также данная проблема может возникать, если перехватывать фискальный накопитель нечему, так как никакие приложения не открыты. Чтобы решить данную проблему, необходимо зайти в Диспетчер устройств, далее в USB/COM-порты и там будет находиться два фискальных накопителя ATOL, которые подключены к разным COM-портам. Один будет указан с восклицательным знаком, его нужно будет удалить через ПКМ (Пк самостоятельно его настроить и их снова станет два, но уже без восклицательного знака). Затем через ПКМ необходимо обновить конфигурацию оборудования для устройств и провести текст связи повторно.
12. Подключение интегрированного терминала.
Для этого нужно найти папку SBRF/cs552/INPAS/Argus, а в настройках ККМ-Agent выбрана нужная платежная система. В настройках подразделения нужно отметить Интегрированный терминал в зале. После установки терминала необходимо перезагрузить ККМ-Agent и ПК.
13. Проблема при поступлении заказа в Гуляш и при печати чека.
Проблема заключается в том, что интегрированный терминал подключается, оплата проходит, но заказ не поступает в систему Гуляш и чек не печатается. Такая ошибка возникает, есть в папке KKMPrint скопилось большое количество нераспечатанных чеков из-за того, что фискальный накопитель неисправен или к нему нет подключения. Также возможно, что данные чеки сохранены из старой очереди печати, которые использовались при тестах. Если это тестовые чеки, то их можно просто удалить, проверить идентификатор в подразделении и ККМ и сменить идентификатор, который использовался при тестах. Если это не тестовые чеки, необходимо в первую очередь решить проблему с печатью чеков, и уже затем заказы через интегрированный терминал станут поступать в систему Гуляш.
14. Error opening file for writing.
Если при установке ККМ-Agent возникает подобная ошибка, достаточно будет просто перезагрузить ПК.
- ТурбоМы изучили все возможные ошибки и теперь знаем, как с ними справляться. Теперь мы готовы быстро их устранить.
Понравился материал?
Понравилось?
Переходим к следующей теме!
Goulash