Стандартный конвертер экспорта данных формата MySQL с выборкой данных: по весовым товарам, по специальным свойствам товаров (присваиваются при расчете покупателя), по картам клиентов, по стоп листам карт клиентов.
Настройка конвертера
Чтобы подключить конвертер, перейдите в раздел веб-интерфейса Настройка сервера и оборудования – Конвертеры. В открывшемся окне нажмите кнопку +Добавить. Далее выберите из списка конвертер и нажмите +Создать:
Откроется окно настройки конвертера:
Название – в поле указывается название конвертера (по умолчанию, присваивается значение типа добавляемого конвертера).
Запускается – указывается служба, через которую будет осуществляться обмен данными (при условии, что пользователь имеет право доступа к ресурсам). Существуют следующие варианты значений:
На сервере – обмен будет осуществляться через УКМ-сервер.
На терминалах – обмен будет осуществляться через УКМ-клиент.
Магазины – для выбора магазинов, данные которых будут выгружаться конвертером, кликните по ссылке Добавить магазины и в открывшемся окне выберите нужные. После этого присвойте каждому магазину свой номер.
Экспорт средств оплаты – при включении параметра Настройка перекодировки средств оплаты будут показаны все средства оплаты, действующие в выбранных ранее магазинах. Напротив каждой строки с названием средства оплаты указывается его код, который будет выгружаться конвертером (если коды не указываются, то при передаче данных будут использованы коды средств оплаты УКМ 4).
Средства оплаты – из списка необходимо выбрать одно из средств оплаты.
Имя базы данных – имя базы данных в СУБД MySQL, которая будет создана или к которой необходимо подключиться.
Имя хоста – имя или IP-адрес сервера базы данных (место расположения базы данных).
Имя пользователя – имя пользователя для подключения к базе данных.
Пароль пользователя – пароль пользователя, который используется при подключении к базе данных конвертера.
Количество попыток экспорта некорректных чеков – сколько раз система будет инициировать повторную выгрузку некорректно выгруженных чеков.
Пауза между попытками (сек.) – интервал (в секундах) между повторными попытками выгрузить некорректные чеки.
Выгружать кассовые документы – при включении флага в базу данных будет выгружаться информация в разрезе товаров и видов оплат (устаревший функционал).
Выгружать чеки – при включении флага в базу данных будет выгружаться информация о всех чеках.
Выгружать зарегистрированных физ. лиц – флаг доступен только при включенном параметре Выгружать чеки. При включении флага в базу данных будет выгружаться информация о физических лицах, зарегистрированных на сервере УКМ 4.
Выгружать зарегистрированных юр. лиц – флаг доступен только при включенном параметре Выгружать чеки. При включении параметра в базу данных выгружается информация о юридических лицах, зарегистрированных на сервере УКМ 4.
Выгружать результаты опросов – при включении флага в базу данных выгружаются итоги опросов.
Выгружать off-line транзакции Siebel – включенный флаг обеспечивает выгрузку транзакций системы Siebel, произведенных в режиме off-line.
Выгружать разрешения на операции – при включенном флаге выгружаются разрешения на проведение различных кассовых операций, требующих повышения прав кассира.
Не выгружать данные старше (дни) – позволяет ограничивать передачу устаревших данных. Максимальное значение, которое можно установить в поле, = 100. По умолчанию, значение не установлено и будут выгружаться все данные.
При первом подключении выгружать – параметр позволяет выбрать вариант выгрузки чеков относительно момента подключения конвертера. Существуют следующие варианты выгрузки:
От начала открытой смены на момент подключения конвертера – выгружаются чеки, начиная с момента открытия той смены, во время работы которой был подключен настраиваемый конвертер.
С момента подключения конвертера – будут выгружены чеки, закрытие которых происходило, начиная с момента подключения настраиваемого конвертера.
Если база данных, к которой необходимо подключится, существует, то в полях при настройке конвертера необходимо указывать параметры для подключения к данной базе. Если базы данных не существует, то ее необходимо создать с помощью SQL-скрипта, который открывается по ссылке Скрипт создания БД.
Ручной запуск выгрузки
В конвертере существует возможность ручного запуска выгрузки данных. Для того, чтобы запустить выгрузку данных вручную, найдите конвертер Стандартный экспорт 4 в списке подключенных конвертеров (раздел веб-интерфейса Настройка сервера и оборудования – Конвертеры):
Кликните по ссылке Выгрузить данные. Откроется окно Ручная выгрузка:
В дополнение к описанным выше полям, в открывшейся форме появится несколько новых:
В форме, открывающейся во вкладке По сменам, с помощью выпадающих списков Регион и Город можно отобрать магазины, данные по сменам которых необходимо передать во внешнюю систему. Фильтр позволяет выбрать отдельные кассы, данные по сменам которых необходимо передать во внешнюю систему, для этого необходимо кликнуть по названию магазина и в открывшейся форме выбрать нужные кассы:
В форме, открывающейся во вкладке По датам, в полях С: и По: задается диапазон времени, за который необходимо передать данные во внешнюю программу. В форме также существует механизм для выбора конкретных магазинов, данные из которых необходимо передать во внешнюю программу. Для этого нужно нажать на кнопку Выбранных и выбрать магазины из представленного списка:
Правила взаимодействия с внешней системой
УКМ 4 заполняет таблицы базы экспорта с чеками по мере их появления (таблица receipt и связанные с нею записи). Признаком того, что чек полностью записан в базу экспорта, является непустое значение в поле receipt_result. Для смены признаком является непустое значение в поле shift.date_close.
Внешняя система сама определяет порядок считывания чеков из базы экспорта – либо по мере появления новых чеков, либо после закрытия смены всех чеков, относящихся к ней. Для этого пользователи имеют возможность добавить в структуру базы данных в любую таблицу произвольное количество полей, названия которых начинаются с префикса ext_. Эти поля предназначены для обработки внешней системой и могут использоваться, например, в качестве флагов.
В случае если внешняя система ведет собственную нумерацию средств оплаты, используемых в кассовой системе, в конвертере предусмотрена возможность замены кодов видов оплат. Настройка выполняется в интерфейсе конвертера.
Таблицы
Внимание!
В таблицах ниже приведены лишь общие сведения о полях. Подробные характеристики каждого поля можно найти в полном SQL-файле, расположенном в веб-интерфейсе по ссылке Скрипт создания БД в настройках конвертера:
clients
Информация о зарегистрированных клиентах.
Название поля | Тип данных | Описание |
| id | varchar(40) | Идентификатор клиента |
| classifclient | int(11) unsigned | Идентификатор узла классификатора клиентов, которому принадлежит клиент |
| sur_name | varchar(100) | Фамилия клиента (физического лица или ответственного закупщика юридического лица) |
| name | varchar(100) | Имя клиента (физического лица или ответственного закупщика юридического лица) |
| patronymic | varchar(100) | Отчество клиента (физического лица или ответственного закупщика юридического лица) |
| birthday | datetime | Дата рождения клиента (физического лица или ответственного закупщика юридического лица) |
| inn | varchar(100) | ИНН клиента |
| passport | varchar(100) | Паспортные данные клиента (физического лица или ответственного закупщика юридического лица) |
| pricelist | int(11) | Прайс-лист, назначенный клиенту |
| type | tinyint(1) | Тип клиента: 0 – физ. лицо; 1 – юр. лицо |
| allow_paycash | tinyint(1) | Способ оплаты, используемый клиентом при расчете с магазином: 0 – только со счета; 1 – любым способом |
| active | 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) | Адрес грузополучателя |
clients_properties
Выгрузка информации о дополнительных свойствах клиентов.
Название поля | Тип данных | Описание |
| id | varchar(40) | Идентификатор свойства |
| name | varchar(100) | Название свойства |
clients_properties_values
Выгрузка информации о значениях дополнительных свойствах клиентов.
Название поля | Тип данных | Описание |
| property | varchar(40) | Идентификатор свойства |
| client | varchar(40) | Идентификатор клиента |
| value | varchar(100) | Значение свойства |
login
Информация о пользователе, вошедшем в систему и вышедшем из системы, и времени входа/выхода пользователя.
Название поля | Тип данных | Описание |
| store | varchar(100) | Код магазина в рамках значений внешней системы |
| cash_number | int(11) | Номер кассы |
| cash_id | int(11) | Идентификатор кассового терминала |
| id | bigint(20) unsigned | Идентификатор записи |
| user_id | bigint(19) | Идентификатор пользователя |
| date | datetime | Дата и время входа пользователя в cистему |
| user_name | varchar(100) | Имя пользователя, вошедшего в cистему |
| logout_date | datetime | Дата и время выхода пользователя из cистемы |
inquirer_detailed_answer
Информация о результатах проведенных опросов.
Название поля | Тип данных | Описание |
| store | varchar(100) | Код магазина в рамках значений внешней системы |
| cash_number | int(11) | Номер кассы |
| cash_id | bigint(20) | Идентификатор кассового терминала |
| receipt_id | bigint(20) unsigned | Идентификатор чека |
| date | datetime | Дата закрытия чека |
| inq_id | varchar(40) | ID опроса |
| inq_name | varchar(40) | Название опроса |
| inq_question | text | Текст опроса |
| answ_id | varchar(40) | ID опроса |
| answ_text | varchar(100) | Текст ответа |
moneyoperation
Информация о выполнении операции внесения денежных средств в денежный ящик/изъятия денежных средств из денежного ящика, подключенного к ККМ.
Название поля | Тип данных | Описание |
| store | varchar(100) | Код магазина в рамках значений внешней системы |
| cash_number | int(11) | Номер кассы |
| cash_id | int(11) | Идентификатор кассового терминала |
| id | bigint(20) unsigned | Идентификатор операции внесения/изъятия денежных средств |
| global_number | bigint(20) unsigned | Глобальный номер документа, оформляемого системой по операции, с момента начала функционирования системы. Номер автоматически присваивается каждой операции |
| local_number | bigint(20) unsigned | Номер документа, оформляемого системой по операции внесения/изъятия денежных средств за смену |
| login | bigint(20) unsigned | Идентификатор пользователя, выполнившего операцию внесения/изъятия денежных средств |
| shift_number | bigint(20) unsigned | Номер смены, в течение которой выполнялась операция внесения/изъятия денежных средств. Поле хранит одно из следующих значений: • номер текущей смены, если операция внесения/изъятия денежных средств выполняется в течение открытой смены; • номер следующей смены, если операция внесения/изъятия денежных средств выполняется после закрытия смены |
| date | datetime | Дата и время выполнения операции внесения/изъятия денежных средств |
| type | bigint(20) unsigned | Тип операции: 100 – внесение; 101 – изъятие |
| payment_id | bigint(20) unsigned | Идентификатор внесенных/изъятых средств |
| payment_name | varchar(100) | Название внесенных/изъятых средств |
| amount | decimal(20,4) | Сумма внесенных/изъятых средств |
| amount_before | decimal(20,4) | Сумма средств в денежном ящике до внесения/изъятия |
moneyoperation_note
Покупюрный учет внесенных/изъятых денежных средств.
Название поля | Тип данных | Описание |
| store | varchar(100) | Код магазина в рамках значений внешней системы |
| cash_number | int(11) | Номер кассы |
| cash_id | int(11) | Идентификатор кассового терминала |
| id | bigint(20) unsigned | Идентификатор записи |
| moneyoperation | bigint(20) unsigned | Идентификатор операции внесения/изъятия денежного средства, для которой ведется покупюрный учет |
| note | decimal(20,4) | Номинал купюры |
| count | bigint(20) unsigned | Количество внесенных/изъятых купюр данного номинала |
moneyoperation_props
Загрузка информации об операциях внесения/изъятия денежных средств из денежного ящика, выполняемых при оплате товара заказанного через интернет магазин.
Название поля | Тип данных | Описание |
| store | varchar(100) | Код магазина в рамках значений внешней системы |
| cash_number | int(11) | Номер кассы |
| cash_id | int(11) | Идентификатор кассового терминала |
| id | bigint(20) unsigned | Идентификатор записи |
| courier_order | int(11) | Флаг, устанавливаемый в случае выполнения операции Возврат средств, совершаемой автоматически при оплате товара, доставляемого покупателю курьером |
receipt
Информация о заголовках, результатах формирования и итоговых суммах чеков, а также информации о следующих типах связи между чеками: связь между чеком на возврат и исходным чеком на продажу товаров; связь между отложенным чеком и исходным чеком на продажу товаров.
Название поля | Тип данных | Описание |
| store | varchar(100) | Код магазина в рамках значений внешней системы |
| cash_number | int(11) | Номер кассы |
| cash_id | int(11) | Идентификатор кассового терминала |
| id | bigint(20) unsigned | Идентификационный номер чека |
| global_number | bigint(20) unsigned | Порядковый номер документа за время функционирования cистемы |
| local_number | bigint(20) unsigned | Порядковый номер чека за текущую смену. Значение обнуляется после закрытия смены |
| type | bigint(20) unsigned | 0 – чек на продажу; 1 – чек на возврат; 4 – чек на возврат по чеку; 5 – восстановленный чек; 7 – чек инвентаризации; 8 – чек на продажу, в котором была применена хотя бы одна нефискальная оплата; 9 – возврат по чеку, в котором была применена хотя бы одна нефискальная оплата; 10 – чек на возврат, в котором была применена хотя бы одна нефискальная оплата. |
| stock_id | bigint(20,0) unsigned | Идентификатор отдела, в котором продавался товар |
| stock_name | varchar(100) | Название отдела |
| client | varchar(40) | Идентификатор зарегистрированного в чеке клиента |
| login | bigint(20) unsigned | Идентификационный номер записи с данными о кассире, сформировавшем чек |
| shift_open | bigint(20) unsigned | Идентификационный номер смены |
| date | datetime | Дата и время формирования чека |
| pos | int(11) | Заполняется для чеков на возврат или восстановленных чеков. Номер кассового терминала, на котором сформировался исходный чек на продажу товаров |
| invoice_number | varchar(100) | Номер счета-фактуры |
| link_receipt | bigint(20) unsigned | Идентификатор исходного чека на продажу товаров. Заполняется для операций возвратов или восстановленных чеков |
| link_cash_id | bigint(20) unsigned | Идентификатор кассового терминала, на котором сформировался исходный чек |
| amount | decimal(20,4) | Итоговая сумма чека |
| items_count | bigint(20) unsigned | Количество строк с товарными позициями в чеке |
| result | bigint(20) unsigned | Результат формирования чека, может принимать одно из следующих значений: 0 – формирование чека завершено успешно; 1 – чек аннулирован; 2 – чек отложен; 3 – чек разрушен (произошел сбой при открытом чеке); 4 – нормальное окончание чека инвентаризации |
| footer_date | datetime | Дата и время формирования концовки чека |
| client_card_code | varchar(40) | Номер карты клиента, по которой он был идентифицирован при расчете. Если идентификация осуществлялась не по карте (или клиент вообще не был зарегистрирован), то поле пустое |
| ext_processed | int(11) | Используется для сигнализации об обработке записи |
Запись информации о чеке (имеется в виду информация во всех таблицах, связанных с чеком): считается законченной тогда, когда в данной таблице будет заполнено поле result).
receipt_discount_gifts
Выданные подарки (хранение результатов скидок типа подарок).
Название поля | Тип данных | Описание |
| store | varchar(100) | Код магазина в рамках значений внешней системы |
| cash_number | int(11) | Номер кассы |
| cash_id | integer(11) | Идентификатор кассового терминала |
| id | bigint(20) | Идентификационный номер чека |
| receipt_discount | bigint(20) | Идентификатор записи о скидке в чеке (ссылка на #receipt_discounts) |
| item | varchar(40) | Код товара |
| item_name | varchar(40) | Название товара |
| amount | decimal(20,3) | Стоимость подарка (сумма скидки) |
receipt_discount_adder
Состояние накопительного сумматора клиента в чеке (значения накопительных сумм клиентов для скидок).
Название поля | Тип данных | Описание |
| store | varchar(100) | Код магазина в рамках значений внешней системы |
| cash_number | int(11) | Номер кассы |
| cash_id | integer(11) | Идентификатор кассового терминала |
| id | bigint(20) | Идентификационный номер чека |
| discount_id | bigint(20) | Идентификатор скидки (ссылка на #receipt_discounts) |
| client_id | varchar(40) | Код клиента |
| adder_type | integer(11) | Тип сумматора |
| name | varchar(40) | Название сумматора |
| amount | decimal(20,4) | Накопленная сумма (значение скидки) |
receipt_discount_properties
Свойства алгоритма скидок.
Название поля | Тип данных | Описание |
| store | varchar(100) | Код магазина в рамках значений внешней системы |
| cash_number | int(11) | Номер кассы |
| cash_id | integer(11) | Идентификатор кассового терминала |
| id | bigint(20) | Идентификационный номер чека |
| receipt_discount | bigint(20) | Идентификатор записи о скидке в чеке (ссылка на #receipt_discounts) |
| code | int(11) | Код свойства |
| value | text | Значение свойства |
receipt_discount_item_properties
Свойства скидок на товарную позицию чека.
Название поля | Тип данных | Описание |
| store | varchar(100) | Код магазина в рамках значений внешней системы |
| cash_number | int(11) | Номер кассы |
| cash_id | integer(11) | Идентификатор кассового терминала |
| id | bigint(20) | Идентификационный номер чека |
| receipt_item_discount | bigint(20) | Идентификатор записи о скидке в чеке (ссылка на #receipt_discounts) |
| code | int(11) | Код свойства |
| value | text | Значение свойства |
receipt_discounts
Информация о назначенных скидках.
Название поля | Тип данных | Описание |
| store | varchar(100) | Код магазина в рамках значений внешней системы |
| cash_number | int(11) | Номер кассы |
| cash_id | integer(11) | Идентификатор кассового терминала |
| id | bigint(20) unsigned | Идентификационный номер записи |
| receipt_header | bigint(20) unsigned | Идентификационный номер заголовка чека, к которому применена скидка |
| name | varchar(100) | Название скидки |
| type | tinyint(4) | Поле зарезервировано |
| discount_type | bigint(20) | Идентификатор скидки |
| card_type | integer(11) unsigned | Идентификатор типа дисконтной карты |
| card_number | varchar(40) | Номер кредитной карты. Если карта не использовалась, поле не заполнено |
| marketing_effort_id | bigint(20) | Идентификатор маркетинговой схемы |
| marketing_effort_name | varchar(100) | Название маркетинговой схемы |
| advertising_campaign_id | bigint(20) | Идентификатор рекламной акции |
| advertising_campaign_name | varchar(100) | Название рекламной акции |
receipt_item
Информация о товарных позициях чеков.
Название поля | Тип данных | Описание |
| store | varchar(100) | Код магазина в рамках значений внешней системы |
| cash_number | int(11) | Номер кассы |
| cash_id | integer(11) | Идентификатор кассового терминала |
| id | bigint(20) unsigned | Порядковый номер товарной позиции за время функционирования системы (позиции чеков имеют сквозную нумерацию в рамках кассы) |
| receipt_header | bigint(20) unsigned | Идентификационный номер заголовка чека, к которому относится товарная позиция |
| var | varchar(40) | Идентификационный код, по которому пользователь нашел товарную позицию в системе (штрихкод). Если товар был введен по артикулу, то NULL |
| item | varchar(40) | Артикул |
| name | varchar(255) | Название товарной позиции, напечатанное в чеке |
| var_quantity | decimal(20,4) | Количество товара в упаковке (для товара, продающегося упаковками) |
| quantity | decimal(20,4) | Количество товара данной позиции, введенное пользователем |
| total_quantity | decimal(20,4) | Общее количество товара данной товарной позиции. Значение поля равно произведению полей var_quantity и quantity |
| price | decimal(20,4) | Цена товарной позиции |
| min_price | decimal(20,4) | Пороговое значение цены товара (цена товара с учетом скидок не может быть меньше этого значения) |
| blocked_discount | tinyint(1) | Признак блокировки скидки для данной позиции чека. Признак используется для услуги |
| total | decimal(20,4) | Сумма оплаты товарной позиции. Значение поля равно произведению полей total_quantity и price |
| stock_id | bigint(20) unsigned | Идентификатор отдела, в котором продавался товар |
| stock_name | varchar(100) | Название отдела |
| measurement | varchar(100) | Единица измерения количества товара (название) (кг, шт, …) |
| measurement_precision | bigint(20) unsigned | Точность единицы измерения количества товара |
| classif | varchar(40) | Идентификационный номер группы товара (классификатор) |
| type | bigint(20) unsigned | Тип товарной позиции в чеке: 0 – нормальная; 1 – аннулированная; 2 - сторнирующая; 3 - сторнированная |
| input | bigint(20) unsigned | Способ ввода пользователем товарной позиции при формировании чека: 0 – сканером; 1 – с клавиатуры; 2 – по «горячей» клавише |
| tax | Integer(11) | Идентификатор налоговой группы на данную товарную позицию |
| position | integer(11) | Порядковый номер товарной позиции в чеке |
| remain | decimal(20,4) | Остаток товара на момент продажи. Значение берется из внешней системы |
| pricelist | integer(11) unsigned | Идентификационный номер прайс-листа, если он был назначен (NULL для основного прайс-листа) |
| real_amount | decimal(20,4) | Сумма, которую заплатил покупатель за товарную позицию чека с учетом всех скидок |
| seller_name | varchar(100) | ФИО продавца, если он зарегистрирован для позиции |
| seller_code | varchar(50) | Код продавца, если он зарегистрирован для позиции |
| sold_by_promo_price | tinyint(1) | Признак, что товар продан по акционной цене |
| init_price | decimal(20,4) | Исходная цена товара |
receipt_item_kiz_marks
Товарные позиции в чеках – с маркировкой DataMatrix.
Название поля | Тип данных | Описание |
| cash_id | int(11) | ID кассы |
| id | bigint(20) unsigned | ID позиции |
| receipt_header | bigint(20) unsigned | ID заголовка чека |
| mark_type | int(11) | Тип маркировки |
| kiz | varchar(255) | Штрихкод (полная маркировка) |
| serial_number | varchar(40) | Серийный номер |
| max_price | decimal(20,4) | Максимальная розничная цена (МкРЦ) |
receipt_item_discount
Информация о скидках/наценках, назначенных на товарные позиции чеков.
Название поля | Тип данных | Описание |
| store | varchar(100) | Код магазина в рамках значений внешней системы |
| cash_number | int(11) | Номер кассы |
| cash_id | int(11) | Идентификатор кассового терминала |
| id | bigint(20) unsigned | Идентификатор записи |
| receipt_item | bigint(20) unsigned | Идентификатор товарной позиции, на которую назначена скидка/наценка |
| base_total | decimal(20,4) | Стоимость товарной позиции до назначения скидки/наценки |
| increment | decimal(20,4) | Абсолютная величина скидки/наценки на товарную позицию. Знак минус перед величиной обозначает, что указанная величина является скидкой, отсутствие знака – наценкой |
| receipt_discount | bigint(20) unsigned | Идентификатор скидки |
| sequence | tinyint(4) | Порядковый номер назначения скидки при одновременном назначении нескольких скидок |
account_increment | decimal(20,4) | Сумма бонусов, списанных/начисленных в результате работы скидки |
receipt_item_properties
Информация о дополнительных свойствах проданных товаров.
Название поля | Тип данных | Описание |
| store | varchar(100) | Код магазина в рамках значений внешней системы |
| cash_number | int(11) | Номер кассы |
| cash_id | integer(11) | Идентификатор кассового терминала |
| id | bigint(20) unsigned | Идентификатор записи |
| receipt_item | bigint(20) unsigned | Идентификатор товарной позиции |
| code | varchar(20) | Код свойства (для item_cc – имя поля) |
| display_name | varchar(40) | Название свойства, отображаемое системой на дисплее кассира |
| value_id | integer(11) unsigned | Идентификатор значения свойства |
| value | varchar(40) | Значение свойства |
receipt_item_tax
Информация о связи налога с товарной позицией.
Название поля | Тип данных | Описание |
| store | varchar(100) | Код магазина в рамках значений внешней системы |
| cash_number | int(11) | Номер кассы |
| cash_id | integer(11) | Идентификатор кассового терминала |
| id | bigint(20) unsigned | Идентификатор записи |
| receipt_item | bigint(20) unsigned | Идентификатор товара |
| receipt_tax | bigint(20) unsigned | Идентификатор налога |
receipt_payment
Хранение информации о платежах клиентов по чекам.
Название поля | Тип данных | Описание |
| store | varchar(100) | Код магазина в рамках значений внешней системы |
| cash_number | int(11) | Номер кассы |
| cash_id | int(11) | Идентификационный номер кассового терминала |
| id | bigint(20) unsigned | Идентификационный номер платежа |
| receipt_header | bigint(20) unsigned | Идентификационный номер заголовка чека, к которому относится платеж |
| type | bigint(20) unsigned | Тип платежа: 0 – нормально проведенный платеж; 2 – отмена платежа, в случае если он аннулирован или отложен; 3 – выдача сдачи |
| payment_id | bigint(20) unsigned | Идентификационный номер платежного средства |
| payment_name | varchar(100) | Название платежного средства |
| pinpad_id | bigint(20) unsigned | ID пинпада |
| efts | bigint(20) | Код способа авторизации платежного средства |
| amount | decimal(20,4) | Сумма платежа |
| amount_witn_change | decimal (20,4) | Сумма платежных средств, предоставленных клиентом для оплаты товаров (до выдачи клиенту сдачи) |
cookies | text | Сохраненные данные платежа для обмена со внешней системой |
| card_number | varchar(128) | Номер кредитной карты. Если карта не использовалась, поле не заполнено |
| card_type | varchar(64) | Тип карты |
| auth_code | varchar(100) | Код авторизации |
receipt_tax
Информация о налогах, отображенных в чеках. Информация о налогах, начисленных на аннулированные и сторнированные товарные позиции, в базе данных не сохраняется.
Название поля | Тип данных | Описание |
| store | varchar(100) | Код магазина в рамках значений внешней системы |
| cash_number | int(11) | Номер кассы |
| cash_id | integer(11) | Идентификатор кассового терминала |
| id | bigint(20) unsigned | Идентификатор записи |
| taxgroup_id | int(11) | Идентификатор налоговой группы |
| tax_id | int(11) | Идентификатор налога |
| name | varchar(40) | Название налога |
| percent | varchar(20) | Ставка налога, задается в формате [+/-]число[%] |
| priority | tinyint(4) | Приоритет налога, определяет очередность расчета налога из стоимости товара. Чем выше значение приоритета, тем раньше рассчитывается величина налога. Налоги с одинаковым приоритетом рассчитываются одновременно (выделяются из одинаковой стоимости) |
| amount | decimal(20,4) | Величина налога |
shift
Хранение информации об открытии и закрытии смены. Смена открывается пользователем, вошедшим в систему. В открытой смене могут работать и другие пользователи. Закрыть смену может любой пользователь, вошедший в систему.
Название поля | Тип данных | Описание |
| store | varchar(100) | Код магазина в рамках значений внешней системы |
| cash_number | int(11) | Номер кассы |
| cash_id | int(11) | Идентификационный номер кассового терминала |
| id | bigint(20) unsigned | Идентификационный номер записи |
| number | bigint(20) unsigned | Порядковый номер смены |
| login | bigint(20) unsigned | Идентификационный номер записи, хранящей данные о пользователе, открывшем смену |
| date | datetime | Дата и время открытия смены |
| sale | decimal(20,4) | Общая сумма продаж в системе на момент открытия смены (накопительным итогом с первой смены) |
| return | decimal(20,4) | Общая сумма возвратов в системе на момент открытия смены (накопительным итогом с первой смены) |
| cancel | decimal(20,4) | Общая сумма аннулированных продаж в системе на момент открытия смены (накопительным итогом с первой смены) |
| cancel_return | decimal(20,4) | Общая сумма аннулированных возвратов в системе на момент открытия смены (накопительным итогом с первой смены) |
| close_login | bigint(20) unsigned | Идентификационный номер записи, хранящей данные о пользователе, закрывшем смену |
| close_date | datetime | Дата и время закрытия смены |
Для каждой смены информация в данную таблицу записывается дважды – один раз при открытии смены и второй раз (в эту же запись) при закрытии смены. Таким образом, смена считается закрытой тогда, когда для нее заполнено поле close_date.
shift_result
Передача во внешнюю систему информации о сумме в разрезе УКМ 4 и фискального регистратора.
Название поля | Тип данных | Описание |
| store | varchar(100) | Идентификатор магазина |
| cash_number | int(11) | Номер кассы |
| cash_id | int(11) | Идентификатор кассы |
| id | bigint(20) unsigned | Идентификатор смены |
| receipts_sale_ukm | bigint(20) unsigned | Сумма продаж по данным УКМ 4 |
| receipts_return_ukm | int(11) | Сумма возвратов по данным УКМ 4 |
| receipts_cancel_ukm | int(11) | Cумма отмен по данным УКМ 4 |
| fiscal_sale_ukm | decimal(20,4) | Cумма фискальных продаж по данным УКМ 4 |
| nonfiscal_sale_ukm | decimal(20,4) | Cумма нефискальных продаж по данным УКМ 4 |
| fiscal_return_ukm | decimal(20,4) | Cумма фискальных возвратов по данным УКМ 4 |
| nonfiscal_return_ukm | decimal(20,4) | Cумма нефискальных возвратов по данным УКМ 4 |
| cumulatively_sale_ukm | decimal(20,4) | Количество продаж по данным УКМ 4 |
| shift_number_kkm | bigint(20) | Номер смены в фискального регистратора |
| serial_number_kkm | varchar(40) | Cерийный номер фискального регистратора |
| registration_number_kkm | varchar(40) | Регистрационный номер фискального регистратора |
| receipts_sale_kkm | int(11) | Cумма продаж по данным фискального регистратора |
| receipts_return_kkm | int(11) | Cумма возвратов по данным фискального регистратора |
| receipts_cancel_kkm | int(11) | Cумма отмен по данным фискального регистратора |
| sale_kkm | decimal(20,4) | Значение накопительного счетчика фискального регистратора |
| cumulatively_sale_kkm | decimal(20,4) | Количество продаж по данным фискального регистратора |
shift_result_payments
Передача во внешнюю систему информации о суммах за смену с разбиением по видам оплаты.
Название поля | Тип данных | Описание |
| store | varchar(100) | Идентификатор магазина |
| cash_number | int(11) | Номер кассы |
| cash_id | int(11) | Идентификатор кассы |
| id | bigint(20) unsigned | Идентификатор смены |
| payment_id | bigint(20) unsigned | Идентификатор вида оплаты |
| payment_name | varchar(100) | Название вида оплаты |
| is_cash | tinyint(1) | Фискальный признак |
| is_local | tinyint(1) | Признак денежного ящика |
| sale_ukm | decimal(20,4) | Сумма продаж по данным УКМ 4 |
| return_ukm | decimal(20,4) | Сумма возвратов по данным УКМ 4 |
| sale_kkm | decimal(20,4) | Сумма продаж по данным фискального регистратора |
| return_kkm | decimal(20,4) | Сумма возвратов по данным фискального регистратора |
document
Данные о документах приемки/инвентаризации/ревизии.
Название поля | Тип данных | Описание |
| store_id | varchar(40) | Идентификатор магазина |
| id | varchar(40) | Идентификатор документа |
| number | varchar(40) | Номер приходной накладной (asn_nbr) |
| 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(100) | Номер машины поставщика |
| shipper | varchar(40) | Грузоотправитель |
| payer | varchar(40) | Плательщик |
| reason_number | varchar(40) | Номер накладной или заказа поставщику |
| reason_date | datetime | Дата договора или заказа поставщику |
| container | int(11) | Количество контейнеров в поставке |
| alt_type | varchar(40) | Альтернативный (внешний) тип документа |
| 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(100) | ФИО водителя-экспедитора |
| handle_type | varchar(40) | Внешний тип поставки |
| stream | varchar(40) | Поток |
| command_client | varchar(100) | Номер СС имя клиента (из документов ASN-SRT) |
| confirm_date | datetime | Дата подтверждения |
| attempt | int(11) | Номер итерации приемки |
| bp | varchar(40) | Идентификатор бизнес-процесса |
| act_type | int(11) | Тип акта (ревизия/инвентаризация) |
acceptance_items
Данные о фактической спецификации приходной накладной.
Название поля | Тип данных | Описание |
| store_id | varchar(40) | Код магазина в рамках значений внешней системы |
| document | varchar(40) | Идентификатор документа |
| attempt | int(11) | Итерация приемки |
| item | varchar(40) | Артикул товара |
| var | varchar(40) | Штрихкод товара |
| quantity | decimal(20,4) | Принятое количество |
| tax | decimal(20,4) | Налог |
| amount | decimal(20,4) | Сумма |
| title | varchar(100) | Примечание |
| appeal_reason | vachar(40) | Причина отказа |
| sequence | int(11) | Порядковый номер |
acceptance_items_defect
Данные о непринятых товарах.
Название поля | Тип данных | Описание |
| store_id | varchar(40) | Код магазина в рамках значений внешней системы |
| document | varchar(40) | Идентификатор документа |
| attempt | int(11) | Итерация приемки |
| item | varchar(40) | Артикул товара |
| defect_code | varchar(40) | Код брака |
| quantity | decimal(20,4) | Количество брака |
| comments | varchar(100) | Комментарий |
| sequence | int(11) | Порядковый номер |
oper_day
Передача информации об операционном дне.
Название поля | Тип данных | Описание |
| store_id | varchar(40) | Код магазина в рамках значений внешней системы |
| date | date | Дата операционного дня |
| comment | text | Комментарий |
| responsible_cashier | varchar(40) | Идентификатор старшего кассира, ответственного за операционный день |
| user | varchar(40) | Идентификатор пользователя, который работал с операционным днем последним |
| close_date | datetime | Дата закрытия |
receipt_kkm
Реквизиты ККМ, на которой был пробит чек.
Название поля | Тип данных | Описание |
| store | varchar(100) | Идентификатор магазина |
| cash_number | int(11) | Номер кассы |
| cash_id | int(11) | Идентификатор кассы |
| receipt_header | bigint(20) | Идентификатор чека |
| kkm_serial_number | varchar(40) | Серийный номер фискального регистратора |
| kkm_owner_number | varchar(40) | ИНН владельца фискального регистратора |
| kkm_model_name | varchar(40) | Название модели ККМ |
sap_crm_offline
Транзакции системы лояльности SAP CRM.
Название поля | Тип данных | Описание |
| cash_id | bigint(20) | Идентификатор кассы |
| id | bigint(20) | Уникальный идентификатор транзакции |
| datetime_gr | datetime | Дата и время совершения транзакции по Гринвичу |
| timezone | varchar(6) | Часовой пояс |
| store_id_ex | varchar(40) | Внешний идентификатор магазина (идентификатор в SAP) |
| pos_num | int(11) | Номер кассы |
| card_num | varchar(40) | Номер карты |
| tr_type | varchar(10) | Тип (on / off / external) |
| service_code | varchar(10) | Код веб-сервиса запроса (С1, С2, С3 и т.д.) |
| request | text | Запрос |
| response | text | Ответ |
| receipt_id | bigint(20) | Идентификатор чека |
receipt_external_orders
Заказы Global. Заказы в чеках.
Название поля | Тип данных | Описание |
| store | varchar(100) | Идентификатор магазина |
| cash_id | bigint(20) | Идентификатор кассы |
| id | bigint(20) | Идентификатор чека (receipt.id) |
| order_id | bigint(20) | Идентификатор заказа |
| ext_order_type | varchar(100) | Тип системы, в которой был сделан заказ |
| ext_order_id | varchar(100) | Номер заказа, присвоенный системой, в которой он был сделан |
| order_date | datetime | Дата создания заказа |
| status | tinyint(5) | Статус заказа, полученный после обработки (может быть NULL для аннулированных или возвратных чеков): 2 – оплачен; 4 – выкупается; 5 – выкуплен |
| appeal_code | varchar(100) | Код причины неполного выкупа |
| appeal_title | varchar(255) | Описание причины неполного выкупа |
| appeal_comment | varchar(40) | Комментарий при неполном выкупе (опционально) |
При загрузке будет проверяться наличие в базе УКМ 4 заказа с таким же «уникальным идентификатором заказа» (order_id), как и у загружаемого. Если заказ существует, то будет выполнена проверка допустимости загружаемого статуса. Если выполняется хотя бы одно из условий, описанных в таблице ниже, то запись в базу загружаться не будет, в журнал сервера будет добавлено сообщение о неверном статусе. Загрузка остальных заказов будет продолжена.
Статус загружаемого заказа | Статус заказа в базе УКМ 4 |
| Аннулирован | Оплачен, выкуплен |
| Ожидает оплаты | Оплачен, выкуплен, выкупается |
| Ожидает выкупа | Оплачен, выкуплен, выкупается |
receipt_external_order_items
Заказы Global. Товарные позиции в чеках, оформленные по заказу.
Название поля | Тип данных | Описание |
| store | varchar(100) | Идентификатор магазина |
| cash_id | bigint(20) | Идентификатор кассы |
| receipt_item_id | bigint(20) | Идентификатор товарной позиции в чеке (receipt_item.id) |
| order_id | bigint(20) | Идентификатор заказа Global |
| item | varchar(40) | Артикул товара |
receipt_header_return
Информация по чеку на возврат.
Название поля | Тип данных | Описание |
| store | varchar(100) | Идентификатор магазина |
| cash_number | int(11) | Номер кассы |
| cash_id | bigint(20) | Идентификатор кассы |
| id | bigint(20) unsigned | Идентификатор чека |
| return_type | bigint(20) | 0 – Возврат через оформление чеком |
receipt_discount_coupons
Напечатанные суммовые купоны.
Название поля | Тип данных | Описание |
| store | varchar(100) | Идентификатор магазина |
| cash_number | int(11) | Номер кассы |
| cash_id | bigint(20) | Идентификатор кассы |
| receipt_discount | bigint(20) unsigned | Идентификатор скидки, выдавшей купон |
| coupon_order | int(3) | Порядковый номер купона в чеке |
| amount | decimal(20,4) | Сумма купона |
| coupon_type | int(11) | Идентификатор типа купона |
| coupon_type_name | varchar(100) | Название типа купона |
| number | varchar(25) | Номер купона |
receipt_discount_coupons_accept
Принятые суммовые купоны в чеке.
Название поля | Тип данных | Описание |
|---|---|---|
| store | varchar(100) | Идентификатор магазина |
| cash_number | int(11) | Номер кассы |
| cash_id | bigint(20) unsigned | Идентификатор кассы |
| receipt_discount | bigint(20) unsigned | Идентификатор скидки, принявшей купон |
| coupon_order | int(3) unsigned | Порядковый номер купона в чеке |
| amount | decimal(20,4) | Сумма купона |
| coupon_type | int(11) | Идентификатор типа купона |
| coupon_type_name | varchar(100) | Название типа купона |
| number | varchar(25) | Номер купона |
loyality_transactions
Транзакции внешних систем лояльности.
Название поля | Тип данных | Описание |
|---|---|---|
| store | varchar(100) | Идентификатор магазина |
| cash_number | int(11) | Номер кассы |
| cash_id | int(11) | Идентификатор кассы |
| efts | int(11) | Код способа авторизации платежного средства |
| transaction_id | varchar(50) | Идентификационный номер транзакции |
| receipt_header | bigint(20) unsigned | Идентификационный номер заголовка чека, к которому применена скидка |
| transaction_time | datetime | Время проведения транзакции |
| operation_type | int(4) | Бизнес-процесс (приход товара, возврат от покупателя и т.д.) |
| operation_mode | int(4) | Режим проведения транзакции (0 – on-line, 1 – off-line) |
| card_num | varchar(128) | Номер карты |
| discount_amount | decimal(20,2) | Величина скидки |
| award_bonuses | decimal(20,2) | Начислено бонусов |
| used_bonuses | decimal(20,2) | Использовано бонусов |
| used_coupons | int(11) | Использовано купонов |
| award_coupons | int(11) | Начислено купонов |
| used_gifts | int(11) | Использовано подарков |
| is_canceled | tinyint(1) | Признак отмененной транзакции |
| orig_transaction_id | varchar(50) | Внешний идентификатор отмененной транзакции для операции отмены транзакции |
access_permissions
Разрешения на выполнение операций на кассе.
Название поля | Тип данных | Описание |
|---|---|---|
| store | varchar(100) | Идентификатор магазина |
| cash_number | int(11) | Номер кассы |
| cash_id | int(11) | Идентификатор кассы |
| efts | int(11) | Код способа авторизации платежного средства |
| receipt_id | bigint(20) unsigned | Идентификатор чека |
| receipt_item | bigint(20) unsigned | Идентификатор товарной позиции, на которую назначена скидка |
| user_id | bigint(19) | Идентификатор пользователя |
| user_name | varchar(100)) | Имя пользователя, вошедшего в систему |
| operation_code | int(11) | Код оператора |
| oper_date | datetime | Дата операции |
siebel_offline_receipt
Чеки Siebel, оформленные в off-line режиме.
Название поля | Тип данных | Описание |
|---|---|---|
| cash_id | bigint(20) unsigned | Идентификатор кассы |
| receipt_id | bigint(20) unsigned | Идентификатор чека |
| cheque_id | varchar(40) | Штрихкод чека |
| cash_number | int(11) | Номер кассы |
| shift_number | int(11) | Номер смены |
| cheque_number | int(11) | Номер чека |
| shop_index | varchar(40) | Индекс магазина |
| card_number | varchar(40) | Номер кредитной карты. Если карта не использовалась, поле не заполнено |
| auth_by_phone_number | tinyint(1) | Аутентификация по номеру телефона |
| cheque_open_date | datetime | Дата открытия чека |
| operation | tinyint(1) | Тип операции: 0 – продажа; 1 – возврат |
| purchase_cheque_id | varchar(40) | Идентификатор чека покупки |
| var_type | tinyint(1) | Вариант перехода в off-line режим: 1 или 2 |
siebel_offline_discount
Детализация скидок Siebel.
Название поля | Тип данных | Описание |
|---|---|---|
| cash_id | bigint(20) unsigned | Идентификатор кассы |
| item_id | bigint(20) unsigned | Идентификатор товарной позиции |
| cheque_id | varchar(40) | Штрихкод чека |
| pos_number | int(11) | Номер кассы |
| disc_id | varchar(100) | Идентификатор скидки |
| disc_summ | decimal(20,4) | Сумма скидки |
| disc_quantity | decimal(20,4) | Величина скидки |
| disc_barcode | varchar(40) | Штрихкод скидки |
siebel_offline_card
Примененные/выданные скидочные средства Siebel.
Название поля | Тип данных | Описание |
|---|---|---|
| cash_id | bigint(20) unsigned | Идентификатор кассы |
| item_id | bigint(20) unsigned | Идентификатор товарной позиции |
| cheque_id | varchar(40) | Штрихкод чека |
| barcode | varchar(40) | QR-код |
| card_type | tinyint(1) | Идентификатор типа дисконтной карты |
| barcode_number | int(11) | Номер QR-кода |
| card_use | tinyint(1) | Использовалась ли карта |
siebel_offline_certificate
Продажа/оплата подарочных сертификатов Siebel.
Название поля | Тип данных | Описание |
|---|---|---|
| cash_id | bigint(20) unsigned | Идентификатор кассы |
| item_id | bigint(20) unsigned | Идентификатор товарной позиции |
| cheque_id | varchar(40) | Штрихкод чека |
| barcode | varchar(40) | QR-код |
| card_use | tinyint(1) | Использовалась ли карта |
| summ | decimal(20,4) | Сумма чека |
siebel_offline_gifts
Подарки Siebel.
Название поля | Тип данных | Описание |
|---|---|---|
| cheque_id | varchar(40) | Штрихкод чека |
| gift_action_id | varchar(100) | Идентификатор выдачи подарка |
| gift_number | int(11) | Номер подарка |
| gift_disc_number | int(11) | Номер скидки, к которой относятся подарки |
| item | varchar(40) | Подарок |
| gift_quantity | int(11) | Количество подарков |
| gift_disc_barcode | varchar(40) | Номер купона, по которому выдан подарок |
receipt_item_agent
Хранение агентов позиции.
Название поля | Тип данных | Описание |
|---|---|---|
| store | varchar(100) | ID магазина |
| cash_id | int(11) | ID кассы |
| receipt_item | bigint(20) unsigned | ID позиции |
| item_agent_data | text | Теги, разделенные запятыми, в следующем порядке: 1222,1222Расшифровка,1075,1044,1073,1074,1026,1005,1016,1225,1171,1226 |
exportonly_data
Выгрузка дополнительных данных.
Название поля | Тип данных | Описание |
|---|---|---|
| store | varchar(100) | ID магазина из бэк-офиса; значение берется из настроек конвертера |
| cash_number | int(11) | Номер кассы |
| cash_id | bigint(20) unsigned | ID кассы |
| id | bigint(20) unsigned | ID записи |
| date | timestamp | Дата создания записи |
| code | tinytext | Код операции: константа; выдается под конкретную доработку |
| data | text | Данные в формате XML; cостав формируется индивидуально для конкретной доработки |
| ext_processed | int(11) | Поле, используемое внешними системами |
receipt_item_excise
Передача признака маркированного товара в чеке.
Название поля | Тип данных | Описание |
|---|---|---|
| cash_id | int(11) | Идентификатор кассового терминала |
| id | bigint(20) unsigned | Идентификатор товарной позиции |
| receipt_header | bigint(20) unsigned | Идентификационный номер заголовка чека, к которому относится товарная позиция |
| excise | tinyint(1) | Признак маркировки. Может принимать значения: 0 – неакцизный товар; 1 – маркированный товар; 2 – немаркированный товар; 3 – специальный маркированный товар; 4 – частично маркированный товар |
sub_excise | tinyint(1) | Признак подакцизности товара. Может принимать значения: 0 – неподакцизный товар; 1 – подакцизный товар |