Стандартный импорт 4

Конвертер импорта данных, работающий при помощи собственной базы данных MySQL, позволяет загружать информацию о покупателях, скидках, товарах, кассирах, налогах и т.д. на сервер УКМ 4 из внешней торговой системы.

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

Настройка конвертера

Чтобы подключить конвертер, перейдите в раздел веб-интерфейса Настройка сервера и оборудования – Конвертеры. В открывшемся окне нажмите кнопку +Добавить. Далее выберите из списка конвертер и нажмите +Создать:

После создания конвертера откроется окно его настройки:

Название – в данном поле указывается название конвертера (по умолчанию, присваивается значение типа добавляемого конвертера).

Запускается – указывается служба, через которую будет осуществляться обмен данными (при условии, что пользователь имеет право доступа к ресурсам). Существуют следующие варианты значений:

      На сервере – обмен будет осуществляться через УКМ-сервер.

      На терминале – обмен будет осуществляться через УКМ-клиент.

Журнал выгрузки – при включенном флаге будет сформирован файл в формате CSV, в который будет записана информация о загружаемых товарах и ценах.

      Путь для хранения журнала импорта – укажите путь до каталога, в котором будет храниться файл журнала импорта. Файл журнала будет сформирован в каталоге: "указанный_каталог/id_конвертера".

      Срок хранения журнала импорта, дни – по умолчанию, установлено значение 30 дней.

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

Имя базы данных – имя базы данных в СУБД MySQL, которая будет создана или к которой необходимо подключиться.

Примечание. Если базы данных конвертера не существует, то ее необходимо создать с помощью SQL-скрипта, который открывается по ссылке Скрипт создания БД (см. скриншот выше).

Имя хоста – имя или IP-адрес сервера базы данных (место расположения базы данных).

Имя пользователя – имя пользователя для подключения к базе данных.

Пароль пользователя – пароль пользователя, который подключается к базе данных.

Рекламная акция, в которую загружать скидки – наименование рекламной акции (из списка зарегистрированных в системе), для которой будут загружаться данные о скидках.

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

Типы счетов в УКМ – если в магазине ведется учет товара по счетам, то в данном поле указывается идентификатор счета во внешней системе, с которым будут выгружаться данные.

Скрипт создания БД – ссылка на скрипт для создания базы данных, предназначенной для обмена между сервером УКМ 4 и внешней системой.

Принцип организации импорта данных

Обмен информацией производится через дополнительную базу данных MySQL. База создается самими пользователями. SQL-скрипт для создания структуры базы находится в дистрибутиве УКМ 4 и доступен в момент создания конвертера (в разделе Настройка сервера и оборудования – Конвертеры). При создании базы указываются ее имя, пользователь и его пароль для подключения к ней. Примеры SQL-скриптов для создания базы:

create database import4; GRANT ALL ON import4.* TO ukm_import@'192.168.10.23' IDENTIFIED BY '1234' WITH MAX_USER_CONNECTIONS 10;

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

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

Значения сигнала о состоянии процесса

Внимание! Начиная с версии MySQL 5.5, при написании запроса название таблицы signal необходимо заключать в апострофы, т.к. слово "signal" является ключевым.

Пример запроса:

select count(*) from `signal` where `signal`='busy'

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

• cumm – сигнал помещается внешней системой и означает, что она подготовила данные, которыми необходимо полностью заменить данные в УКМ 4 (полная загрузка данных);
• incr – сигнал помещается внешней системой и означает, что она подготовила данные, которые содержат в себе только изменения (частичная загрузка данных);
• busy – сигнал помещается УКМ 4 и означает, что конвертер выполняет импортирование данных (конвертер занят).

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

Схема взаимодействия систем

Взаимодействие внешней системы с УКМ 4 состоит из следующих шагов:

1. Внешняя система проверяет готовность УКМ 4 принять данные. Если УКМ 4 готов принять данные, то внешняя система выполняет экспорт данных. Если УКМ 4 не готов принять данные, то внешняя система приостанавливает экспорт данных.

Для того чтобы убедиться в том, что УКМ 4 готов принять данные, нужно выполнить следующий запрос:

select count(*) from signal where signal='busy'

Нулевое значение означает, что УКМ 4 готов к приему данных.

2. Если УКМ 4 готов принять данные, внешняя система проверяет, закончился ли предыдущий экспорт данных в УКМ 4 (т.е. сигналов cumm или incr нет).

