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

Разработка программного обеспечения
   
Сегодня 25 апреля 2019 г.
 
 

с 10.00 до 19.00




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

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


 

Версия формата 1.7 от 26.03.2019

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

     1) тип чека
  •       1-продажа;
  •       2-возврат;
  •       3-х-отчет;
  •       4-z-отчет;
  •       5-нач. ост.;
  •       6-снятие;
  •       7-детальная информация в отчетах
  •       8-x-отчет по отделам;
  •       9-открыть ящик
  •       10 - текстовый документ (если поле 20 равно ноль, то заголовок не печатается, если пусто или любое число, то печатается). 
  •       11 - подкладной документ
  •       12 - отчет по кассирам
  •       13 - закрыть программу
  •       14 - выключить компьютер
  •       15 - запрос времени с кассы. Дата и время ККМ сохраняется в файл kkmdate.txt (если поле 20 не равно 1) (для Штрих54).
  •       16 - изменить время на кассе Если в поле 12 имеется строка в 19 знаков вида dd.mm.yyyy hh:nn:ss, то будет проставлена эта дата.
  •       17 - печать товарного чека с раскодированием
  •       18 - запрос времени на кассе после открытия смены
  •       19 - автоотмена
  •       21 - формирование файла kkmInfo.txt
  •       23 - тестовый
  •       24 - сообщение formMsg (файл sound.xte)
  •       25 - развернуть из трея
  •       26 - свернуть в трей
  •       27 - повтор печати сбойного чека (файла problemCheck.etx)
  •       28 - печать отложенных z-отчетов
  •       29 - действие из opWork
  •       30 - (файл info.xte)
  •       31 - (файл toSaleXXXX.xte)
  •       32 - показать форму отчетов при безналичной оплате
  •       33 - аварийная отмена при безнале;
  •       34 - отмена вместо возврата при безнале
  •       35 - отчёт о состоянии расчётов
  •       36 - запрос количества непереданных документов в ОФД. Если в поле 20 (showInSale) стоит ничего или 0, то информация сохраняется с названием fnnepdoc.txt в директории сканирования сервера чеков
  •       37-чек коррекции приход. При этом в поле 12 nameDiscard нужно записать дату dd.mm.yyyy, если тип коррекции = 1. Поле 13-Код клиента Тип коррекции: 0-самостоятельно, 1- по предписанию. В поле 17 nameSertif записать номер документа основания коррекции, а в поле 30 (если пусто, то будет взято из поля 19 код оператора) нужно проставить код системы налогообложения
    0-Основная
    1-Упрощенная доход
    2-Упрощенная доход - расход
    3-ЕНВД
    4-Единый сельхозналог
    5-Патентная система
  •     38-чек коррекции расход. При этом в поле 13-Код клиента Тип коррекции: 0-самостоятельно, 1- по предписанию, а в поле 30 (19 код оператора) нужно проставить код системы налогообложения
  •     39-запрос чека из ФН по номеру (номер указывается в поле 10. Для Атол это номер фискального документа, а для Штрих - сквозной номер документа). Если в поле 20 (showInSale) стоит 1, то чек сразу печатается, если ничего или 0, то чек сохраняется с названием fncheck.txt в директории сканирования сервера чеков. Для Штрих54: Если в поле 13 (codeClient) есть число > 0, то это число типа документа, который нужно найти. В этом случае будет производиться поиск последнего документа этого типа и далее либо печать, либо сохранение в файле. При этом поле 10 (номер документа в ФН не используется). Поиск может выполняться значительное время (несколько секунд) и зависит от количества документов и от того, что ищем. Если поле 13 равно 7 - то это подтверждение оператора и нужно обязательно заполнить поле 10 Номер документа. При этом будет напечатан документ Подтверждение. Сохранение в fncheck.txt не происходит.
    Если поле 13 = 0, то берётся номер ФД из поля 10 и формируется отчёт в зависимости от типа полученного документа.
    Если поле 13 = 10, то берётся номер ФД из поля 10 и формируется отчёт из ФН за последний месяц.
  • Значения, которые можно передавать в поле 13:
