Облачная фискализация в МойСклад: как работает приложение Первый ККМ

Почему интернет-магазину нужна отдельная облачная фискализация

Оплата на сайте, учет заказа и формирование кассового чека — разные операции. Эквайринг подтверждает перевод денег, МойСклад хранит состав и состояние заказа, а онлайн-касса формирует фискальный документ и передает его по кассовому контуру. Если эти части не связаны, сотрудник переносит позиции вручную, выбирает признак расчета по памяти и отдельно ищет, был ли уже пробит чек.

Такая схема особенно уязвима при предоплате, частичном выполнении заказа, маркированных товарах и возвратах. Ошибка может появиться даже при правильной оплате: неверный НДС, повторный чек, забытый полный расчет после предоплаты или код маркировки не от того товара.

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

Что представляет собой приложение Первый ККМ для МойСклад

«Интеграция с облачной кассой Первый ККМ» — решение Magic Sklad в каталоге приложений МойСклад. В официальной карточке оно описано как интерфейс для формирования кассовых чеков на основании документов сервиса.

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

Как чек проходит от заказа до кассы

1. Заказ попадает в МойСклад. В документе уже есть состав, количество, цена, контрагент и организация.
2. Сотрудник сохраняет документ. Все действия виджета выполняются после сохранения заказа или отгрузки.
3. Приложение получает команду. Ее запускают кнопкой в виджете либо сменой статуса, если настроен вебхук.
4. Данные отправляются в Первый ККМ. Используются настройки кассового аккаунта, СНО, НДС и выбранного сценария расчета.
5. Касса формирует чек. Для электронного чека приложение берет адрес из поля «Электронный адрес» карточки контрагента.
6. Результат возвращается в МойСклад. Ссылка записывается в дополнительное поле, а документ может получить настроенный статус.

Ссылка на чек остается рядом с заказом. Менеджеру не нужно искать операцию в отдельном кабинете по сумме и времени: он может открыть документ и проверить результат фискализации в контексте продажи.

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

В одном аккаунте МойСклад можно настроить несколько кассовых аккаунтов приложения. Это подходит группе компаний, нескольким ИП и ООО, интернет-магазинам с разными направлениями продаж или бизнесу, где отдельные кассы используются для разных проектов. У каждого аккаунта сохраняются собственные токены Первый ККМ и Честного ЗНАКа, СНО, НДС, адрес для отправки чека по умолчанию, дополнительное поле для ссылки и правила статусов.

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

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

Ручное пробитие или фискализация по статусу

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

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

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

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

Маркировка в МойСклад и облачной кассе: как устроен процесс

Работа с маркировкой — один из главных сценариев приложения. В карточке товара или модификации МойСклад должен быть указан тип маркируемой продукции и GTIN. В настройках соответствующего кассового аккаунта нужен токен ККТ из Честного ЗНАКа. Без корректной карточки товара приложение не сможет надежно сопоставить отсканированный Data Matrix с позицией заказа.

1. Заказ окончательно комплектуют. Количество маркированных единиц в документе должно совпадать с фактическим количеством на упаковочном столе.
2. Открывают «Коды маркировки». Приложение строит строки по позициям документа. Для нескольких штучных единиц создаются отдельные строки, потому что у каждого экземпляра свой уникальный код.
3. Сканируют Data Matrix. Форма принимает управляющий символ GS от настроенного сканера; при ручной работе его можно вставить клавишей F8.
4. Проверяют GTIN. GTIN внутри считанного кода сравнивается с GTIN, указанным в карточке товара. Если код относится к другому товару или GTIN отсутствует в карточке, сотрудник получает предупреждение.
5. Сохраняют коды. Приложение отправляет их на проверку через настроенный контур Честного ЗНАКа и сохраняет подготовленные позиции для этого документа.
6. Формируют чек полного расчета. Сохраненные коды попадают в чек; после успешной фискализации продажа маркированного товара передается по кассовому контуру.