Если эти сигналы есть, то внешняя система удаляет их.

3. Внешняя система заполняет таблицы данных и формирует соответствующую запись в таблице signal. Запись в таблице signal информирует сервер УКМ 4 о произведённых изменениях и одновременно является сигналом для начала операции импортирования.

4. Конвертер проверяет запись таблицы signal. Если запись хранит информацию о том, что внешняя система подготовила данные, то конвертер помещает значение busy в поле signal и начинает импорт данных. После чтения информации УКМ 4 удаляет запись из таблиц.

5. По окончании процесса импорта, конвертер удаляет сигнал о занятости из таблицы signal.

Очередь сигналов и данных

Приведенная схема взаимодействия систем работает для случая, когда экспортированные из внешней системы данные сразу импортируются в УКМ 4. Если есть вероятность того, что УКМ 4 не успеет обработать предыдущий экспорт данных из внешней системы до готовности нового, следует организовать очередь сигналов и данных. Для этого используется поле version, хранящее номер версии данных (номер экспорта данных из внешней системы).

Поле version хранится в каждой таблице данных и таблице сигналов. При подготовке данных поле version заполняется значением счётчика. При формировании сигнала поле signal.version имеет то же самое значение, что и в данных. То есть, если к моменту готовности новой порции данных конвертер сообщает, что находится в процессе импортирования данных, либо не приступал к импортированию предыдущих данных, то необходимость в приостановке экспорта данных из внешней системы отпадает. В этом случае внешняя система увеличивает номер версии на 1 и формирует новый пакет.

Полная и частичная загрузка данных

Стандартный конвертер поддерживает полную и частичную загрузку данных в УКМ 4. В случае полной загрузки данные импортируются в УКМ 4 без сохранения предыдущего состояния.

В случае частичной загрузки, следует выделять две операции: добавление новой (или корректировка старой) записи и удаление записи. В последнем случае в поля delete в таблице данных следует установить значение 1. Значения всех полей, кроме ключевых, при удалении роли не играют. Эти поля могут оставаться пустыми или иметь значение по умолчанию.

Правила работы со свойствами товаров

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

Следует различать 2 разных типа свойств товаров:

• Свойства первого типа характеризуются тем, что их значения редко повторяются для разных товаров (как крайний случай, значения индивидуальны для каждого товара). К таким свойствам можно отнести артикул производителя, состав товара, сроки годности и т.д.
• Свойства второго типа характеризуются тем, что их значения могут повторяться для многих товаров. Например, страна происхождения товара.

В данном конверторе нельзя загрузить произвольные типы и значения свойств первого типа. Загружаемый список ограничен полями в таблице item.

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

• properties
• property_values
• available_receipt_item_properties
• item_properties_type
• item_property_values
• var_property_values

Таблица properties содержит идентификаторы и названия типов свойств (например, свойства «Сорт», «Размер», «Продавец»):

Возможные значения свойств загружаются в таблицу property_values:

В таблице available_receipt_item_properties перечисляются те значения свойств, которые доступны кассиру при указании значения свойства.

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

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

Таблица item_property_values предназначена для указания связи артикула с конкретным значением свойства товара. Если такая связь установлена, то кассир не будет выбирать значение свойства, оно будет присвоено строке чека автоматически. Существует аналогичная таблица var_property_values, предназначенная для автоматического присвоения значения свойства при вводе товара по штрихкоду.

Передача данных о заказах в УКМ 4

Загрузка информации о заказах в УКМ 4 производится из таблиц order_order и order_var.

Требования к загрузке налоговых ставок

В связи с добавлением в УКМ 4 функционала автоматического мапирования ставок НДС, со стороны УКМ 4 имеются новые требования к загрузке налоговых ставок через конвертеры. Для работы алгоритма автоматического выбора индекса ставки для ККТ при передаче данных о налогах через конвертеры УКМ 4 требуется указанием формулы налоговой ставки НДС в заданном виде.

Список ставок НДС, ожидаемых конвертерами УКМ 4

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

Примечание: Для ставок НДС 10%, 18%, 20% допустима форма передачи процента ставки: "XX%" и "XX.00%", например, 10.00% является допустимым значением ставки при передаче через конвертер.

2. Регистр для значения ставки Не облагается при передаче данных конвертеру можно указывать любой.

3. Ставка Не облагается может отсутствовать в справочнике налогов в нескольких случаях (это не вызовет проблем в работе кассовой системы):

