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

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

По умолчанию используется браузерный мост. Это страница, которую нужно открыть на кассовом компьютере. Она выполняет команды через браузерный плагин KKMServer или через локальный KKMServer на этом же компьютере. Поэтому не нужно публиковать кассу во внешнюю сеть.

Схема работы: МойСклад, сервис kassa.vitrinapro.ru, браузерный мост, KKMServer и онлайн-касса

Что потребуется

  1. Аккаунт МойСклад с правами администратора.
  2. Онлайн-касса, зарегистрированная в ФНС и подключенная к ОФД.
  3. Фискальный накопитель в рабочем состоянии.
  4. Установленный и запущенный KKMServer на кассовом компьютере.
  5. Браузер на кассовом компьютере с установленным расширением KKMServer.

Важно: кассовый компьютер должен быть включен, KKMServer должен работать, а страница браузерного моста должна оставаться открытой во время продаж.

Шаг 1. Проверьте кассу в KKMServer

Откройте KKMServer на кассовом компьютере. В списке устройств должна быть видна ваша онлайн-касса. Нажмите печать тестового чека. Если тестовый чек не выходит, сначала исправьте подключение кассы, драйвер, бумагу, смену, ФН или связь с ОФД.

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

Шаг 2. Откройте браузерный мост

На кассовом компьютере откройте страницу: 

http://kassa.vitrinapro.ru/browser-bridge.php

Нажмите Включить мост. Если для вашего подключения выдан короткий код подключения, введите его перед запуском. Если подключение одно, поле можно оставить пустым: МойСклад сам передает идентификатор фискального сервиса на сайт при каждой операции.

Настройки браузерного моста KKMServer

Если расширение KKMServer найдено, мост будет выполнять команды через него. Если расширение не найдено, мост попробует отправлять команды на локальный адрес KKMServer, обычно http://127.0.0.1:5893.

Шаг 3. Установите решение в МоемСкладе

Откройте каталог решений МоегоСклада, найдите Касса МойСклад + KKMServer и нажмите установку. После установки решение появится в аккаунте, а МойСклад сможет отправлять операции на фискализацию.

Если при установке отображается статус ожидания настройки, дождитесь завершения подключения вашего аккаунта и кассы.

Шаг 4. Выберите фискальный сервис в точке продаж

В МоемСкладе откройте настройки точки продаж или кассы. В списке фискальных сервисов выберите Касса МойСклад + KKMServer. Сохраните настройки.

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

Шаг 5. Проведите тестовую продажу

Оставьте страницу браузерного моста открытой. Создайте продажу на небольшую сумму, например 1 рубль. После проведения операции онлайн-касса должна напечатать фискальный чек, а в МойСклад должны вернуться фискальные реквизиты.

Успешное пробитие чека

Успешный результат обычно содержит:

Как понять, что сервис доступен

Проверочная страница сервиса: 

http://kassa.vitrinapro.ru/fiscal.php/health

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

Расширенная настройка: прямой доступ к KKMServer

Обычно прямой доступ не нужен. Его используют только если KKMServer клиента доступен серверу kassa.vitrinapro.ru по белому IP, VPN или защищенному туннелю. В этом случае администратор может включить режим server_http и указать внешний адрес KKMServer.

Для большинства клиентов оставляйте режим по умолчанию: браузерный мост на кассовом компьютере.

Если чек не пробился

Тестовый чек из KKMServer не печатается

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

Тестовый чек печатается, а из МоегоСклада нет

Проверьте, открыта ли страница browser-bridge.php на кассовом компьютере, включен ли мост и правильно ли введен код подключения, если он выдан.

На странице моста написано, что плагин не найден

Установите расширение KKMServer для браузера или проверьте локальный адрес KKMServer http://127.0.0.1:5893. Если локальный HTTP-запрос запрещен браузером, используйте расширение KKMServer.

МойСклад сообщает ошибку доступа

Решение могло быть установлено не в тот аккаунт, или настройка еще не завершена. Проверьте аккаунт МоегоСклада и обратитесь в поддержку с названием аккаунта.

Что сообщить в поддержку

Чтобы быстро найти причину, отправьте: