...
Принцип работы данного конвертера – событийный, т.е. начало приема информации происходит по сигналу из внешней системы, который записывается в таблицу signal конвертера.
Настройка конвертера
Чтобы подключить конвертер, перейдите в раздел веб-интерфейса Настройка сервера и оборудования – Конвертеры. В открывшемся окне нажмите кнопку +Добавить. Далее выберите из списка конвертер и нажмите +Создать:
...
Товары без агента загружать как собственные – если данный параметр активирован, то при импорте данных, проставленное значение NULL в поле tag_1226 таблицы external_order_items конвертера заменяется на значение 0. По умолчанию, данный параметр неактивен. Якорь new new
...
Протокол импорта данных основан на обмене сигналами между внешней системой и конвертером. Обмен сигналами производится системами через таблицу signal. Каждая операция по импорту данных сопровождается записью в таблице signal.
...
Значение сигнала о состоянии процесса импорта хранится в поле signal таблицы signal. Поле может принимать одно из следующих значений:
...
3. Внешняя система заполняет таблицы данных и формирует соответствующую запись в таблице signal. Запись в таблице signal информирует сервер УКМ 4 о произведённых изменениях и одновременно является сигналом для начала операции импортирования.
...
Загрузка информации о заказах, сделанных с помощью терминалов сбора данных, в УКМ 4 производится из таблиц order_order и order_var.
Требования к загрузке налоговых ставок
...
В таблицах ниже приведены лишь общие сведения о полях. Подробные характеристики каждого поля можно найти в полном SQL-файле, расположенном в веб-интерфейсе по ссылке Скрипт создания БД в настройках конвертера:
Якорь assortmentgroupitems assortmentgroupitems
assortment_group_items
assortmentgroupitems | |
assortmentgroupitems |
Загрузка информации в весовые ассортименты (весы).
...
Название поля | Тип данных | Описание |
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 |
Хранение списков возможных значений свойств товаров.
...
Название поля | Тип данных | Описание |
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) | Идентификатор магазина (идентификатор из настроек конвертера) | ||||||
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 – частично маркированный товар | ||||||||
version | bigint(20) unsigned | Номер версии данных | ||||||||
| tinyint( | 31) | unsignedПризнак того, что запись устарела иПризнак подакцизности товара. Может принимать значения: 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) | Порядок отображения блюд и групп модификаторов в меню |