интеграция сканера

Требования

Shop-Script премиум 11.2 или новее
Мобильное устройство с установленным приложеним Shop-Script:
- Версия приложения для iOS: 2.3 или новее
- Версия приложения для Android: 2.2 или новее (возможно будет другой номер, пока не знаю)
Для работы с маркировкой Честный знак - бесплатный плагин «Честный знак».
Заполненное значение характеристики GTIN в товарах (Миша, посмотри, пожалуйста, нужен ли этот пункт или выглядит неуместно?)
Опционально: Любой сканер товарных кодов совместимый с Android или iOS.
- Для работы с маркировкой «Честный знак» сканер должен поддерживать 2D-коды формата «Data Matrix» и «GS1 Data Matrix».
- Для работы с маркировкой GTIN/EAN, достаточно что бы сканер поддерживал только 1D-коды.
- Как правило, сканеры, с возможностью Bluetooth-подключения, работают и с iOS и с Android, но лучше это проверить заранее. Спецификации сканеров рекомендуем уточнять на сайте производителя. Для разработки и тестирования мы использовали сканер «Netum NT-C750».

Что такое GTIN и Честный знак и чем они отличаются

GTIN - это уникальный код товара в международной базе товаров GS1, этот код позволяет идентифицировать любой товар.
Кодом GTIN маркируются группы товаров, а не отдельные экземпляры.
Например у любой упаковки молока «Простоквашино 3,2%» - будет одинаковый код GTIN.

Существует несколько подклассов: GTIN8, GTIN12, GTIN13, GTIN14, где число означает количество символов в коде.

В Shop-Script, GTIN является системной характеристикой, которая по умолчанию включена для всех типов товаров.

Чтобы включить характеристику GTIN, передейдите в Shop-Script → Настройки → Типы и характеристики товаров.

Честный знак - это национальная система маркировки и отслеживания продукции,
в отличии от GTIN, Честным знаком помечается каждый экземпляр товара.
То есть у каждой упаковки молока «Простоквашино 3,2%», код Честного знака будет уникальным.

В мобильном Shop-Script, поиск по товарным кодам доступен и по GTIN и по «Честному знаку».
Технически поиск по «Честному знаку» происходит по значению характеристики GTIN товара или артикула.
То есть в Shop-Script необходимо добавить только значение характеристики GTIN для товара или артикула.

Маркировка «Честный знак» обязательно содержит в себе GTIN14.
В случае если GTIN товара состоит из 8, 12 или 13 символов, он дополняется нулями в начале.
Например если у товара GTIN13 «1234567891113», то в коде Честного знака он будет преобразован в GTIN14 и станет выглядеть так: «01234567891113».
Shop-Script поддерживает все варианты написания GTIN - и с ведущими нулями и без них.

Как добавить значения GTIN в Shop-Script

Есть 3 способа:

1. Через импорт-экспорт товаров Shop-Script:

Откройте Shop-Script и перейдите в раздел «Импорт-экспорт».
Экспортируйте товары в разделе «Экспорт товаров в CSV».
В полученный в результате экспорта .csv-файл добавьте колонку GTIN и внесите в неё значения GTIN товаров.
Импортируйте таблицу с заполненными полями GTIN товаров и артикулов в Shop-Script, на странице «Импорт товаров из CSV»

Подробная инструкция по Импорту-экспорту товаров Shop-Script здесь.

2. Через раздел товаров Shop-Script:

Перейдите в Shop-Script, в раздел «Товары → Каталог».
Включите представление «Таблица: товар и модификации».
Добавьте колонку с характеристикой GTIN для отображения в таблице.
Внесите значения характеристики для товаров и модификаций.

3. Через редактор товаров в Shop-Script:

Откройте редактор товара в Shop-Script.
Перейдите в раздел редактора «Цены и характеристики».
Добавьте значение характеристики для товара или артикулов.
Сохраните товар.

Готово! Товары подготовлены, теперь их можно добавлять в корзину мобильной кассы Shop-Script просто отсканировав товарный код.(не могу нормально сформулировать завершающую мысль, помоги, пожалуйста)

Как сканировать товарные коды в мобильном приложении

Мобильное приложение поддерживает 2 режима сканирования:

Камерой мобильного устройства.
С помощью сканера товарных кодов.
Сканер это отдельное устройство, которое подключается по Bluetooth.

В обоих режимах допустимо сканирование как маркировки Честный знак, так и простого GTIN/EAN:

В случае, если отсканируете Честный знак, он будет автоматически соотнесен с товаром и добавлен в заказ.
В случае если отсканируете GTIN/EAN - код Честного знака не будет автоматически добавлен в заказ

Сканирование камерой мобильного устройства

Откройте мобильное приложение Shop-Script.
Перейдите в раздел «Касса».
Нажмите кнопку «Сканировать».
Наведите объектив камеры на товарный код.

Когда товар будет отсканирован и добавлен в корзину - в шторке камеры отобразится зеленая галочка.

Добавление товара с помощью сканера товарных кодов

Переключите раскладку клавиатуры мобильного устройства на английский язык.
- Это нужно для корректной работы с Честным знаком.
  Большинство сканеров работают как виртуальные клавиатуры с посимвольным вводом, поэтому английский символ «F» в коде Честного знака, будет распознан сканером как кириллический символ «А», соответственно в заказе будет зафиксировано некорректное значение кода Честного знака.
