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

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

с 10.00 до 19.00




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

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


Разделители полей - точка с запятой (;)

Первая строка в файле чека с расширением 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-чек коррекции приход. При этом в поле 13-Код клиента Тип коррекции: 0-самостоятельно, 1- по предписанию, а в поле 19 код оператора нужно проставить код системы налогообложения
    0-Основная
    1-Упрощенная доход
    2-Упрощенная доход - расход
    3-ЕНВД
    4-Единый сельхозналог
    5-Патентная система

 

  •     38-чек коррекции расход. При этом в поле 13-Код клиента Тип коррекции: 0-самостоятельно, 1- по предписанию, а в поле 19 код оператора нужно проставить код системы налогообложения
  •     39-запрос чека из ФН по номеру (номер указывается в поле 10. Для Атол это номер фискального документа, а для Штрих - сквозной номер документа). Если в поле 20 (showInSale) стоит 1, то чек сразу печатается, если ничего или 0, то чек сохраняется с названием fncheck.txt в директории сканирования сервера чеков. Для Штрих54: Если в поле 13 (codeClient) есть число, то это число типа документа, который нужно найти. В этом случае будет производится поиск последнего документа этого типа и далее либо печать, либо сохранение в файле. При этом поле 10 (номер документа в ФН не используется). Поиск может выполняться значительное время (несколько секунд) и зависит от количества документов и от того, что ищем. Если поле 13 равно 7 - то это подтверждение оператора и нужно обязательно заполнить поле 10 Номер документа. При этом будет напечатан документ Подтверждение. Сохранение в fncheck.txt не происходит. Значения, которые можно передавать в поле 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 - показ свойств драйвера
    2) тип оплаты
  •       1-нал
  •       2-безнал
  •       3-продажа без чека
  •       4-возврат без чека
  •       5-комбинированная оплата
  •       6-оплата по 2-му терминалу.
  •       7-аванс
  •       8-кредит
  •       9-оплата встречным представлением
    3) % скидки на чек
    4) скидка руб. на чек
    5) сумма оплаты
    6) номер кассира - число от 1 до 30 
    7) название кассира
    8) номер диск. карты
    9) номер кредитной карты
    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-Патентная система 
Вторая и последующие строки - информация о товаре
    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 - до 70 знаков акцизной марки
    19: Емкость в литрах
    20: Крепость в градусах 
    21: Признак весового  товара (1-да)
    22: Предмет расчёта (1-12) по умолчанию 1 - товар (работа - 3, услуга - 4, 12-иной предмет расчёта)
    • товар, за исключением подакцизного товара
    • подакцизный товар
    • выполняемая работа
    • оказываемая услуга
    • прием ставок при осуществлении деятельности по проведению азартных игр
    • выплата денежных средств в виде выигрыша при проведению азартных игр
    • прием денежных средств при реализации лотерейных билетов, ставок
    • выплата денежных средств в виде выигрыша при проведению лотерей
    • предоставление прав на использование результатов интеллектуальной деятельности
    • аванс, задаток, предоплата, кредит, взнос в счет оплаты, пени, штраф, вознаграждение, бонус
    • составной предмет расчёта
    • иной предмет расчёта, не относящийся к перечисленным выше
    23: Способ расчёта (1-7) по умолчанию 4 - полный расчёт
    • Полная предварительная оплата до момента передачи предмета расчета
    • Частичная предварительная оплата до момента передачи предмета расчета
    • Аванс
    • Полная оплата, в т.ч. с учетом аванса в момент передачи предмета расчета
    • Частичная оплата предмета расчета в момент его передачи с последующей оплатой в кредит
    • Передача предмета расчета без его оплаты с последующей оплатой в кредит
    • Оплата предмета расчета после его передачи с оплатой в кредит (оплата кредита)
 
 
    24: Сумма налога на позицию
    25: ИНН поставщика (тег 1226) до 12 знаков Например  007720571071 Если ИНН 12 семёрок (777777777777), то теги 1226 и 1171 не передаются.
    26: Наименование поставщика (тег 1224)  
    27: телефон поставщика (тег 1171 в виде +79255077305)
Для вывода информации по 13 и 14-му полю требуется в настройках поставить галочку Выводить доп. инф. о товаре (BigTxtStr). Разделители строки - символ ^ (крышечка).
Для касс Атол возможно выделение текста путем удвоения ширины (произвольной области печати, ограниченной символами !{ начало и !} окончание).

 

Для вывода информации по 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, по которому печатался чек.
 
Для оплаты с авторизацией название чека должно быть sbrf.xte.
Если нужно напечатать чек с оплатой по безналичному расчету без авторизации, то название файла должно быть любое кроме sbrf.xte
 
Если нужно напечатать товарный чек на кассовом принтере, название файла должно быть tovcheck.xte
Если нужно напечатать товарный чек на принтере через драйвер, название файла должно быть tovchek.xte
 
Начиная с версии 45.5

в режиме сервера чеков можно печатать текстовые строки, штрихкоды, отрезы и т.д. не только в режиме 10, а в режиме формирования чеков продажи или возврата.

Это позволяет создать единый документ в виде одного xte-файла, в котором будет рекламный блок, подробная информация о товаре, чек безналичной оплаты и его копия и кассовый чек.

Можно протягивать бумагу, печатать дополнительные клише, выделять жирным шрифтом, отрезать полностью или частично.

Для активизации этих возможностей любая строка, начиная со 2-й в файле xte должна начинаться c перв символа @ (в чеках продажи или возврата).

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

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

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

Пример:

@{pc}далее текст. Текст будет перенесён по словам и отцентрирован.

Символ b или B это жирный удвоенный шрифт. Количество символов в строке при этом сокращается в 2 раза.

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

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

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

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

Пример:

@{.}

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

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

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

Пример:

@{f3}

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

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

1 это EAN-13

6 это QR-код

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

Пример:

EAN-13

@{#1}4650000343933

Или QR-код

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

 

Дополнительная информация по режиму сервера чеков:

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

     считывания из файла a100_d.err.
     Кодировка может быть Dos или Win1251. Примеры приведены в кодировке Dos

 
Содержимое файла kkmInfo.txt
Первая строка
     1) Модель кассы (текст);
     2) Режим;
     3) Подрежим;
     4) Признак наличия бумаги; 
     5) Текущее состояние чека;
     6) Код последней ошибки; 
     7) Описание последней ошибки;
Вторая строка
     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) Количество продаж (для Штрихов кол-во чеков)

Примеры файлов xte

Напечатать х-отчёт:

3;;;;;;;;;;;;;;;;;;;;;;;;;;

Чек с продажей:

1;1;;0;0.01;30;Администратор;;;;;;

;1;0.01;0;;;;;0;;;;Договор: 1-030-2001302;

Или

1;1;;0;1;30;oper1;;;;;;

;1;1;0;;;;2;;;;;ФИО: "Информ-связь" ООО^Лицевой счет: 646017601^;

Продажа с тремя товарами

1;1;;0.00;5000.00;1;Администратор;;;

панадол 125мг №10 суппоз. с;1.000;81.30;1;;;20873;4602233002644;1;

панадол 125мг №10 суппоз. с;1.000;81.30;1;;;20873;4602233002644;1;

панавир 0.004%-5мл №5амп.;1.000;4340.46;1;;;21673;4600828003250;1;

 

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