• При использовании опции Формировать налоговые ставки автоматически, в соответствии с ФЗ РФ для заказчиков с неосновной системой налогообложения в чек всегда будет добавляться корректная ставка Не облагается – независимо от того, как заданы параметры ставки для списка карточек товаров для импорта.

• Ставка Не облагается будет автоматически использоваться УКМ 4 при пустом справочнике налогов для добавления товаров в чек. Актуально для пользователей с неосновной системой налогообложения, которые не выгружают налоги в УКМ 4 с любыми конвертерами.
• Ставка Не облагается будет использоваться УКМ 4 для объектов пользователя с неосновной системой налогообложения во всех случаях: даже если эта ставка не загружена в справочник налогов УКМ 4, не выбрана для товаров, и справочник налогов не пуст. Актуально для пользователей, которые в одной системе УКМ 4 поддерживают работу как магазинов с основной системой налогообложения, так и магазинов с любой неосновной системой налогообложения (например, ЕНДВ).

Таблицы

Внимание! В таблицах ниже приведены лишь общие сведения о полях. Подробные характеристики каждого поля можно найти в полном SQL-файле, расположенном в веб-интерфейсе по ссылке Скрипт создания БД в настройках конвертора:

assortment_group_items

Загрузка информации в весовые ассортименты (весы).

assortment_groups

Весовые ассортиментные группы.

available_receipt_item_properties

Хранение информации о специальных свойствах товаров; их значения присваиваются товару при расчете с покупателем. Значение этих свойств может быть «привязано» как к позициям в чеке, так и ко всему чеку в целом.

classif

Хранение информации о группах товаров и связи товаров с группами.

classifclients

Классификатор покупателей.

clear_signal

Таблица сигналов для удаления записей.

* Удаление прайс-листов (в поле name - "pricelist"):

1. Если выставлены значения в полях store и record_id, то прайс-лист с id = record_id отвязывается от магазина store, т.е. удаляется запись в таблице trm_in_pricetype_pricelist по полям:

clear_signal.record_id = trm_in_pricetype_pricelist.pricelist

clear_signal.store = trm_in_pricetype_pricelist.cash_line_id

Если отвязанный прайс-лист больше не используется ни в одном из магазинов (данный прайс-лист не упоминается в таблице trm_in_pricetype_pricelist), то происходит его каскадное удаление.

2. Если выставлено значение только в поле store, то все прайс-листы отвязываются от данного магазина т.е. удаляется запись в таблице trm_in_pricetype_pricelist по полям clear_signal.store = trm_in_pricetype_pricelist.cash_line_id.

Если отвязанные прайс-листы больше не используются ни в одном из магазинов (данные прайс-листы не упоминается в таблице trm_in_pricetype_pricelist), то происходит их каскадное удаление.

3. Если выставлено значение только в поле record_id, то осуществляется каскадное удаление прайс-листа с id = record_id; удаляются все записи из таблиц pricelist, pricelist_items, pricelist_var, pricetype_pricelist по полям соответственно:

clear_signal.record_id = trm_in_pricelist.id

clear_signal.record_id = trm_in_pricelist_items.pricelist

clear_signal.record_id = trm_in_pricelist_var.pricelist

clear_signal.record_id = trm_in_pricetype_pricelist.pricelist

Удаление прайс-листов по виду цены (поле name = pricetype):

1. Если выставлены значения в полях store и record_id, то каскадно удаляются все прайс-листы вида цены с идентификатором record_id для данного магазина. Если удаляемый прайс-лист используется для других магазинов (упоминается в таблице trm_in_pricetype_pricelist), то прайс-лист не удаляется, а лишь отвязывается от магазина store.

2. Если выставлено только поле record_id, а store = NULL, то каскадно удаляются все прайс-листы данного вида цены для всех магазинов.

Удаление самого вида цены не происходит, удаляются лишь прайс-листы. Для удаление вида цены достаточно выгрузить запись в таблицу pricetype c deleted = 1.

Удаление весового ассортимента (поле name = assortment):

1. Если выставлены значения в полях store и record_id, то осуществляется каскадное удаление ассортиментной группы c id = record_id из магазина store, т.е. удаляются записи в таблицах srv_assortment_groups и srv_assortment_group_items по полям:

clear_signal.record_id = srv_assortment_groups.id

clear_signal.store = srv_assortment_groups.cl_id

clear_signal.record_id = srv_assortment_group_items.ag_id

