ООО "Модульные Системы"

Разработка программного обеспечения

Описание формата xte

 

Версия формата 3.5 от 04.02.2022

 

Первая строка в файле чека с расширением xte

1) тип чека

2) тип оплаты (в windows для типа текстовых документов (тип чека 10) - тип документа). Для чеков типа CHECK_MARK_CODES = 72 или ADD_MARKS_TO_BUFFER = 80 в этом поле передаётся тип первичного чека (продажа 1 или возврат 2)

3) % скидки на чек

4) скидка руб. на чек

5) сумма оплаты

6) номер кассира - число от 1 до 30. Если число более 30, будет приведено к диапазону 1-30

7) название кассира

8) номер диск. карты

9) номер кредитной карты (или rrn: и цифры (до 13))

10) номер чека (в андроиде для типа текстовых документов (тип чека 10) - тип документа). Для чека типа 70 (GET_DOC_BY_FD_NUM) в этом поле номер ФД

11) сумма к оплате (metrics.sumTov - metrics.sumSkTotal - metrics.sumBoomCard - metrics.sumBeznal) В андроиде итог чека (sumTov - sumSkTotal)

12) название (ФИО) дисконтной карты

13) код клиента

14) сумма безнала

15) сумма сертификата (бумкарты)

16) сумма оплаты наличными

17) название сертификата (бумкарты)

18) признак автоотмены

19) код оператора

20) показывать в расчётных операциях (0 или 1) (showInSale)

21) номер смены

22) email или телефон покупателя

23) тип доставки чека 0-печатать, 1- электронно, 2- печатать и электронно 

24) ИНН кассира 

25) тег 1085 строка 64 знака максимум, например должность типа Кассир. Для лекарств в этом поле передаётся строка mdlp

26) тег 1086 строка 256 знаков максимум, например ФИО оператора. 

Для лекарств в это поле передаётся идентификатор места осуществления деятельности sid. 

После sid цифры из личного кабинета Честного знака.

В конце строки sid символ & обязателен! 

Пример значения поля 1086: sid717528521946& 

Тег 1085 и 1086 объединяются в тег 1084 дополнительный реквизит пользователя

27) сумма аванса

28) сумма кредита

29) сумма встречного представления

30) система налогообложения 

31) признак агента 1057 (нужно передавать числа 0-7, далее указаны значения по ФФД)

32) clientInfo1227 данные клиента тег 1227 256 знаков

33) clientInn1228 ИНН клиента тег 1228 12 знаков (если 10, дополнить справа пробелами)

34) mestoRasch_1187 место расчётов (256 знаков)

35) итог чека (sumTov - sumSkTotal) (ранее было в поле 11)

36) дополнительный реквизит чека. Тег 1192 ФФД (строка до 16 знаков)

37) Адрес расчётов. Тег 1009 ФФД 256 знаков

38) Предварительно проверить имеющиеся в чеке КМ (0 или 1) . Если тип чека == CHECK_MARK_CODES (72), то в поле ValidateMarks  содержится признак очистки буфера кодов маркировки (1-да)

39) $@$ (3 символа разделителя для формата csf) Это всегда последнее поле 1-й строки! 

Внимание! Начиная с версии формата 2.5 это обязательный параметр! Даже если переданы не все поля формата, разделитель должен присутствовать

 

Вторая и последующие строки - информация о товаре

1: Название товара

2: Количество

3: Цена

4: Отдел

5: % скидки на товар

6: скидка рублевая на позицию

7: Код товара

8: Штрихкод

9: Код налоговой группы

10: Истинная цена товара Если пусто, то формула расчёта цены: dPriceRealNew = dPrice*(1.0 - dSkidkaPrTov/100.0) - dSkidkaRubTov/dKolvo;

11: Код в базе чеков

12: Код товара в товароучетной системе

13: Дополнительная информация о товаре (строка до 1000 знаков) (Поддерживается для ККМ Атол и Штрих)

14: Дополнительная информация о товаре (строка до 1000 знаков) перед регистрацией продажи (Поддерживается для ККМ Атол и Штрих (в одной строке до 249 знаков))

15: Выводить в несколько строк (1-да) (Для Атол и Штрих (до 128 знаков))

16: Переносить по словам (1-да). Если не указано, используется настройка PerenosWords (только для Атол)

17: Товар относится к алкоголю - число 22

18: Код pdf 417 - до 150 знаков акцизной марки

19: Емкость в литрах

20: Крепость в градусах 

21: Признак весового  товара (1-да)

