Главная » IS-Kiosk » Интеграция сторонних систем в IS-Kiosk » 1С в IS-Kiosk » Описание формата обмена данными с 1С в IS-Kiosk » 2.1 - Выгрузка данных по реализации - XYYMMDDn.00N+
Назад

2.1 - Выгрузка данных по реализации - XYYMMDDn.00N+

Номер статьи: 0000183

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

3

Резерв – ANSI строка из 3 символов ‘0’ (0x30)

INN

2

Идентификатор юридического лица – от 00 до 99 (не используется)

-

1

Разделитель пробел (символ с кодом 0x20)

DATE

8

Дата фискализации чека (в формате дд.мм.гг)

-

1

Разделитель пробел (символ с кодом 0x20)

TIME

8

Время суток фискализации чека (в формате чч:мм:сс)

-

1

Разделитель пробел (символ с кодом 0x20)

TYPE

1

Вид документа
(1 – продажа, 2 – возврат, 4 - Приходный ордер, 8 - Расходный ордер)

-

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 Формат товарных позиций документа

Товарная часть чека представляет собой строки (количество которых определяется количеством товарных позиций чека) следующего формата:

 

Размер, [байт]

Описание

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.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)

100

Комментарий к позиции

1*

Разделитель пробел (символ с кодом 0x20)

50*

Наименование позиции на языке по умолчанию

2

Возврат каретки и перевод строки

(пара символов с кодами 0x0D, 0x0A соответственно)


Примечание:

Элементы, отмеченные * не отправляются при работе с web-сервисом.


2.1.5 Формат типа оплаты документа

Денежная часть чека представляет собой строку следующего формата:

Размер, [байт]

Описание

5

Сигнатура (ANSI строка ‘Оплата’)

1

Разделитель пробел (символ с кодом 0x20)

1

Вид оплаты (1 – наличные, 2 – банковская карта и т.д.)

1

Разделитель пробел (символ с кодом 0x20)

12

Сумма оплаты

1

Разделитель пробел (символ с кодом 0x20)

$данные$

Закодированные данные по банковской карте (при оплате картой).

Закодированные данные с двух сторон обрамлены символом $

20

Идентификатор продавца в банке-эквайере (MerchantId)

2

Возврат каретки и перевод строки

(пара символов с кодами 0x0D, 0x0A соответственно)


2.1.6 Пример выгрузки

Касса 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       240,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                                                                                                      Клюквенный соус                                   
~         3229      1,000       0,00       0,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                                                                                                      Ветчина                                           
~        00038      1,000       0,00       0,00          0 000000    0,00% 0000000000000                                                                                                      Грибы                                             
~        00039      1,000       0,00       0,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                                                                                                      Клюквенный соус                                   
Оплата 2       240,65 $NDQ0NDQ0NDQ0NDQ0NDQ0NCAgICAgMDAwMSAgICAgICAgICAgICAgICAgMzI0MiAgICAgICAgICAgICAgICAgMDIuMTEuMjIgMDA6MDA6MDA=$
+





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 соответственно)



2.1.8        Формат файла выгрузки списка персональной информации, предоставленной клиентом

 

Имя файла выгрузки персональной информации, предоставленной клиентом формируется следующим образом:

если смена закрыта, то используется шаблон:

СYYMMDDn.00N+

в противном случае используется шаблон:

С##mmddn.00N+

где:

X – заглавная, латинская буква X

YY – год закрытия смены (две цифры)

MM – месяц закрытия смены (две цифры)

DD – день закрытия смены (две цифры)

n – номер кассы (одна, две или более цифр, в зависимости от этого номера)

00N+ – номер смены (либо дополнен нулями до трех символов, если это номер

менее 1000, либо расширен до необходимого количества)

С – заглавная, латинская буква С

## – внутренний циклический счетчик программы

mm – месяц формирования отчета

dd – день формирования отчета

 

Описание формата файла выгрузки: файл состоит из ФИО и контактных данных, предоставленных клиентом. Ниже следующими строками отображается список выбранных услуг и товаров, которые заинтересовали клиента.

Просмотры: 1087