2.1 - Выгрузка данных по реализации - XYYMMDDn.00N+
2.1 Выгрузка данных по реализации
Имя файла с отчетом о продажах формируется следующим образом:
если смена закрыта, то используется шаблон:
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 |
4 |
Резерв – ANSI строка из 4 символов ‘0’ (0x30) |
|
INN |
2 |
Идентификатор юридического лица – от 00 до 99 (не используется) |
|
- |
1 |
Разделитель пробел (символ с кодом 0x20) |
|
DATE |
8 |
Дата фискализации чека (в формате дд.мм.гг) |
|
- |
1 |
Разделитель пробел (символ с кодом 0x20) |
|
TIME |
8 |
Время суток фискализации чека (в формате чч:мм:сс) |
|
- |
1 |
Разделитель пробел (символ с кодом 0x20) |
|
TYPE |
1 |
Вид документа (1 – продажа, 2 – возврат, 3 – внесение, 4 - выплата) |
|
- |
1 |
Разделитель пробел (символ с кодом 0x20) |
|
TOTAL |
12 |
Сумма по чеку |
|
- |
1 |
Разделитель пробел (символ с кодом 0x20) |
|
UID |
6 |
(не используется) |
|
- |
1 |
Разделитель пробел (символ с кодом 0x20) |
|
UNICK |
0-20 |
Имя кассира |
|
@ |
1 |
Разделитель @ (символ с кодом 0x40) |
|
CNICK |
13 |
(не используется) |
|
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 Формат товарных позиций документа
Товарная часть чека представляет собой строки (количество которых определяется количеством товарных позиций чека) следующего формата:
|
Размер, [байт] |
Описание |
|
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) |
|
0-50 |
“Имя” клиента (не используется) |
|
2 |
Возврат каретки и перевод строки (пара символов с кодами 0x0D, 0x0A соответственно) |
2.1.4 Формат модификаторов товарных позиций
Модификаторы товара (позиции документа) - часть чека представляет собой строки (количество которых определяется количеством модификаторов у данной товарной позиций) следующего формата:
|
Размер, [байт] |
Описание |
|
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) |
|
0-50 |
“Имя” клиента (не используется) |
|
2 |
Возврат каретки и перевод строки (пара символов с кодами 0x0D, 0x0A соответственно) |
2.1.5 Формат типа оплаты документа
Денежная часть чека представляет собой строку следующего формата:
|
Размер, [байт] |
Описание |
|
5 |
Сигнатура (ANSI строка ‘Оплата’) |
|
1 |
Разделитель пробел (символ с кодом 0x20) |
|
1 |
Вид оплаты (1 – наличные, 2 – банковская карта и т.д.) |
|
1 |
Разделитель пробел (символ с кодом 0x20) |
|
12 |
Сумма оплаты |
|
1 |
Разделитель пробел (символ с кодом 0x20) |
|
0-20 |
Номер банковской карты (ANSI строка) (не используется) |
|
1 |
Разделитель пробел (символ с кодом 0x20) |
|
0-20 |
Идентификатор документа авторизации банковской карты (ANSI строка) (не используется) |
|
2 |
Возврат каретки и перевод строки (пара символов с кодами 0x0D, 0x0A соответственно) |
2.1.6 Пример выгрузки
Касса 1
Смена 21
ФР Касса №1
Zномер 21
ИтогПродаж 924,00
Возврат/аннулирование 0,00
ПродажНал 0,00
ВозвратНал 0,00
ПродажКарта 924,00
ВозвратКарта 0,00
Чек 00000360/000000 01.01.18 12:00:00 1 924,00 000000 Администратор
0000000087538 2,0 924,00 924,00 0 000000 0,00% 0000000000000
~0000000001949 1,0 111,00 111,00 0 000000 0,00% 0000000000000
~0000000001739 1,0 29,00 29,00 0 000000 0,00% 0000000000000
~0000000002344 2,0 142,00 142,00 0 000000 0,00% 0000000000000
Оплата 2 924,00 0000
+
2.1.7 Формат файла выгрузки списка проданных позиций
Имя файла выгрузки списка проданных позиций формируется следующим образом:
если смена закрыта, то используется шаблон:
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 соответственно) |