...
Принцип работы данного конвертера – событийный, т.е. начало приема информации происходит по сигналу из внешней системы, который записывается в таблицу signal конвертера.
Настройка конвертера
Чтобы подключить конвертер, перейдите в раздел веб-интерфейса Настройка сервера и оборудования – Конвертеры. В открывшемся окне нажмите кнопку +Добавить. Далее выберите из списка конвертер и нажмите +Создать:
...
Протокол импорта данных основан на обмене сигналами между внешней системой и конвертером. Обмен сигналами производится системами через таблицу signal. Каждая операция по импорту данных сопровождается записью в таблице signal.
...
Значение сигнала о состоянии процесса импорта хранится в поле signal таблицы signal. Поле может принимать одно из следующих значений:
...
3. Внешняя система заполняет таблицы данных и формирует соответствующую запись в таблице signal. Запись в таблице signal информирует сервер УКМ 4 о произведённых изменениях и одновременно является сигналом для начала операции импортирования.
...
Загрузка информации о заказах, сделанных с помощью терминалов сбора данных, в УКМ 4 производится из таблиц order_order и order_var.
Требования к загрузке налоговых ставок
...
В таблицах ниже приведены лишь общие сведения о полях. Подробные характеристики каждого поля можно найти в полном SQL-файле, расположенном в веб-интерфейсе по ссылке Скрипт создания БД в настройках конвертера:
Якорь assortmentgroupitems assortmentgroupitems
assortment_group_items
assortmentgroupitems | |
assortmentgroupitems |
Загрузка информации в весовые ассортименты (весы).
...
Название поля | Тип данных | Описание |
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 |
7 | null |
...
Название поля | Тип данных | Описание |
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 | 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 |
Предназначена для хранения перечня свойств товаров.
...
Название поля | Тип данных | Описание |
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>ЗНАЧЕНИЕ СВОЙСТВА</
...
const>
<displayname>НАЗВАНИЕ СВОЙСТВА</
...
displayname>
</question>
Якорьreprice reprice
repricing_act
reprice | |
reprice |
...
Название поля | Тип данных | Описание |
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 |
Привязка значения свойства к штрихкоду.
...
Название поля | Тип данных | Описание | ||||||
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 – изменяемая товарная позиция: не добавляется в чек в режиме 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 – запись актуальна |
...
Название поля | Тип данных | Описание | ||||||
---|---|---|---|---|---|---|---|---|
store | varchar(40) | ID магазина | ||||||
order_id | bigint(20) | ID заказа | ||||||
item | varchar(40) | 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 – запись актуальна |
...
Название поля | Тип данных | Описание | ||||||
store | varchar(40) | ID магазина | ||||||
order_id | bigint(20) | ID заказа | ||||||
amount | decimal(20,4) | Величина оплаты | ||||||
| tinyint(1) | Форма расчета для ККТ: 0 – наличные; 1 – безналичные; 3 – постоплата (кредит); 4 – встречное представление | ||||||
version | int(11) | Номер версии данных | ||||||
deleted | tinyint(1) | Признак того, что запись устарела и должна быть удалена из БД кассового терминала: 1 – запись устарела; 0 – запись актуальна |
...
Название поля | Тип данных | Описание | ||||||
store | varchar(40) | Идентификатор магазина (идентификатор из настроек конвертера) | ||||||
order_id | intbigint(1120) | Идентификатор заказа в системе 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 – запись актуальна |
...
Название поля | Тип данных | Описание |
---|---|---|
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(1) | Признак того, что запись устарела и должна быть удалена из БД кассового терминала: 1 – запись устарела; 0 – запись актуальна |
Якорь itemagent itemagent
item_agent
itemagent | |
itemagent |
Принадлежность товара агенту.
...
Название поля | Тип данных | Описание |
---|---|---|
list | int(11) | ID списка |
item | varchar(40) | Артикул товара |
version | bigint(20) | Номер версии данных |
deleted | tinyint(1) | Признак того, что запись устарела и должна быть удалена из БД кассового терминала: 1 – запись устарела; 0 – запись актуальна |
Якорь | ||||
---|---|---|---|---|
|
Описание классификатора.
Название поля | Тип данных | Описание |
---|---|---|
id | bigint(20) | ID меню |
name | varchar(40) | Наименование меню |
role | bigint(20) | Действует только для роли с идентификатором |
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) | Порядок отображения строк в меню |
Якорь | ||||
---|---|---|---|---|
|
Видимость классификатора в конкретном магазине.
Название поля | Тип данных | Описание |
---|---|---|
store | varchar(40) | 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 | int(11) | ID магазина |
rmenu | bigint(20) | ID меню |
Якорь | ||||
---|---|---|---|---|
|
Товары классификатора.
Название поля | Тип данных | Описание |
---|---|---|
rmenu | bigint(20) | ID меню |
dish | varchar(40) | Идентификатор блюда |
show_order | int(11) | Порядок отображения блюд и групп модификаторов в меню |