Товарные коды в Shop-Script 8.9

В Shop-Script 8.9 появилось новое свойство товаров — товарный код.

Строго говоря, товарный код — это свойство не товара, а единицы артикула в заказе (позиции заказа) — той, которая хранится в таблице базы данных shop_order_items. Например, если покупатель заказал 10 штук одного артикула, то для каждой заказанной штуки в базе данных может храниться своё значение товарного кода. В этом примере для артикула в заказе может храниться до 10 значений товарного кода — столько, сколько сохранит пользователь — администратор магазина.

Создание товарных кодов

В магазине может быть один или несколько товарных кодов. Один из них может использоваться для маркировки товаров по системе «Честный ЗНАК», другой — для хранения серийных номеров, третий — для продажи лицензий программного обеспечения и т. д.

Пользователь должен настроить нужные ему товарные коды в разделе «Настройки → Типы и характеристики товаров». Для каждого товарного кода можно выбрать, для каких типов товаров он должен быть доступен. Или выбрать, чтобы товарный код был доступен для всех типов товаров.

Сохранение значений товарных кодов

Значения товарных кодов сохраняются отдельно на странице каждого заказа. Для этого под названиями заказанных артикулов нужно использовать ссылки с иконками в виде миниатюрных QR-кодов. Для этого же можно использовать и одну общую ссылку «Изменить товарные коды» в правой панели.

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

Где хранятся товарные коды

Свойства товарных кодов хранятся в таблицах базы данных:

• shop_product_code — настройки товарных кодов, кроме соответствия типам товаров;
• shop_type_codes — настройки товарных кодов: для каких типов товаров доступен каждый товарный код;
• shop_order_item_codes — значения товарных кодов для заказанных единиц артикулов (позиций заказов).

Как можно вводить значения товарных кодов для позиций заказа

Самый простой способ — вписывать значения товарных кодов вручную в поля веб-интерфейса на странице заказа.

Более быстрый способ — использовать в качестве устройства ввода сканер штрихкодов, который взаимодействует с компьютером в качестве своеобразной «клавиатуры» и автоматически вводит значения в текстовые поля.

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

События для плагинов

Редактирование значений товарных кодов на странице заказа — это действие с заказом с идентификатором editcode.

Для подключения плагинов к процессу сохранения значений товарных кодов используйте события:

• order_action_form.editcode — открытие диалога для ввода значений;
• order_action.editcode — сохранение значений.

Как получить значения товарных кодов для заказа

С использованием shopOrder

$order = new shopOrder($order_id);
$order_items_codes = $order['items_product_codes'];

С использованием shopOrderItemCodesModel

• метод extendOrderItems();
• метод getByItemId();
• методы базового класса waModel.

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

Используйте методы класса shopOrderItemCodesModel и методы базового класса waModel, например, multipleInsert().

Товарный код для системы маркировки товаров «Честный ЗНАК»

Значения маркировки «Честный ЗНАК» должны сохраняться в свойствах товарного кода с уникальным кодом chestnyznak.

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

Товарные коды для плагинов доставки и оплаты

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

Ознакомительная версия Shop-Script 8.9 на GitHub

Мы выгрузили ознакомительную версию Shop-Script 8.9 для разработчиков в dev-ветку репозитория на «ГитХабе». Проверьте, чтобы ваши плагины и темы дизайна правильно работали с новой версией.

На что нужно обратить особое внимание:

• полностью переработанный раздел «Настройки → Типы и характеристики товаров» с возможностью настройки товарных кодов, доступный по новому URL;
• возможность сохранять значения любых типов характеристик для артикулов товаров;
• страница заказа с функцией сохранения значений товарных кодов.