2.1 - Выгрузка данных по реализации - XYYMMDDn.00N+
2.1 Выгрузка данных по реализации (редакция от 11 июля 2025 года)
Имя файла с отчетом о продажах формируется следующим образом:
если смена закрыта, то используется шаблон:
XYYMMDDn.00N+
в противном случае используется шаблон:T##mmddn.00N+
где:
X – заглавная, латинская буква X
YY – год закрытия смены (две цифры)
MM – месяц закрытия смены (две цифры)
DD – день закрытия смены (две цифры)
n – номер кассы (одна, две или более цифр, в зависимости от этого номера)
00N+ – номер смены (либо дополнен нулями до трех символов, если это номер
менее 1000, либо расширен до необходимого количества)
T – заглавная, латинская буква T
## – внутренний циклический счетчик программы
mm – месяц формирования отчета
dd – день формирования отчета
Описание формата файла выгрузки: все суммы в отчете представлены в базовой валюте.
Заголовок отчета представляет собой строки вида: “параметр значение”, имя параметра и его значение разделены пробелом (0x20).
Признаком конца заголовка сменного отчета является пустая строка (пара символов с кодами 0x0D, 0x0A).
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 Информация о системе лояльности в заказе
Данный раздел является необязательным и выгружается, если к заказу была применена дисконтная карта или авторизован клиент системы лояльности.
Строка представляет собой xml-данные
Основной элемент: <loyalty>
Описание элемента <loyalty> |
|
Атрибуты |
Описание |
loyaltyIdentity |
Внутренний идентификатор системы лояльности |
cardNumber |
Номер карты клиента (необязательный атрибут) |
clientPhone |
Телефон клиента (необязательный атрибут) |
holderIdentity |
Идентификатор клиента (необязательный атрибут) |
calculationPaymentId |
Внутренний идентификатор способа/типа оплаты заказа (или и дентификатор маркетинговой кампании) |
operationSum |
Сумма операции (например, списываемая сумма бонусов) |
Пример строки:
<loyalty loyaltyIdentity="{0FE14324-17CF-46BD-9E7D-C86528CE79C8}" cardNumber="145133812448" holderIdentity="145133812448" calculationPaymentId="2224284" operationSum="11.00"/>
Пример документа с авторизацией клиента системы лояльности
Чек 00001446/000000 15.07.25 14:08:00 1 19.00 000000 Администратор @00000006 800
00035 1.000 30.00 30.00 0 000000 0.00% 0000000000000
% LoonaBonus 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 19,00 $KioqKioqKioqKioqMTEyNiAgICAgICAgICAgICAgICAgICAgICAgICAgNTE5MDE3MDAzNjU5ICAgICAgICAgMDEuMDEuMSAwMDowMDowMA==$
+
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 – день формирования отчета
Описание формата файла выгрузки: все суммы в отчете представлены в базовой валюте.
Файл состоит из списка проданных позиций или модификаторов
Размер, [байт] |
Описание |
13 |
Идентификатор товара (Баркод) |
1 |
Разделитель пробел (символ с кодом 0x20) |
50 |
Наименование позиции на языке по умолчанию |
1 |
Разделитель пробел (символ с кодом 0x20) |
10 |
Цена позиции (с точностью до 0.01) |
1 |
Разделитель пробел (символ с кодом 0x20) |
11 |
Количество товара (с точностью до 0.001) |
1 |
Разделитель пробел (символ с кодом 0x20) |
10 |
Сумма позиции без учёта модификаторов (с учетом скидки) |
2 |
Возврат каретки и перевод строки (пара символов с кодами 0x0D, 0x0A соответственно) |
2.1.11 Формат файла выгрузки списка персональной информации, предоставленной клиентом
Имя файла выгрузки персональной информации, предоставленной клиентом формируется следующим образом:
если смена закрыта, то используется шаблон:
СYYMMDDn.00N+
в противном случае используется шаблон:
С##mmddn.00N+
где:
X – заглавная, латинская буква X
YY – год закрытия смены (две цифры)
MM – месяц закрытия смены (две цифры)
DD – день закрытия смены (две цифры)
n – номер кассы (одна, две или более цифр, в зависимости от этого номера)
00N+ – номер смены (либо дополнен нулями до трех символов, если это номер
менее 1000, либо расширен до необходимого количества)
С – заглавная, латинская буква С
## – внутренний циклический счетчик программы
mm – месяц формирования отчета
dd – день формирования отчета
Описание формата файла выгрузки: файл состоит из ФИО и контактных данных, предоставленных клиентом. Ниже следующими строками отображается список выбранных услуг и товаров, которые заинтересовали клиента.