Касса МойСклад + KKMServer

Сервис принимает операции МоегоСклада, передает их на кассовый ПК через браузерный мост KKMServer и возвращает фискальные реквизиты обратно в продажу.

Схема: МойСклад отправляет чек в сервис, браузерный мост на кассовом ПК выполняет команду через KKMServer

Возможности программы

Решение закрывает основные кассовые операции точки продаж и работает с уже установленной онлайн-кассой клиента.

Продажи

После проведения продажи в МоемСкладе сервис формирует команду KKMServer и пробивает фискальный чек.

Возвраты

Возврат продажи передается в ККТ как фискальная операция возврата с нужными позициями и суммами.

Смены

Поддерживается открытие и закрытие смены, а также внесение и изъятие наличных.

Реквизиты

МойСклад получает номер ФН, регистрационный номер ККТ, ФД, ФП и время фискализации.

Несколько клиентов

Для каждого аккаунта МоегоСклада можно указать свой режим связи, KKMServer, кассу, СНО и кассира.

Проверка перед запуском

Есть health-проверка сервиса и тестовый режим Fiscal API без обращения к реальной кассе.

Что нужно перед настройкой

Проверьте базовые условия. Если один пункт не выполнен, МойСклад не сможет стабильно отправлять чеки на кассу.

1

Аккаунт МойСклад

Нужен доступ администратора, чтобы установить решение и выбрать фискальный сервис.

2

KKMServer

Сервис должен быть установлен на кассовом ПК и успешно печатать тестовый чек.

3

Онлайн-касса

ККТ должна быть зарегистрирована, подключена к ФН и ОФД, бумага и смена должны быть в норме.

4

Браузерный мост

На кассовом ПК нужно открыть browser-bridge.php и оставить страницу включенной.

5

Настройка клиента

Для каждой организации указываются свой адрес KKMServer, касса, СНО и кассир.

Пошаговая настройка

Идём от проверки кассы к тестовой продаже в МоемСкладе.

1

Проверьте KKMServer

На кассовом ПК напечатайте тестовый чек прямо из KKMServer.

2

Откройте мост

На кассовом ПК откройте страницу браузерного моста и введите Fiscal Account ID.

3

Установите решение

В МоемСкладе установите решение и выберите его как фискальный сервис точки продаж.

4

Проведите продажу

Сделайте тестовую продажу на небольшую сумму и проверьте печать фискального чека.

Что именно настраивается

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

1. Режим связиПо умолчанию используется браузерный мост. Прямой HTTP к KKMServer включается только если касса доступна серверу по сети.
2. КассаУказываются номер устройства, ИНН или номер ККТ, если к KKMServer подключено несколько касс.
3. ЧекНастраиваются СНО, НДС по умолчанию, отдел, признак предмета расчета и признак способа расчета.
4. КассирМожно передавать кассира из МоегоСклада или задать имя и ИНН кассира в настройках клиента.
Схема подключения сервиса и KKMServer клиента Пример карточки решения в каталоге МойСклад

Как сервис пробивает чек

Клиенту не нужно запускать отдельную форму вручную. После настройки операция идет по цепочке автоматически.

1

МойСклад

Кассир проводит продажу, возврат или сменную операцию в точке продаж.

2

kassa.vitrinapro.ru

Сервис принимает запрос МоегоСклада и ставит команду в очередь нужного клиента.

3

Браузерный мост

Открытая на кассовом ПК страница забирает команду и выполняет ее через KKMServer.

Если что-то пошло не так

Большинство проблем видно сразу по HTTP-ответу Fiscal API или ошибке KKMServer.

!
Чек не фискализируетсяПроверьте, запущен ли KKMServer и печатает ли он тестовый чек.
?
Нет связи с кассойПроверьте, что на кассовом ПК открыта страница браузерного моста и введен правильный Fiscal Account ID.
Тест KKMServer проходитПередайте поддержку время операции, сумму и статус страницы браузерного моста.

Что отправить в поддержку

Эти данные помогают быстро понять, где остановилась фискализация.

Название аккаунта МойСклад, Fiscal Account ID, время операции, сумма чека, статус browser-bridge.php, номер устройства, скриншот ошибки и результат тестового чека из KKMServer.