clear_signal.store = srv_assortment_group_items.cl_id

2. Если выставлено значение только в поле store, то осуществляется каскадное удаление всех ассортиментных групп магазина store, т.е. удаляются записи в таблицах srv_assortment_groups и srv_assortment_group_items по полям:

clear_signal.store = srv_assortment_groups.cl_id

clear_signal.store = srv_assortment_group_items.cl_id

client_card

Карты клиента.

client_card_stoplist

Стоп-лист карт клиента.

clients

Хранение информации о клиентах, зарегистрированных в программе.

clients_operations

Операции по счетам клиентов.

clients_properties

Заведение дополнительных свойств клиентов.

clients_properties_values

Выгрузка значений свойств клиентов.

disc_std_classif

Хранение информации о группах классификатора, включенных в скидку на товар и классификатор.

disc_std_classif_n_plus_m

Скидки при покупке N количества товара, из них на M скидка.

disc_std_client_property

Скидка на товары с заданным свойством для зарегистрированного клиента.

disc_std_clients

Скидка на зарегистрированного клиента.

disc_std_groupclassifs

Параметры скидки на набор групп.

disc_std_groupitems

Скидка на корзину товаров. Перечень товаров в корзинах.

disc_std_items_n_plus_m

Параметры скидки N+M.

disc_std_itemsgroup

Скидка на корзину. Перечень корзин.

discount_card

Перечень дисконтных карт (ДК).

discount_card_siebel

XXX

discount_card_stop_list

Стоп-лист дисконтных карт (ДК).

discount_card_type

Тип дисконтных карт (ДК).

discount_types

Загрузка информации о заголовках скидок (код, название и другие атрибуты).

* Идентификатор алгоритма скидки – значение поля efts:

7 – на товары с заданным свойством для зарегистрированного клиента;

15 – на штрихкод;

16 – на чек для зарегистрированного клиента;

19 – на классификатор и артикул;

108 – скидка на чек по времени и сумме.

** Параметры скидки в формате XML поля param:

<body>
    <lim_discount>
         <value></value>
    </lim_discount>
    <describe>
         <modificator>
              <value>-10%</value>
         </modificator>
    </describe>
</body>

<body>
    <lim_discount>
         <value></value>
    </lim_discount>
    <describe>
         <amount_from>
              <value>100</value>
         </amount_from>
         <modificator>
              <value>-10%</value>
         </modificator>
    </describe>
</body>

<body>
    <lim_discount>
         <value></value>
    </lim_discount>
    <describe>
         <amount_from>
              <value>100</value>
         </amount_from>
         <amount_to>
              <value>200</value>
         </amount_to>
         <modificator>
              <value>-10%</value>
         </modificator>
    </describe>
    <describe>
         <amount_from>
              <value>200</value>
         </amount_from>
         <modificator>
              <value>-20%</value>
         </modificator>
    </describe>
</body>

<body>
    <lim_discount>
         <value></value>
    </lim_discount>
    <describe>
         <time_from>
              <value>0100</value>
         </time_from>
         <time_to>
              <value>0200</value>
         </time_to>
         <modificator>
              <value>-10%</value>
         </modificator>
    </describe>
    <describe>
         <time_from>
              <value>0200</value>
         </time_from>
         <modificator>
              <value>-20%</value>
         </modificator>
    </describe>
</body>

<body>
    <lim_discount>
         <value></value>
    </lim_discount>
    <describe>
         <time_from>
              <value>0100</value>
         </time_from>
         <time_to>
              <value>0200</value>
         </time_to>
         <amount_from>
              <value>100</value>
         </amount_from>
         <amount_to>
              <value>200</value>
         </amount_to>
         <modificator>
              <value>-10%</value>
         </modificator>
    </describe>
    <describe>
         <time_from>
              <value>0200</value>
         </time_from>
         <amount_from>
              <value>200</value>
         </amount_from>
         <modificator>
              <value>-20%</value>
         </modificator>
    </describe>
</body>

discount_card_personal

XXX ???

discount_types_classifclient

Скидки, раздел «Кому», связь скидки и группы клиентов.

discount_types_client

Скидки, раздел «Кому», связь скидки и клиента.

discount_types_gifts

Скидки. Перечень подарков.

discount_types_items

Скидки, пороговые значения сумм или количеств в скидке на товар или классификатор.

discount_types_vars

Скидки, список штрихкодов в скидке на штрихкод.