22: Предмет расчёта (1-18) по умолчанию 1 - товар (работа - 3, услуга - 4, 12-иной предмет расчёта).

Для ФФД 1.2: Для маркированного товара передавать 33

23: Способ расчёта (1-7) по умолчанию 4 - полный расчёт

24: Сумма налога на позицию Для Штрих: Если режим начисления налогов в таблице 0 = 0, то это поле игнорируется. Если =1, то работает

25: ИНН поставщика (тег 1226) до 12 знаков Например  007720571071 Если ИНН 12 семёрок (777777777777), то теги 1226 и 1171 не передаются.

26: Наименование поставщика (тег 1225, часть тега 1224)  

27: телефон поставщика (тег 1171 в виде +79255077305, часть тега 1224)

28: признак агента по предмету расчёта (тег 1222)

29: ffd_1044_PayingAgentOperation; // Операция платежного агента 1044 (до 24 знаков, например Операция платежного агента)

30: ffd_1073_PayingAgentPhone; // Телефон платежного агента 1073 (до 19 знаков +71111111111)

31: ffd_1074_ReceivePaymentsOperatorPhone; // Телефон оператора по приему платежей 1074 (до 19 знаков +71111111111)

32: ffd_1075_MoneyTransferOperatorPhone; // Телефон оператора перевода 1075 (до 19 знаков +71111111111)

33: ffd_1026_MoneyTransferOperatorName; // Наименование оператора перевода 1026 (до 64 знаков)

34: ffd_1005_MoneyTransferOperatorAddress; // Адрес оператора перевода 1005 (до 256 знаков)

35: ffd_1016_MoneyTransferOperatorINN; // ИНН оператора перевода 1016 (10 знаков 1111111111)

36: группа товара

37: единица измерения

38: название для кассы

39: код маркировки

40: акциз товара тег 1229 (в копейках)

41: код страны происхождения товара тег 1230 (до 3-х знаков, если меньше, дополняется пробелами)

42: номер таможенной декларации тег 1231 (строка до 32-х знаков)

43: ffd_1191 дополнительный реквизит предмета расчёта (текст 64)

44:  MeasureUnit_2108 код по ФФД единицы измерения (0-255)

45: DivisionalQuantity_1291 признак дробного деления 1-да, 0 или пусто - нет

46: Numerator_1293  - Числитель дробной части реализации маркированного товара (если DivisionalQuantity =1)

47: Denominator_1294 - Знаменатель дробной части реализации маркированного товара (если DivisionalQuantity =1)

48: Часть тега 1260. Дата документа основания. Значение тега 1263. date_1263  Формат - "yyyy.mm.dd" или "dd.mm.yyyy"

49: Часть тега 1260. Идентификатор ФОИВ. Значение тега 1262. fois_1262. Формат - "ЦЦЦ", трёхзначное число. Для медикаментов 020

50: Часть тега 1260. Номер документа основания. Значение тега 1264. number_1264. Строка до 32-х знаков.

51: Часть тега 1260. Значение отраслевого реквизита. Значение тега 1265. industryAttribute _1265. Строка до 256 знаков.

Для продажи медикаментов без льготы строка вида tm=mdlp&sid=00752852194630&

Для продажи медикаментов при продаже по льготному рецепту с частичной оплатой строка вида tm=mdlp&ps=45102&dn=АБV492&&781&dd=181110&sid=00752852194630&ss=12300&

Для продажи медикаментов при продаже по льготному рецепту со 100% льготной оплатой строка вида tm=mdlp&tr=3108805&ps=45102&dn=АБV492&&781&dd=181110&sid=00752852194630&

 

Для вывода информации по 13 и 14-му полю требуется в настройках поставить галочку Выводить доп. инф. о товаре (BigTxtStr). Разделители строки - символ ^ (крышечка).

Для касс Атол возможно выделение текста путем удвоения ширины (произвольной области печати, ограниченной символами !{ начало и !} окончание).

 

Для включения многострочной печати нужно поставить галочку Многострочное название товара (BigNameTov) на вкладке Чеки, если нужен перенос по словам, то поставить галочку у параметра Переносить по словам (PerenosWords).

 

Можно использовать строку @payinfo; для передачи информации о безналичной оплате для чеков возврата.

 

Типы чеков при обмене с сервером чеков (для поля №1)

В чеках коррекции начиная с версии 49.5 поддерживается передача сумм через @paysum; . Можно передать суммы и в заголовке чека, но если есть строка @paysum; то суммы будут взяты оттуда.

