...
Чтобы подключить конвертер, перейдите в раздел веб-интерфейса Настройка сервера и оборудования – Конвертеры. В открывшемся окне нажмите кнопку +Добавить. Далее выберите из списка конвертер и нажмите +Создать:
...
Выгружать кассовые документы – при включении флага в базу данных будет выгружаться информация в разрезе товаров и видов оплат (устаревший функционал).
Выгружать чеки – при включении флага в базу данных будет выгружаться информация о всех чеках.
...
Кликните по ссылке Выгрузить данные. Откроется окно Ручная выгрузка:
В дополнение к описанным выше полям, в открывшейся форме появится несколько новых:
...
Внешняя система сама определяет порядок считывания чеков из базы экспорта – либо по мере появления новых чеков, либо после закрытия смены всех чеков, относящихся к ней. Для этого пользователи имеют возможность добавить в структуру базы данных в любую таблицу произвольное количество полей, названия которых начинаются с префикса ext_. Эти поля предназначены для обработки внешней системой и могут использоваться, например, в качестве флагов.
Для кассовых документов признаком подготовленности очередного кассового документа является появление записи в таблице 17697192. Внешняя система должна сама удалять обработанную информацию.
В случае если внешняя система ведет собственную нумерацию средств оплаты, используемых в кассовой системе, в конвертере предусмотрена возможность замены кодов видов оплат. Настройка выполняется в интерфейсе конвертера.
...
В таблицах ниже приведены лишь общие сведения о полях. Подробные характеристики каждого поля можно найти в полном SQL-файле, расположенном в веб-интерфейсе по ссылке Скрипт создания БД в настройках конвертера:
...
clients
Информация о зарегистрированных клиентах.
Название поля | Тип данных | Описание |
| cash_line_id | integervarchar(40) | Идентификатор клиента |
| classifclient | int(11) unsigned | Идентификатор магазинаstoreузла классификатора клиентов, которому принадлежит клиент |
| sur_name | varchar(100) | Магазин |
| id | integer(11) | Идентификационный номер записи |
| numberФамилия клиента (физического лица или ответственного закупщика юридического лица) | ||
| name | varchar(100) | Номер кассового документа в программе |
| date | datetime | Дата формирования кассового документа |
cashdoc_items
Спецификация кассового документа.
Название поля | Тип данных | Описание | ||
| cash_line_id | integer(11) | Идентификатор магазина | ||
| storeИмя клиента (физического лица или ответственного закупщика юридического лица) | ||||
| patronymic | varchar(100) | Отчество клиента (физического лица или ответственного закупщика юридического лица) | ||
| birthday | datetime | Дата рождения клиента (физического лица или ответственного закупщика юридического лица) | ||
| inn | varchar(100) | ИНН клиента | ||
| passport | varchar(100) | Магазин | id | integerПаспортные данные клиента (физического лица или ответственного закупщика юридического лица) |
| pricelist | int(11) | Идентификационный номер документа | type_saleПрайс-лист, назначенный клиенту | |
| type | tinyint(1) | Тип клиента: 0 – физ. лицо; 1 – юр. лицо | ||
| allow_paycash | tinyint(1) | Тип продажи (1 – оптовая; 0 – розничная/не установлена) | ||
| item | varchar(40) | Артикул товара | ||
| quantity | decimal(20,4) | Количество проданного товара | ||
| total | decimal(20,4) | Итоговая сумма по операции продажи для данного артикула без учета скидок за период формирования документа | ||
| discount | decumal(20,4) | Итоговая сумма скидок в чеках на продажу по данному артикулу за период формирования кассового документа | ||
| meanprice | decima(20,4) | Итоговая сумма по операции продажи по данному артикулу за период формирования кассового документа с учетом скидок. Цена рассчитывается системой как среднее значение цены | ||
| quantity_return | decimal(20,4) | Количество возвращенного товара | ||
| total_return | decimal(20,4) | Итоговая сумма по операции возврата товаров для данного артикула без учета скидок за период формирования документа | ||
| discount_return | decimal(20,4) | Итоговая сумма скидок по операции возврата товаров по данному артикулу за период формирования кассового документа | ||
| meanprice_return | decimal(20,4) | Итоговая сумма по операции возврата товаров по данному артикулу за период формирования кассового документа с учетом скидок. Цена рассчитывается системой как среднее значение цены |
cashdoc_payments
...
| Способ оплаты, используемый клиентом при расчете с магазином: 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
Выгрузка информации о дополнительных свойствах клиентов.
Название поля | Тип данных | Описание |
| cash_line_id | integervarchar(1140) | Идентификатор магазинасвойства |
| storename | varchar(100) | Магазин |
| id | integer(11) | Идентификационный номер записи |
| type_sale | tinyint(1) | Тип продажи (1 – оптовая; 0 – розничная/не установлена) |
| payment | integer(11) | Название вида оплаты |
| count | integer(11) | Итоговое количество операций, оплата которых производилась данным видом оплаты |
| sale | decimal(20,4) | Итоговая сумма по операции продажи по данному виду оплаты за период формирования кассового документа без учета скидок |
| return | decimal(20,4) | Итоговая сумма по операции возврата товаров с использованием данного вида оплаты за период формирования кассового документа без учета скидок |
| pinsert | DECIMAL(20,4) | Итоговая сумма по операции внесения средств данного вида оплаты в денежные ящики кассовых терминалов |
| pextract | DECIMAL(20,4) | Итоговая сумма по операции изъятия средств данного вида оплаты из денежного ящика кассовых терминалов |
cashdoc_statistic
...
| Название свойства |
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
Информация о результатах проведенных опросов.
Название поля | Тип данных | Описание |
| cash_linestore | varchar(100) | Код магазина в рамках значений внешней системы |
| cash_number | int(11) | Номер кассы |
| cash_id | integerbigint(1120) | Идентификатор магазина |
| store | varchar(100) | Магазин |
| id | integer(11) | Идентификационный номер документа |
| type_sale | tinyint(1) | Тип продажи (1 – оптовая; 0 – розничная/не установлена) |
| sale | decimal(20,4) | Итоговая сумма по операции продажа товаров по всем видам оплаты за период формирования кассового документа без учета скидок |
| return | decimal(20,4) | Итоговая сумма по операции возврат товаров по всем видам оплаты за период формирования кассового документа без учета скидок |
| cancel | decimal(20,4) | Итоговая сумма по операции аннулирования чеков на продажу |
| cancel_return | decimal(20,4) | Итоговая сумма по операции аннулирования чеков на возврат |
| discount | decimal(20,4) | Итоговая сумма скидок в чеках на продажу по всем видам оплаты за период формирования кассового документа |
| discount_return | decimal(20,4) | Итоговая сумма скидок в чеках на возврат по всем видам оплаты |
cashdoc_taxes
...
| кассового терминала | ||
| 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
Информация о выполнении операции внесения денежных средств в денежный ящик/изъятия денежных средств из денежного ящика, подключенного к ККМ.
Название поля | Тип данных | Описание | |
| cash_line_id | integer(11store | varchar(100) | Идентификатор Код магазина |
| store | varchar(100) | Магазин | |
| id | integerв рамках значений внешней системы | ||
| cash_number | int(11) | Номер кассы | |
| cash_id | int(11) | Идентификационный номер документа | |
| type_sale | tinyint(1) | Тип продажи (1 – оптовая; 0 – розничная/не установлена) | |
| amount | decimal(20,4) | Величина налога | |
| amount_return | decimal(20,4) | Возвращаемая величина налога | |
| tax_id | integer(11) | Идентификатор налога | |
| percent | varchar(20) | Ставка налога |
clients
Информация о зарегистрированных клиентах.
...
Название поля
...
Тип данных
...
Описание
...
0 – физ. лицо; 1 – юр. лицо
...
0 – только со счета; 1 – любым способом
...
0 – заблокирован; 1 – не заблокирован
...
clients_properties
Выгрузка информации о дополнительных свойствах клиентов.
...
Название поля
...
Тип данных
...
Описание
...
clients_properties_values
Выгрузка информации о значениях дополнительных свойствах клиентов.
...
Название поля
...
Тип данных
...
Описание
...
login
Информация о пользователе, вошедшем в систему и вышедшем из системы, и времени входа/выхода пользователя.
...
Название поля
...
Тип данных
...
Описание
...
inquirer_detailed_answer
Информация о результатах проведенных опросов.
...
Название поля
...
Тип данных
...
Описание
...
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 | Номер смены, в течение которой выполнялась операция внесения/изъятия денежных средствИдентификатор кассового терминала |
| 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) | Сумма средств в денежном ящике до внесения/изъятия |
...
Название поля | Тип данных | Описание | ||||||
| store | varchar(100) | Код магазина в рамках значений внешней системы | ||||||
| cash_number | int(11) | Номер кассы | ||||||
| cash_id | integer(11) | Идентификатор кассового терминала | ||||||
| id | bigint(20) unsigned | Порядковый номер товарной позиции за время функционирования системы (позиции чеков имеют сквозную нумерацию в рамках кассы) | ||||||
| receipt_header | bigint(20) unsigned | Идентификационный номер заголовка чека, к которому относится товарная позиция | ||||||
| var | varchar(40) | Идентификационный код, по которому пользователь нашел товарную позицию в системе (штрихкод). Если товар был введен по артикулу, то NULL | ||||||
| varchar(255) | Исходный штрих-код товара | ||||||
| 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) | Исходная цена товара |
...
Название поля | Тип данных | Описание | ||||||
| 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) | Порядковый номер назначения скидки при одновременном назначении нескольких скидок | ||||||
| decimal(20,4) | Сумма бонусов, списанных/начисленных в результате работы скидки |
receipt_item_properties
Информация о дополнительных свойствах проданных товаров.
...
Название поля | Тип данных | Описание | ||||||
| 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) | Сумма платежных средств, предоставленных клиентом для оплаты товаров (до выдачи клиенту сдачи) | ||||||
| text | Сохраненные данные платежа для обмена со внешней системой | ||||||
| card_number | varchar(128) | Номер кредитной карты. Если карта не использовалась, поле не заполнено | ||||||
| card_type | varchar(64) | Тип карты | ||||||
| auth_code | varchar(100) | Код авторизации |
...
Название поля | Тип данных | Описание |
|---|---|---|
| cheque_id | varchar(40) | Штрихкод чека |
| gift_action_id_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) | Идентификатор выдачи подарка | gift_numberID магазина |
| cash_id | int(11) | Номер подаркаID кассы | |
| giftreceipt_disc_numberitem | intbigint(1120) | Номер скидки, к которой относятся подарки | |
| item | varchar(40) | Подарок | |
| gift_quantity | int(11) | Количество подарков | |
| gift_disc_barcode | varchar(40) | Номер купона, по которому выдан подарок |
receipt_item_agent
...
| unsigned | ID позиции | |
| item_agent_data | text | Теги, разделенные запятыми, в следующем порядке: 1222,1222Расшифровка,1075,1044,1073,1074,1026,1005,1016,1225,1171,1226 |
| Якорь | ||||
|---|---|---|---|---|
|
Выгрузка дополнительных данных.
Название поля | Тип данных | Описание | |
|---|---|---|---|
| store | varchar(100) | ID магазинамагазина из бэк-офиса; значение берется из настроек конвертера | |
| cash_idnumber | int(11) | Номер кассы | |
| cash_id | bigint(20) unsigned | ID кассы | receipt_item|
| id | bigint(20) unsigned | ID | позицииitem_agent_записи |
| date | timestamp | Дата создания записи | |
| code | tinytext | Код операции: константа; выдается под конкретную доработку | |
| data | text | Теги, разделенные запятыми, в следующем порядке: 1222,1222, Расшифровка,1075,1044,1073,1074,1026,1005,1016,1225,1171,1226 |
...
| Данные в формате XML; cостав формируется индивидуально для конкретной доработки | ||
| ext_processed | int(11) | Поле, используемое внешними системами |
| Якорь | ||||
|---|---|---|---|---|
|
Передача признака маркированного товара в чеке.
Название поля | Тип данных | Описание | ||||||
|---|---|---|---|---|---|---|---|---|
| store | varchar(100) | ID магазина из бэк-офиса; значение берется из настроек конвертера | ||||||
| cash_numberid | int(11) | Номер кассы | cash_idИдентификатор кассового терминала | |||||
| id | bigint(20) | unsignedID кассы | idunsigned | Идентификатор товарной позиции | ||||
| receipt_header | bigint(20) unsigned | ID записи | ||||||
| date | timestamp | Дата создания записи | ||||||
| code | tinytext | Код операции: константа; выдается под конкретную доработку | ||||||
| data | text | Данные в формате XML; cостав формируется индивидуально для конкретной доработки | ||||||
| ext_processed | int(11) | Поле, используемое внешними системамиИдентификационный номер заголовка чека, к которому относится товарная позиция | ||||||
| excise | tinyint(1) | Признак маркировки. Может принимать значения: 0 – неакцизный товар; 1 – маркированный товар; 2 – немаркированный товар; 3 – специальный маркированный товар; 4 – частично маркированный товар | ||||||
| tinyint(1) | Признак подакцизности товара. Может принимать значения: 0 – неподакцизный товар; 1 – подакцизный товар |