item_property_values

Хранение информации о связи артикулов с расширенным набор свойств товаров.

items

Хранение информации о товаре.

items_tnved

XXX ???

items_remain

Остатки товара в магазинах.

items_stocks

Хранение информации о связи товаров с отделами.

nopdf

Предназначена для загрузки информации для "пивного чека".

order_order

Сформированные заказы.

order_var

Штрихкоды заказов.

payments

Перечень средств оплаты.

pricelist

Хранение информации о прайс-листах.

pricelist_ext

Прайс-листы (заголовки).

pricelist_items

Хранение информации о списке товаров прайс-листа.

pricelist_items_ext

XXX ???

pricelist_var

Хранение информации о списке товаров прайс-листа для штрихкода.

pricetype

Вид цены.

pricetype_store

Привязка магазина к основному виду цены (основные, немаркетинговые цены).

pricetype_store_pricelist

Программирование прайс-листов для магазинов (всех, в т.ч. и маркетинговых).

properties

Предназначена для хранения перечня свойств товаров.

* Исторически сложилось, что существуют зарезервированные имена свойств, которые УКМ 4 обрабатывает особым образом (более того, данные свойства имеют «двойников» в таблице items). Данные имена свойств используются при печати по чеку сопроводительных документов (сертификатов):

qdoc_id – номер сертификата соответствия;

qdoc_org – организация, выдавшая сертификат соответствия, и город;

qdoc_date – дата выдачи сертификата соответствия;

qdoc_exp – дата окончания срока действия сертификата соответствия;

hdoc_id – номер гигиенического сертификата;

hdoc_date – дата выдачи гигиенического сертификата;

hdoc_org – организация, выдавшая гигиенический сертификат, и город.

При печати документов УКМ 4 в первую очередь проверяет для товара наличие значений свойств в таблице trm_in_item_cc (куда они загружаются из таблицы items конвертора). Если значение свойства не найдено там, то затем проверяется таблица trm_in_properties.

item_properties_type

Связь товара со свойствами, которые выбирает кассир.

property_values

Хранение списков возможных значений свойств товаров.

* Пример заполнения поля description:

<question><const>ЗНАЧЕНИЕ СВОЙСТВА</const><displayname>НАЗВАНИЕ СВОЙСТВА</displayname></question>

repricing_act

XXX ???

repricing_act_item

XXX ???

role

Должности кассиров.

signal

Данная таблица предназначена для обмена сигналами о готовности данных для импорта между УКМ 4 и внешней торговой системой. Запись в таблице signal информирует сервер УКМ 4 о произведённых изменениях и одновременно является сигналом для начала операции импортирования.

Внимание! Начиная с версии MySQL 5.5, при написании запроса название таблицы signal необходимо заключать в апострофы, т.к. слово "signal" является ключевым.

Пример запроса:

select count(*) from `signal` where `signal`='busy'

stocks

Хранение информации об отделах магазина.

taxes

Информация о налогах.

taxgroup

В УКМ 4 связь товара с налогом производится через налоговую группу. Связь позволяет одновременно привязывать к товару не один, а несколько налогов. Таблица taxgroup содержит информацию о привязке налога к группе налогов и группы налогов к товару.

users

Список кассиров.

var

Хранение информации о штриховых кодах товаров.

var_property_values

Привязка значения свойства к штрихкоду.

discount_types_where

Параметр настройки скидки "Где".

sellers

Продавцы.

pricetags_classif

Назначение ценников на узел классификатора.

pricetags_item

Назначение ценников на товар.

pricetags_var

Назначение ценников на штрихкод.

document

Приходная накладная.

document_items

Спецификация приходной накладной.

appeal_reason

XXX ???

defect_reason

XXX ???

certificate_type

XXX ???

certificate

XXX ???

certificate_operations

XXX ???

external_order_refusals

Заказы Global. Справочник причин отказа.

external_order_items

Заказы Global. Состав внешних заказов

external_order_payments

XXX ???

external_orders

Заказы Global. Внешние заказы.

items_egais

Загрузка признака акцизного товара и параметров товарной карточки.

cash_messages

Таблица предназначена для загрузки сообщений кассиру.

items_sets

XXX ???

var_fur_identity

XXX ???

social_moscow_items

XXX ???

agent

XXX ???

item_agent

XXX ???

alco_type

XXX ???

list

XXX ???

list_items

XXX ???

external_order_item_add_info