1 – Отчёт о регистрации
2 – Отчёт об открытии смены
3 – Кассовый чек
4 – БСО
5 – Отчёт о закрытии смены
6 – Отчёт о закрытии фискального накопителя
7 – Подтверждение оператора
11 – Отчет об изменении параметров регистрации
21 – Отчет о состоянии расчетов
31 – Кассовый чек коррекции
41 – Бланк строгой отчетности коррекции
  •       40 - дата и время первого непереданного документа. Если в поле 20 (showInSale) стоит ничего или 0, то информация сохраняется с названием fndatdoc.txt в директории сканирования сервера чеков
  •       41 - запрос статуса 24 часа
  •       42 - печать диагностики соединения с ОФД для Атол
  •       43 - Отчёт о состоянии счётчиков ККТ (для Атол)
  •       44 - Изменение фамилии кассира 
  •       45 - Отчёт по суммам до закрытия смены (для Атол)
  •       46 - Установка параметров в ККМ (для Штрих)
  •       47 - Принудительное открытие смены (для Штрих)
  •       48 - отключиться от ККМ
  •       49 - подключиться к ККМ
  •       50 - строка параметров подключения к ККМ (для Штрих) 2-я строка: @{kp1}номер порта (1-255), например 12;скорость (2400, 4800, 9600, 19200, 38400, 57600, 115200), например 115200;таймаут в мс, например 300; Параметры сохраняются в реестре. При подключении сначала делается попытка использовать параметры драйвера ККМ. Если подключение не удалось, извлекаются сохранённые параметры из реестра и ещё раз делается попытка подключения.
  •       51 - показ свойств драйвера
  •       52 - остановить сервис сервера чеков
    2) тип оплаты
  •       1-нал
  •       2-безнал
  •       3-продажа без чека
  •       4-возврат без чека
  •       5-комбинированная оплата
  •       6-оплата по 2-му терминалу.
  •       7-аванс
  •       8-кредит
  •       9-оплата встречным представлением
    3) % скидки на чек
    4) скидка руб. на чек
    5) сумма оплаты
    6) номер кассира - число от 1 до 30 
    7) название кассира
    8) номер диск. карты
    9) номер кредитной карты (или rrn: и цифры (до 13))
    10) номер чека
    11) итог чека (sumTov - sumSkTotal)
    12) название (ФИО) дисконтной карты
    13) код клиента
    14) сумма безнала
    15) сумма сертификата (бумкарты)
    16) сумма оплаты наличными
    17) название сертификата (бумкарты)
    18) признак автоотмены
    19) код оператора
    20) показывать в расчётных операциях (0 или 1)
    21) номер смены
    22) email или телефон покупателя
    23) тип доставки чека 0-печатать, 1- электронно, 2- печатать и электронно 
    24) ИНН кассира 
    25) тег 1085 строка 64 знака максимум, например должность типа Кассир
    26) тег 1086 строка 256 знаков максимум, например ФИО оператора
    27) сумма аванса
    28) сумма кредита
    29) сумма встречного представления
    30) система налогообложения 
            Варианты:
    •     0-Основная
    •     1-Упрощенная доход
    •     2-Упрощенная доход - расход
    •     3-ЕНВД
    •     4-Единый сельхозналог
    •     5-Патентная система 
    31) признак агента 1057 (нужно передавать числа 0-7, в скобках указаны значения по ФФД)
        Варианты:
    • 0 - нет агента  
    • 1 (1)- Банковскй платежный агент
    • 2 (2) - Банковскй платежный субагент
    • 3 (4) - Платежный агент
    • 4 (8) - Платежный субагент
    • 5 (16) - Проверенный агент
    • 6 (32) - Комиссионер
    • 7(64) - Иной агент
 
 

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

    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-да) (Для Атол и Штрих (для Штрих до 40 знаков))
    16: Переносить по словам (1-да). Если не указано, используется настройка PerenosWords (только для Атол)
    17: Товар относится к алкоголю - число 22
    18: Код pdf 417 - до 150 знаков акцизной марки
    19: Емкость в литрах
    20: Крепость в градусах 
    21: Признак весового  товара (1-да)
    22: Предмет расчёта (1-18) по умолчанию 1 - товар (работа - 3, услуга - 4, 12-иной предмет расчёта)
    • 1-товар, за исключением подакцизного товара
    • 2-подакцизный товар
    • 3-выполняемая работа
    • 4-оказываемая услуга
    • 5-прием ставок при осуществлении деятельности по проведению азартных игр
    • 6-выплата денежных средств в виде выигрыша при проведению азартных игр
    • 7-прием денежных средств при реализации лотерейных билетов, ставок
    • 8-выплата денежных средств в виде выигрыша при проведению лотерей
    • 9-предоставление прав на использование результатов интеллектуальной деятельности
    • 10-аванс, задаток, предоплата, кредит, взнос в счет оплаты, пени, штраф, вознаграждение, бонус
    • 11-платёжный агент (субагент), комиссионер, поверенное лицо
    • 12-составной предмет расчёта из 0-10
    • 13-иной предмет расчёта (не относящийся к 0-11)
    • 14- передача имущественных прав
    • 15-внереализационный доход
    • 16-страховые взносы
    • 17-торговый сбор
    • 18-курортный сбор