Почему GTIN в карточке товара критически важен

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

Что происходит при количестве больше одной штуки

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

Маркировка при автоматической фискализации по статусу

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

Что делать, если состав заказа изменился

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

Практические кейсы фискализации маркированных товаров

Продажа маркированного товара без предоплаты

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

Предоплата получена на сайте, первый чек выдал другой сервис

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

Оба чека формируются из МойСклад

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

Полный возврат маркированного товара

Возврат оформляйте только после фактического приема товара и проверки его кода. В полном возврате приложение использует сохраненные для документа позиции. Ответственный должен сверить, что возвращается именно тот экземпляр, который был продан, и проверить результат кассовой операции.

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

Оставьте в форме частичного возврата только фактически принятые позиции и укажите возвращаемое количество. Для маркированного товара недостаточно выбрать одно наименование: требуется проконтролировать конкретные экземпляры и их коды. Не копируйте в возврат все сохраненные марки большого заказа, если покупатель вернул только часть.

Ошибка сканирования или код от другого товара

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

Основные сценарии работы приложения

1. Ручная фискализация менеджером

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

2. Автоматическая предоплата по статусу

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

3. Автоматический полный расчет по статусу

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

4. Массовая фискализация партии заказов

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

5. Несколько юрлиц в одном аккаунте МойСклад

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

6. Отдельная касса для проекта или канала продаж

Если часть заказов должна идти через выделенный кассовый контур, аккаунт привязывается к проекту. Это позволяет разделять интернет-магазины, направления или специальные процессы внутри одной организации.

7. Полный возврат

Формируется возврат прихода. В настройке можно разделить возврат предоплаты и возврат полного расчета. Состав документа и фактически принятый товар должны совпадать.

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

Используется отдельная операция обычного возврата прихода: в форме оставляют только возвращаемые строки и изменяют количество. Частичный возврат не является чеком коррекции.

Чек коррекции: отдельный сценарий, а не возврат

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

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

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

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

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

Что подготовить перед подключением

• Зарегистрированная облачная касса Первый ККМ для каждого юридического лица.
• Токен каждого кассового аккаунта.
• Токен ККТ из Честного ЗНАКа для аккаунтов, работающих с маркировкой.
• Правильные организации и проекты в документах МойСклад.
• Заполненные тип маркировки и GTIN в карточках товаров и модификаций.
• Настроенный 2D-сканер Data Matrix.
• Проверенные СНО и ставки НДС для каждой кассы.
• Дополнительное поле типа «Ссылка» в Заказе покупателя или Отгрузке.
• Раздельные статусы предоплаты, полного расчета и возврата.
• Email покупателей в карточках контрагентов.
• Тестовые документы для каждого юрлица, типа чека и маркированного сценария.

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

Что важно учитывать в ежедневной работе

• Виджет используется только после сохранения документа.
• Изменения статуса и ссылки на чек могут стать видны после обновления страницы или повторного открытия документа.
• После изменения состава заказа сохраненные коды маркировки нужно сбросить и отсканировать заново.
• Настройки, токены, СНО, НДС и правила статусов каждого кассового аккаунта сохраняются отдельно.
• Перед массовой фискализацией маркированных заказов нужно проверить сохранение кодов в каждом документе.
• Частичный возврат и чек коррекции — разные операции с разными основаниями.
• Автоматизация по статусам требует очереди контроля ошибок, а не только успешного сценария.

Чем продуктовая статья отличается от инструкции

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

Вывод

Приложение Первый ККМ делает фискализацию частью процесса в МойСклад: чек создается из реального документа, нужная касса выбирается по организации или проекту, маркировка проверяется и передается в чек, а повторяемые операции запускаются по статусам. Главная ценность решения — связанная и контролируемая цепочка от предоплаты и сканирования Data Matrix до полного расчета, возврата, частичного возврата и коррекции.