2.1 - Выгрузка данных по реализации - XYYMMDDn.00N+
2.1 Выгрузка данных по реализации (редакция от 12 декабря 2025 года)
Имя файла с отчетом о продажах формируется следующим образом:
если смена закрыта, то используется шаблон:
XYYMMDDn.00N+
в противном случае используется шаблон:T##mmddn.00N+
где:
X – заглавная, латинская буква X
YY – год закрытия смены (две цифры)
MM – месяц закрытия смены (две цифры)
DD – день закрытия смены (две цифры)
n – номер кассы (одна, две или более цифр, в зависимости от этого номера)
00N+ – номер смены (либо дополнен нулями до трех символов, если это номер
менее 1000, либо расширен до необходимого количества)
T – заглавная, латинская буква T
## – внутренний циклический счетчик программы
mm – месяц формирования отчета
dd – день формирования отчета
Описание формата файла выгрузки: все суммы в отчете представлены в базовой валюте.
Заголовок отчета представляет собой строки вида: “параметр значение”, имя параметра и его значение разделены пробелом (0x20).
Признаком конца заголовка сменного отчета является пустая строка (пара символов с кодами 0x0D, 0x0A).
Примечание:
В качестве разделителя целой и дробной части при экспорте данных используется запятая.
В настройках IS-Kiosk есть возможность изменить разделитель.
Примечание:
При работе с несколькими ФР на одной кассе (с использованием справочника «Подключённые ФР»), формат имени файла содержит название используемого фискального регистратора («Наименование» из справочника «Подключённые ФР»). В этом случае имена файлов будут следующими:
XYYMMDDn_c.00N+
T##mmddn_c.00N+
где:
_ – разделитель
c – наименование подключенного ФР
2.1.1 Информация о кассовой смене
Обязательными являются следующие параметры:
|
Имя |
Описание |
|
Касса |
Номер кассы |
|
Смена |
Номер смены |
|
ФР |
Идентификатор ФР |
|
Zномер |
Номер Z-отчёта |
|
ИтогПродаж |
Общий итог продаж |
|
Возврат/аннулирование |
Общий итог возвратов и аннулирований. |
|
ПродажаНаличные |
Сумма продаж оформленных за наличные. |
|
ВозвратНаличные |
Сумма возвратов оформленных за наличные. |
|
ПродажаКарта |
Сумма продаж оформленных по безналу. |
|
ВозвратКарта |
Сумма возвратов оформленных по безналу. |
2.1.2 Формат заголовка документа
Документы (чеки) представлены в отчете в следующем формате:
|
Поле |
Размер [байт] |
Описание |
|
SIGN |
3 |
Сигнатура (ANSI строка ‘Чек’) |
|
- |
1 |
Разделитель пробел (символ с кодом 0x20) |
|
ID |
8 |
Идентификатор документа (номер счёта) |
|
/ |
1 |
Разделитель прямой слеш (символ с кодом 0x2F) |
|
FISCAL |
1 |
Признак фискальной операции 0 – документ зафискализирован 1 – документ сохранён |
|
XXX |
3 |
Резерв – ANSI строка из 3 символов ‘0’ (0x30) |
|
INN |
2 |
Идентификатор юридического лица – от 00 до 99 (не используется) |
|
- |
1 |
Разделитель пробел (символ с кодом 0x20) |
|
DATE |
8 |
Дата фискализации чека (в формате дд.мм.гг) |
|
- |
1 |
Разделитель пробел (символ с кодом 0x20) |
|
TIME |
8 |
Время суток фискализации чека (в формате чч:мм:сс) |
|
- |
1 |
Разделитель пробел (символ с кодом 0x20) |
|
TYPE |
1 |
Вид документа |
|
- |
1 |
Разделитель пробел (символ с кодом 0x20) |
|
TOTAL |
12 |
Сумма по чеку |
|
- |
1 |
Разделитель пробел (символ с кодом 0x20) |
|
SLID |
6 |
Код типа обслуживания (канала продажи) |
|
- |
1 |
Разделитель пробел (символ с кодом 0x20) |
|
UNICK |
0-20 |
Имя кассира |
|
@ |
1 |
Разделитель @ (символ с кодом 0x40) |
|
REMOTEID |
13 |
Идентификатор удалённого подразделения (объекта) |
|
- |
1 |
Разделитель пробел (символ с кодом 0x20) |
|
DOCNUM |
8 |
Номер документа (внутренний номер документа) |
|
- |
1 |
Разделитель пробел (символ с кодом 0x20) |
|
ORDERNUM |
8 |
Номер заказа, полученный из 1С (при работе с web-сервисом) |
|
EOL |
2 |
Возврат каретки и перевод строки (пара символов с кодами 0x0D, 0x0A соответственно) |
|
OK |
1 |
Признак успешного/неуспешного завершения чека (+/- соответственно) |
|
|
|
Данные о документе, на основании которого был оформлен возврат |
|
|
|
Товарная часть чека |
|
|
|
Денежная часть чека |
|
EOL |
2 |
Возврат каретки и перевод строки (пара символов с кодами 0x0D, 0x0A соответственно) |
Данные о документе, на основании которого был оформлен возврат, представлены в отчете в следующем формате:
|
Размер, [байт] |
Описание |
|
15 |
Сигнатура (ANSI строка ‘Возврат по чеку’) |
|
1 |
Разделитель пробел (символ с кодом 0x20) |
|
8 |
Идентификатор документа основания (номер счёта) |
|
1 |
Разделитель пробел (символ с кодом 0x20) |
|
2 |
Номер кассы, где был оформлен документ основание |
|
1 |
Разделитель пробел (символ с кодом 0x20) |
|
3 |
Номер смены, в рамках которой был оформлен документ основание |
|
2 |
Возврат каретки и перевод строки (пара символов с кодами 0x0D, 0x0A соответственно) |
2.1.3 Формат информации об устройстве оповещения
Данный раздел является необязательным и выгружается по параметру в системе.
Строка представляет собой xml-данные
Основной элемент: <bazzer>
| Описание элемента <bazzer> | |
| Атрибуты | Описание |
| bazzerNum | Номер устройства оповещения (номер баззера) |
| clientInfo | Информация о клиенте (например, имя клиента) |
2.1.4 Формат данных о применённом промокоде
Данный раздел является необязательным и выгружается по параметру в системе.
Строка представляет собой xml-данные
Основной элемент: <promo>
|
Описание элемента <promo> |
|
|
Атрибуты |
Описание |
|
promoCode |
Номер применённого промокода |
Пример строки:
<promo promoCode="1A2B3C4D5E6F7" />
2.1.5 Формат товарных позиций документа
Товарная часть чека представляет собой строки (количество которых определяется количеством товарных позиций чека) следующего формата:
|
Размер, [байт] |
Описание |
|
13 |
Идентификатор товара (Баркод) |
|
1 |
Разделитель пробел (символ с кодом 0x20) |
|
11 |
Количество товара (с точностью до 0.001) |
|
1 |
Разделитель пробел (символ с кодом 0x20) |
|
10 |
Сумма по позиции с учётом всех модификаторов (без учета скидки) |
|
1 |
Разделитель пробел (символ с кодом 0x20) |
|
10 |
Сумма по позиции с учётом всех модификаторов (с учетом скидки) |
|
1 |
Разделитель пробел (символ с кодом 0x20) |
|
10 |
Идентификатор схемы скидки (не используется) |
|
1 |
Разделитель пробел (символ с кодом 0x20) |
|
6 |
Идентификатор пользователя назначившего скидку (не используется) |
|
1 |
Разделитель пробел (символ с кодом 0x20) |
|
7 |
Процент скидки (с точностью до 0.01) |
|
1 |
Символ % (0x25) |
|
1 |
Разделитель пробел (символ с кодом 0x20) |
|
13 |
Идентификатор клиента (не используется) |
|
1 |
Разделитель пробел (символ с кодом 0x20) |
|
100 |
Комментарий к позиции |
|
1* |
Разделитель пробел (символ с кодом 0x20) |
|
50* |
Наименование позиции на языке по умолчанию |
|
2 |
Возврат каретки и перевод строки (пара символов с кодами 0x0D, 0x0A соответственно) |
Примечание:
Элементы, отмеченные * не отправляются при работе с web-сервисом.
2.1.6 Формат модификаторов товарных позиций
Модификаторы товара (позиции документа) - часть чека представляет собой строки (количество которых определяется количеством модификаторов у данной товарной позиций) следующего формата:
|
Размер, [байт] |
Описание |
|
1 |
Символ ~ тильда (символ с кодом 0x 7E) |
|
13 |
Идентификатор модификатора (Баркод) |
|
11 |
Количество модификатора для единицы позиции (с точностью до 0.001) |
|
1 |
Разделитель пробел (символ с кодом 0x20) |
|
10 |
Сумма по модификатору для единицы позиции (без учета скидки) |
|
1 |
Разделитель пробел (символ с кодом 0x20) |
|
10 |
Сумма по модификатору для единицы позиции (с учетом скидки) |
|
1 |
Разделитель пробел (символ с кодом 0x20) |
|
10 |
Идентификатор схемы скидки (не используется) |
|
1 |
Разделитель пробел (символ с кодом 0x20) |
|
6 |
Идентификатор пользователя назначившего скидку (не используется) |
|
1 |
Разделитель пробел (символ с кодом 0x20) |
|
7 |
Процент скидки (с точностью до 0.01) |
|
1 |
Символ % (0x25) |
|
1 |
Разделитель пробел (символ с кодом 0x20) |
|
13 |
Идентификатор клиента (не используется) |
|
1 |
Разделитель пробел (символ с кодом 0x20) |
|
100 |
Комментарий к позиции |
|
1* |
Разделитель пробел (символ с кодом 0x20) |
|
50* |
Наименование позиции на языке по умолчанию |
|
2 |
Возврат каретки и перевод строки (пара символов с кодами 0x0D, 0x0A соответственно) |
Примечание:
Элементы, отмеченные * не отправляются при работе с web-сервисом.
2.1.7 Информация о системе лояльности в заказе
Данный раздел является необязательным и выгружается только при работе с web-сервиса (API v2), если к заказу была применена дисконтная карта или авторизован клиент системы лояльности.
Строка представляет собой xml-данные
Основной элемент: <loyalty>
|
Описание элемента <loyalty> |
|
|
Атрибуты |
Описание |
|
loyaltyIdentity |
Внутренний идентификатор системы лояльности |
|
cardNumber |
Номер карты клиента (необязательный атрибут) |
|
clientPhone |
Телефон клиента (необязательный атрибут) |
|
holderIdentity |
Идентификатор клиента (необязательный атрибут) |
|
purchaseId |
Идентификатор исходной транзакции |
|
calculationPaymentId |
Внутренний идентификатор способа/типа оплаты заказа (или и дентификатор маркетинговой кампании) |
|
operationSum |
Сумма операции (например, списываемая сумма бонусов) |
Пример строки:
<loyalty loyaltyIdentity=\"{0FE14324-17CF-46BD-9E7D-C86528CE79C8}\" cardNumber=\"145133812448\" holderIdentity=\"145133812448\" clientPhone=\"+79216320451\" purchaseId=\"59672699357641766\" calculationPaymentId=\"2348745\" operationSum=\"10,00\"/>"
2.1.8 Формат типа оплаты документа
Денежная часть чека представляет собой строку следующего формата:
|
Размер, [байт] |
Описание |
|
5 |
Сигнатура (ANSI строка ‘Оплата’) |
|
1 |
Разделитель пробел (символ с кодом 0x20) |
|
1 |
Вид оплаты (1 – наличные, 2 – банковская карта и т.д.) |
|
1 |
Разделитель пробел (символ с кодом 0x20) |
|
12 |
Сумма оплаты |
|
1 |
Разделитель пробел (символ с кодом 0x20) |
|
$данные$ |
Закодированные данные по банковской карте (при оплате картой). Закодированные данные с двух сторон обрамлены символом $ |
|
20 |
Идентификатор продавца в банке-эквайере (MerchantId) |
|
2 |
Возврат каретки и перевод строки (пара символов с кодами 0x0D, 0x0A соответственно) |
2.1.9 Пример выгрузки
Касса 1
Смена 21
ФР Касса №1
Zномер 21
ИтогПродаж 924,00
Возврат/аннулирование 0,00
ПродажНал 0,00
ВозвратНал 0,00
ПродажКарта 240,65
ВозвратКарта 0,00
Чек 00000620/100000 19.02.22 18:54:00 1 229.65 000001 Администратор @00000006
00006 1,000 5.65 5.65 0 000000 0.00% 0000000000000 Комментарий к позиции Сок
00023 1,000 235.00 235.00 0 000000 0.00% 0000000000000 Картофель фри большой
~ 00021 2,000 60.00 60.00 0 000000 0.00% 0000000000000 Клюквенный соус + Лук
~ 00044 1,000 0.00 0.00 0 000000 0.00% 0000000000000 Бекон
~ 00042 1,000 25.00 25.00 0 000000 0.00% 0000000000000 Ветчина
~ 00018 1,000 0.00 0.00 0 000000 0.00% 0000000000000 Комментарий к модификатору Кисло-сладкий соус
~ 00017 1,000 30.00 30.00 0 000000 0.00% 0000000000000 Кофе Американо 0.4 л
~ 00020 1,000 0.00 0.00 0 000000 0.00% 0000000000000 Табаско соус
~ 00021 1,000 0.00 0.00 0 000000 0.00% 0000000000000 Клюквенный соус
%LoyaltyBonus 1.000 -11.00 -11.00 0 000000 0.00% 0000000000000
<loyalty loyaltyIdentity="{0FE14324-17CF-46BD-9E7D-C86528CE79C8}" cardNumber="145133812448" holderIdentity="145133812448" calculationPaymentId="2224284" operationSum="11.00"/>
Оплата 2 229.65 $NDQ0NDQ0NDQ0NDQ0NDQ0NCAgICAgMDAwMSAgICAgICAgICAgICAgICAgMzI0MiAgICAgICAgICAgICAgICAgMDIuMTEuMjIgMDA6MDA6MDA=$
+
2.1.10 Формат файла выгрузки списка проданных позиций
Имя файла выгрузки списка проданных позиций формируется следующим образом:
если смена закрыта, то используется шаблон:
SYYMMDDn.00N+
в противном случае используется шаблон:
S##mmddn.00N+
где:
X – заглавная, латинская буква X
YY – год закрытия смены (две цифры)
MM – месяц закрытия смены (две цифры)
DD – день закрытия смены (две цифры)
n – номер кассы (одна, две или более цифр, в зависимости от этого номера)
00N+ – номер смены (либо дополнен нулями до трех символов, если это номер менее 1000, либо расширен до необходимого количества)
S – заглавная, латинская буква S
## – внутренний циклический счетчик программы
mm – месяц формирования отчета
dd – день формирования отчета
Примечание:
При работе с несколькими ФР на одной кассе (с использованием справочника «Подключённые ФР»), формат имени файла содержит название используемого фискального регистратора («Наименование» из справочника «Подключённые ФР»). В этом случае имена файлов будут следующими:
XYYMMDDn_c.00N+
T##mmddn_c.00N+
где:
_ – разделитель
c – наименование подключенного ФР
Описание формата файла выгрузки: все суммы в отчете представлены в базовой валюте.
Файл состоит из списка проданных позиций или модификаторов
|
Размер, [байт] |
Описание |
|
13 |
Идентификатор товара (Баркод) |
|
1 |
Разделитель пробел (символ с кодом 0x20) |
|
50 |
Наименование позиции на языке по умолчанию |
|
1 |
Разделитель пробел (символ с кодом 0x20) |
|
10 |
Цена позиции (с точностью до 0.01) |
|
1 |
Разделитель пробел (символ с кодом 0x20) |
|
11 |
Количество товара (с точностью до 0.001) |
|
1 |
Разделитель пробел (символ с кодом 0x20) |
|
10 |
Сумма позиции без учёта модификаторов (с учетом скидки) |
|
2 |
Возврат каретки и перевод строки (пара символов с кодами 0x0D, 0x0A соответственно) |
Пример выгрузки:
00006 Сок 5,65 45,000 254,25
00023 Пицца Барбекю Куриная 19 120,00 7,000 840,00
00021 Клюквенный соус 30,00 16,000 480,00
00042 Ветчина 25,00 7,000 175,00
00038 Грибы 0,00 7,000 0,00
00039 Маслины 0,00 7,000 0,00
00018 Кисло-сладкий соус 0,00 9,000 0,00
2.1.11 Формат файла выгрузки списка персональной информации, предоставленной клиентом
Имя файла выгрузки персональной информации, предоставленной клиентом формируется следующим образом:
если смена закрыта, то используется шаблон:
СYYMMDDn.00N+
в противном случае используется шаблон:
С##mmddn.00N+
где:
X – заглавная, латинская буква X
YY – год закрытия смены (две цифры)
MM – месяц закрытия смены (две цифры)
DD – день закрытия смены (две цифры)
n – номер кассы (одна, две или более цифр, в зависимости от этого номера)
00N+ – номер смены (либо дополнен нулями до трех символов, если это номер
менее 1000, либо расширен до необходимого количества)
С – заглавная, латинская буква С
## – внутренний циклический счетчик программы
mm – месяц формирования отчета
dd – день формирования отчета
Описание формата файла выгрузки: файл состоит из ФИО и контактных данных, предоставленных клиентом. Ниже следующими строками отображается список выбранных услуг и товаров, которые заинтересовали клиента.