Интеграция предназначена для формирования чеков из сервиса МойСклад на облачной кассе Первый ККМ. Поддерживаются все СНО, виды НДС, работа с Маркировкой.

Гибкий процесс пробития чеков, идеально подойдёт как для интернет-магазинов, так и для обычных розничных операций.

Есть проверки на корректность кода маркировки, обработка ошибок, минимизация ошибок со стороны кассира.

Поддерживается работа сканера, настроенного для работы с МойСклад.

Инструкция по настройке:

Перейдите в Решения -> Интеграция с облачной кассой Первый ККМ -> Перейти в Решение

Приложение «Интеграция с облачной кассой Первый ККМ» позволяет подключать несколько кассовых аппаратов в соответствии с тарифом. Аккаунты расположены сверху, их можно добавить по иконке «+».

За один раз можно работать с одним аккаунтом, сохранить его, а затем переходить к настройке следующего. Т.е. при такой картине после сохранения настроек одного аккаунта остальные не сохранятся

Аккаунт можно переименовать двойным нажатием на вкладку с названием

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

Первым делом требуется выбрать, в каком документе будет отображаться кассовый виджет. На данный момент доступны документы «Заказ покупателя» и «Отгрузка».

Токен ККМ – вы можете найти в личном кабинете облачной кассы https://lk.online.kkm1.ru. Войдите в аккаунт, перейдите в раздел Компании -> организации и скопируйте токен.

Токен из ЧЗ [необязательно] – вы можете найти в личном кабинете Честного знака. Он необходим, если вы работаете с маркированными товарами. Этот токен можно сгенерировать при регистрации личного кабинета на первой странице заполнения реквизитов, называется «Токен ККТ». Либо, если у вас уже есть аккаунт в Честном знаке, нажмите в правом верхнем углу на профиль, перейдите в настройки и сгенерируйте токен ККТ.

Выберите ОФД, на который зарегистрирован ваш кассовый аппарат. По умолчанию выбирается Первый ОФД, в будущем список будет расширяться.

Выберите дополнительное поле, в которое должна сохраниться ссылка на чек. Чтобы выбор был доступен, требуется создать дополнительное поле в документе «Заказ покупателя» или «Отгрузка», в зависимости от выбранного на первом шаге документа. Тип поля: «Ссылка».

Перейдите в раздел с документом и нажмите на шестерёнку в правом верхнем углу

Нажмите на «+ Поле», укажите произвольное название дополнительному полю и выберите тип «Ссылка», как на скриншоте.

Нажмите на кнопку «Сохранить» в верхней части экрана. После чего это поле будет доступно к выбору в настройках интеграции

Дополнительное поле доступно к выбору

СНО по умолчанию – необходимо выбрать вашу систему налогообложения.

Внимание! При заполнении настроек не происходит проверки на то, как зарегистрирована ваша касса. Убедитесь какая у вас система налогообложения перед заполнением.

Указывать в чеке НДС из настроек [необязательно] – в карточке товара в МойСклад можно указать НДС в разделе «Общие данные». Если галочка установлена, НДС к товарам будет подставляться из настроек интеграции (следующий пункт). Если галочка не установлена, НДС будет подставляться из карточки товара.

НДС [необязательно] – выберите НДС из списка, если хотите подставлять его в кассовый чек. Учитывается только при включенной галочке из предыдущего пункта.

Установка статусов [не обязательное] – можно установить, какой статус поставить заказу покупателя после операции.

Можно настроить отображение виджета в зависимости от условий внутри документа. На данный момент есть опции: «Всегда» — виджет отображается во всех документах (которые выбраны на шаге 1), «У организации» — виджет отображается в документах, где выбрана указанная организация, и «В проекте» — виджет отображается в документах, где выбран указанный проект.

В вкладке «Настройки вебхуков» можно настроить формирование определённых чеков при смене статуса, например следующие настройки будут работать таким образом:

При смене статуса документа на «Новый», будет сформирован чек предоплаты
При смене статуса документа на «Сбор заказа», будет сформирован чек полного расчёта с указанием в нём, что предоплата уже была совершена (Последнее определяет галочка «Закрывающий чек»)
При смене статуса на «Возврат», будет сформирован чек возврата. При установленной галочке это будет возврат предоплаты, без галочки – возврат полного расчёта.

Действия определённые в вебхуках взаимодействуют с настройками, указанными выше, т.е. при статусе «Сбор заказа» распечатается чек «Полный расчёт», после чего в документ установится ссылка на чек в дополнительное поле, а также поменяется статус у документа в соответствии с настройками статуса после успешной оплаты

Также чеки по вебхукам будут пробиваться в первую очередь с учётом ранее отсканированных кодов маркировки при сборке заказа. Чеки можно формировать массово с помощью выбора документов и изменения у всех статуса

После заполнения настроек нажмите «Применить настройки», это сохранит настройки интеграции

Все действия с виджетом необходимо проводить после сохранения документа в МойСклад.

При отправке электронных чеков используется адрес электронной почты из карточки контрагента, поле «Электронный адрес».

После настройки интеграции в заказах покупателя появится вот такой виджет

Первый чек – генерирует чек «Приход» с типом «Предоплата 100%».
Второй чек – генерирует чек «Приход» с типом «Полный расчёт». Галочка «Предоплата уже совершена» установит в чеке признак, что чек уже оплачен ранее предоплатой.
Коды маркировки – откроет форму работы с кодами маркировки, рассмотрим её ниже.
Возврат чека – генерирует чек «Возврат прихода» с типом «Полный расчёт». Галочка «Возврат предоплаты» установит в чеке тип «Предоплата 100%»
Чек коррекции – открывает отдельную форму коррекции с выбором кассового аккаунта, типа чека, основания, СНО, документа-основания и товарных строк.
Частичный возврат – формирует обычный чек «Возврат прихода» только по выбранным позициям и фактически возвращаемому количеству.

Работа с формой маркировки:

После того как заказ окончательно сформирован, необходимо внести коды маркировки. Для этого нужно нажать на кнопку «Коды маркировки», после чего откроется форма

Здесь необходимо просканировать коды маркировки. Форма понимает символ <GS> как напрямую, так и при нажатии клавиши F8. Если GTIN в отсканированном коде маркировки отличается от GTIN, указанного в карточке товара, будет выведена ошибка.

После сканирования кодов маркировки необходимо нажать «Сохранить», после чего начнётся проверка кода маркировки в системе честный знак, и если всё корректно – информация о кодах сохранится и можно будет работать дальше.

Пример ошибки ЧЗ после проверки

Внимание! Если вы сохранили коды маркировки, но затем изменили заказ покупателя – то система будет помнить ранее отсканированные позиции! При изменении позиций после сканирования кодов маркировки, необходимо будет зайти в коды маркировки и нажать на кнопку «Сбросить сохранённые позиции», после чего отсканировать марки повторно!

Обязательный регламент работы с маркировкой

Маркировку необходимо заполнять после окончательной сборки заказа и до формирования чека полного расчёта. Для каждого штучного маркированного экземпляра нужен собственный код Data Matrix. Если в заказе три одинаковые единицы товара, форма создаст три строки для трёх уникальных кодов.

Карточка товара: у товара или модификации должны быть корректно указаны тип маркировки и GTIN.
Кассовый аккаунт: в его настройках должен быть указан токен ККТ из Честного ЗНАКа.
Сканирование: код считывается настроенным 2D-сканером; символ GS форма принимает от сканера или по клавише F8.
Сверка: GTIN внутри считанного кода сравнивается с GTIN карточки товара. Предупреждение нельзя игнорировать.
Сохранение: после проверки коды сохраняются для конкретного документа и используются при полном расчёте.
Автоматизация: чек по статусу использует уже сохранённые коды, но не сканирует их автоматически.
Изменение заказа: после замены товара или количества нужно сбросить сохранённые позиции и отсканировать актуальные экземпляры заново.

Перед массовой сменой статуса: проверьте, что каждый маркированный заказ окончательно собран, все GTIN заполнены, а коды каждого экземпляра сохранены. После запуска контролируйте появление ссылки на чек по каждому документу.