Возможность передать все суммы налогов. Для этого нужно сформировать строки как товар с полем 9 код налоговой группы и полем 24 сумма налога на позицию. Для Штрих в чеки коррекции возможно передать только сумма наличными, безналичными (электронные + сертификаты), аванс, кредит и встречное представление.

            Для Штрих54: 

            Если поле 13 = 0, то берётся номер ФД из поля 10 и формируется отчёт в зависимости от типа полученного документа. 

            Если поле 13 = 7 - то это подтверждение оператора и нужно обязательно заполнить поле 10 Номер документа. При этом будет напечатан документ Подтверждение. Сохранение в fncheck.txt не происходит.

            Если в поле 13 (codeClient) есть число > 0, но не равно 10 и 7, то это число типа документа, который нужно найти. В этом случае будет производиться поиск последнего документа этого типа и далее либо печать, либо                сохранение в файле. При этом поле 10 (номер документа в ФН не используется). Поиск может выполняться значительное время (несколько секунд) и зависит от количества документов и от того, что ищем.

            Если поле 13 = 10, то берётся номер ФД из поля 10 и формируется отчёт из ФН. Значения, которые можно передавать в поле 13:

1 – Отчёт о регистрации

2 – Отчёт об открытии смены

3 – Кассовый чек

4 – БСО

5 – Отчёт о закрытии смены

6 – Отчёт о закрытии фискального накопителя

7 – Подтверждение оператора

11 – Отчет об изменении параметров регистрации

21 – Отчет о состоянии расчетов

31 – Кассовый чек коррекции

41 – Бланк строгой отчетности коррекции

 

Типы оплат при обмене с сервером чеков (для поля №2)

 

Коды налоговых групп (для поля №9)

 

 

Типы систем налогообложения (для поля №30 и 37)

 

Признаки агента (для поля №31)

 

Предметы расчёта (для поля №22 у товара)

 

Способы расчёта (для поля №23 у товара)

 

Пример передачи сумм оплаты для чеков коррекции

@paysum;наличными;безналичными;Тип 3;Тип 4;Тип 5;Тип 6;Сертификатом;Тип 8;Тип 9;Тип 10;Тип 11;Тип 12;Тип 13;Авансом;Кредитом;Встречным представлением;

 

Пример передачи информации о безналичной оплате для чеков возврата (в любой строке, начиная со 2-й). Формат строки PayInfoClass

@payinfo;************3130;961171;23718750;103;06.07.2020 18:53:59;315;Оплата;1;23718750;2;8;8;1;001;Visa_SD;ОДОБРЕНО; /;LANTMS07;000103;0000000000;00;A0000000031010;

 

Файл ответа от сервера чеков

     При обработке этот файл удаляется и создается файл a100_d.err с числом 0, если ошибок не было, либо с кодом ошибки.

Если в ответе в режиме сервере чеков код ошибки = 1261 это означает, что авторизация успешно проведена, а при печати фискального чека произошла ошибка. Код ошибки находится во 2-й строке. При этом не нужно формировать файл sbrf.xte (это приведет к повторной авторизации), а сформировать файл с любым другим названием с тем же содержимым (тип 2) и чек будет напечатан как безналичный.

Начиная с версии 44.5 

можно указать название файла ответа, либо файл ответа может быть сформирован из названия файла без расширения .xte плюс .otv

В файл ответа типа a100_d.err записывать в 3-й строке № чека кассы,

в 4-й строке сумму чека из кассы,

в 5-й строке название файла xte, по которому печатался чек.

в 6-й строке будет 1, если текстовая информация по спецсимволам @ была напечатана или 0, если нет

Начиная с версии программы 49.3 от 03.10.2019

Если включена настройка Расширенная информация в файле ответа (на вкладке Сервер чеков), то формат файла ответа аналогичен формату в андроиде

1. код ответа. 0 -нет ошибки, число отличное от нуля - ошибка

2. код ответа при безнале

3. № чека кассы

4. сумма чека в копейках

5. название файла чека

6. текстовая информация напечатана 1- да, 0 или пусто - нет

7. дата время открытия смены в формате dd.mm.yyyy HH:mm:ss

8. номер смены ККМ

9. количество непереданных документов (обновляется при типе 36)

10. дата и время 1-го непереданного документа (обновляется при вызове типа 40)

11. серийный номер ККМ

12. модель и номер

13. уровень батареи в процентах

14. текущие дата и время кассы

15. описание ошибки кассы

16. строка с информацией об оплатах №1

17. строка с информацией об оплатах №2

18. строка с информацией об оплатах №3

 

 