23: Способ расчёта (1-7) по умолчанию 4 - полный расчёт
    • 1-Полная предварительная оплата до момента передачи предмета расчета
    • 2-Частичная предварительная оплата до момента передачи предмета расчета
    • 3-Аванс
    • 4-Полная оплата, в т.ч. с учетом аванса в момент передачи предмета расчета
    • 5-Частичная оплата предмета расчета в момент его передачи с последующей оплатой в кредит
    • 6-Передача предмета расчета без его оплаты с последующей оплатой в кредит
    • 7-Оплата предмета расчета после его передачи с оплатой в кредит (оплата кредита)
 
 
    24: Сумма налога на позицию
    25: ИНН поставщика (тег 1226) до 12 знаков Например  007720571071 Если ИНН 12 семёрок (777777777777), то теги 1226 и 1171 не передаются.
    26: Наименование поставщика (тег 1224)  
    27: телефон поставщика (тег 1171 в виде +79255077305)
    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)
 
Для вывода информации по 13 и 14-му полю требуется в настройках поставить галочку Выводить доп. инф. о товаре (BigTxtStr). Разделители строки - символ ^ (крышечка).
Для касс Атол возможно выделение текста путем удвоения ширины (произвольной области печати, ограниченной символами !{ начало и !} окончание).
 
Для включения многострочной печати нужно поставить галочку Многострочное название товара (BigNameTov) на вкладке Чеки, если нужен перенос по словам, то поставить галочку у параметра Переносить по словам (PerenosWords).
 
     При обработке этот файл удаляется и создается файл a100_d.err с числом 0, если ошибок не было, либо с кодом ошибки.
Если в ответе в режиме сервере чеков код ошибки = 1261 это означает, что авторизация успешно проведена, а при печати фискального чека произошла ошибка. Код ошибки находится во 2-й строке. При этом не нужно формировать файл sbrf.xte (это приведет к повторной авторизации), а сформировать файл с любым другим названием с тем же содержимым (тип 2) и чек будет напечатан как безналичный.
Начиная с версии 44.5 
можно указать название файла ответа, либо файл ответа может быть сформирован из названия файла без расширения .xte плюс .otv
В файл ответа типа a100_d.err записывать в 3-й строке № чека кассы,
в 4-й строке сумму чека из кассы,
в 5-й строке название файла xte, по которому печатался чек.
в 6-й строке будет 1, если текстовая информация по спецсимволам @ была напечатана или 0, если нет
 
