...
Принцип работы данного конвертера – событийный, т.е. начало приема информации происходит по сигналу из внешней системы, который записывается в таблицу signal конвертера.
Настройка конвертера
Чтобы подключить конвертер, перейдите в раздел веб-интерфейса Настройка сервера и оборудования – Конвертеры. В открывшемся окне нажмите кнопку +Добавить. Далее выберите из списка конвертер и нажмите +Создать:
...
После создания конвертера откроется окно его настройки:
Название – в данном поле указывается название конвертера (по умолчанию, присваивается значение типа добавляемого конвертера).
...
На сервере – обмен будет осуществляться через УКМ-сервер.
На терминалетерминалах – обмен будет осуществляться через УКМ-клиент.
...
Магазины – кликните по ссылке Добавить магазины для выбора магазинов и назначения им уникальных идентификаторов, с которыми выгружаются данные из внешней системы.
Подключение к БД – детали подключения конвертера к базе данных.
Имя базы данных – имя базы данных в СУБД MySQL, которая будет создана или к которой необходимо подключиться.
...
Примечание. Если базы данных конвертера не существует, то ее необходимо создать с помощью SQL-скрипта, который открывается по ссылке Скрипт создания БД (см. скриншот выше).
Имя хоста – имя или IP-адрес сервера базы данных (место расположения базы данных).
Имя пользователя – имя пользователя для подключения к базе данных.
Пароль пользователя – пароль пользователя, который подключается к базе данных.
Загрузка скидок – детали загрузки маркетинговых инструментов и счетов.
Рекламная акция, в которую загружать скидки – наименование рекламной акции (из списка зарегистрированных в системе), для которой будут загружаться данные о скидках. устаревший функционал; в поле необходимо указать значение Не загружать скидки.
Тип дисконтной системы, в которую загружать дисконтные карты – наименование типа дисконтной системы (из списка зарегистрированных в системе), для которой будут загружаться данные о дисконтных картах.
Типы счетов в УКМ – если в магазине ведется учет товара по счетам, то в данном поле указывается идентификатор счета во внешней системе, с которым будут выгружаться данные.
Товары без агента загружать как собственные – если данный параметр активирован, то при импорте данных, проставленное значение NULL в поле tag_1226 таблицы external_order_items конвертера заменяется на значение 0. По умолчанию, данный параметр неактивен. Якорь new new
Скрипт создания БД – ссылка на скрипт для создания базы данных, предназначенной для обмена между сервером УКМ 4 и внешней системой.
...
Протокол импорта данных основан на обмене сигналами между внешней системой и конвертером. Обмен сигналами производится системами через таблицу signal. Каждая операция по импорту данных сопровождается записью в таблице signal.
Значения сигнала о состоянии процесса
Внимание!
Начиная с версии MySQL 5.5, при написании запроса название таблицы signal необходимо заключать в апострофы, т.к. слово "signal" является ключевым.
...
Значение сигнала о состоянии процесса импорта хранится в поле signal таблицы signal. Поле может принимать одно из следующих значений:
...
3. Внешняя система заполняет таблицы данных и формирует соответствующую запись в таблице signal. Запись в таблице signal информирует сервер УКМ 4 о произведённых изменениях и одновременно является сигналом для начала операции импортирования.
...
- Свойства первого типа характеризуются тем, что их значения редко повторяются для разных товаров (как крайний случай, значения индивидуальны для каждого товара). К таким свойствам можно отнести артикул производителя, состав товара, сроки годности и т.д.
- Свойства второго типа характеризуются тем, что их значения могут повторяться для многих товаров. Например, страна происхождения товара.
В данном конверторе конвертере нельзя загрузить произвольные типы и значения свойств первого типа. Загружаемый список ограничен полями в таблице item.
...
В общем случае, не все значения свойства могут быть доступны кассиру для выбора. Например, с помощью этого механизма можно управлять выбором продавцов, которые работали с покупателем, в зависимости от графика их работы. В первую очередь, такой механизм используется для свойств, которые создаются в самом УКМ 4, однако, он также применим и для свойств, загружаемых через конверторыконвертеры.
Для связи типа свойства с конкретным артикулом, предназначена таблица item_properties_type. Наличие в этой таблице записи приводит к тому, что при выборе данного товара на кассе кассиру выводится список значений данного свойства (ограниченный таблицей available_receipt_item_properties) для выбора значения. Если требуется на кассе указывать значения свойства, которое не привязано к артикулу, то необходимо воспользоваться соответствующей кассовой операцией.
Таблица item_property_values предназначена для указания связи артикула с конкретным значением свойства товара. Если такая связь установлена, то кассир не будет выбирать значение свойства, оно будет присвоено строке чека автоматически. Существует аналогичная таблица var_property_values, предназначенная для автоматического присвоения значения свойства при вводе товара по штрихкоду.
Якорь orders orders
Передача данных о заказах в УКМ 4
orders | |
orders |
Загрузка информации о заказах, сделанных с помощью терминалов сбора данных, в УКМ 4 производится из таблиц order_order и order_var.
...
1. В случае, если формулы ставок отличаются от рекомендуемых, то товары могут быть добавлены в чек с некорректной ставкой налога.
Примечание:. Для ставок НДС 10%, 18%, 20% допустима форма передачи процента ставки: "XX%" и "XX.00%", например, 10.00% является допустимым значением ставки при передаче через конвертер.
...
- Ставка Не облагается будет автоматически использоваться УКМ 4 при пустом справочнике налогов для добавления товаров в чек. Актуально для пользователей с неосновной системой налогообложения, которые не выгружают налоги в УКМ 4 с любыми конвертерами.
- Ставка Не облагается будет использоваться УКМ 4 для объектов пользователя с неосновной системой налогообложения во всех случаях: даже если эта ставка не загружена в справочник налогов УКМ 4, не выбрана для товаров, и справочник налогов не пуст. Актуально для пользователей, которые в одной системе УКМ 4 поддерживают работу как магазинов с основной системой налогообложения, так и магазинов с любой неосновной системой налогообложения (например, ЕНДВ).
Таблицы
Внимание! В
В таблицах ниже приведены лишь общие сведения о полях. Подробные характеристики каждого поля можно найти в полном SQL-файле, расположенном в веб-интерфейсе по ссылке Скрипт создания БД в настройках конвертораконвертера:
Якорь assortmentgroupitems assortmentgroupitems
assortment_group_items
assortmentgroupitems | |
assortmentgroupitems |
Загрузка информации в весовые ассортименты (весы).
Название поля | Тип данных | Описание |
store | varchar(40) | Код магазина в рамках значений внешней системы |
ag_id | int(11) | Идентификатор весового ассортимента (весов) |
var | varchar(40) | Штрихкод товара |
plu | varchar(40) | Номер ячейки в весах |
hot_key | varchar(40) | Код «горячей клавиши» |
exp_date1 | datetime | Срок годности (дата) |
exp_date2 | int(11) | Срок годности (в днях) |
version | int(11) | Номер версии данных |
status | int(11) | Признак того, что запись устарела и должна быть удалена из БД кассового терминала: 1 – запись устарела; 0 – запись актуальнаСтатус товара: 0 – добавлено вручную; 1 – добавлено автоматически 2 – удалена; 3 – черновик |
deleted | tinyint(1) unsigned | Признак того, что запись устарела и должна быть удалена из БД кассового терминала: 1 – запись устарела; 0 – запись актуальна |
...
* Удаление прайс-листов (в поле name - – "pricelist"):
1. Если выставлены значения в полях store и record_id, то прайс-лист с id = record_id отвязывается от магазина store, т.е. удаляется запись в таблице trm_in_pricetype_pricelist по полям:
...
clear_signal.store = srv_assortment_group_items.cl_id
Якорь cards cards
client_card
cards | |
cards |
Карты клиента.
Название поля | Тип данных | Описание |
client | varchar(40) | Код клиента |
card_code | varchar(40) | Номер карты |
pin | varchar(256) | Пин-код карты |
version | bigint(20) unsigned | Номер версии данных |
deleted | tinyint(3) unsigned | Признак того, что запись устарела и должна быть удалена из БД кассового терминала: 1 – запись устарела; 0 – запись актуальна |
...
Название поля | Тип данных | Описание |
id | varchar(40) | Идентификатор клиента |
classifclient | int(11) unsigned | Идентификатор узла классификатора клиентов, которому принадлежит клиент |
sur_name | varchar(100) | Фамилия клиента физического лица или ответственного закупщика юридического лица |
name | varchar(100) | Имя клиента (физического лица или ответственного закупщика юридического лица) |
patronymic | varchar(100) | Отчество клиента (физического лица или ответственного закупщика юридического лица) |
birthday | datetime | Дата рождения клиента физического лица или ответственного закупщика юридического лица). Значение года должно быть в диапазоне 1400 - – 10000 |
inn | varchar(100) | ИНН клиента |
passport | varchar(100) | Паспортные данные клиента (физического лица или ответственного закупщика юридического лица) |
pricetype | varchar(38) | Идентификатор вида цены |
type | tinyin(1) | Признак печати счета-фактуры: при оформлении продажи клиенту программа распечатает счет-фактуры |
allow_paycash | tinyint(1) | Способ оплаты, используемый клиентом при расчете с магазином: 0 – только со счета; 1 – любым способом |
enterprisename | varchar(100) | Название клиента – юридического лица |
okpo | varchar(100) | ОКПО клиента |
okdp | varchar(100) | ОКДП клиента |
kpp | varchar(100) | КПП клиента |
baddress | varchar(100) | Юридический адрес клиента |
address | varchar(100) | Физический адрес клиента |
phone | varchar(100) | Контактный телефон клиента |
bank | varchar(100) | Банковские реквизиты клиента |
register | varchar(100) | Номер свидетельства о регистрации индивидуального предпринимателя |
consignee_name | varchar(100) | Название грузополучателя |
consignee_address | varchar(100) | Адрес грузополучателя |
active | tinuint(1) | 0 – заблокирован, 1 - – разблокирован |
save_change | tinuint(1) | Значение признака зачисления сдачи на счёт покупателя через услугу: 0 – не зачислять, 1 – решение принимает покупатель, 2 – зачислять автоматически |
version | bigint(20) unsigned | Номер версии данных |
deleted | tinyint(3) unsigned | Признак того, что запись устарела и должна быть удалена из БД кассового терминала: 1 – запись устарела; 0 – запись актуальна |
...
Название поля | Тип данных | Описание |
id | bigint(20) unsigned | Идентификатор операции |
account_id | int(11) | Идентификатор типа счета |
client | varchar(40) | Идентификатор клиента |
number | varchar(100) | Номер операции (может быть равен номеру исходного документа) |
date | datetime | Дата документа |
operation_date | datetime | Дата операции |
amount | decimal(20,4) | Сумма операции |
type | tinyint(1) | Тип операции (0 – приход/расход, баланс изменяется на величину amount: если amount – положительное число, то приход, если отрицательное – расход; 1 – баланс устанавливается в значение amount, независимо от значения баланса до обработки операции) |
version | bigint(20) unsigned | Номер версии данных |
Якорь ofd ofd
clients_properties
ofd | |
ofd |
Заведение дополнительных свойств клиентов.
Название поля | Тип данных | Описание |
id | varchar(40) | Идентификатор свойства |
name | varchar(100) | Наименование свойства |
version | int(11) | Номер версии данных |
deleted | tinyint(1) unsigned | Признак того, что запись устарела и должна быть удалена из БД кассового терминала: 1 – запись устарела; 0 – запись актуальна |
Якорь em em
clients_properties_values
em | |
em |
Выгрузка значений свойств клиентов.
...
Значение поля efts (код алгоритма) | Значение параметра | |
108 | <describe, amount_from, amount_to, time_from, time_to, modificator>, где: describe – диапазон скидки "от и до"; количество диапазонов может быть любым; amount_from – нижний диапазон суммы чека; amount_to – верхний диапазон суммы чека; time_from – значение времени, начиная с которого выполняется условие; time_from – значение времени, до которого выполняется условие; modificator – значение скидки. Условия действия скидки по сумме внутри диапазона проверяются по связке "И". Условия действия скидки по времени предоставляются на первый диапазон, который удовлетворяет всем условиям. Условия действия скидки по сумме и времени предоставляется как предел (в рублях или % от суммы чека) суммы скидки по заданному правилу. Примеры: скидка на чек 10%: <body> <lim_discount> <value></value> </lim_discount> <describe> <modificator> <value>-10%</value> </modificator> </describe> </body> скидка на чек 10%, если сумма чека больше 100 руб.: <body> <lim_discount> <value></value> </lim_discount> <describe> <amount_from> <value>100</value> </amount_from> <modificator> <value>-10%</value> </modificator> </describe> </body> скидка на чек: если сумма чека от 100 до 200 руб. – 10%: если сумма чека больше 200 руб. – 20%: <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> скидка на чек: если время от 01:00 до 02:00 – 10%, если время от 02:00 – 20%: <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> | |
19 | <x, y, z> где: x – способ назначения скидки (0 – пороговый; 1 – ступенчатый); y – ± процент / руб. на ед. / руб. на позиц.) скидки / наценки / стоимости) по умолчанию; z – z – тип пороговых значений (0 – суммовой; 1 – количественный) | |
16 | null | |
15 | null | 14|
7 | null |
discount_card_personal
...
Название поля | Тип данных | Описание |
id | int(11) | Идентификатор записи |
discount_type | bigint(20) | Идентификатор скидки |
var | varchar(40) | Штрихкод |
quantity | decimal(20,4) | Пороговое количество |
modificator | varchar(40) | Модификатор типа скидки: значение скидки в формате: [+|-|p]value[%|x|g] |
version | int(11) | Версия изменения записи |
deleted | tinyint(1) unsigned | Признак того, что запись устарела и должна быть удалена из БД кассового терминала: 1 – запись устарела; 0 – запись актуальна |
Якорь ipv ipv
item_property_values
ipv | |
ipv |
Хранение информации о связи артикулов с расширенным набор свойств товаров.
...
Название поля | Тип данных | Описание | ||||||
id | varchar(40) | Артикул товара | ||||||
name | varchar(255) | Название товара, которое печатается в документах | ||||||
descr | text | Описание товара | ||||||
measure | varchar(40) | Название единицы измерения количества товара | ||||||
measprec | decimal(11,0) | Точность единицы измерения количества товара: 1 – один знак после запятой; 2 – два знака после запятой, и т.д. | ||||||
classif | varchar(40) | Идентификационный номер группы товара | ||||||
prop | int(11) | Не используется | ||||||
tax | int(11) | Идентификатор налоговой группы товара (поле опциональное) | ||||||
| tinyint(3) | Крепость алкоголя | ||||||
gtd | varchar(40) | Номер ГТД | ||||||
country | varchar(40) | Название страны-производителя | ||||||
certification | varchar(40) | Номер сертификата | ||||||
certification_date | varchar(40) | Дата начала действия сертификата | ||||||
produser_marking | varchar(100) | Производитель | ||||||
summary | varchar(100) | Описание товара | ||||||
structure | text | Состав товара | ||||||
exp_date | datetime | Срок годности | ||||||
realization_time | int(11) | Время реализации | ||||||
qdoc_org | varchar(40) | Организация, выдавшая сертификат соответствия, и город | ||||||
qdoc_id | varchar(40) | Номер сертификата соответствия | ||||||
qdoc_date | datetime | Дата выдачи сертификата соответствия | ||||||
qdoc_exp | datetime | Дата окончания срока действия сертификата соответствия | ||||||
hdoc_org | varchar(40) | Организация, выдавшая гигиенический сертификат, и город | ||||||
hdoc_id | varchar(40) | Номер гигиенического сертификата | ||||||
hdoc_date | datetime | Дата выдачи гигиенического сертификата | ||||||
tnved | varcharbigint(4020) unsigned | Код Идентификатор кода ТН ВЭД | ||||||
version | bigint(20) unsigned | Номер версии данных | ||||||
deleted | tinyint(3) unsigned | Признак того, что запись устарела и должна быть удалена из БД кассового терминала: 1 – запись устарела; 0 – запись актуальна |
Якорь
...
tnved tnved
tnved
tnved | |
tnved |
Коды ТН ВЭД.
Название поля | Тип данных | Описание |
id | bigint(20) unsigned | ID кода ТН ВЭД |
name | varchar(255) | Наисенование кода ТН ВЭД |
tnved | varchar(40) | Значение кода ТН ВЭД |
version | int(10) unsigned | Номер версии данных |
deleted | tinyint(1) | Признак того, что запись устарела и должна быть удалена из БД кассового терминала: 1 – запись устарела; 0 – запись актуальна |
Якорь rests rests
items_remain
rests | |
rests |
Остатки товара в магазинах.
...
Название поля | Тип данных | Описание |
store | varchar(40) | Идентификатор магазина |
id | varchar(20) | Идентификатор заказа |
date | datetime | Дата/время формирования заказа |
property_code | varchar(20) | Идентификатор свойства. Это свойство будет привязано к товарной позиции в чеке со значением идентификатора заказа |
changeable | tinyint(1) | Изменяемый (1) / неизменяемый (0) заказ |
version | int(11) unsigned | Номер версии данных |
deleted | tinyint(3) unsigned | Признак того, что запись устарела и должна быть удалена из БД кассового терминала: 1 – запись устарела; 0 – запись актуальна |
...
Название поля | Тип данных | Описание |
store | varchar(40) | Идентификатор магазина |
order_id | varchar(20) | Идентификатор заказа |
position | int(11) | Идентификатор строки товарной позиции в заказе |
var_item | varchar(40256) | Штрихкод |
quantity | decimal(20,4) | Количество |
stock | int(11) | Отдел |
price | decimal(20,4) | Цена товара |
minprice | decimal(20,4) | Минимальная цена товара |
fix_price | tinyint(1) | Признак того, что цена товара в заказе не может быть изменена на кассевозможности применения скидок на позицию в заказе: 0 – можно менятьприменять; 1 – нельзя менятьприменять |
version | int(11) unsigned | Номер версии данных |
deleted | tinyint(3) unsigned | Признак того, что запись устарела и должна быть удалена из БД кассового терминала: 1 – запись устарела; 0 – запись актуальна |
...
Название поля | Тип данных | Описание |
store | varchar(40) | Код магазина в рамках значений внешней системы |
id | int(11) | Идентификатор средства оплаты |
name | varchar(40) | Название |
version | int(11) | Номер версии данных |
deleted | tinyint(1) | Признак того, что запись устарела и должна быть удалена из БД кассового терминала: 1 – запись устарела; 0 – запись актуальна |
Якорь pricelist pricelist
pricelist
pricelist | |
pricelist |
Хранение информации о прайс-листах.
...
Название поля | Тип данных | Описание |
pricelist | int(11) unsigned | Идентификатор прайс-листа, которому принадлежит товар |
item | varchar(40) | Артикул товара |
price | decimal(20,4) | Цена товара |
minprice | decimal(20,4) | Ограничение цены товара |
is_promo_price | tinyint(1) | Акционная цена |
version | bigint(20) unsigned | Номер версии данных |
deleted | tinyint(3) unsigned | Признак того, что запись устарела и должна быть удалена из БД кассового терминала: 1 – запись устарела; 0 – запись актуальна |
Якорь pr222 pr222
pricelist_items_ext
pr222 | |
pr222 |
Дополнительные цены.
Название поля | Тип данных | Описание |
pricelist | int(11) unsigned | Идентификатор прайс-листа |
item | varchar(40) | Код товара |
nomenclature_id | int(11) | Идентификатор номенклатуры |
pos | int | Позиция цены |
price | decimal(20,4) | Цена товара |
minprice | decimal(20,4) | Минимальная цена товара |
descr | varchar(100) | Дополнительный текст для вывода цены |
version | bigint(20) unsigned | Номер версии данных |
deleted | tinyint(3) unsigned | Признак того, что запись устарела и должна быть удалена из БД кассового терминала: 1 – запись устарела; 0 – запись актуальна |
...
Название поля | Тип данных | Описание |
pricelist | int(11) unsigned | Идентификатор прайс-листа, которому принадлежит товар |
var | varchar(40) | Штрихкод товара |
price | decimal(20,4) | Цена товара за единицу измерения, указанную для артикула (поля items.measure и items.measprec) |
minprice | decimal(20,4) | Ограничение цены товара |
is_promo_price | tinyint(1) | Акционная цена |
version | int(11) | Номер версии данных |
deleted | tinyint(1) | Признак того, что запись устарела и должна быть удалена из БД кассового терминала: 1 – запись устарела; 0 – запись актуальна |
Якорь pricetype pricetype
pricetype
pricetype | |
pricetype |
Вид цены.
Название поля | Тип данных | Описание |
id | int(11) unsigned | Идентификатор вида цены |
name | varchar(100) | Название вида цены |
version | int(11) | Номер версии данных |
deleted | tinyint(1) | Признак того, что запись устарела и должна быть удалена из БД кассового терминала: 1 – запись устарела; 0 – запись актуальна |
...
Название поля | Тип данных | Описание |
pricetype | int(11) unsigned | Идентификатор вида цены |
store | varchar(40) | Идентификатор магазина в рамках значений внешней системы |
version | bigint(20) unsigned | Номер версии данных |
deleted | tinyint(3) unsigned | Признак того, что запись устарела и должна быть удалена из БД кассового терминала: 1 – запись устарела; 0 – запись актуальна |
Якорь psp psp
pricetype_store_pricelist
psp | |
psp |
Программирование прайс-листов для магазинов (всех, в т.ч. и маркетинговых).
Название поля | Тип данных | Описание |
pricetype | int(11) unsigned | Идентификатор вида цены |
store | varchar(40) | Идентификатор магазина в рамках значений внешней системы |
pricelist | int(11) | Идентификатор прайс-листа |
version | int(11) | Номер версии данных |
deleted | tinyint(1) | Признак того, что запись устарела и должна быть удалена из БД кассового терминала: 1 – запись устарела; 0 – запись актуальна |
Якорь proper proper
properties
proper | |
proper |
Предназначена для хранения перечня свойств товаров.
...
При печати документов УКМ 4 в первую очередь проверяет для товара наличие значений свойств в таблице trm_in_item_cc (куда они загружаются из таблицы items конвертора конвертера). Если значение свойства не найдено там, то затем проверяется таблица trm_in_properties.
...
Название поля | Тип данных | Описание |
item_id | varchar (40) | Идентификатор товара |
property_code | varchar(40) | Идентификатор свойства (код свойства) |
version | int(11) | Номер версии данных |
deleted | tinyint(1) | Признак того, что запись устарела и должна быть удалена из БД кассового терминала: 1 – запись устарела; 0 – запись актуальна |
Якорь pv pv
property_values
pv | |
pv |
Хранение списков возможных значений свойств товаров.
...
* Пример заполнения поля description:<question><const>ЗНАЧЕНИЕ
<question>
<const>ЗНАЧЕНИЕ СВОЙСТВА</
...
const>
<displayname>НАЗВАНИЕ СВОЙСТВА</
...
displayname>
</question>
Якорь reprice reprice
repricing_act
reprice | |
reprice |
Акты переоценки.
Название поля | Тип данных | Описание |
store | varchar (40) | ID магазина |
id | bigint(20) unsigned | ID акта |
date_start | datetime | Дата начала срока действия акта |
date_stop | datetime | Дата окончания срока действия акта |
priority | int(11) | Приоритет |
description | varchar(255) | Примечание |
version | integer(10) unsigned | Номер версии данных |
deleted | tinyint(1) | Признак того, что запись устарела и должна быть удалена из БД кассового терминала: 1 – запись устарела; 0 – запись актуальна |
...
Товары в актах переоценки.
Название поля | Тип данных | Описание |
store | varchar(40) | ID магазина |
repricing_act_id | bigint(20) unsigned | ID акта |
item | varchar(40) | Артикул товара |
number | int(11) unsigned | Уникальный ID переоценки товара в рамках одного акта |
price | decimal(20,4) | Цена товара |
version | integer(10) unsigned | Номер версии данных |
deleted | tinyint(1) | Признак того, что запись устарела и должна быть удалена из БД кассового терминала: 1 – запись устарела; 0 – запись актуальна |
...
Данная таблица предназначена для обмена сигналами о готовности данных для импорта между УКМ 4 и внешней торговой системой. Запись в таблице signal информирует сервер УКМ 4 о произведённых изменениях и одновременно является сигналом для начала операции импортирования.
Внимание!
Начиная с версии MySQL 5.5, при написании запроса название таблицы signal необходимо заключать в апострофы, т.к. слово "signal" является ключевым.
...
Название поля | Тип данных | Описание |
id | varchar(40) | Штриховой код товара |
item | varchar(40) | Артикул товара |
quantity | decimal(20,4) | Количество товара. Например, количество товара в упаковке товаров |
tare_weight | decimal(20,4) | Вес тары |
stock | int(11) | Идентификатор отдела |
version | bigint(20) unsigned | Номер версии данных |
deleted | tinyint(3) unsigned | Признак того, что запись устарела и должна быть удалена из БД кассового терминала: 1 – запись устарела; 0 – запись актуальна |
Якорь vpv vpv
var_property_values
vpv | |
vpv |
Привязка значения свойства к штрихкоду.
...
Параметр настройки скидки "Где".
Название поля | Тип данных | Описание |
discount | bigint(20) | Идентификатор скидки из trm_in_discount_types |
store | varchar(40) | Идентификатор магазина, для которого назначена скидка |
version | int(10) unsigned | Номер версии данных |
deleted | tinyint(1) | Признак того, что запись устарела и должна быть удалена из БД кассового терминала: 1 – запись устарела; 0 – запись актуальна |
...
Название поля | Тип данных | Описание |
classif_id | varchar(40) | ID классификатора товарного справочника |
pricetag_id | int(11) | Идентификатор ценника |
version | int(11) unsigned | Номер версии данных |
deleted | tinyint(1) | Признак того, что запись устарела и должна быть удалена из БД кассового терминала: 1 – запись устарела; 0 – запись актуальна |
...
Название поля | Тип данных | Описание |
store_id | varchar(40) | Идентификатор магазина |
id | varchar(40) | Идентификатор приходной накладной |
number | varchar(40) | Номер приходной накладной |
ref_shipment | varchar(40) | Номер отгрузки |
title | varchar(100) | Название документа |
barcode | varchar(100) | Штрихкод |
date_from | datetime | Поставка ожидается "с" |
date_to | datetime | Подставка ожидается "по" |
operation_type | int(11) | Название бизнес процесса (приход товара, возврат от покупателя и т.д.) |
operation_date | datetime | Дата и время создания операции в управляющей системе |
consignee | varchar(40) | Грузополучатель |
supplier | varchar(40) | Поставщик |
supplier_transport | varchar(40) | Номер машины поставщика |
shipper | varchar(40) | Грузоотправитель |
payer | varchar(40) | Плательщик |
reason_number | varchar(40) | Номер договора или заказа поставщику |
reason_date | datetime | Дата договора или заказа поставщику |
container | int(11) | Количество контейнеров в поставке |
alt_type | varchar(40) | planАльтернативный внешний тип документа |
plan_gate | int(11) | Ожидаемый номер ворот |
gate | int(11) | Реальный номер ворот |
plan_pallet_count | int(11) | Ожидаемое количество паллет |
pallet_count | int(11) | Реальное количество паллет |
pallet_capacity | decimal(20,1) | Количество паллетомест |
invoice_number | varchar(40) | Номер накладной |
invoice_date | date | Дата накладной |
agent | varchar(40) | ФИО водителя-экспедитора |
handle_type | varchar(40) | Внешний тип поставки |
stream | varchar(40) | Поток |
command_client | varchar(100) | Номер СС имя клиента (из документов ASN-SRT) |
bp | varchar(40) | ID бизнес-процесса |
act_type | int(11) | Тип акта (ревизия/инвентаризация) |
version | int(11) unsigned | Номер версии данных |
deleted | tinyint(1) | Признак того, что запись устарела и должна быть удалена из БД кассового терминала: 1 – запись устарела; 0 – запись актуальна |
...
Название поля | Тип данных | Описание |
store_id | varchar(40) | Идентификатор магазина |
document | varchar(40) | Идентификатор приходной накладной |
item | varchar(40) | Идентификатор товара |
sequence | int(11) | Порядковый номер в накладной |
quantity | decimal(20,4) | Ожидаемое количество |
price | decimal(20,4) | Цена товара |
title | varchar(100) | Примечание |
version | int(11) unsigned | Номер версии данных |
deleted | tinyint(1) | Признак того, что запись устарела и должна быть удалена из БД кассового терминала: 1 – запись устарела; 0 – запись актуальна |
...
Название поля | Тип данных | Описание |
code | varchar(40) | Код свойства |
title | varchar(100) | Название |
version | bigint(20) unsigned | Номер версии данных |
deleted | tinyint(1) | Признак того, что запись устарела и должна быть удалена из БД кассового терминала: 1 – запись устарела; 0 – запись актуальна |
defect_reason
XXXСписок проблем.
Название поля | Тип данных | Описание |
defect_code | varchar(40) | Код |
title | varchar(100) | Проблема |
version | int(11) unsigned | Номер версии данных |
deleted | tinyint(1) | Признак того, что запись устарела и должна быть удалена из БД кассового терминала: 1 – запись устарела; 0 – запись актуальна |
...
Название поля | Тип данных | Описание |
id | int(11) | Идентификатор типа сертификата (значение id должно быть больше 1 000 000, записи с меньшим id не будут загружаться) |
name | varchar(40) | Название типа сертификата |
nominal | decimal(20, 4) | Номинал |
mono_account | tinyint(1) | Признак одноразового использования сертификата: 0 - – подарочная карта (многоразовая), 1 - 1 – сертификат (одноразовый) |
check_underpay | tinyint(1) | Признак разрешения недоплаты: 0 – не разрешено; 1 – разрешено; 2 – решение принимает кассир |
multi_sell | tinyint(1) | 0 – сертификат можно продать только один раз; 1 – можно продавать сертификат повторно |
allow_return | tinyint(1) | 0 – возврат сертификата запрещен; 1 - 1 – возврат сертификата разрешен (значения из этого поля копируется в базу УКМ 4 в поле return_money) |
allow_return_payment | tinyint(1) | Возвращать средства на счет сертификата при возврате товаров: 0 – запрещено; - 1 – разрешено |
check_store | tinyint(1) | Проверять магазин при продаже сертификата |
item_id | varchar(40) | Идентификатор товара, продаваемого как сертификат |
use_pincode | tinyint(1) | Признак использования защитного кода |
print_in_receipt | tinyint(1) | Печатать в чеке |
fixed_nominal | tinyint(1) | Признак фиксированного номинала |
min_nominal | decimal(20,4) | Минимальное значение номинала сертификата |
max_nominal | decimal(20,4) | Максимальное значение номинала сертификата |
nominal_multiplicity | decimal(20,4) | Значение кратности номинала сертификата |
version | int(11) | Номер версии данных |
deleted | tinyint(1) | Признак того, что запись устарела и должна быть удалена из БД кассового терминала: 1 – запись устарела; 0 – запись актуальна |
...
Название поля | Тип данных | Описание |
number | varchar(255) | ID транзакции |
amount | decimal(20, 2) | Cумма транзакции |
version | int(11) | Номер версии данных |
deleted | tinyint(1) | Признак того, что запись устарела и должна быть удалена из БД кассового терминала: 1 – запись устарела; 0 – запись актуальна |
Якорь refreasons refreasons
external_order_refusals
refreasons | |
refreasons |
Заказы Global. Справочник причин отказа.
Название поля | Тип данных | Описание |
id | int(11) | Код причины |
title | varchar(255) | Название |
can_comment | tinyint(1) | Нужно комментировать [1 – да; 0 – нет] |
version | int(11) | Номер версии данных |
deleted | tinyint(1) | Признак того, что запись устарела и должна быть удалена из БД кассового терминала: 1 – запись устарела; 0 – запись актуальна |
Якорь uff uff
external_order_items
uff | |
uff |
Заказы Global. Состав внешних заказов.
Название поля | Тип данных | Описание | ||||||
store | varchar(40) | Идентификатор магазина (идентификатор из настроек конвертера) | ||||||
order_id | intbigint(1120) | Номер заказа в системе Global | ||||||
item | varchar(40)) | Артикул товара | ||||||
quantity | decimal(20,4) | Количество товара | ||||||
price | decimal(20,4) | Цена | ||||||
min_price | decimal(20,4) | Минимальная цена | ||||||
changeable | tinyint(1) | Режим работы с позицией заказа: 0 – неизменяемая позиция (услуга)1 – изменяемая (товарная) позиция; 0 – неизменяемая позиция (услуга): добавляется в чек всегда, нельзя удалить из чека; 1 – изменяемая товарная позиция: не добавляется в чек в режиме changeable = 2, можно удалить; 2 – изменяемая товарная позиция: обязательно добавляется в чек в режиме changeable = 2, можно удалить | ||||||
| tinyint(1) | Признак того, что цена товара в заказе не может быть изменена на кассевозможности применения скидок на позицию в заказе: 0 – можно менятьприменять; 1 – нельзя менятьприменять | ||||||
tag_1212 | tinyint(1) | Признак предмета расчета (1212): значения от 1 до 26 в соответствии с ФЗ 54 РФ | ||||||
tag_1214 | tinyint(1) | Признак способа расчета (1214): значения от 1 до 7 в соответствии с ФЗ 54 РФ | ||||||
tag_1226 | bigint(20) | ИНН поставщика | ||||||
tax_group | int(11) | ID налоговой группы для поставщика | ||||||
version | int(11) | Номер версии данных | ||||||
deleted | tinyint(1) | Признак того, что запись устарела и должна быть удалена из БД кассового терминала: 1 – запись устарела; 0 – запись актуальна |
Якорь | ||||
---|---|---|---|---|
|
...
add_info
Дополнительная информация для товара заказа.
Название поля | Тип данных | Описание | ||||||
---|---|---|---|---|---|---|---|---|
store | varchar(40) | ID магазина | ||||||
order_id | bigint(20) | ID заказа | ||||||
amountitem | decimalvarchar(20,440) | Величина оплаты | return_by_cash_forbidden | tinyint(1) | Признак того, что для этого средства оплаты запрещен возврат из денежного ящикаID товара в заказе | |||
info_id | int(11) | ID доп. информации | ||||||
| varchar(225) | Доп. информация (штрихкод или DataMatrix) | ||||||
price | decimal(20,4) | Цена | ||||||
quantity | decimal(20,4) | Количество | ||||||
min_price | decimal(20,4) | Мин. цена | ||||||
tag_1212 | tinyint | Признак предмета расчета | ||||||
tag_1214 | tinyint | Признак способа расчета | ||||||
tag_1226 | bigint(20) | ИНН агента | ||||||
tax_group | int(11) | Индекс налоговой группы | ||||||
version | int(11) | Номер версии данных | ||||||
deleted | tinyint(1) | Признак того, что запись устарела и должна быть удалена из БД кассового терминала: 1 – запись устарела; 0 – запись актуальна |
Якорь extpay extpay
external_order_
extpay | |
extpay |
...
payments
Предоплаты/авансы заказов из внешних систем.
Название поля | Тип данных | Описание |
store | varchar(40) |
ID магазина |
order_id |
bigint( |
20) |
ID заказа |
items_egais
Загрузка признака акцизного товара и параметров товарной карточки.
Название поля
Тип данных
Описание
amount | decimal(20,4) | Величина оплаты | ||||||
| tinyint(1) | Форма расчета для ККТ: 0 – наличные; 1 – безналичные; 3 – постоплата (кредит); 4 – встречное представление | ||||||
version | int(11) | Номер версии данных | ||||||
deleted | tinyint(1) | Признак того, что запись устарела и должна быть удалена из БД кассового терминала: 1 – запись устарела; 0 – запись актуальна |
Якорь extern extern
external_orders
extern | |
extern |
Заказы Global. Внешние заказы.
Название поля | Тип данных | Описание | ||||||
store | varchar(40) | Идентификатор магазина (идентификатор из настроек конвертера) | ||||||
order_id | bigint(20) | Идентификатор заказа в системе Global | ||||||
ext_order_type | varchar(100) | Тип системы, в которой сделан заказ | ||||||
ext_order_id | varchar(100) | Идентификатор, присвоенный системой, в которой сделан заказ | ||||||
order_date | datetime | Дата создания заказа (опционально) | ||||||
| tinyint(5) | Статус заказа: 1 – ожидает оплаты; 2 – оплачен; 3 – ожидает выкупа; 4 – выкупается; 5 – выкуплен; 6 – аннулирован; 7 – ожидает возврата; 8 – возвращен; 9 – ожидает приёма; 10 – принят | ||||||
sale_type | tinyint(1) | Тип продажи (1 – оплата курьером; 0 – оплата на кассе) | ||||||
wholesale | tinyint(1) | 1 – оптовая продажа; 0 – розничная продажа | ||||||
client_name | varchar(255) | Имя покупателя | ||||||
| varchar(40) | ИНН покупателя (для заказов юридическими лицами). Если поля client_inn и client_name заполнены, то они регистрируются в ККТ (теги 1228 и 1227, соответственно) | ||||||
check_structure | tinyint(1) | Проверять состав чека при выкупе: 1 – да: товары сканируются сканером для добавления, товары не из заказа нельзя добавить в чек; 0 – нет: все товары заказа добавляются в чек сразу, можно добавить дополнительный товар в чек | ||||||
changeable | tinyint(1) | Режим работы с составом заказа: | ||||||
amount | decimal(20,4) | Сумма заказа | ||||||
version | int(11) | Номер версии данных | ||||||
deleted | tinyint(1) | Признак того, что запись устарела и должна быть удалена из БД кассового терминала: 1 – запись устарела; 0 – запись актуальна |
Якорь iegais iegais
items_egais
iegais | |
iegais |
Загрузка признака акцизного товара и параметров товарной карточки.
Название поля | Тип данных | Описание | ||||||
id | varchar(40) | Артикул товара | ||||||
| tinyint(1) | Признак маркированности товара, параметр товарной карточки. Может принимать значения: 0 – неакцизный товар; 1 – маркированный товар; 2 – немаркированный товар; 3 – специальный маркированный товар; 4 – частично маркированный товар | ||||||
| tinyint(1) | Признак подакцизности товара. Может принимать значения: 0 – неподакцизный товар; 1 – подакцизный товар | ||||||
| int(11) | Признак уникальности контрольной марки товара. Может принимать значения: 0 – уникальная марка; 1 – неуникальная марка | ||||||
version | bigint(20) unsigned | Номер версии данных | ||||||
deleted | tinyint(3) unsigned | Признак того, что запись устарела и должна быть удалена из БД кассового терминала: 1 – запись устарела; 0 – запись актуальна |
cash_messages
Загрузка сообщений кассиру.
Название поля | Тип данных | Описание |
store_id | int(11) | Идентификатор магазина (идентификатор из настроек конвертера) |
id | int(11) | Идентификатор сообщения |
message | text | Текст сообщения |
date_from | datetime | Дата начала периода вывода сообщения на кассе |
date_to | datetime | Дата окончания периода вывода сообщения на кассе |
version | int(11) | Номер версии данных |
deleted | tinyint(1) | Признак того, что запись устарела и должна быть удалена из БД кассового терминала: 1 – запись устарела; 0 – запись актуальна |
items_sets
Наборы.
Название поля | Тип данных | Описание |
---|---|---|
set_id | varchar(40) | Идентификатор набора |
item_id | varchar(40) | Идентификатор позиции набора |
quantity | decimal(20,4) | Количество товара |
version | int(11) | Номер версии данных |
deleted | tinyint(1) | Признак того, что запись устарела и должна быть удалена из БД кассового терминала: 1 – запись устарела; 0 – запись актуальна |
var_fur_identity
Соответствие меток КиЗ меховых изделий штрихкодам.
Название поля | Тип данных | Описание |
---|---|---|
var_id | varchar(40) | Штрихкод товара |
fur_identity | varchar(40) | Метка КиЗ |
version | bigint(20) unsigned | Номер версии данных |
deleted | tinyint(1) | Признак того, что запись устарела и должна быть удалена из БД кассового терминала: 1 – запись устарела; 0 – запись актуальна |
social_moscow_items
Товары-исключения для социальных сертификатов Москвы.
Название поля | Тип данных | Описание |
---|---|---|
item | varchar(40) | Идентификатор товара |
version | int(11) | Номер версии данных |
deleted | tinyint(1) | Признак того, что запись устарела и должна быть удалена из БД кассового терминала: 1 – запись устарела; 0 – запись актуальна |
Якорь agent agent
agent
agent | |
agent |
Справочник агентов.
Название поля | Тип данных | Описание | ||
---|---|---|---|---|
tag_1226 | bigint(20) | ИНН поставщика, обязательное поле | ||
tag_1222 | tinyint(3) | Тип агента 2^i, i от 0 до 6 | ||
tag_1073 | varchar(25) | Телефон пл агента | ||
tag_1044 | varchar(25) | Операция пл. агента | ||
tag_1016 | bigint(20) | ИНН оператора перевода | ||
tag_1026 | varchar(70) | Наименование оператора перевода | ||
tag_1075 | varchar(25) | Tелефон оператора перевода | ||
tag_1005 | varchar(256) | Адрес оператора перевода | ||
tag_1074 | varchar(25) | Тел. оператора по приему платежей | ||
tag_1225 | varchar(256) | Наименование поставщика | ||
tag_1171 | varchar(25) | Телефон поставщика | ||
version | int(11) | Номер версии данных | ||
deleted | tinyint( | 31) | unsignedПризнак того, что запись устарела и должна быть удалена из БД кассового терминала: 1 – запись устарела; 0 – запись актуальна |
cash_messages
...
Якорь itemagent itemagent
item_agent
itemagent | |
itemagent |
Принадлежность товара агенту.
Название поля | Тип данных | Описание |
---|
item_id |
varchar( |
40) | Идентификатор |
товара | ||
tag_1226 | bigint(20) | ИНН поставщика |
tax_group_id | int(11) | ID налоговой группы поставщика |
version | int(11) | Номер версии данных |
deleted | tinyint(1) | Признак того, что запись устарела и должна быть удалена из БД кассового терминала: 1 – запись устарела; 0 – запись актуальна |
...
alco_
...
type
НаборыТипы акцизных марок.
Название поля | Тип данных | Описание | ||
---|---|---|---|---|
settype_id | varchar(405) | Идентификатор набора | item_idТип акцизной марки | |
name | varchar( | 40256) | Идентификатор позиции набора | quantityНазвание типа |
min_price | decimal(20,4) | Количество товараМинимальная розничная цена | ||
version | int(11) | Номер версии данных | ||
deleted | tinyint(1) | Признак того, что запись устарела и должна быть удалена из БД кассового терминала: 1 – запись устарела; 0 – запись актуальна |
var_fur_identity
...
list
Списки товаров.
Название поля | Тип данных | Описание | |
---|---|---|---|
var_id | varcharint(4011) | Штрихкод товара | fur_identityID списка |
name | varchar( | 40128) | Метка КиЗНаименование списка |
version | bigint(20) unsigned | Номер версии данных | |
deleted | tinyint(1) | Признак того, что запись устарела и должна быть удалена из БД кассового терминала: 1 – запись устарела; 0 – запись актуальна |
...
list_items
Товары-исключения для социальных сертификатов МосквыПринадлежность товара списку.
Название поля | Тип данных | Описание | Тип данных | Описание |
---|---|---|---|---|
list | int(11) | ID списка | ||
item | varchar(40) | ИдентификаторАртикул товара | ||
version | intbigint(1120) | Номер версии данных | ||
deleted | tinyint(1) | Признак того, что запись устарела и должна быть удалена из БД кассового терминала: 1 – запись устарела; 0 – запись актуальна |
agent
...
Якорь | ||||
---|---|---|---|---|
|
Описание классификатора.
Название поля | Тип данных | Описание |
---|---|---|
tag_1226id | bigint(20) | ИНН поставщика, обязательное поле |
tag_1222 | tinyint(3) | Тип агента 2^i, i от 0 до 6 |
tag_1073 | varchar(25) | Телефон пл агента |
tag_1044 | varchar(25) | Операция пл. агента |
ID меню | ||
name | varchar(40) | Наименование меню |
role | bigint(20) | ИНН оператора перевода |
tag_1026 | varchar(70) | Наименование оператора перевода |
tag_1075 | varchar(25) | Tелефон оператора перевода |
tag_1005 | varchar(256) | Адрес оператора перевода |
tag_1074 | varchar(25) | Тел. оператора по приему платежей |
tag_1225 | varchar(256) | Наименование поставщика |
tag_1171 | varchar(25) | Телефон поставщика |
version | int(11) | Номер версии данных |
deleted | tinyint(1) | Признак того, что запись устарела и должна быть удалена из БД кассового терминала: 1 – запись устарела; 0 – запись актуальна |
item_agent
Принадлежность товара агенту.
...
Название поля
...
Тип данных
...
Описание
...
alco_type
...
Действует только для роли с идентификатором | ||
type | tinyint(4) | Тип меню: 0 – нормальное; 1 – добавление блюд меню к блюдам родительского меню; 2 – исключает из родительского меню блюда этого меню |
owner | bigint(20) | Идентификатор родительского меню |
date_from | datetime | Действует с даты |
date_to | datetime | Действует по дату |
time_from | varchar(5) | Действует с момента времени |
time_to | varchar(5) | Действует до момента времени |
monday | tinyint(1) | Действует ли меню в понедельник |
tuesday | tinyint(1) | Действует ли меню во вторник |
wednesday | tinyint(1) | Действует ли меню в среду |
thursday | tinyint(1) | Действует ли меню в четверг |
friday | tinyint(1) | Действует ли меню в пятницу |
saturday | tinyint(1) | Действует ли меню в субботу |
sunday | tinyint(1) | Действует ли меню в воскресенье |
show_at | int(11) | Порядок отображения строк в меню |
Якорь | ||||
---|---|---|---|---|
|
Видимость классификатора в конкретном магазине.
Название поля | Тип данных | Описание |
---|---|---|
type_idstore | varchar(540) | Тип акцизной марки |
name | varchar(256) | Название типа |
min_price | decimal(20,4) | Минимальная розничная цена |
version | int(11) | Номер версии данных |
deleted | tinyint(1) | Признак того, что запись устарела и должна быть удалена из БД кассового терминала: 1 – запись устарела; 0 – запись актуальна |
list
Списки товаров.
...
Название поля
...
Тип данных
...
Описание
...
list_items
Принадлежность товара списку.
...
Название поля
...
Тип данных
...
Описание
...
external_order_item_add_info
...
ID магазина | ||
rmenu | bigint(20) | ID меню |
default_settings | tinyint(1) | Использовать стандартные настройки для этого пункта |
role | bigint(20) | Роль пользователя, которому доступно меню |
date_from | datetime | Начало периода активности меню в магазине |
date_to | datetime | Окончание периода активности меню в магазине |
time_from | varchar(5) | Начало времени активности меню |
time_to | varchar(5) | Окончание времени активности меню |
monday | tinyint(1) | Действует ли меню в понедельник |
tuesday | tinyint(1) | Действует ли меню во вторник |
wednesday | tinyint(1) | Действует ли меню в среду |
thursday | tinyint(1) | Действует ли меню в четверг |
friday | tinyint(1) | Действует ли меню в пятницу |
saturday | tinyint(1) | Действует ли меню в субботу |
sunday | tinyint(1) | Действует ли меню в воскресенье |
Якорь | ||||
---|---|---|---|---|
|
Активность классификатора.
Название поля | Тип данных | Описание |
---|---|---|
store_id | varcharint(4011) | id ID магазина | order_id
rmenu | bigint(20) | id заказа |
item | varchar(40) | id товара в заказе |
info_id | int(11) | id доп. информации |
additional_info | varchar(225) | Доп. информация (штрихкод или DataMatrix) |
version | ID меню |
Якорь | ||||
---|---|---|---|---|
|
Товары классификатора.
Название поля | Тип данных | Описание | |||
---|---|---|---|---|---|
rmenu | bigint(20) | ID меню | |||
dish | varchar(40) | Идентификатор блюда | |||
show_order | int(11) | Номер версии данных | deleted | tinyint(1) | Признак того, что запись устарела и должна быть удалена из БД кассового терминала: 1 – запись устарела; 0 – запись актуальнаПорядок отображения блюд и групп модификаторов в меню |