Возможности печати текстовых строк внутри чеков продажи и возврата (не типа 10)

Для АРМ Касса 2021 начиная с версии 1.4

Комментарий, который не будет напечатан для всех типов чеков: символ #

Пример

#Какой-то текст

 

Текстовая печать

Можно использовать спецсимвол @ с дополнительной информацией как в чеках продажи или возврата, так и в чеках с нефискальной информацией.

Если после символа есть { то символы между { и } являются управляющими.

Символ (с или C) это центрирование.

Символ (p или P) перенос по словам.

Пример:

@{pc}далее текст.

Символ b или B это жирный удвоенный шрифт.

Символ * это печать звёздочек во всю ширину ленты.

Символ . это печать точек во всю ширину ленты.

Символ - это печать тире во всю ширину ленты.

Символ > это симметричная печать >>><<< во всю ширину ленты.

Пример:

@{.}

Символ h или H это печать клише.

Пример:

@{h}

Символ (d или D) это открытие денежного ящика

Пример

@{d}

 

Печать штрихкода

Символ # это штрихкод. Символ, идущий следующим, это тип штрихкода.

1 это EAN-13

2 это EAN-8 (может не поддерживаться на Штрих)

3 это CODE-39

4 это CODE-128 (может не поддерживаться)

5 это pdf417 (может не поддерживаться на Штрих)

6 это QR-код (если длина кода превышает 100 знаков, код генерируется программно)

 

Текст, идущий за пределами {} это текст штрихкода.

Пример:

@{#1}4650000343933

или

@{#6}http://www.mscosoft.ru

 

Если в строке управления присутствуют символы l, c или r (L, C, R), то это выравнивание штрихкода

Пример:

@{c#1}4650000343933

 

Если в строке управления присутствует символ s (S), то это печать текстовых данных штрихкода

Пример:

@{s#1}4650000343933

 

Также можно задавать ширину и высоту ШК в точках

Пример

@{#1&320%150}4650000343933

3 символа за & это ширина ШК (будет примерно такая и зависит от разрешения принтера) (для Атол не поддерживается)

3 символа за % это высота ШК в линиях (150 примерно соответствует 15 мм высоты)

 

Если в строке управления присутствует символ z (Z), то для QR-кода это коэффициент масштаба (1-9)

Пример:

@{z5#6}http://www.mscosoft.ru

 

Печать картинки:

Возможно распечатать монохромный bmp.

X пикселей по горизонтали в зависимости от возможностей принтера ККМ и до Y строк по вертикали в зависимости от объёма памяти ККМ

Для печати используется команда @{$} и далее полный путь к файлу.

Пример:

@{$}c:\ecr\exe\logo_rzd.bmp

Если будет присутствовать буква u или U, то после печати картинки файл будет удалён.

Также возможно центрирование буквами L (лево), c (центр) и R (право)

Пример:

@{uc$}c:\ecr\exe\logo_rzd.bmp

 

Для АРМ Касса 2021 начиная с версии 5.3

Обработка команд форматирования {s2} и {s3}

При этом разделителем полей служит символ @

При s2 строка будет разделена на 2 поля и выведена в виде текст слева и текст справа для ширины ленты кассы.

При s3 строка будет разделена на 3 поля и выведена в виде текст слева, текст в центре и текст справа для ширины ленты кассы. 

 

Пример:

@{s2}Это текст слева@Это текст справа

@{s3}Это текст слева@текст в центре@Это текст справа

 

Начиная с версии 46.1

Можно использовать спецсимвол @ с дополнительной информацией как в чеках продажи или возврата, так и в чеках с нефискальной информацией.

Если после символа есть { то символы между { и } являются управляющими.

Символ (с или C) это центрирование.

Символ (p или P) перенос по словам.

Пример:

@{pc}далее текст.

Символ b или B это жирный удвоенный шрифт.

Символ * это печать звёздочек во всю ширину ленты.

Символ . это печать точек во всю ширину ленты.

Символ - это печать тире во всю ширину ленты.

Символ > это симметричная печать >>><<< во всю ширину ленты.

Пример:

@{.}

Символ h или H это печать клише.

Пример:

@{h}

Символ (t или T) это печать заголовка текстового документа (выводится блок с ИНН и параметрами ККМ) Только для Штрих

Символ (f или F) это протяжка. Число в 1 символ, идущее следом, это на сколько строк произвести протяжку. (работает до открытия чека).

Символ (o или O) это отрез. При этом o или о русская это частичный отрез, а O или О русская это полный отрез. (работает до открытия чека).

Символ # это штрихкод. Символ, идущий следующим, это тип штрихкода.

1 это EAN-13

3 это CODE-39 (генерируется программно)

5 это pdf417 (начиная с версии 49.5)

6 это QR-код

 

Текст, идущий за пределами {} это текст штрихкода.

Пример:

@{#1}4650000343933

или

@{#6}http://www.mscosoft.ru

 

Также можно задавать ширину и высоту ШК в точках

Пример

@{#1&320%150}4650000343933

3 символа за & это ширина ШК (будет примерно такая и зависит от разрешения принтера)

3 символа за % это высота ШК в линиях (150 примерно соответствует 15 мм высоты)

 

Для АРМ Касса для Windows, включая версию 2021 и Андроид

Начиная с версии 46.3

Печать картинки:

Возможно распечатать монохромный bmp размером до 319х1199

(319 пикселей по горизонтали и до 1199 строк по вертикали)

Для печати используется команда @{$} и далее полный путь к файлу.

Пример:

@{$}c:\ecr\exe\logo_rzd.bmp

 

Тип чека 46: можно устанавливать параметры в ККМ (для Штрих)

параметры 2-й строки

 

Тип печати клише

@{hhV}

V может быть 0 (печать клише перед документом) или 1 (печать клише после документа (по умолчанию))

 

Отрез при закрытии чека (самой кассой)

@{czV}

V может быть 0-отреза при закрытии чека нет или 1-отрез полный или 2- отрез частичный

 

Отрез при открытом чеке (если 0, то будет ошибка при подаче команды отреза)

@{coV}

V может быть 0 (отрез при открытом чеке запрещён (по умолчанию)) или 1 (отрез разрешён)

 

Использовать весовой датчик

@{vdV}

V может быть 0 (по умолчанию) или 1 (использовать датчик)

 

Промотка перед отрезом

@{fcV}

V может быть 0 (промотки нет (по умолчанию)) или 1 (промотка есть)

 

Тип принтера

@{tpV}

V может быть 1 (VKP-80) или 2 (TG2460H)

 

Выброс чеков

@{vcV}

V может быть 0 (вперёд) или 1 (в ретрактор)

 

Выброс отчётов

@{voV}

V может быть 0 (вперёд) или 1 (в ретрактор)

 

Параметры ОФД

Сервер ОФД

@{of1}V-строка

 

Порт ОФД

@{of2}V-число, например 7778

 

Задержка между пакетами, мс ОФД (0-3000)

@{of3}V-число в мс, например 300

 

Не печатать документы

@{ndV}

V может быть 

0‐печатать все документы;

1‐не печатать один документ;

2‐не печать 

3‐отправлять чеки открытия и закрытия в буфер на SD.

 

Печатать налоги

@{pnV}

0‐налог 4 не печатается, остальные печатаются;

1‐все налоги печатаются;

2‐ печатается только буква налога

3 – буква налога не печатается (в том числе при закрытии смены)

 

Делать петлю при печати

@{pmV}

V может быть 

0-нет

1-да (делать петлю)

 

 

Для оплаты с авторизацией название чека должно быть sbrf.xte.

Если нужно напечатать чек с оплатой по безналичному расчету без авторизации, то название файла должно быть любое кроме sbrf.xte

 

Если нужно напечатать товарный чек на кассовом принтере, название файла должно быть tovcheck.xte

Если нужно напечатать товарный чек на принтере через драйвер, название файла должно быть tovchek.xte

 

 

     Существует возможность нажатия клавиш Ctrl * после создания файла, чтобы приложение могло начать корректный процесс

     считывания из файла a100_d.err.

     Кодировка может быть Dos или Win1251. Примеры приведены в кодировке Dos

 

Содержимое файла kkmInfo.txt

Первая строка

Вторая строка

Третья строка

Четвёртая строка

 

Содержимое файла fndatdoc.txt

Дата 1-го непереданного в ОФД документа. Если непереданных документов нет, то --

 

Содержимое файла fnnepdoc.txt

Количество непереданных в ОФД документов

 

Содержимое файла fnrepdoc.txt

1) Количество непереданных в ОФД документов

2) Номер 1-го непереданного в ОФД документа

3) Дата 1-го непереданного в ОФД документа

******** Статус информационного обмена *********

Транспортное соединение установлено:          да

Есть сообщение для передачи в ОФД:           нет

Ожидание ответного сообщения от ОФД:          да

Есть команда от ОФД:                         нет

Изменились настройки соединения с ОФД:       нет

Ожидание ответа на команду от ОФД:           нет

************************************************