Начиная с версии 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 (генерируется программно)
6 это QR-код
Текст, идущий за пределами {} это текст штрихкода.
Пример:
@{#1}4650000343933
или
Также можно задавать ширину и высоту ШК в точках
Пример
@{#1&320%150}4650000343933
3 символа за & это ширина ШК (будет примерно такая и зависит от разрешения принтера)
3 символа за % это высота ШК в линиях (150 примерно соответствует 15 мм высоты)
 
Начиная с версии 46.3
Печать картинки:
Возможно распечатать монохромный bmp размером до 319х1199
(319 пикселей по горизонтали и до 1199 строк по вертикали)
Для печати используется команда @{$} и далее полный путь к файлу.
Пример:
@{$}c:\ecr\exe\logo_rzd.bmp
 
 
Тип чека 46: можно устанавливать параметры в ККМ (для Штрих)
параметры 2-й строки
 
Тип печати клише
@{hhV}
V может быть 0 (печать клише перед документом) или 1 (печать клише после документа (по умолчанию))
 
Отрез при закрытии чека (самой кассой)
@{czV}
V может быть 0 (отреза при закрытии чека нет) или 1 (отрез есть (по умолчанию))
 
Отрез при открытом чеке (если 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 – буква налога не печатается (в том числе при закрытии смены)
 
Для оплаты с авторизацией название чека должно быть sbrf.xte.
Если нужно напечатать чек с оплатой по безналичному расчету без авторизации, то название файла должно быть любое кроме sbrf.xte
 
Если нужно напечатать товарный чек на кассовом принтере, название файла должно быть tovcheck.xte
Если нужно напечатать товарный чек на принтере через драйвер, название файла должно быть tovchek.xte
 
 
     Существует возможность нажатия клавиш Ctrl * после создания файла, чтобы приложение могло начать корректный процесс
     считывания из файла a100_d.err.
     Кодировка может быть Dos или Win1251. Примеры приведены в кодировке Dos
 

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

Первая строка
     1) Модель кассы (текст);
     2) Режим;
     3) Подрежим;
     4) Признак наличия бумаги; 
     5) Текущее состояние чека;
     6) Код последней ошибки; 
     7) Описание последней ошибки;
     8) Смена открыта (1-да, 0-нет)
     9) Номер смены
     10) Заводской номер ККМ
Вторая строка
     1) Номер чека;
     2) Сумма чека; (для Штрихов вместо суммы чека будут накопления по 4-м типам оплаты: продажа;возврат;продажа2;возврат2 и т.д. Если суммы ненулевые, значит чек не закрыт!)
Третья строка
     1) № смены
     2) Сумма внесения
     3) Сумма снятия
     4) Сумма наличности
     5) Сумма выручки
     6) Продажа наличными
     7) Возвраты наличными
     8) Продажа тип 2
     9) Возврат тип 2
     10) Продажа тип 3
     11) Возврат тип 3
     12) Продажа тип 4
     13) Возврат тип 4
     14) Количество продаж (для Штрихов кол-во чеков)
Четвёртая строка (для Штрих54)
  1. Заводской номер;
  2. Версия ФН;
  3. Состояние жизни (число). В норме число 3 - фискальный режим;
  4. Флаги предупреждения (число). Если не ноль, то проблема;
  5. Срок действия ФН
   

Пример чека с признаком агента Комиссионер

1;1;0;0.00;600.00;1;Администратор;;;11;600.00;;0;0.00;0.00;600.00;;;0;;1031;;0;;Кассир ;Администратор;0;0;0;0;6;
товар 2 с комиссией;1,00;500,00;1;0;0;2;;2;500,00;500580;;товар 2 с комиссией;;0;0;;;;;0;4;4;83.33;7720123471;ООО Хорошая фирма;79255077305;
товар 1 без комиссии;1,00;100,00;1;0;0;1;;2;100,00;500581;;товар 1 без комиссии;;0;0;;;;;0;4;4;16.67;;;;
 
 

 

 
Главная страница. Описание формата xte
         
     
         
 
 
ООО Модульные Системы (c) 1996-2017. Все права защищены.
Использование материалов и графики с сайта без согласования с администрацией запрещено