Интеграция предназначена для формирования чеков из сервиса МойСклад на облачной кассе Первый ККМ. Поддерживаются все СНО, виды НДС, работа с Маркировкой.
Гибкий процесс пробития чеков, идеально подойдёт как для интернет-магазинов, так и для обычных розничных операций.
Есть проверки на корректность кода маркировки, обработка ошибок, минимизация ошибок со стороны кассира.
Поддерживается работа сканера, настроенного для работы с МойСклад.
Инструкция по настройке:
Перейдите в Решения -> Интеграция с облачной кассой Первый ККМ -> Перейти в Решение
Приложение «Интеграция с облачной кассой Первый ККМ» позволяет подключать несколько кассовых аппаратов в соответствии с тарифом. Аккаунты расположены сверху, их можно добавить по иконке «+».
За один раз можно работать с одним аккаунтом, сохранить его, а затем переходить к настройке следующего. Т.е. при такой картине после сохранения настроек одного аккаунта остальные не сохранятся
Аккаунт можно переименовать двойным нажатием на вкладку с названием
При первой установке приложения автоматически открывается форма для настройки аккаунта.
Первым делом требуется выбрать, в каком документе будет отображаться кассовый виджет. На данный момент доступны документы «Заказ покупателя» и «Отгрузка».
Токен ККМ – вы можете найти в личном кабинете облачной кассы https://lk.online.kkm1.ru. Войдите в аккаунт, перейдите в раздел Компании -> организации и скопируйте токен.
Токен из ЧЗ [необязательно] – вы можете найти в личном кабинете Честного знака. Он необходим, если вы работаете с маркированными товарами. Этот токен можно сгенерировать при регистрации личного кабинета на первой странице заполнения реквизитов, называется «Токен ККТ». Либо, если у вас уже есть аккаунт в Честном знаке, нажмите в правом верхнем углу на профиль, перейдите в настройки и сгенерируйте токен ККТ.
Выберите ОФД, на который зарегистрирован ваш кассовый аппарат. По умолчанию выбирается Первый ОФД, в будущем список будет расширяться.
Выберите дополнительное поле, в которое должна сохраниться ссылка на чек. Чтобы выбор был доступен, требуется создать дополнительное поле в документе «Заказ покупателя» или «Отгрузка», в зависимости от выбранного на первом шаге документа. Тип поля: «Ссылка».
Перейдите в раздел с документом и нажмите на шестерёнку в правом верхнем углу
Нажмите на «+ Поле», укажите произвольное название дополнительному полю и выберите тип «Ссылка», как на скриншоте.
Нажмите на кнопку «Сохранить» в верхней части экрана. После чего это поле будет доступно к выбору в настройках интеграции
Дополнительное поле доступно к выбору
СНО по умолчанию – необходимо выбрать вашу систему налогообложения.
Внимание! При заполнении настроек не происходит проверки на то, как зарегистрирована ваша касса. Убедитесь какая у вас система налогообложения перед заполнением.
Указывать в чеке НДС из настроек [необязательно] – в карточке товара в МойСклад можно указать НДС в разделе «Общие данные». Если галочка установлена, НДС к товарам будет подставляться из настроек интеграции (следующий пункт). Если галочка не установлена, НДС будет подставляться из карточки товара.
НДС [необязательно] – выберите НДС из списка, если хотите подставлять его в кассовый чек. Учитывается только при включенной галочке из предыдущего пункта.
Установка статусов [не обязательное] – можно установить, какой статус поставить заказу покупателя после операции.
Можно настроить отображение виджета в зависимости от условий внутри документа. На данный момент есть опции: «Всегда» — виджет отображается во всех документах (которые выбраны на шаге 1), «У организации» — виджет отображается в документах, где выбрана указанная организация, и «В проекте» — виджет отображается в документах, где выбран указанный проект.
В вкладке «Настройки вебхуков» можно настроить формирование определённых чеков при смене статуса, например следующие настройки будут работать таким образом:
- При смене статуса документа на «Новый», будет сформирован чек предоплаты
- При смене статуса документа на «Сбор заказа», будет сформирован чек полного расчёта с указанием в нём, что предоплата уже была совершена (Последнее определяет галочка «Закрывающий чек»)
- При смене статуса на «Возврат», будет сформирован чек возврата. При установленной галочке это будет возврат предоплаты, без галочки – возврат полного расчёта.
Действия определённые в вебхуках взаимодействуют с настройками, указанными выше, т.е. при статусе «Сбор заказа» распечатается чек «Полный расчёт», после чего в документ установится ссылка на чек в дополнительное поле, а также поменяется статус у документа в соответствии с настройками статуса после успешной оплаты
Также чеки по вебхукам будут пробиваться в первую очередь с учётом ранее отсканированных кодов маркировки при сборке заказа. Чеки можно формировать массово с помощью выбора документов и изменения у всех статуса
После заполнения настроек нажмите «Применить настройки», это сохранит настройки интеграции
Работа с виджетом:
Все действия с виджетом необходимо проводить после сохранения документа в МойСклад.
При отправке электронных чеков используется адрес электронной почты из карточки контрагента, поле «Электронный адрес».
После настройки интеграции в заказах покупателя появится вот такой виджет
- Первый чек – генерирует чек «Приход» с типом «Предоплата 100%».
- Второй чек – генерирует чек «Приход» с типом «Полный расчёт». Галочка «Предоплата уже совершена» установит в чеке признак, что чек уже оплачен ранее предоплатой.
- Коды маркировки – откроет форму работы с кодами маркировки, рассмотрим её ниже.
- Возврат чека – генерирует чек «Возврат прихода» с типом «Полный расчёт». Галочка «Возврат предоплаты» установит в чеке тип «Предоплата 100%»
- Чек коррекции – в разработке
Работа с формой маркировки:
После того как заказ окончательно сформирован, необходимо внести коды маркировки. Для этого нужно нажать на кнопку «Коды маркировки», после чего откроется форма
Здесь необходимо просканировать коды маркировки. Форма понимает символ <GS> как напрямую, так и при нажатии клавиши F8. Если GTIN в отсканированном коде маркировки отличается от GTIN, указанного в карточке товара, будет выведена ошибка.
После сканирования кодов маркировки необходимо нажать «Сохранить», после чего начнётся проверка кода маркировки в системе честный знак, и если всё корректно – информация о кодах сохранится и можно будет работать дальше.
Пример ошибки ЧЗ после проверки
Внимание! Если вы сохранили коды маркировки, но затем изменили заказ покупателя – то система будет помнить ранее отсканированные позиции! При изменении позиций после сканирования кодов маркировки, необходимо будет зайти в коды маркировки и нажать на кнопку «Сбросить сохранённые позиции», после чего отсканировать марки повторно!
Кейсы использования:
1. Оплата маркированного товара на сайте, чек предоплаты формируется банком.
Со стороны МойСклад необходимо сначала добавить коды маркировки, сохранить их, затем поставить галочку «Предоплата уже совершена» и нажать «Второй чек». Сформируется чек полного расчёта, данные о маркировке передадутся в ЧЗ.
2. Обычная продажа маркированного товара, без предоплаты на сайте. Идентично сканируем коды маркировки, сохраняем их, НЕ ставим галочку и формируем сразу «Второй чек»
3. Возврат товара с возвращением его в оборот. Нажимаем «Возврат чека», информация о кодах маркировки в этом документе уже сохранена, поэтому коды вернутся в оборот автоматически
4. Платёжные ссылки/оплаты на сайте: все чеки формируем вручную в МойСклад. Сначала нажимаем «Первый чек» (формируется чек предоплаты). Далее, когда клиент забирает товар или мы готовим отправку, сканируем коды маркировки, ставим галочку «Предоплата уже совершена» и нажимаем «Второй чек».
Внимание! Из-за специфики работы API МойСклад, чтобы увидеть изменения в документе (ссылку на чек, статус), требуется обновить страницу или закрыть и открыть документ заново после формирования чека.