Несколько касс и юридических лиц

В приложении можно добавить несколько кассовых аккаунтов и настроить каждый отдельно. Для кассы сохраняются собственные токены, СНО, НДС, поле для ссылки на чек, статусы и настройки маркировки. Область действия аккаунта задаётся одним из правил: «Всегда», «У организации» или «В проекте».

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

Фискализация по статусам

Для каждого кассового аккаунта можно отдельно назначить статусы, которые запускают чек предоплаты, полного расчёта и возврата. Для полного расчёта указывается, была ли предоплата, а для возврата — возвращается предоплата или полный расчёт. После успешной операции приложение может записать ссылку на чек и установить следующий статус документа.

Статус запускает операцию, но сам по себе не подтверждает успешную фискализацию. Контрольный признак — сформированная ссылка на чек и корректные реквизиты документа. Для маркированных товаров к моменту смены статуса полного расчёта коды должны быть заранее отсканированы и сохранены.

Чек коррекции

Нажмите «Чек коррекции», чтобы открыть отдельную форму. Выберите кассовый аккаунт нужного юридического лица, тип чека — приход, возврат прихода, расход или возврат расхода — и основание коррекции: самостоятельная либо по предписанию ФНС. Затем проверьте СНО, способ расчёта, номер и дату документа-основания, товарные строки, количество, цены, скидки и НДС.

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

Частичный возврат

Нажмите «Частичный возврат». В открывшейся форме оставьте только фактически возвращаемые строки и укажите количество, которое принял сотрудник. Приложение сформирует обычный чек «Возврат прихода» на выбранную часть заказа.

Для маркированного товара дополнительно сверьте конкретные возвращаемые экземпляры и их коды. Нельзя отправлять в частичный возврат весь исходный состав или все сохранённые марки, если покупатель вернул только часть заказа. Частичный возврат и чек коррекции — разные операции.

Кейсы использования:

1. Оплата маркированного товара на сайте, чек предоплаты формируется банком.

Со стороны МойСклад необходимо сначала добавить коды маркировки, сохранить их, затем поставить галочку «Предоплата уже совершена» и нажать «Второй чек». Сформируется чек полного расчёта, данные о маркировке передадутся в ЧЗ.

2. Обычная продажа маркированного товара, без предоплаты на сайте. Идентично сканируем коды маркировки, сохраняем их, НЕ ставим галочку и формируем сразу «Второй чек»

3. Возврат товара с возвращением его в оборот. Нажимаем «Возврат чека», информация о кодах маркировки в этом документе уже сохранена, поэтому коды вернутся в оборот автоматически

4. Платёжные ссылки/оплаты на сайте: все чеки формируем вручную в МойСклад. Сначала нажимаем «Первый чек» (формируется чек предоплаты). Далее, когда клиент забирает товар или мы готовим отправку, сканируем коды маркировки, ставим галочку «Предоплата уже совершена» и нажимаем «Второй чек».

5. Несколько юридических лиц: добавляем отдельный кассовый аккаунт для каждого ООО или ИП и задаём отображение по организации. Документ автоматически обрабатывается подходящей кассой.

6. Отдельная касса проекта: создаём аккаунт с правилом отображения по проекту, чтобы выделенный канал продаж использовал собственный кассовый контур.

7. Массовая фискализация: заранее сохраняем маркировку во всех заказах, выделяем готовые документы и меняем статус. Затем проверяем ссылку на чек по каждому заказу.

8. Частичный возврат: оставляем в форме только принятые от покупателя позиции и корректируем возвращаемое количество.

9. Исправление кассовой операции: используем «Чек коррекции», выбираем правильный тип и основание, проверяем документ-основание и строки. Для обычного возврата эту операцию не используем.

Внимание! Из-за специфики работы API МойСклад, чтобы увидеть изменения в документе (ссылку на чек в дополнительном поле, новый статус, который вы указали в настройках после успешного формирования чека), требуется обновить страницу или закрыть и открыть документ заново после формирования чека.

Интеграция с кассой Первый ККМ