Подключите сканер к мобильному устройству.
- Обычно, чтобы включить режим поиска Bluetooth устройств на скарнере - нужно отсканировать специальный штрих-код. Его можно найти либо в инструкции к сканеру, либо на сайте производителя.
Откройте мобильное приложение Shop-Script.
Перейдите в раздел «Касса».
Нажмите кнопку «Сканировать».
- При запуске режима сканирования, появляеся шторка камеры, ее можно закрыть, но это не обязательно.
Отсканируйте товарный код.

Как добавить товарный код в товар, который находится в корзине

Откройте мобильное приложение Shop-Script.
Перейдите в раздел «Касса».
- Если вы используете внешний сканер товарных кодов, нажмите кнопку «Сканировать».
- Если вы пользуетесь камерой мобильного устройства, дополнительных действий не требуется.
Добавьте товар в корзину любым способом.
Перейдите в корзину.
Нажмите на название товарного кода.
В открывшемся диалоге:
- Чтобы добавить товарный код камерой мобильного устройства, нажмите кнопку «Сканировать» в поле соответствуещего товарного кода.
- Чтобы добавить товарный код с помощью внешнего сканера, нажмите на поле соответствующего товарного кода.
Отсканируйте товарный код и нажмите «Сохранить».

Мобильное приложение Shop-Script позволяет быстро добавлять товары в заказ мобильной кассы с помощью встроенной камеры смартфона или планшета либо внешнего Bluetooth-сканера, подключённого к мобильному устройству.

Что для этого потребуется:

Премиум-лицензия Shop-Script версии не ниже 11.2.
Смартфон или планшет с мобильным приложением Shop-Script:
- iOS: не ниже версии 2.3,
- Android: не ниже версии 2.2.
Для работы с маркировкой «Честный знак» — установленный плагин «Честный знак».
Заполненные значения характеристики «GTIN» в свойствах товаров.
(Необязательно) Bluetooth-сканер товарных кодов, совместимый с Android либо iOS, совместимый с вашим мобильным устройством.
- Для работы с маркировкой «Честный знак» сканер должен поддерживать 2D-коды форматов «Data Matrix» и «GS1 Data Matrix».
- Для работы с маркировкой GTIN достаточно, чтобы сканер поддерживал только 1D-коды.
- Часто сканеры с возможностью Bluetooth-подключения работают и с iOS, и с Android, но лучше проверить это. Спецификации сканеров рекомендуем уточнять на сайте производителя.
По результатам собственного тестирования мы подтверждаем корректную работу сканера Netum NT-C750.

GTIN и «Честный знак»

GTIN (и его аналог EAN) — это уникальный код в международной базе товаров, который позволяет идентифицировать любую разновидность товаров. Кодами GTIN маркируются группы товаров, а не их отдельные экземпляры.

Например, у любой упаковки некоторого товара «Супермолоко 3,2%» будет одинаковый код GTIN.

«Честный знак» — это российская система маркировки и отслеживания продукции. В отличие от GTIN, с его помощью помечается каждый экземпляр товара.

У каждой упаковки товара «Супермолоко 3,2%» код «Честный знак» будет уникальным.

В мобильном приложении Shop-Script поиск товаров работает и при сканировании штрихкодов GTIN, и при сканировании QR-кодов «Честный знак». При этом, когда вы сканируете маркировку «Честный знак», поиск товаров происходит по значению характеристики «GTIN» (потому что код GTIN всегда содержится внутри кода «Честный знак»).

Чтобы можно было добавлять товары в корзину мобильной кассы сканированием маркировки GTIN или «Честный знак», нужно заполнить значения характеристики «GTIN» в свойствах товаров.

Как сканировать коды маркировки в мобильном приложении

Мобильное приложение поддерживает 2 равноценных способа сканирования:

встроенной камерой мобильного устройства;
внешним сканером товарных кодов, подключённым по Bluetooth.

В обоих случаях можно сканировать и «Честный знак», и GTIN:

При сканировании маркировки «Честный знак» она будет соотнесена с товаром (по содержащемуся в отсканированном коде значению характеристики «GTIN») и добавлен в заказ вместе с товаром.
При сканировании маркировки GTIN найденный по значению характеристики «GTIN» товар будет добавлен в заказ, но без маркировки «Честный знак».

Добавление товара в заказ с помощью встроенной камеры

В разделе «Касса» мобильного приложения Shop-Script нажмите на иконку сканера.
После запуска камеры наведите объектив на товарный код.

Добавление товара в заказ с помощью Bluetooth-сканера

Переключите раскладку клавиатуры мобильного устройства на английский язык. Большинство сканеров работают как виртуальные клавиатуры с посимвольным вводом, поэтому для их работы имеет значение, какой язык выбран в свойствах клавиатуры — в зависимости от него сканер передаст мобильному приложению корректное либо неверное значение кода маркировки.
Подключите сканер к мобильному устройству. Для активации в сканере режима поиска других Bluetooth-устройств часто бывает необходимо отсканировать им специальный штрихкод — из инструкции к сканеру или на сайте его производителя.
В разделе «Касса» мобильного приложения Shop-Script нажмите на иконку сканера.
Нажмите на кнопку сканирования. При включении режима сканирования появится «шторка» встроенной камеры — её можно закрыть, но это необязательно.
Отсканируйте код маркировки.

Как добавить код маркировки в товар, уже находящийся в корзине мобильной кассы

В свойствах товарной позиции нажмите на название кода маркировки (например, «Честный знак»).
В открывшемся окошке:
- при использовании встроенной камеры: нажмите на иконку с изображением штрихкода напротив названия кода маркировки;
- при использовании внешнего сканера: нажмите на текстовое поле слева от иконки с изображением штрихкода, чтобы в нём появился текстовый курсор.
Отсканируйте код маркировки и подтвердите результат сканирования с помощью кнопки сохранения.