История страницы

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

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

Image Removed

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

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

Image Added

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

Image Added

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

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

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

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

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

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

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

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

Подключение к БД – детали подключения конвертера к базе данных.

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

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

      Имя хоста - Имя или ip – имя или 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;

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

...

Image Added

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

...

внешней системой и

...

конвертером

...

.

...

Обмен сигналами производится системами через таблицу 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 содержит идентификаторы и названия типов свойств (например, свойства

...

«Сорт»,

...

«Размер»,

...

«Продавец»):

...

Image Added

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

...

Image Added

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

...

.

Image Removed

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

...

он также применим и для свойств, загружаемых через

...

конвертеры.

Для связи

...

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

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

...

штрих-коду.

Якорь
orders orders

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

Загрузка информации о заказах

...

, сделанных с помощью терминалов сбора данных, в УКМ 4 производится из таблиц order_order и order_var.

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

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

...

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

Список ставок НДС

...

, ожидаемых конвертерами УКМ 4

...

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

...

некорректной ставкой налога.

Примечание

...

. Значения всех налоговых ставок всегда должны указываться как целочисленные.

2. Регистр для значения ставки 

...

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

...

.

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

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

Актуально для конвертеров:

 Стандартный 2 DBF импорт
 Стандартный 2 CSV импорт
 Супермаг Плюс CSV импорт

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

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

Таблицы

assortment_group_items

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

Таблицы

Внимание! 

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

Image Added

Якорь
assortmentgroupitems assortmentgroupitems

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

Якорь
cards cards

client_card

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

...

client_card_stoplist

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

...

clients

...

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

...

clients_operations

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

...

Якорь
ofd ofd

clients_properties

...

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

...

Якорь
em em

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

Справочник дисконтных карт Siebel для off-line операций

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>

discount_types_classifclient

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

         <modificator>
              <value>-20%</value>
         </modificator>
    </describe>
</body>

discount_card_personal

Информация для скидки по персональной дисконтной карте

discount_types_classifclient

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

discount_types_client

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

discount_types_gifts

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

discount_types_items

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

discount_types_vars

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

Якорь
ipv ipv

item_property_values

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

items

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

Якорь
tnved tnved

tnved

Коды ТН ВЭД

Якорь
rests rests

items_remain

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

items_stocks

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

Якорь
order order

order_order

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

Якорь
var var

order_var

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

payments

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

discount_types_client

...

Якорь
pricelist pricelist

pricelist

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

...

pricelist_

...

ext

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

discount_types_items

...

pricelist_items

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

discount_types_vars

...

Якорь
pr222 pr222

pricelist_items_ext

Дополнительные цены