Оглавление
Полное и самое актуальное описание протокола
СКАЧАТЬ ЗДЕСЬ
Общее
ККМ общается с внешним миром через HTTP-запросы. Как правило, при использовании локально подключенной ККМ, адресом будет что-то вроде http://localhost:номер порта. Однако ничто не мешает общаться с кассой и из внешнего мира. Компания Армакс предоставляет такой доступ для разработчиков:
- Тестовый доступ открыт на office.armax.ru:58088.
- В качестве транспорта используется http протокол (без шифрования).
- Авторизация — Basic Authentication. Логин — номер кассира. Пароль — пароль кассира. По умолчанию и то, и другое — числа от 1 до 99 (логин и пароль одинаковые).
- При ошибках обмена возвращаются ошибочные состояния HTTP.
- При ошибках внутри кассы — коды ошибок совместимые с ККМ Атол (см. Протокол ККТ 3.1.pdf).
- При возникновении ошибки (в документе поле result не нулевое) поле <result> содержит код ошибки. Поля <data> нет. Может быть не пустое поле <message>.
- Описание форматов фискальных данных
Запросы
В качестве контейнера используем XML или JSON. Если не хватает данных — используются умолчания (реализовано для экономии трафика; обсуждаемо).
ВНИМАНИЕ! office.armax.ru:58088 — это тестовая касса, доступ к которой разрешен всем. Это НЕ удаленный сервер, перенаправляющий запросы на Вашу копию онлайн кассы.
1. Получение состояния кассы
-
GET http://office.armax.ru:58088/cashboxstatus.xml
Пример ответа
GETXHTML123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131<?xml version="1.0" encoding="UTF-8"?><cashboxStatus version="1.0"><!-- признак агента (1057) — из текущих данных фискализации --><agentFlags>79</agentFlags><!-- признак проведения азартных игр — из текущих данных фискализации --><allowGames>false</allowGames><!-- признак проведения лотереи — из текущих данных фискализации --><allowLotteries>false</allowLotteries><!-- признак расчетов за услуги — из текущих данных фискализации --><allowServices>true</allowServices><!-- номер автомата — из текущих данных фискализации --><atmNumber>1111</atmNumber><!-- признак автоматического режима — из текущих данных фискализации --><automatMode>true</automatMode><!-- наличность в кассе - строка (в копейках) --><cash>10459558</cash><!-- номер ккм в зале --><cashBoxNumber>1</cashBoxNumber><!-- номер кассира (в текущем режиме) --><cashier>7</cashier><!-- номер смены (текущей или следующей, если закрыта) --><cycleNumber>8</cycleNumber><!-- дата/время в кассе RFC2822 --><dt>2017-05-26T12:54:20 +03:00</dt><!-- адрес электронной почты отправителя чека — из текущих данных фискализации --><email>a@b.ru</email><!-- продажа подакцизного товара — из текущих данных фискализации --><excisableGoods>false</excisableGoods><!-- признак установки принтера в автомате — из текущих данных фискализации --><externPrinter>false</externPrinter><!-- версия ФФД ФН — из текущих данных фискализации --><fSfDfVersion>2</fSfDfVersion><!-- версия ФФД ККТ — из текущих данных фискализации --><fdfVersion>2</fdfVersion><!-- Флаги состояния ККМ(примечание 1) --><flags>75</flags><!-- адрес сайта ФНС— из текущих данных фискализации --><fnsSite>www.nalog.ru</fnsSite><!-- Состояние фискального накопителя --><fsStatus><!-- флаг открытия смены. Передается только если смена открыта --><cycleIsOpen>1</cycleIsOpen><!-- передается только если версяи ФН отладочная --><debugMode>1</debugMode><!-- Номер фискального накопителя --><fsNumber>9999078900000972</fsNumber><!-- версия фискального накопителя --><fsVersion>fn debug v 1.32</fsVersion><!-- Дата последнего документа --><lastDocDt>2017-05-26T11:31:00</lastDocDt><!-- номер последнего документа --><lastDocNumber>100</lastDocNumber><lifeTime><!-- доступно перерегистраций --><availableRegistrations>11</availableRegistrations><!-- выполнено перерегистраций --><completedRegistrations>1</completedRegistrations><!-- дата окончания срока использования фн (если ккм не фискальзирована — не передается) --><expirationDt>2018-06-10</expirationDt></lifeTime><!-- фаза жизни ФН (примечание 2) --><phase>3</phase><!-- Состояние обмена с ОФД --><transport><!-- Дата первого неотправленного документа --><firstDocDt>2017-05-26T13:01:00</firstDocDt><!-- Номер первого неотправленного документа --><firstDocNumber>101</firstDocNumber><!-- Количество неотправленных документов --><offlineDocsCount>1</offlineDocsCount><!-- Состояние обмена с ОФД (примечание 3) --><state>3</state></transport></fsStatus><!-- признак ККТ для расчетов только в Интернет — из текущих данных фискализации --><internetOnly>false</internetOnly><!-- количество внесений --><introductions>1</introductions><!-- сумма внесений (в копейках) --><introductionsSum>10000</introductionsSum><!-- признак АС БСО — из текущих данных фискализаци --><makeBso>false</makeBso><!-- Режим работы кассы (примечание 4) --><mode>1</mode><!-- модель кассы --><model>201</model><!-- Модель кассы/фр --><modelstr>УМКА-01-ФА</modelstr><!-- ИНН ОФД — из текущих данных фискализации --><ofdInn>7709364346</ofdInn><!-- наименование ОФД — из текущих данных фискализации --><ofdName>Акционерное общество Энергетические системы и коммуникации</ofdName><!-- признак автономного режима — из текущих данных фискализации --><offlineMode>false</offlineMode><!-- адрес расчетов — из текущих данных фискализации --><paymentAddress>г. Воронеж, ул. Липецкая, д.3</paymentAddress><!-- место расчетов — из текущих данных фискализации --><paymentPlace>ОФИС1</paymentPlace><!-- количество выплат --><payouts>1</payouts><!-- сумма выплат (в копейках) --><payoutsSum>10000</payoutsSum><!-- ИНН кассира --><regCashierInn>000000000000</regCashierInn><!-- кассир --><regCashierName>CASHIER 17</regCashierName><!-- дата фискализации --><regDate>2017-07-12</regDate><!-- Номер документа фискализации — из текущих данных фискализации --><regDocNumber>1</regDocNumber><!-- регистрационный номер ККМ --><regNumber>0000000001019507</regNumber><!-- заводской номер ККМ --><serial>17000012</serial><!-- короткое состояние ККМ (дополнительные флаги примечание 5) --><shortFlags>3</shortFlags><!-- подрежим работы ккм (примечание 4) --><subMode>0</subMode><!-- minor version --><subver>1</subver><!-- системы налогообложения — из текущих данных фискализации--><taxes>15</taxes><!-- признак шифрования — из текущих данных фискализации --><useEncryption>false</useEncryption><!-- ИНН пользователя — из текущих данных фискализации --><userInn>7725225244</userInn><!-- наименование пользователя — из текущих данных фискализации --><userName>ООО ВЕКТОР-М</userName><!-- major version --><ver>0</ver></cashboxStatus> -
GET http://office.armax.ru:58088/cashboxstatus.json
Пример ответа
JavaScript123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172{"cashboxStatus": {"agentFlags": 79,"allowGames": false,"allowLotteries": false,"allowServices": true,"atmNumber": "1111 ","automatMode": true,"cash": 400000,"cashBoxNumber": 1,"cashier": 2,"cycleNumber": 4,"dt": "17 Jul 2017 12:01:11 +0400","email": "a@b.ru","excisableGoods": false,"externPrinter": false,"fSfDfVersion": 2,"fdfVersion": 0,"flags": 75,"fnsSite": "www.nalog.ru","fsNumber": "9999078900002164","fsStatus": {"cycleIsOpen": 1,"debugMode": true,"fsNumber": "9999078900002164","fsVersion": "fn debug v 1.32","lastDocDt": "2017-07-17T10:43:00","lastDocNumber": 29,"lifeTime": {"availableRegistrations": 11,"completedRegistrations": 1,"expirationDt": "2018-08-20"},"phase": 3,"transport": {"docIsReading": true,"firstDocDt": null,"firstDocNumber": 0,"offlineDocsCount": 0,"state": 0}},"internetOnly": false,"introductions": 0,"introductionsSum": 0,"makeBso": false,"mode": 1,"model": 201,"modelstr": "УМКА-01-ФА","ofdInn": "7709364346","ofdName": "Акционерное общество Энергетические системы и коммуникации","offlineMode": false,"paymentAddress": "г. Воронеж, ул. Липецкая, д.3","paymentPlace": "ОФИС1","payouts": 0,"payoutsSum": 0,"regCashierInn": "000000000000","regCashierName": "CASHIER 17","regDate": "2017-07-12","regDocNumber": 1,"regNumber": "0000000001020321","serial": 17000001,"shortFlags": 3,"subMode": 0,"subver": 1,"taxes": 15,"useEncryption": false,"userInn": "7725225244","userName": "ООО ВЕКТОР-М","ver": 0}} -
ПРИМЕЧАНИЕ 1. ФЛАГИ СОСТОЯНИЯ ККМ
Битовое поле (назначение бит):
0-й – ККТ фискализирована (0 — нет, 1 — да);
1-й – смена открыта (0 — нет, 1 — да);
2-й – состояние денежного ящика (0 — открыт, 1 — закрыт),
3-й – датчик ЧЛ (0 — нет бумаги, 1 — есть бумага);
4-й – бит не используется;
5-й – состояние датчика крышки (0 – крышка закрыта, 1 – крышка открыта);
6-й – состояние ФН: 0 – не активизирован, 1 – активизирован);
7-й – равен 1, применимо, если батарейка установлена.
-
ПРИМЕЧАНИЕ 2: ФАЗЫ ЖИЗНИ ФН
Жизненный цикл фискального накопителя включает ряд стадий, в процессе производства и эксплуатации ФН переходит из одной фазы жизни в другую. Переход между фазами выполняется в одностороннем порядке, то есть возврат из определенной фазы на предыдущую фазу жизненного цикла невозможен.
Существуют следующие фазы жизни:
1. Готовность к фискализации.
2. Фискальный режим.
3. Постфискальный режим (передача фискальных документов в ОФД).
4. Доступ к Архиву ФН.
-
ПРИМЕЧАНИЕ 3: СОСТОЯНИЕ ОБМЕНА С ОФД
(0 – нет, 1 – да)
Бит 0 – транспортное соединение установлено
Бит 1 – есть сообщение для передачи в ОФД
Бит 2 – ожидание ответного сообщения (квитанции) от ОФД
Бит 3 – есть команда от ОФД
Бит 4 – изменились настройки соединения с ОФД
Бит 5 – ожидание ответа на команду от ОФД
-
ПРИМЕЧАНИЕ 4: РЕЖИМЫ РАБОТЫ КАССЫ
См. режимы атоловских касс. Протокол ККТ 3.1.pdf стр. 77
-
ПРИМЕЧАНИЕ 5: КОРОТКОЕ СОСТОЯНИЕ ККМ
Флаги.
0-й (младший) бит: 0 – бумага есть, 1 – нет бумаги (в принтере чеков).
1-й бит: 0 – связь с принтером установлена, 1 – нет связи с принтером.
2-й бит: бит зарезервирован, при считывании возвращает 0.
3-й бит: 0 – нет ошибок отрезчика, 1 – ошибка отрезчика
4-й бит: 0 – нет ошибок принтера, 1 – восстановимая ошибка принтера (перегрев).
5-й и 6-й биты зарезервированы и не используются.
2. Получение документа из фискального накопителя.
-
GET http://office.armax.ru:58088/fiscaldoc.xml?number=12&print=1
Принимает параметры:
number — номер документа
print — флаг необходимости печати документаПример ответа:
XHTML123456789101112131415161718192021222324252627282930<?xml version="1.0" encoding="UTF-8"?><document version="1.0"><data><!-- номер (ФД) документа --><docNumber>12</docNumber><!-- ТИП документа (см. форматы фискальных данных) --><docType>2</docType><!-- Реквизиты документа (см. форматы фискальных данных) --><fiscprops><prop tag="1009" value="г. Воронеж, ул. Липецкая, д.3">г. Воронеж, ул. Липецкая, д.3</prop><prop tag="1018" caption="ИНН" value="7725225244 ">ИНН 7725225244</prop><prop tag="1021" caption="КАССИР" value="СЕМЕНОВ С.К.">КАССИР СЕМЕНОВ С.К.</prop><prop tag="1048" value="ООО ВЕКТОР-М">ООО ВЕКТОР-М</prop><prop tag="1187" caption="МЕСТО РАСЧЕТОВ" value="ОФИС1">МЕСТО РАСЧЕТОВ ОФИС1</prop><prop tag="1012" value="16 May 2017 14:52:00 +0300">16.05.17 14:52</prop><prop tag="1038" caption="СМЕНА" value="2">СМЕНА 2</prop><prop tag="1188" caption="ВЕР. ККТ" value="0.1">ВЕР. ККТ 0.1</prop><prop tag="1189" caption="ФФД ККТ" value="2">ФФД ККТ 1.05</prop><prop tag="1209" value="2" /><prop tag="1037" caption="РН ККТ" value="0000000001019507 ">РН ККТ 0000000001019507</prop><prop tag="1040" caption="ФД" value="12">ФД 12</prop><prop tag="1041" caption="ФН" value="9999078900000972">ФН 9999078900000972</prop><prop tag="1077" caption="ФП" value="23044b710774">ФП 1265698676</prop></fiscprops><!-- Наименование документа --><name>Отчет об открытии смены</name></data><!-- Результат операции --><result>0</result></document> -
GET http://office.armax.ru:58088/fiscaldoc.json?number=12&print=1
Принимает параметры:
number — номер документа
print — флаг необходимости печати документаПример ответа:
JavaScript1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192{"document": {"data": {"docNumber": 12,"docType": 2,"fiscprops": [{"printable": "г. Воронеж, ул. Липецкая, д.3","tag": 1009,"value": "г. Воронеж, ул. Липецкая, д.3"},{"caption": "ИНН","printable": "ИНН\t7725225244","tag": 1018,"value": "7725225244 "},{"caption": "КАССИР","printable": "КАССИР\tСЕМЕНОВ С.К.","tag": 1021,"value": "СЕМЕНОВ С.К."},{"printable": "ООО ВЕКТОР-М","tag": 1048,"value": "ООО ВЕКТОР-М"},{"caption": "МЕСТО РАСЧЕТОВ","printable": "МЕСТО РАСЧЕТОВ\tОФИС1","tag": 1187,"value": "ОФИС1"},{"printable": "16.05.17 14:52","tag": 1012,"value": "16 May 2017 14:52:00 +0300"},{"caption": "СМЕНА","printable": "СМЕНА\t2","tag": 1038,"value": 2},{"caption": "ВЕР. ККТ","printable": "ВЕР. ККТ\t0.1","tag": 1188,"value": "0.1"},{"caption": "ФФД ККТ","printable": "ФФД ККТ\t 1.05","tag": 1189,"value": 2},{"printable": "","tag": 1209,"value": 2},{"caption": "РН ККТ","printable": "РН ККТ\t0000000001019507","tag": 1037,"value": "0000000001019507 "},{"caption": "ФД","printable": "ФД\t12","tag": 1040,"value": 12},{"caption": "ФН","printable": "ФН\t9999078900000972","tag": 1041,"value": "9999078900000972"},{"caption": "ФП","printable": "ФП\t1265698676","tag": 1077,"value": "23044b710774"}],"name": "Отчет об открытии смены"},"result": 0}}
3. Открытие смены
(см. форматы фискальных данных)
-
GET http://office.armax.ru:58088/cycleopen.xml?print=1
Принимает параметры:
print — флаг необходимости печати документаПример ответа:
XHTML12345678910111213141516171819202122232425<?xml version="1.0" encoding="UTF-8"?><document version="1.0"><data><docNumber>34</docNumber><docType>2</docType><fiscprops><prop tag="1009" value="г. Воронеж, ул. генерала Лизюкова, д.4">г. Воронеж, ул. генерала Лизюкова, д.4</prop><prop tag="1018" caption="ИНН" value="7725225244 ">ИНН 7725225244</prop><prop tag="1021" caption="КАССИР" value="КАССИР 2">КАССИР КАССИР 2</prop><prop tag="1048" value="ООО ВЕКТОР-М">ООО ВЕКТОР-М</prop><prop tag="1187" caption="МЕСТО РАСЧЕТОВ" value="Офис 7">МЕСТО РАСЧЕТОВ Офис 7</prop><prop tag="1012" value="11 Aug 2017 15:13:00 +0400">11.08.17 15:13</prop><prop tag="1038" caption="СМЕНА" value="8">СМЕНА 8</prop><prop tag="1188" caption="ВЕР. ККТ" value="0.1">ВЕР. ККТ 0.1</prop><prop tag="1189" caption="ФФД ККТ" value="2">ФФД ККТ 1.05</prop><prop tag="1209" value="2" /><prop tag="1037" caption="РН ККТ" value="0000000001020321 ">РН ККТ 0000000001020321</prop><prop tag="1040" caption="ФД" value="34">ФД 34</prop><prop tag="1041" caption="ФН" value="9999078900002164">ФН 9999078900002164</prop><prop tag="1077" caption="ФП" value="230499d6dbdb">ФП 2580995035</prop></fiscprops><name>Отчет об открытии смены</name></data><result>0</result></document> -
GET http://office.armax.ru:58088/cycleopen.json?print=1
Принимает параметры:
print — флаг необходимости печати документаПример ответа:
JavaScript12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394{"document": {"data": {"docNumber": 36,"docType": 2,"fiscprops": [{"printable": "г. Воронеж, ул. генерала Лизюкова, д.4","tag": 1009,"value": "г. Воронеж, ул. генерала Лизюкова, д.4"},{"caption": "ИНН","printable": "ИНН\t7725225244","tag": 1018,"value": "7725225244 "},{"caption": "КАССИР","printable": "КАССИР\tКАССИР 2","tag": 1021,"value": "КАССИР 2"},{"printable": "ООО ВЕКТОР-М","tag": 1048,"value": "ООО ВЕКТОР-М"},{"caption": "МЕСТО РАСЧЕТОВ","printable": "МЕСТО РАСЧЕТОВ\tОфис 7","tag": 1187,"value": "Офис 7"},{"printable": "11.08.17 15:15","tag": 1012,"value": "11 Aug 2017 15:15:00 +0400"},{"caption": "СМЕНА","printable": "СМЕНА\t9","tag": 1038,"value": 9},{"caption": "ВЕР. ККТ","printable": "ВЕР. ККТ\t0.1","tag": 1188,"value": "0.1"},{"caption": "ФФД ККТ","printable": "ФФД ККТ\t 1.05","tag": 1189,"value": 2},{"printable": "","tag": 1209,"value": 2},{"caption": "РН ККТ","printable": "РН ККТ\t0000000001020321","tag": 1037,"value": "0000000001020321 "},{"caption": "ФД","printable": "ФД\t36","tag": 1040,"value": 36},{"caption": "ФН","printable": "ФН\t9999078900002164","tag": 1041,"value": "9999078900002164"},{"caption": "ФП","printable": "ФП\t417905539","tag": 1077,"value": "230418e8bb83"}],"name": "Отчет об открытии смены"},"result": 0},"protocol": 1,"version": "1.0"}
4. Закрытие смены
(см. форматы фискальных данных)
-
GET http://office.armax.ru:58088/cycleclose.xml?print=1
Принимает параметры:
print — флаг необходимости печати документаПример ответа:
XHTML12345678910111213141516171819202122232425262728293031323334353637383940414243444546<?xml version="1.0" encoding="UTF-8"?><document version="1.0"><data><docNumber>33</docNumber><docType>5</docType><fiscprops><prop tag="1009" value="г. Воронеж, ул. генерала Лизюкова, д.4">г. Воронеж, ул. генерала Лизюкова, д.4</prop><prop tag="1018" caption="ИНН" value="7725225244 ">ИНН 7725225244</prop><prop tag="1021" caption="КАССИР" value="КАССИР 2">КАССИР КАССИР 2</prop><prop tag="1048" value="ООО ВЕКТОР-М">ООО ВЕКТОР-М</prop><prop tag="1187" caption="МЕСТО РАСЧЕТОВ" value="Офис 7">МЕСТО РАСЧЕТОВ Офис 7</prop><prop tag="1012" value="11 Aug 2017 15:12:00 +0400">11.08.17 15:12</prop><prop tag="1038" caption="СМЕНА" value="7">СМЕНА 7</prop><prop tag="1050" caption="РЕСУРС ФН МЕНЕЕ 30 ДНЕЙ" value="false" /><prop tag="1051" caption="РЕСУРС ФН МЕНЕЕ 3 ДНЕЙ" value="false" /><prop tag="1052" caption="ПАМЯТЬ ФН ЗАПОЛНЕНА" value="false" /><prop tag="1053" caption="ОФД НЕ ОТВЕЧАЕТ" value="false" /><prop tag="1097" caption="НЕПЕРЕДАННЫХ ФД" value="0">НЕПЕРЕДАННЫХ ФД 0</prop><prop tag="1098" caption="ФД НЕ ПЕРЕДАНЫ С" value="01 Jan 1970 00:00:00 +0300">ФД НЕ ПЕРЕДАНЫ С 00.00.00</prop><prop tag="1111" caption="ФД ЗА СМЕНУ" value="2">ФД ЗА СМЕНУ 2</prop><prop tag="1118" caption="ЧЕКОВ ЗА СМЕНУ" value="0">ЧЕКОВ ЗА СМЕНУ 0</prop><prop tag="1194" value=""><fiscprops><prop tag="1134" caption="ВСЕГО ЧЕКОВ" value="0">ВСЕГО ЧЕКОВ 0</prop><prop tag="1129" caption="ПРИХОД" value=""><fiscprops><prop tag="3004" caption="ГРОСС ИТОГ ПРИХ." value="155568">ГРОСС ИТОГ ПРИХ. 1555,68</prop></fiscprops></prop><prop tag="1133" caption="КОРРЕКЦИИ" value=""><fiscprops><prop tag="1144" caption="ЧЕКОВ КОРРЕКЦИИ" value="0">ЧЕКОВ КОРРЕКЦИИ 0</prop></fiscprops></prop></fiscprops></prop><prop tag="1209" value="2" /><prop tag="1037" caption="РН ККТ" value="0000000001020321 ">РН ККТ 0000000001020321</prop><prop tag="1040" caption="ФД" value="33">ФД 33</prop><prop tag="1041" caption="ФН" value="9999078900002164">ФН 9999078900002164</prop><prop tag="1077" caption="ФП" value="2404a6f5b445">ФП 2801120325</prop></fiscprops><name>Отчет о закрытии смены</name></data><result>0</result></document> -
GET http://office.armax.ru:58088/cycleclose.json?print=1
Принимает параметры:
print — флаг необходимости печати документаПример ответа:
JavaScript123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165{"document": {"data": {"docNumber": 35,"docType": 5,"fiscprops": [{"printable": "г. Воронеж, ул. генерала Лизюкова, д.4","tag": 1009,"value": "г. Воронеж, ул. генерала Лизюкова, д.4"},{"caption": "ИНН","printable": "ИНН\t7725225244","tag": 1018,"value": "7725225244 "},{"caption": "КАССИР","printable": "КАССИР\tКАССИР 2","tag": 1021,"value": "КАССИР 2"},{"printable": "ООО ВЕКТОР-М","tag": 1048,"value": "ООО ВЕКТОР-М"},{"caption": "МЕСТО РАСЧЕТОВ","printable": "МЕСТО РАСЧЕТОВ\tОфис 7","tag": 1187,"value": "Офис 7"},{"printable": "11.08.17 15:14","tag": 1012,"value": "11 Aug 2017 15:14:00 +0400"},{"caption": "СМЕНА","printable": "СМЕНА\t8","tag": 1038,"value": 8},{"caption": "РЕСУРС ФН МЕНЕЕ 30 ДНЕЙ","printable": "","tag": 1050,"value": false},{"caption": "РЕСУРС ФН МЕНЕЕ 3 ДНЕЙ","printable": "","tag": 1051,"value": false},{"caption": "ПАМЯТЬ ФН ЗАПОЛНЕНА","printable": "","tag": 1052,"value": false},{"caption": "ОФД НЕ ОТВЕЧАЕТ","printable": "","tag": 1053,"value": false},{"caption": "НЕПЕРЕДАННЫХ ФД","printable": "НЕПЕРЕДАННЫХ ФД\t1","tag": 1097,"value": 1},{"caption": "ФД НЕ ПЕРЕДАНЫ С","printable": "ФД НЕ ПЕРЕДАНЫ С\t11.08.17","tag": 1098,"value": "11 Aug 2017 15:13:00 +0400"},{"caption": "ФД ЗА СМЕНУ","printable": "ФД ЗА СМЕНУ\t2","tag": 1111,"value": 2},{"caption": "ЧЕКОВ ЗА СМЕНУ","printable": "ЧЕКОВ ЗА СМЕНУ\t0","tag": 1118,"value": 0},{"fiscprops": [{"caption": "ВСЕГО ЧЕКОВ","printable": "ВСЕГО ЧЕКОВ\t0","tag": 1134,"value": 0},{"caption": "ПРИХОД","fiscprops": [{"caption": "ГРОСС ИТОГ ПРИХ.","printable": "ГРОСС ИТОГ ПРИХ.\t1555,68","tag": 3004,"value": 155568}],"tag": 1129},{"caption": "КОРРЕКЦИИ","fiscprops": [{"caption": "ЧЕКОВ КОРРЕКЦИИ","printable": "ЧЕКОВ КОРРЕКЦИИ\t0","tag": 1144,"value": 0}],"tag": 1133}],"tag": 1194},{"printable": "","tag": 1209,"value": 2},{"caption": "РН ККТ","printable": "РН ККТ\t0000000001020321","tag": 1037,"value": "0000000001020321 "},{"caption": "ФД","printable": "ФД\t35","tag": 1040,"value": 35},{"caption": "ФН","printable": "ФН\t9999078900002164","tag": 1041,"value": "9999078900002164"},{"caption": "ФП","printable": "ФП\t3530041966","tag": 1077,"value": "2404d2682a6e"}],"name": "Отчет о закрытии смены"},"result": 0},"protocol": 1,"version": "1.0"}
5. Получение отчета о состояние расчетов
(см. форматы фискальных данных).
В зависимости от версии ФН, отчет необходимо получать при закрытой смене, иначе ошибка 212 (Неверное состояние ФН).
-
GET http://office.armax.ru:58088/calcreport.xml?print=1
Принимает параметры:
print — флаг необходимости печати документаПример ответа:
XHTML12345678910111213141516171819202122232425<?xml version="1.0" encoding="UTF-8"?><document version="1.0"><data><docNumber>38</docNumber><docType>21</docType><fiscprops><prop tag="1009" value="г. Воронеж, ул. генерала Лизюкова, д.4">г. Воронеж, ул. генерала Лизюкова, д.4</prop><prop tag="1018" caption="ИНН" value="7725225244 ">ИНН 7725225244</prop><prop tag="1048" value="ООО ВЕКТОР-М">ООО ВЕКТОР-М</prop><prop tag="1187" caption="МЕСТО РАСЧЕТОВ" value="Офис 7">МЕСТО РАСЧЕТОВ Офис 7</prop><prop tag="1002" caption="АВТОНОМН. РЕЖИМ" value="false" /><prop tag="1012" value="11 Aug 2017 15:35:00 +0400">11.08.17 15:35</prop><prop tag="1097" caption="НЕПЕРЕДАННЫХ ФД" value="1">НЕПЕРЕДАННЫХ ФД 1</prop><prop tag="1098" caption="ФД НЕ ПЕРЕДАНЫ С" value="11 Aug 2017 15:35:00 +0400">ФД НЕ ПЕРЕДАНЫ С 11.08.17</prop><prop tag="1116" caption="ПЕРВЫЙ НЕПЕРЕДАННЫЙ ФД" value="37">ПЕРВЫЙ НЕПЕРЕДАННЫЙ ФД 37</prop><prop tag="1209" value="2" /><prop tag="1037" caption="РН ККТ" value="0000000001020321 ">РН ККТ 0000000001020321</prop><prop tag="1040" caption="ФД" value="38">ФД 38</prop><prop tag="1041" caption="ФН" value="9999078900002164">ФН 9999078900002164</prop><prop tag="1077" caption="ФП" value="280487a55ac4">ФП 2275760836</prop></fiscprops><name>Отчет о текущем состоянии расчетов</name></data><result>0</result></document> -
GET http://office.armax.ru:58088/calcreport.json?print=1
Принимает параметры:
print — флаг необходимости печати документаПример ответа:
JavaScript12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394{"document": {"data": {"docNumber": 39,"docType": 21,"fiscprops": [{"printable": "г. Воронеж, ул. генерала Лизюкова, д.4","tag": 1009,"value": "г. Воронеж, ул. генерала Лизюкова, д.4"},{"caption": "ИНН","printable": "ИНН\t7725225244","tag": 1018,"value": "7725225244 "},{"printable": "ООО ВЕКТОР-М","tag": 1048,"value": "ООО ВЕКТОР-М"},{"caption": "МЕСТО РАСЧЕТОВ","printable": "МЕСТО РАСЧЕТОВ\tОфис 7","tag": 1187,"value": "Офис 7"},{"caption": "АВТОНОМН. РЕЖИМ","printable": "","tag": 1002,"value": false},{"printable": "11.08.17 15:41","tag": 1012,"value": "11 Aug 2017 15:41:00 +0400"},{"caption": "НЕПЕРЕДАННЫХ ФД","printable": "НЕПЕРЕДАННЫХ ФД\t0","tag": 1097,"value": 0},{"caption": "ФД НЕ ПЕРЕДАНЫ С","printable": "ФД НЕ ПЕРЕДАНЫ С\t00.00.00","tag": 1098,"value": "01 Jan 1970 00:00:00 +0300"},{"caption": "ПЕРВЫЙ НЕПЕРЕДАННЫЙ ФД","printable": "ПЕРВЫЙ НЕПЕРЕДАННЫЙ ФД\t0","tag": 1116,"value": 0},{"printable": "","tag": 1209,"value": 2},{"caption": "РН ККТ","printable": "РН ККТ\t0000000001020321","tag": 1037,"value": "0000000001020321 "},{"caption": "ФД","printable": "ФД\t39","tag": 1040,"value": 39},{"caption": "ФН","printable": "ФН\t9999078900002164","tag": 1041,"value": "9999078900002164"},{"caption": "ФП","printable": "ФП\t3407562530","tag": 1077,"value": "2804cb1b4722"}],"name": "Отчет о текущем состоянии расчетов"},"result": 0},"protocol": 1,"version": "1.0"}
6. Получение X-отчет
(см. форматы фискальных данных)
-
GET http://office.armax.ru:58088/xreport.xml?print=1
Принимает параметры:
print — флаг необходимости печати документаПример ответа:
XHTML12345678910111213141516171819202122232425262728293031323334<?xml version="1.0" encoding="UTF-8"?><document version="1.0"><data><docType>127</docType><fiscprops><prop tag="1009" value="г. Воронеж, ул. генерала Лизюкова, д.4">г. Воронеж, ул. генерала Лизюкова, д.4</prop><prop tag="1018" caption="ИНН" value="7725225244">ИНН 7725225244</prop><prop tag="1021" caption="КАССИР" value="СИС. АДМИН">КАССИР СИС. АДМИН</prop><prop tag="1048" value="ООО ВЕКТОР-М">ООО ВЕКТОР-М</prop><prop tag="1187" caption="МЕСТО РАСЧЕТОВ" value="Офис 7">МЕСТО РАСЧЕТОВ Офис 7</prop><prop tag="1012" value="11 Aug 2017 17:01:30 +0400">11.08.17 17:01</prop><prop tag="1038" caption="СМЕНА" value="10">СМЕНА 10</prop><prop tag="1194" value=""><fiscprops><prop tag="1134" caption="ВСЕГО ЧЕКОВ" value="0">ВСЕГО ЧЕКОВ 0</prop><prop tag="1129" caption="ПРИХОД" value=""><fiscprops><prop tag="3004" caption="ГРОСС ИТОГ ПРИХ." value="155568">ГРОСС ИТОГ ПРИХ. 1555,68</prop></fiscprops></prop><prop tag="1133" caption="КОРРЕКЦИИ" value=""><fiscprops><prop tag="1144" caption="ЧЕКОВ КОРРЕКЦИИ" value="0">ЧЕКОВ КОРРЕКЦИИ 0</prop></fiscprops></prop></fiscprops></prop><prop tag="1037" caption="РН ККТ" value="0000000001020321">РН ККТ 0000000001020321</prop><prop tag="1041" caption="ФН" value="9999078900002164">ФН 9999078900002164</prop></fiscprops><name>Статистика за смену</name></data><result>0</result></document> -
GET http://office.armax.ru:58088/xreport.json?print=1
Принимает параметры:
print — флаг необходимости печати документаПример ответа:
JavaScript123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899{"document": {"data": {"docType": 127,"fiscprops": [{"printable": "г. Воронеж, ул. генерала Лизюкова, д.4","tag": 1009,"value": "г. Воронеж, ул. генерала Лизюкова, д.4"},{"caption": "ИНН","printable": "ИНН\t7725225244","tag": 1018,"value": "7725225244"},{"caption": "КАССИР","printable": "КАССИР\tСИС. АДМИН","tag": 1021,"value": "СИС. АДМИН"},{"printable": "ООО ВЕКТОР-М","tag": 1048,"value": "ООО ВЕКТОР-М"},{"caption": "МЕСТО РАСЧЕТОВ","printable": "МЕСТО РАСЧЕТОВ\tОфис 7","tag": 1187,"value": "Офис 7"},{"printable": "11.08.17 17:02","tag": 1012,"value": "11 Aug 2017 17:02:15 +0400"},{"caption": "СМЕНА","printable": "СМЕНА\t10","tag": 1038,"value": 10},{"fiscprops": [{"caption": "ВСЕГО ЧЕКОВ","printable": "ВСЕГО ЧЕКОВ\t0","tag": 1134,"value": 0},{"caption": "ПРИХОД","fiscprops": [{"caption": "ГРОСС ИТОГ ПРИХ.","printable": "ГРОСС ИТОГ ПРИХ.\t1555,68","tag": 3004,"value": 155568}],"tag": 1129},{"caption": "КОРРЕКЦИИ","fiscprops": [{"caption": "ЧЕКОВ КОРРЕКЦИИ","printable": "ЧЕКОВ КОРРЕКЦИИ\t0","tag": 1144,"value": 0}],"tag": 1133}],"tag": 1194},{"caption": "РН ККТ","printable": "РН ККТ\t0000000001020321","tag": 1037,"value": "0000000001020321"},{"caption": "ФН","printable": "ФН\t9999078900002164","tag": 1041,"value": "9999078900002164"}],"name": "Статистика за смену"},"result": 0},"protocol": 1,"version": "1.0"}
7. Печать чека
Выходной документ такой же, как и в пункте 2.
-
POST http://office.armax.ru:58088/fiscalcheck.xml
Пример данных запроса:
XHTML123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869<?xml version="1.0" encoding="UTF-8"?><document version="1.0"><!-- Уникальное ИД сессии --><sessionId>11111111111111111567</sessionId><!-- Флаг необходимости печати чека --><print>0</print><data><!-- Тип документа (1. Продажа,2.Возврат продажи, 4. Покупка, 5. Возврат покупки, 7. Коррекцияприхода, 9. Коррекция расхода) --><type>1</type><!-- ТИП ОПЛАТЫ (1. Наличным, 2. Электронными, 3. Предоплата, 4. Постоплата, 5. Встречноепредоставление) --><moneyType>1</moneyType><!-- Сумма закрытия чека (может быть 0, если без сдачи) в копейках --><sum>10000000</sum><!-- Реквизиты. см. форматы фискальных данных --><fiscprops><prop tag="1018" value="7725225244" /><prop tag="1037" value="0000000001020321" /><prop tag="1008" value="check@yandex.ney" /><prop tag="1054" value="1" /><prop tag="1055" value="1" /><prop tag="1059"><fiscprops><prop tag="1214" value="4" /><prop tag="1212" value="4" /><prop tag="1222" value="4">ПЛ.АГЕНТ</prop><prop tag="1223"><fiscprops><prop tag="1073" value="11111" /><prop tag="1074" value="22222" /></fiscprops></prop><prop tag="1224"><fiscprops><prop tag="1171" value="33333" /><prop tag="1225" value="Avon" /></fiscprops></prop><prop tag="1226" value="7702203276" /><prop tag="1030" value="Оплата Продукция по каталогам" /><prop tag="1197" value="шт." /><prop tag="1079" value="56465" /><prop tag="1023" value="1.374" /><prop tag="1199" value="1" /><prop tag="1043" value="77583" /></fiscprops></prop><prop tag="1059"><fiscprops><prop tag="1214" value="4" /><prop tag="1212" value="11" /><prop tag="1030" value="Комиссия" /><prop tag="1079" value="3103" /><prop tag="1023" value="1.000" /><prop tag="1199" value="6" /><prop tag="1043" value="3103" /></fiscprops></prop><prop tag="1084"><fiscprops><prop tag="1085" value="ФИО" /><prop tag="1086" value="БАРИНОВ ЕВЛАМПИЙ КАСЬЯНОВИЧ" /></fiscprops></prop><prop tag="1192" value="Я">Я</prop></fiscprops></data></document>
Пример ответа:
XHTML123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778<?xml version="1.0" encoding="UTF-8"?><document version="1.0"><data><data><docNumber>46</docNumber><docType>3</docType><fiscprops><prop tag="1009" value="г. Воронеж, ул. генерала Лизюкова, д.4">г. Воронеж, ул. генерала Лизюкова, д.4</prop><prop tag="1018" caption="ИНН" value="7725225244">ИНН 7725225244</prop><prop tag="1021" caption="КАССИР" value="КАССИР 2">КАССИР КАССИР 2</prop><prop tag="1048" value="ООО ВЕКТОР-М">ООО ВЕКТОР-М</prop><prop tag="1187" caption="МЕСТО РАСЧЕТОВ" value="Офис 7">МЕСТО РАСЧЕТОВ Офис 7</prop><prop tag="1008" caption="ЭЛ. АДР. ПОКУПАТЕЛЯ" value="check@yandex.ney">ЭЛ. АДР. ПОКУПАТЕЛЯ check@yandex.ney</prop><prop tag="1012" value="11 Aug 2017 17:40:39 +0400">11.08.17 17:40</prop><prop tag="1020" caption="ИТОГ" value="80686">ИТОГ 806,86</prop><prop tag="1038" caption="СМЕНА" value="12">СМЕНА 12</prop><prop tag="1042" caption="ЧЕК" value="2">ЧЕК 2</prop><prop tag="1054" value="1">ПРИХОД</prop><prop tag="1055" caption="СНО" value="1">СНО ОСН</prop><prop tag="1059" value=""><fiscprops><prop tag="1214" value="4" /><prop tag="1212" value="4" /><prop tag="1222" value="4">ПЛ.АГЕНТ</prop><prop tag="1223" value=""><fiscprops><prop tag="1073" caption="ТЛФ. ПЛ. АГЕНТА" value="11111">ТЛФ. ПЛ. АГЕНТА 11111</prop><prop tag="1074" caption="ТЛФ. ОП. ПР. ПЛАТЕЖА" value="22222">ТЛФ. ОП. ПР. ПЛАТЕЖА 22222</prop></fiscprops></prop><prop tag="1224" value=""><fiscprops><prop tag="1171" caption="ТЛФ. ПОСТ." value="33333">ТЛФ. ПОСТ. 33333</prop><prop tag="1225" value="Avon">Avon</prop></fiscprops></prop><prop tag="1226" caption="ИНН ПОСТАВЩИКА" value="7702203276">ИНН ПОСТАВЩИКА 7702203276</prop><prop tag="1030" value="Оплата Продукция по каталогам">Оплата Продукция по каталогам</prop><prop tag="1197" value="шт.">шт.</prop><prop tag="1079" value="56465">564,65</prop><prop tag="1023" value="1,374">1,374</prop><prop tag="1199" caption="НДС 18%" value="1">НДС 18%</prop><prop tag="1043" value="77583">775,83</prop></fiscprops></prop><prop tag="1059" value=""><fiscprops><prop tag="1214" value="4" /><prop tag="1212" value="11">АВ</prop><prop tag="1030" value="Комиссия">Комиссия</prop><prop tag="1079" value="3103">31,30</prop><prop tag="1023" value="1,000">1,000</prop><prop tag="1199" value="6" /><prop tag="1043" value="3103">31,30</prop></fiscprops></prop><prop tag="1060" caption="САЙТ ФНС" value="www.nalog.ru">САЙТ ФНС www.nalog.ru</prop><prop tag="1084" value=""><fiscprops><prop tag="1085" value="ФИО">ФИО</prop><prop tag="1086" value="БАРИНОВ ЕВЛАМПИЙ КАСЬЯНОВИЧ">БАРИНОВ ЕВЛАМПИЙ КАСЬЯНОВИЧ</prop></fiscprops></prop><prop tag="1117" caption="ЭЛ. АДР. ОТПРАВИТЕЛЯ" value="a@b.ru">ЭЛ. АДР. ОТПРАВИТЕЛЯ a@b.ru</prop><prop tag="1192" value="Я">Я</prop><prop tag="1209" value="2" /><prop tag="3002" caption="СДАЧА" value="9919314">СДАЧА 99193,14</prop><prop tag="3003" caption="ПРИНЯТО" value="1e+7">ПРИНЯТО 100000,00</prop><prop tag="1037" caption="РН ККТ" value="0000000001020321">РН ККТ 0000000001020321</prop><prop tag="1040" caption="ФД" value="46">ФД 46</prop><prop tag="1041" caption="ФН" value="9999078900002164">ФН 9999078900002164</prop></fiscprops><name>Кассовый чек</name></data></data><result>0</result><sessionId>11111111111111111567</sessionId></document>
-
POST http://office.armax.ru:58088/fiscalcheck.json
Пример данных запроса:
JavaScript123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169{"document": {"sessionId": "111111111111111111111111111118","print": 1,"data": {"docName": "Бланк строгой отчетности","moneyType": 1,"sum": 100000,"type": 1,"fiscprops": [{"tag": 1055,"value": 1},{"tag": 1037,"value": "0000000001020321"},{"tag": 1081,"value": "50000"},{"tag": 1018,"value": "7725225244"},{"tag": 1054,"value": 1},{"tag": 1008,"value": "check@yandex.ney"},{"fiscprops": [{"tag": 1214,"value": 4},{"tag": 1212,"value": 11},{"tag": 1030,"value": "Комиссия"},{"tag": 1079,"value": 3103},{"tag": 1023,"value": "1.000"},{"tag": 1199,"value": 6},{"tag": 1043,"value": 3103}],"tag": 1059},{"fiscprops": [{"tag": 1214,"value": 4},{"tag": 1212,"value": 4},{"tag": 1222,"value": 4},{"fiscprops": [{"tag": 1073,"value": "11111"},{"tag": 1074,"value": "22222"}],"tag": 1223},{"fiscprops": [{"tag": 1171,"value": "33333"},{"tag": 1225,"value": "Avon"}],"tag": 1224},{"tag": 1226,"value": "7702203276"},{"tag": 1030,"value": "Оплата Продукция по каталогам"},{"tag": 1197,"value": "шт."},{"tag": 1079,"value": 56465},{"tag": 1023,"value": "1.000"},{"tag": 1199,"value": 1},{"tag": 1043,"value": 77583}],"tag": 1059},{"tag": 1060,"value": "www.nalog.ru"},{"fiscprops": [{"tag": 1085,"value": "ФИО"},{"tag": 1086,"value": "БАРИНОВ ЕВЛАМПИЙ КАСЬЯНОВИЧ"}],"tag": 1084},{"tag": 1117,"value": "a@k.ru"},{"printable": "Я","tag": 1192,"value": "Я"}]},"result": 0}}
Пример ответа:
JavaScript123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283{"document": {"data": {"data": {"docNumber": 45,"docType": 3,"fiscprops": [{"printable": "г. Воронеж, ул. генерала Лизюкова, д.4","tag": 1009,"value": "г. Воронеж, ул. генерала Лизюкова, д.4"},{"caption": "ИНН","printable": "ИНН\t7725225244","tag": 1018,"value": "7725225244"},{"caption": "КАССИР","printable": "КАССИР\tКАССИР 2","tag": 1021,"value": "КАССИР 2"},{"printable": "ООО ВЕКТОР-М","tag": 1048,"value": "ООО ВЕКТОР-М"},{"caption": "МЕСТО РАСЧЕТОВ","printable": "МЕСТО РАСЧЕТОВ\tОфис 7","tag": 1187,"value": "Офис 7"},{"caption": "ЭЛ. АДР. ПОКУПАТЕЛЯ","printable": "ЭЛ. АДР. ПОКУПАТЕЛЯ\tcheck@yandex.ney","tag": 1008,"value": "check@yandex.ney"},{"printable": "11.08.17 17:33","tag": 1012,"value": "11 Aug 2017 17:33:40 +0400"},{"caption": "ИТОГ","printable": "ИТОГ\t595,68","tag": 1020,"value": 59568},{"caption": "СМЕНА","printable": "СМЕНА\t12","tag": 1038,"value": 12},{"caption": "ЧЕК","printable": "ЧЕК 1","tag": 1042,"value": 1},{"printable": "ПРИХОД","tag": 1054,"value": 1},{"caption": "СНО","printable": "СНО\tОСН","tag": 1055,"value": 1},{"fiscprops": [{"printable": "","tag": 1214,"value": 4},{"printable": "\tАВ","tag": 1212,"value": 11},{"printable": "Комиссия","tag": 1030,"value": "Комиссия"},{"printable": "31,30","tag": 1079,"value": 3103},{"printable": "1,000","tag": 1023,"value": "1,000"},{"caption": "","printable": "","tag": 1199,"value": 6},{"printable": "31,30","tag": 1043,"value": 3103}],"tag": 1059},{"fiscprops": [{"printable": "","tag": 1214,"value": 4},{"printable": "","tag": 1212,"value": 4},{"printable": "\tПЛ.АГЕНТ","tag": 1222,"value": 4},{"fiscprops": [{"caption": "ТЛФ. ПЛ. АГЕНТА","printable": "ТЛФ. ПЛ. АГЕНТА\t11111","tag": 1073,"value": "11111"},{"caption": "ТЛФ. ОП. ПР. ПЛАТЕЖА","printable": "ТЛФ. ОП. ПР. ПЛАТЕЖА\t22222","tag": 1074,"value": "22222"}],"tag": 1223},{"fiscprops": [{"caption": "ТЛФ. ПОСТ.","printable": "ТЛФ. ПОСТ.\t33333","tag": 1171,"value": "33333"},{"printable": "Avon","tag": 1225,"value": "Avon"}],"tag": 1224},{"caption": "ИНН ПОСТАВЩИКА","printable": "ИНН ПОСТАВЩИКА\t7702203276","tag": 1226,"value": "7702203276"},{"printable": "Оплата Продукция по каталогам","tag": 1030,"value": "Оплата Продукция по каталогам"},{"printable": "шт.","tag": 1197,"value": "шт."},{"printable": "564,65","tag": 1079,"value": 56465},{"printable": "1,000","tag": 1023,"value": "1,000"},{"caption": "НДС 18%","printable": "НДС 18%","tag": 1199,"value": 1},{"printable": "564,65","tag": 1043,"value": 56465}],"tag": 1059},{"caption": "САЙТ ФНС","printable": "САЙТ ФНС\twww.nalog.ru","tag": 1060,"value": "www.nalog.ru"},{"fiscprops": [{"printable": "ФИО","tag": 1085,"value": "ФИО"},{"printable": "БАРИНОВ ЕВЛАМПИЙ КАСЬЯНОВИЧ","tag": 1086,"value": "БАРИНОВ ЕВЛАМПИЙ КАСЬЯНОВИЧ"}],"tag": 1084},{"caption": "ЭЛ. АДР. ОТПРАВИТЕЛЯ","printable": "ЭЛ. АДР. ОТПРАВИТЕЛЯ\ta@k.ru","tag": 1117,"value": "a@k.ru"},{"printable": "Я","tag": 1192,"value": "Я"},{"printable": "","tag": 1209,"value": 2},{"caption": "СДАЧА","printable": "СДАЧА\t904,32","tag": 3002,"value": 90432},{"caption": "ПРИНЯТО","printable": "ПРИНЯТО\t1500,00","tag": 3003,"value": 150000},{"caption": "РН ККТ","printable": "РН ККТ\t0000000001020321","tag": 1037,"value": "0000000001020321"},{"caption": "ФД","printable": "ФД\t45","tag": 1040,"value": 45},{"caption": "ФН","printable": "ФН\t9999078900002164","tag": 1041,"value": "9999078900002164"}],"name": "Кассовый чек"}},"result": 0,"sessionId": "111111111111111111111111111118"},"protocol": 1,"version": "1.0"}
Чеки коррекции отправляются тем же способом. Отличается только набор передаваемых реквизитов.
-
Пример чека коррекции
XHTML12345678910111213141516171819202122232425<?xml version="1.0" encoding="UTF-8"?><document><sessionId>К991</sessionId><print>1</print><data><type>7</type><moneyType>2</moneyType><sum>10000</sum><fiscprops><prop tag="1018" caption="ИНН" value="7725225244 " /><prop tag="1187" caption="МЕСТО РАСЧЕТОВ" value="ОФИС1" /><prop tag="1054" value="1" /><prop tag="1055" caption="СНО" value="1" /><prop tag="1173" caption="ТИП КОРРЕКЦИИ" value="1" /><prop tag="1037" caption="РН ККТ" value="0000000001019507 " /><prop tag="1174" caption="ОСН. ДЛЯ КОРР." value=""><fiscprops><prop tag="1177" value="ПОСТАНОВЛЕНИЕ СУДА" /><prop tag="1178" value="27 Jun 2017 00:00:00 +0300" /><prop tag="1179" value="ПС345454" /></fiscprops></prop></fiscprops></data></document>
Кроме реквизитов, описанных в форматах фискальных данных доступны следующие реквизиты чека и предмета расчета:
1. Скидка (3000) и наценка (3001) передаются в копейках. В расчетах не участвуют. Просто печатаются на чеке.
2. Текст 3005 — произвольные текст. Печатается на чеке.
-
Штрих коды и QR код
1234567891011CUSTOM_QR_CODE = 3006,CUSTOM_CODE_39 = 3007,CUSTOM_CODE_128 = 3008,CUSTOM_ITF = 3009,CUSTOM_UPCA = 3010,CUSTOM_UPCE = 3011,CUSTOM_EAN8 = 3012,CUSTOM_CODABAR = 3013,CUSTOM_CODE93 = 3014,CUSTOM_EAN13 = 3015,CUSTOM_PDF417 = 3016
8. Печать произвольного текста и штрих-кодов
-
POST http://office.armax.ru:58088/printtext.xml
Пример данных запроса:
XHTML123456789101112131415161718192021222324252627282930313233<?xml version="1.0" encoding="UTF-8"?><document><sessionId>11111111111111158</sessionId><print>1</print><data><!-- Строка текста --><line>HGTQR-CF6XF-4X3GW-MV843-GGKG3</line><line>CODE_39</line><!-- Штрих код --><barcode tag="3007">01231546464</barcode><line>CODE_128</line><barcode tag="3008">01231546464</barcode><line>ITF</line><barcode tag="3009">14211716007389</barcode><line>UPCA</line><barcode tag="3010">01231546464</barcode><line>UPCE</line><barcode tag="3011">04252614</barcode><line>EAN8</line><barcode tag="3012">01231546464</barcode><line>CODABAR</line><barcode tag="3013">01231546464</barcode><line>CODE_93</line><barcode tag="3014">01231546464</barcode><line>EAN13</line><barcode tag="3015">01231546464</barcode><line>PDF417</line><barcode tag="3016">01231546464</barcode><line>QRCODE</line><barcode tag="3006">МАМА МЫЛА РАМУ</barcode><line>HGTQR-CF6XF-4X3GW-MV843-GGKG3</line></data></document>
Пример ответа:
XHTML12345<?xml version="1.0" encoding="UTF-8"?><document version="1.0"><data /><result>0</result></document>
-
POST http://office.armax.ru:58088/printtext.json
Пример данных запроса:
JavaScript123456789101112131415161718192021222324252627{"document":{"sessionId": "13142342342","print": 1,"data": {"lines": ["CODE_39",{"tag":"3007","value": "01231546464"},"CODE_128",{"tag":"3008","value": "01231546464"},"QRCODE",{"tag":"3006","value": "МАМА МЫЛА РАМУ"},"Просто текст"]}}}
Пример ответа:
JavaScript12345678{"document": {"data": {},"result": 0},"protocol": 1,"version": "1.0"}
105 Comments
У вас опечатка в «GET http://office.armax.ru:58088/cycleсclose.xml?print=1» — ненужная русская «с» в «cycleсclose».
Исправлено, спасибо
Я правильно понимаю что напрямую с кассой общаться не удастся и это нужно делать только через сервер в интернет office.armax.ru?
Вы понимаете неправильно, вы можете общаться с кассой напрямую, а по адресу office.armax.ru подключена тестовая ккм, чтобы вы могли проводить эксперименты и без наличия реальной железки. В случае если у вас есть ккм — вместо адреса office.armax.ru используйте адрес ккм.
Спасибо, это круто 😉
А можно где-то скачать образ диска который стоит в этой кассе? Сейчас купил две, хочу поковыряться и поднять на них небольшое облако
Спросим у разработчиков (support@armax.ru) Они как правило отзывчивые 🙂
А как узнать на каком порту API в моей кассе?
8088 — стандартный порт по протоколу Умка, 3333 — порт совместимый с протоколом Атол 3,1
Спасибо. а umka365 по какому порту с ККТ общается? 🙂
Стандартный https — 443
У вас в API в ответе на запрос состояния описаны не все признаки, которые есть в ФФД. Можем ли мы из ответа вытащить признаки, которые не описаны? Например, признаки по заполнению память (1050, 1051, 1052). Или потребуется доработка API каждый раз для добавления нового признака?
Здравствуйте!
Заявлено, что можно передавать данные в кассу по http протоколу. На сайте представлена информация о необходимости установки драйверов и приложения на ОС Windows для регистрации и конфигурации кассы. Подскажите наличие возможности конфигурации, регистрации кассового аппарата и фискального накопителя по http протоколу для пользователей не имеющих Windows. Если такая возможность есть, то где можно ознакомиться с документацией по API.
Драйвера нужны при использовании ККМ исполнения Lite , т.е. у которых есть только USB порт. Если вы используете другое исполнение — то подключение производится по сетевым интерфейсам.
Описание API для системных функций выложат на следующей неделе.
Можете послать запрос на support@armax.ru — вам вышлют ссылку на сборку конфигуратора под нужную вам ОС
В запросе на печать чека есть поле sessionId, но не описан его источник. Как его получить?
SessionID генерируете вы на своей стороне. Если повторить запрос чека с уже использованным SsessionID — вернется статус старого чека
Пример на регистрацию чека JSON на тестовом сервере не отрабатывает с кодом (406 Not Acceptable (недопустимое значение)). Без детализации локализация ошибки не представляется возможной.
Беглый анализ формата ответа на команду регистрации показал отсутствие важного свойства — ФПД за номером 1077. Как его можно получить?
Можете прислать ваш запрос ?
— Я использовал запрос без изменений из п.7 POST http://office.armax.ru:58088/fiscalcheck.json, но получил 406 код ошибки.
При общении с тестовым сервером не передаётся обязательный для протокола HTTP заголовок Content-Type. Планируется ли его добавить в будущем?
Да, будет
Там еще долго не мог понять проблему с тем что Content-Length регистрозависимый (по RFC наоборот может быть любой), т.е. касса не понимает content-length (некоторые бибилотеки передают в этом формате)
Принял.
Исправлю.
Какие поля при печати чека являются обязательными и дополнительными в рамках API?
Коды ФФД, приведённые в примере запроса (1018 — ИНН пользователя, 1037 — РН ККТ и др.), настраиваются при регистрации ККТ и при ежедневной эксплуатации не изменяются. Зачем их передавать при каждой печати?
Приведённый в п.7 пример ответа на запрос регистрации чека не содержит важного поля с кодом 1077 (фискальный признак документа, ФПД). Планируется его добавить?
Добрый день, мы хотим написать приложение, которое позволит на кассе применять нашу системы лояльности.
Пример работы лояльности, формируется чек, далее есть кнопка скидка, при нажатии появляется окно для ввода карты и (считывание штрих кода или прокаткой на ридере). Далее идет запрос на наш сервер, получается размер скидки, после сумма чека меняется и добавляется информации о скидки и чек отправляется на печатью.
Подскажите, в АПИ не вижу методов связанных со скидками и так далее, как это можно реализовать?
Расчет скидок полностью должен быть реализован на стороне клиента. В чеке для ККТ передаются суммы с учетом скидок и наценок.
Для печати на чеке можно передать скидку/наценку тегами 3000/3001 соответственно.
Кроме того дополнительную информацию для печати можно передать тегом 3005 в чеке или в позиции в чеке.
Вот конкретные вопросы, на которые хотели бы получить ответы:
1. Работа с чеком (корректировка сумму, применение скидки)
2. Добавление на чек информации о скидки.
3. Событие завершение оплаты.
1. ККТ скидку не считает. все суммы передавать нужно с учетом скидки.
2. Сумму скидки по позиции для отображения на чеке можно передать тегом 3000 (наценки — 3001)
3. Проведение чека выполняется в одной транзакции в ответе на запрос содержится чек со всеми реквизитами и result=0.
Можно ли получить пример приложения или описание какое то по реализации приложения и тестовый доступ к ЛК, где будет выкладываться приложение?
Спасибо!
Последнее описание тут
http://umki-static.armax.ru/docs/%D0%9E%D0%BF%D0%B8%D1%81%D0%B0%D0%BD%D0%B8%D0%B5%20%D0%B2%D1%8B%D1%81%D0%BE%D0%BA%D0%BE%D1%83%D1%80%D0%BE%D0%B2%D0%BD%D0%B5%D0%B2%D0%BE%D0%B3%D0%BE%20API%20%D0%9C%D0%95%D0%A9%D0%95%D0%A0%D0%90-%D0%A3%D0%9C%D0%9A%D0%90.pdf
1 Насколько я понимаю, standard — это raspberry pi 2/3?
2 Можно ли получить root на девайс и устанавливать свое ПО, помимо кассового?
3 Можно ли прокинуть встроенный tcp сервер в VPN сеть?
Также есть решение УМКА-01-ФА Lite
— это уже не rasbberry ?
— какие у него интерфейсы подключения?
можно ли туда просто воткнуть фн и использовать как кассу, управляя с другого устройства?
какой интерфейс для работы? ФР?
1. OrangePI PC Plus
2. Да
3. Да
Лайт — не Raspbery
Интерфейс — только USB
Можно, интерфейс — такойже как и Стандарт , обращение идет к экземпляру драйвера, запущенного на компе, к которому подключен Лайт
Как получить root на девайс?
orange:orange
Добрый день!
А есть ли в кассе режим отладки? Ну чтобы данные как то в тестовом режиме погонять. Приобрел у вас кассу Стандарт, но пока интеграцию произвожу с вашей кассой по адресу office.armax.ru:58088 и свою кассу не фискализировал и к ОФД не подключал.
У меня расчеты по интернет, УСН (д-р), не агент (кстати что это) — простой интернет-магазин с обычными неподакцизными товарами, короче говоря — ситуация отличная от той, что на вашей тестовой кассы.
Пытаюсь отослать на вашу кассу продажу своего товара — вроде все указал что у вас в примерах и даже больше, но ваша касса возвращает ошибку 242 (не хватает реквизитов), возможно как раз из-за того, что у нас разные системы бухучета…
Можете дать пример запроса ?
Спасибо за ответ.
Этот же вопрос задал по почте support@armax.ru и пример запроса скинул вам в поддержку на сайт, жду ответа там.
Добрый день.
Возникло несколько вопросов в процессе эксплуатации.
1) 2 кассы из 2-х (от разных поставщиков) конфигуратор доступен на порту 1, хотя в документации везде указан 3333 (ошибка?)
2) Для интернет сайта открытие/закрытие смены делается по крону? Или как то сама открывается/закрывается?
3) Имеется ли очередь чеков, или нужно делать на стороне сайта?
4) Как сменить стандартные пароли? Кассиров и т.д. Версия стандарт.
5) В какой момент данные отправляются в ОФД (как в примере надпись НЕПЕРЕДАННЫХ ФД 1)
1.по порту 3333 — доступен интерфейс по протоклоу Атол
по порту 8088 — по протоколу Умки
2. Насколько я помню возможна настройка на автооткрытие смены и закрытие при превышении 24 часов
3. В стандарте очереди нет
4. Или через сервис umka365.ru или по АПИ
5. при наличии соединения с ОФД, и корректно настроенных параметрах ОФД
Спасибо за ответ.
1) Я предполагаю что так должно быть (документацию три раза прочел), но у меня на двух разных кассах был порт 1 по умолчанию вместо 3333. В целом не проблема (если знаешь как проверить открытые порты nmap’ом), но подобные вопросы я видел и на этом форуме (что не могут достучаться по 3333 порту)
2) Тоже не видел нигде, буду смотреть на практике как будет касса себя вести.
3) Спасибо, реализуем на своей стороне
4) В АПИ нет этого 🙁 Видимо надо копать в Атоловском протоколе.
5) Проблему решил, не была завершена регистрация в налоговой.
1) Дефолтный порт сбился случайно. Но это не проблема — порт настраивается из РМК.
Я так понимаю вы разработчик, у меня планируются 3-4 машины Мещера. Они могут одновременно работать в режиме API (без печати чека) и в режиме розницы через РМК? Или надо две отдельные кассы покупать?
могут
т.е. в интернет магазине, где платеж может прийти в любое время. и в рознице где покупатель может прийти в любое время. Не будет ли у кассы ошибки, из серии я могу работать только в одном режиме.
Кто-то постоит, подождет.
чеки друг-другу не помешают
Есть различия в документации на этой странице и ПДФе, описывающем АПИ
Тут (см.п.7. Печать чека):
Тип документа (1. Продажа,2.Возврат продажи, 4. Покупка, 5. Возврат покупки, 7. Коррекция
прихода, 9. Коррекция расхода)
Там (см.под таблицей 7):
В объекте data:
type — тип документа:
1. Продажа,
2. Возврат продажи,
3. Покупка,
4. Возврат покупки,
5. Коррекция прихода,
6. Коррекция расхода
где правильная версия?
Вот правильная версия
1. Продажа,2.Возврат продажи, 4. Покупка, 5. Возврат покупки, 7. Коррекция
прихода, 9. Коррекция расхода
Добрый день!
А не подскажете, как можно при печати чека POST http://office.armax.ru:58088/fiscalcheck.xml
добавить печать произвольного текста в начале чека и в конце чека?
Т.е. чтобы это было именно при fiscalcheck.
Произвольный текст добавить можно, передав в теге 3005, но он будет печататься в чеке перед продажами весь. Отдельно заголовка и подвала нет.
если тег 3005 передать внутри позиции, то он будет печататься внутри позиции.
Значением тега 3005 выступает строка произвольной длины.
Что в боевой кассе, что в той которая тут указана для тестирования. На емейл приходят два чека. Один нормальный красивый от ОФД, второй страшный и пустой от кассы. Простое письмо, в заголовке слово check, внутри пусто.
Исправлено. теперь приходет страшный, но непустой от кассы.
Чтоб не приходиил — перерегистрируйте с флагом ШФД (шифрование)
Почините форум. Пока сюда задам вопрос: Почему printerssrv не хочет печатать на подключенный в систему USB pos58 принтер, с правильно установленными драйверами? Будет это доработано, может в конфиге флаг сделать, чтобы печатать на произвольный принтер через cups, на собственный страх и риск?
Потому, что не реализована поддержка печати на системном принтере. перечень поддерживаемых принтеров можно увидеть в настройках печати.
Когда будет доработано — не скажу. в ближайших планах нет.
Здравствуйте.
1. Если существует возможность автооткрытия\закрытия смены, то где она настраивается?
2. При попытке отправить тестовый запрос на печать чека получаю ответ 166 недопустимый РНМ. Что я делаю не так?
Спасибо.
В случае станд-алоне ккм — через конфигуратор ККМ в самой кассе.
В случае фискального сервера или арендованной ККМ — в свойствах фиск сервера или через umka365.ru
У нас УМКА-01-ФА. Перекопал на 10 раз все настройки «Универсального конфигуратора УМКИ» — не нашёл, можете поточнее сказать, где эта настройка и есть ли она вообще для УМКИ?
Напишите, пожалуйста, запрос на support@armax.ru. Не могу понять вопрос. историю по форуму не найти.
Умка запоминает SessionID, его нужно каждый раз новый присылать
У меня тоже ошибка 166, но если убрать поле 1037, то все проходит
Простите нас пожалуйста, мы тестировали API и случайно задидосили вашу тестовую АПИшку. Почините её пожалуйста.
починили
Запрашиваем открытие смены — пишет «Неверное состояние ФН».
Всё ещё не работает. Отвечает на открытие «Неверное состояние ФН», а на закрытие «Команда не реализуется в данном режиме ККТ»
Менял жедезку. поменял на плохую (для тестов). поменяю назад
Добрый день!
Что то не так с тестовой кассой — или «ошибка 102: Команда не реализуется в данном режиме ККТ» или Неверное состояние ФН — посмотрите плиз
Спасибо
Смотрел. Будет доступна в понедельник
При запросе по адресу генерации чека — ошибка 404
http://office.armax.ru:58088/fiscalcheck.json
Так это же не страничка которую вы хотите в браузере посмотреть.
генерация чека производится POST — запросом (например через curl)
POST http://office.armax.ru:58088/fiscalcheck.json
в браузере вы можете сделать только GET запросы — например прочитать статус ККМ
Здравствуйте, сергей.
Большое спасибо за оперативный ответ.
Хотел приложить код CURL запроса и тут же увидел ошибку в условии. Исправил. 404 ошибка пропала.
Теперь имеем следующее:
array(3) {
[«document»]=>
array(3) {
[«message»]=>
array(1) {
[«resultDescription»]=>
string(61) «Чек открыт – операция невозможна»
}
[«result»]=>
int(155)
[«sessionId»]=>
string(20) «90000000000000007827»
}
[«protocol»]=>
int(1)
[«version»]=>
string(3) «1.0»
}
Подскажите пожалуйста, где искать причину. Думаю, многим тоже будет полезна эта информация.
Вы какую операцию хотите сделать ?
Пробить чек при приёме онлайн-оплаты.
На суппорт отправил более подробные данные . Запрос SUP-10382
В общем разобрался. Вывод: «Нужно очень внимательно читать документацию». Причём, лучше читать документацию именно от умки. В комментариях есть ссылка на неё. Сначала делал по официальной документации к формату фискальных данных. Но в описании к умке всё гораздо удобнее. Не нужно перерывать массу данных. Всё очень лаконично и чётко изложено. Причём, именно то, что требуется в работе, ничего лишнего. Если бы сразу начал с неё, съэкономил бы массу времени.
Внимательным нужно быть ко всему.
Например, в доке указано, что поле количество позиций продаваемого наименования товара должно быть указано с точностью 3 знака после запятой. Это обязательно. Если указать , к примеру, 1 вместо 1.000, касса не верно посчитает итог чека и выдаст ошибку.
Здравствуйте.
А что с драйверами под Linux? Те что на сайте, вообще под какое-то специализированное решение в терминалах, как выяснилось. В суппорте Евгений скинул ссылку на тестовые сборки, сказав, что скоро будет репозиторий. Затем сказали, что это драйвер вообще не надо ставить, т.к. там что-то нужно исправить. В итоге, драйвера нет, а в тикетнице третью неделю полный игнор ((
Тикет SUP-10248
Вернулись из отпуска разработчики, значит скоро будет
ООО «Сантехника и пиво» это даже круче чем «Яйцекладущий комбинат им. Буденого» )) но почему теперь виртуальная касса перестала выдавать чеки? То был «ФН не фискализирован», а теперь «Недопустимый номер РНМ», хотя раньше все работало?
В тестовых аппартах иногда меняют МГМ — возможны всякие эффекты
Добрый день! Пробовали пробить тестовый чек, указанный в данной документации. Но в ответ получаем 406 ошибку: «406 Not Acceptable ([OFFCET 0]: недопустимое значение)» пробовали и на вашей облачной кассе и на своей тестовой. В чем может быть причина?
Можно увидеть пример запроса ?
ЕМНИП это баг про который я писал на этой странице с content-lenght
http://umki.org/knowledge-base/api-%D0%B4%D0%BB%D1%8F-%D1%80%D0%B0%D0%B1%D0%BE%D1%82%D1%8B-%D1%81-%D0%BA%D0%BA%D0%BC-%D0%BD%D0%B0-%D0%BF%D0%BB%D0%B0%D1%82%D1%84%D0%BE%D1%80%D0%BC%D0%B5-%D1%83%D0%BC%D0%BA%D0%B0/#comment-61
Отправляю на умку такой чек
0
1
1
95000
Ответ нормальный, но пропадает тег 1021, имя кассира, при этом и в офд он также не уходит
вот такой чек регистрируется
2062
3
…
…
…
…
ТЕЛ. ПОКУПАТЕЛЯ …
29.11.18 14:46
ИТОГ 950,00
АВТОМАТ 1
СМЕНА 156
ЧЕК 4
ПРИХОД
СНО УСН доход-расход
301001
950,00
1,000
950,00
…
ЭЛ. АДР. ОТПРАВИТЕЛЯ …
НАЛИЧНЫМИ 950,00
РН ККТ …
ФД 2062
ФН …
САЙТ ФНС nalog.ru
ФП
Кассовый чек
0
Укажите, пожалуйста, ЗН кассы и пример запроса.
ЗН 17000579
хмл-ный текс убивается, вот ссылка на гуглдокс
https://docs.google.com/document/d/1rg5PrmlsgWO_Eg2ZGHtMCzK4FjVMppyYQRDeH_uXaa0/edit?usp=sharing
с примером чека, то что я отправляю тег 1021 с фио кассира, а он не регистрируется на умке
Согласно 54-ФЗ со следующего года можно будет не печатать чеки — достаточно отобразить QR-код со ссылкой на электронную версию чека. Скажите, какой запрос надо сделать к API чтобы получить такой QR-код?
спасибо
Qr код кодирует следующую строку «t=%1&s=%2&fn=%3&i=%4&fp=%5&n=%6»,
где %1 — дата чека в формате «yyyyMMddThhmm»,
%2 — итоговая сумма по чеку с копейками,отделенными точкой (135.00)
%3 — номер фискального накопителя
%4 — номер документа (ФД)
%5 — фискальный признак в виде, печатаемом на чеке
%6 — тип чека (приход(1), возврат прихода(2), расход(3), возврат расхода)
Все необходимые данные возвращаются в ответе на запрос fiscalcheck.json или fiscalcheck.xml
Касса Умка-Ф-01.
Подскажите пожалуйста, как понять, что ККТ успешно передала данные в ОФД? Правильно ли я понимаю, что за это отвечает поле result?
Оптимальна ли схема:
1. Отдаю команду на ККТ, себе в БД пишу информацию по чеку с sessionId.
2. Жду ответ ККТ, если в ответе придет result=0. Значит все ок.
3. Какие еще значения могут передаваться в result, если ККТ чек сформировала, но обмен данными с ОФД совершился неуспешно.
4. Будет ли ККТ самостоятельно пытаться осуществить повторную отправку данных в ОФД? В таком случае, я должен самостоятельно делать запросы о статусе чека с нужным sessionId до момента получения result=0?
Спасибо!
Обмен с ОФД — процесс фоновый и проходит асинхронно. Чек отправляется в Фискальный накопитель, получает фискальный признак, после чеков начинается его отправка в ОФД.
Запросив статус ККМ можно увидеть количество не переданных в ОФД чеков, в общем случае — это значение равное 0
Здравствуйте!
Пробую подключение к ККТ через встроенный браузер на Мещера-01-Ф
http://localhost:8088/cashboxstatus.xml
Пишет, что веб-страница недоступна. http сервер не работает по умолчанию?
Как программе тогда обращаться к кассе?
Здравствуйте. Напишите на support@armax.ru, пришлите скриншот браузера с адрес. строкой и зав. номер кассы.
У вас готова прошивка для национальной маркировки «Честный знак» https://xn--80ajghhoc2aj1c8b.xn--p1ai/business/projects/test_dlya_magazinov/#step2 ? В API в каком поле указывать маркировку?
Код товарной номенклатуры
Добрый день!
А в каком формате указывать маркировку (тег 1162)?
https://честныйзнак.рф/upload/iblock/09e/09e9978505dad5ba4a8f814420ab20b7.pdf
Касса содержимое тега никак не изменяет и не проверяет, принимает строку и отправляет ее в ФН.
В вышеприведенном примере в кассу надо передать след. строку (без указания тега и длины)
000559D39E7F197241424331323334
А в каком формате?
Ascii, HEX, Base64, Bin?
Строка hex.
Тестовый сервер упал 🙁
Бывает периодически
При передачи в теге 1214 (признак способа расчета) значения 3 (аванс) исчезает тег 1030 (наименование предмета расчета).
Отправляем json в fiscalcheck.json (пример ниже) с заполненым тегом 1030, а в ФН он не попадает. Хотя, если тег 1214 сделать 2 (предоплата) или 4 (полный расчет) в том же json, то тег 1030 не пропадает.
{
«document»:
{
«sessionId»:1577241807016,
«print»:0,
«data»:
{
«type»:1,
«moneyType»:2,
«fiscprops»:[
{
«tag»:1054,
«value»:1
},
{
«tag»:1055,
«value»:2
},
{
«tag»:1117,
«value»:»noreply@vallab.ru»
},
{
«tag»:1059,
«fiscprops»:[
{
«tag»:1030,
«value»:»тест»
},
{
«tag»:1212,
«value»:4
},
{
«tag»:1079,
«value»:100
},
{
«tag»:1023,
«value»:»1.000″
},
{
«tag»:1199,
«value»:6
},
{
«tag»:1214,
«value»:3
}]
}],
«sum»:100
}
}
}
Согласно рекомендациям ФНС «аванс» используется когда окончательная сумма и предмет покупки еще не сен (например — предоплата за банкет, еще непонятно сколько и чего будет сьедено/выпито и по какой цене).
Если предмет расчета известен — используется предоплата за это предмет
или обьем. Название может быть и известно. Кассы Атол печатают.
В статье не рассмотрен еще один способ печати через «printrichtext.xml».
Вопрос: реализовано ли в нем печать картинок или это был неудачный эксперимент?
Добрый день. Печать картинок через printrichtext возможна, в формате base64. См. документацию
http://static.armax.ru/docs/UMKA_API_.pdf
Возможно ли при произвольной печати текста «printtext» менять шрифт?
Используйте для этого printrichtext — он поддерживает bbcode
Здравствуйте. Тестирую софт. Ваш тестовый сервер http://office.armax.ru:58088
недоступен
Добрый день. Тестовая касса была отключена. Сейчас она доступна, можете продолжать тестирование.