QA » История » Версия 334
Версия 333 (Елена Куликова, 13.03.2025 15:30) → Версия 334/338 (Елена Куликова, 13.03.2025 15:32)
h1. QA Вопросы и ответы
h2. Ссылки на документацию: "aidl":http://doc.multisoft.ru/doc/MSPOS/, "примеры":http://doc.multisoft.ru/doc/MSPOS/Examples/, "описания функций":http://doc.multisoft.ru/doc/MSPOS/html/, "алгоритм формирования чека продажи с маркированной продукцией":http://doc.multisoft.ru/doc/MSPOS/%d0%90%d0%bb%d0%b3%d0%be%d1%80%d0%b8%d1%82%d0%bc%20%d1%84%d0%be%d1%80%d0%bc%d0%b8%d1%80%d0%be%d0%b2%d0%b0%d0%bd%d0%b8%d1%8f%20%d1%87%d0%b5%d0%ba%d0%b0%20%d0%bf%d1%80%d0%be%d0%b4%d0%b0%d0%b6%d0%b8%20%d1%81%20%d0%bc%d0%b0%d1%80%d0%ba%d0%b8%d1%80%d0%be%d0%b2%d0%b0%d0%bd%d0%bd%d0%be%d0%b9%20%d0%bf%d1%80%d0%be%d0%b4%d1%83%d0%ba%d1%86%d0%b8%d0%b5%d0%b9.pdf, "Алгоритм проверки доступности работы с маркировкой":http://doc.multisoft.ru/doc/MSPOS/%d0%90%d0%bb%d0%b3%d0%be%d1%80%d0%b8%d1%82%d0%bc%20%d0%bf%d1%80%d0%be%d0%b2%d0%b5%d1%80%d0%ba%d0%b8%20%d0%b4%d0%be%d1%81%d1%82%d1%83%d0%bf%d0%bd%d0%be%d1%81%d1%82%d0%b8%20%d1%80%d0%b0%d0%b1%d0%be%d1%82%d1%8b%20%d1%81%20%d0%bc%d0%b0%d1%80%d0%ba%d0%b8%d1%80%d0%be%d0%b2%d0%ba%d0%be%d0%b9.pdf
h2. "Приказ ФНС России от 14.09.2020 № ЕД-7-20/662@":https://www.nalog.gov.ru/rn77/about_fts/docs/10020801/
h2. Перед началом работы: какие модели поддерживаются?
В настоящий момент Фискальное ядро установлено на следующие модели ККТ серии MSPOS: *MSPOS-K, MSPOS-T-Ф, MSPOS-Е-Ф*, *MSPOS-D-Ф*, *MSPOS-kiosk-Ф*, *MSPOS-SE-Ф*, *MSPOS-E-РФ*, *MSPOS-N-Ф*.
Им соответствуют строковые константы моделей (Build.MODEL), бренда (Build.BRAND) и производителя (Build.MANUFACTURER) устройств:
*BRAND = "SUNMI"*
*MODEL:*
* MSPOS-K: "V1S-G", "V1S", "V2"
* MSPOS-T-Ф: "T1MINI-G", "T1MINI", "T2MINI", "T2MINI_S", "D2MINI"
* MSPOS-Е-Ф: "P1_4G", "P1_4G-G", "P1_4G-EU", "P1_4G-R"
* MSPOS-D-Ф: "P2_PRO"
* MSPOS-kiosk-Ф: "K1"
* MSPOS-SE-Ф: "P2_SE", "V2_SE"
*BRAND = "DORO"*
*MANUFACTURER = "TIANYU"*
*MODEL:*
* MSPOS-E-РФ: "P30"
*BRAND = "QCOM"*
*MANUFACTURER = "NEWLAND"*
*MODEL:*
* MSPOS-N-Ф: "N850"
h2. *%{color:red}Вопросы по маркировке%* "тут":http://wiki.multisoft.ru:8881/redmine/projects/mspos-k/wiki/QA#Q44
h2. Q0
h2. *Любые обращения по поводу конкретного устройства/ККТ. Вопросы по переводу устройств между ТК и ОК, а также между субаккаунтами внутри ТК и ОК.*
h2. A0
При обращении по любым вопросам, которые касаются конкретного устройства, в чаты ТП и разработки
нужно указывать *SN* устройства (см. наклейку со штрих-кодами на обратной стороне аппарата).
Если вопрос связан с переводом устройства в тестовый контур или обратно в основной,
*нужно прикладывать фото задней части устройства либо скриншот первой страницы mspos-expert %{color:red}с читаемым SN%*.
Перенос устройств между ТК и ОК, а также между их субаккаунтами осуществляется только после подтверждения права собственности на устройство.
%{color:red}Переводы клиентского оборудования из *кастомного магазина в основной* делаются *по заявке с подписью ответственного лица и печатью организации*%.
Заявки на перевод принимаются *только от той организации, к кастомному магазину которой устройство было привязано при отгрузке*.
Перенос устройств между ТК и ОК после *13-00 МСК* выполняется с большой вероятностью только *на следующий день*.
h2. {{collapse(где найти SN)
!1.png!
}}
Фото не обязательно, если девайс уже привязан к Вашему личному кабинету. Предоставление фото позволяет избежать ошибок при переводе.
{{collapse(Так делать не надо)
!2.png!
}}
h2. Q1
h2. *Как добавить IFiscalCore.aidl в Android Studio?*
h2. A1
0. Скачать IFiscalCore.aidl, IAuth.aidl, IExceptionCallback.aidl с "сервера":http://doc.multisoft.ru/doc/MSPOS/
1. В корневой папке проекта создать папку aidl
2. Внутри папки aidl создать папку с именем, соответствующим package (com.multisoft.drivers.fiscalcore).
3. Правый клик по папке с именем package -> New -> AIDL -> AIDL File
4. Во всплывающем окне ввести имя интерфейса (например, IFiscalCore). Подтвердить выбор.
5. Скопировать содержимое скачанного файла в текстовом виде в созданный без(!) замены файлов.
6. Повторить операции 3-5 для IAuth.aidl и IExceptionCallback.aidl
h2. Q2
h2. *У меня ошибка вида %{color:red}Execution failed for task ':app:compileDebugAidl'%. Либо %{color:red}*.aidl:1: syntax error don't know what to do with "?"%*
h2. A2
Вероятно файлы содержат "BOM":https://ru.wikipedia.org/wiki/%D0%9C%D0%B0%D1%80%D0%BA%D0%B5%D1%80_%D0%BF%D0%BE%D1%81%D0%BB%D0%B5%D0%B4%D0%BE%D0%B2%D0%B0%D1%82%D0%B5%D0%BB%D1%8C%D0%BD%D0%BE%D1%81%D1%82%D0%B8_%D0%B1%D0%B0%D0%B9%D1%82%D0%BE%D0%B2.
Выполните инструкции, описанные в "Q1":http://wiki.multisoft.ru:8881/redmine/projects/mspos-k/wiki/QA#Q1.
h2. Q3
h2. *Как зарегистрироваться в программе Sunmi Partners?*
h2. A3
После подписания партнёрского соглашения на указанную в нём почту придёт приглашение на регистрацию в "Sunmi Partners":https://partner.sunmi.com/login. Регистрироваться без инвайта не нужно.
Откройте присланную ссылку с персонального компьютера (ПК) в "Google Chrome":https://www.google.ru/chrome/browser/desktop/index.html. Рекомендуется использовать его и в дальнейшем для любых действий в "личном кабинете (ЛК)":https://partner.sunmi.com/login.
Первая загрузка сайта может занять некоторое время, подождите полной загрузки и не обновляйте страницу, пока она не будет полностью загружена.
Если страница загрузилась, но открывается пустой список для выбора страны и/или кода телефона - очистите кеш браузера и обновите страницу.
Не обновляйте страницу повторно, пока она не загрузится полностью.
Следуйте шагам реристрации. *Оформлять смс подтверждение не нужно*.
По окончании дождитесь верификации аккаута. Она выполняется автоматически в течение 1 рабочего дня.
В процессе регистрации будет предложено загрузить Company Registration Certification. Подробнее в "Q5":http://wiki.multisoft.ru:8881/redmine/projects/mspos-k/wiki/QA#Q5.
*После регистрации и успешной верификации нужно добавить фискальное ядро в свой магазин.
Для этого выполните пункты "A3_1":http://wiki.multisoft.ru:8881/redmine/projects/mspos-k/wiki/QA#A3_1*
При настройке личного кабинета (ЛК) разработчика установите триггеры в соответствии с картинкой.
Debugger access control рекомендуется установить в положение "выкл", иначе придётся периодически вводить в устройство временный пароль,
который присылается на почту, указанную в ЛК в Development -> Debugger.
*Не включайте Google Play. В основном контуре Google Play выключен* в целях безопасности.
h3. {{collapse(Настройки ТК)
!tk_setttings1.png!
}}
h2. Q3_1
h2. На устройстве нет MSPOS-Expert. Что делать?
На устройстве нет приложения <notextile>%</notextile>AppName<notextile>%</notextile>. Как его добавить?
h2. A3_1
Зайдите в "личный кабинет":https://partner.sunmi.com/login на вкладку *App Store -> App List*,
найдите *MSPOS-Expert* (или <notextile>%</notextile>AppName<notextile>%</notextile>) справа в *"No apps added"*, выделите его галку и нажмите кнопку *"Added apps"*.
После этого приложение появится в *"Apps Selected"*.
Если приложения нет в списке справа, проверьте список слева.
Для добавления приложения, отсутствующего в обоих списках напишите разработчикам этого приложения.
Для того, чтобы приложение появилось в поиске в личном кабинете,
к этому кабинету должен быть привязан *по крайней мере один терминал из списка поддерживаемых приложением* моделей (выбирается при загрузке приложения в магазин).
При публикации приложения разработчик сам указвыает список поддерживаемых моделей и зону видимости: только для своего аккаунта / для своего и субаккаунтов / для всех аккаунтов.
Если приложения нет в поиске, но достоверно известно, что оно загружено, нужно обратиться к авторам приложения с просьбой расширить зону видимости их продукта.
Если разработчик - Вы, можете загружить приложение по "инструкции":http://wiki.multisoft.ru:8881/redmine/projects/mspos-k/wiki/QA/#Q6.
Также рекомендуем добавить *TeamViewerQS* и *TeamViewerQS —APPX*.
В дальнейшем *не удаляйте MSPOS-Expert из магазина*.
h3. {{collapse(Как добавить приложение в ЛК разработчика)
!add_mspos.png!
}}
h2. Q4
h2. *Как подготовить устройство MSPOS к отладке?*
h2. A4
В тестовом контуре возможность отладки автоматически включена для всех устройств, привязанных к тестовому аккаунту.
На своём устройстве *в "Настройки"->"Безопасность" разрешите установку приложений из неизвестных источников*.
Сообщите серийный номер устройств(а) (SN) сотрудникам Multisoft/Альфа-Проект, которые занимаются интеграцией.
Они привяжут его к вашему аккаунту по завершении регистрации в Sunmi Partners.
Для упрощения *разработки в ТК* в Вашем "личном кабинете":https://partner.sunmi.com/login *Device Configuration* -> *Common* -> *Debug Protect* должен быть *выключен*.
В этом случае способ, описанный "здесь":https://developer.sunmi.com/docs/en-US/xeghjk491/ciieghjk579, не актуален.
Там же *Device Configuration* -> *Common* -> *Install by 3rd APP* должен быть *включен*.
Подключите устройство к сети WiFi с открытым доступом и интернет.
Подключите включенное устройство по USB к компьютеру с установленным Android SDK.
Дождитесь установки драйверов (если используется Windows) и появления уведомления "Отладка по USB разрешена" на устройстве.
Если не удалось установить драйвера, и/или устройство не отображается в диспетчере устройств Windows,
попробуйте, если это Type-C, подсоединить разъём другой стороной и/или выбрать другой разъём в ПК для подключения.
Универсальные драйвера под Windows для android-устройств можно найти "здесь":https://developer.android.com/studio/run/win-usb
В *%AndroidSDKInstallDir%\android-sdk\platform-tools\* выполните *"adb devices"* из консоли,
на экран должны быть выведены серийный номер аппарата и *device*, что означает, устройство готово к отладке.
Если эта команда показывает *"unauthorized"*, проверьте подключение к интернет и перезагрузите аппарат.
Если после перезагрузки *adb devices* всё равно возвращает *unauthorized*, либо при отладке возникают ошибки доступа,
попробуйте включить режим разработчика вручную стандартным для android устройств способом:
многократными тапами по *Build.Number (Номер сборки)* в меню *"о телефоне".*
Также попробуйте отключить (если была включена) и включить снова опцию *"Отладка по USB"* в меню *"Для разработчиков"*.
h2. A4_1
*Перевод MSPOS-Е-Ф, MSPOS-D-Ф, MSPOS-SЕ-Ф (с экв.) и других эквайринговых моделей sunmi в режим отладки (включение adb)*:
Данная процедура необратима. По завершении девайс перезагрузится, и на экране ККТ появится неудаляемый водяной знак.
Использование эквайринговых моделей со включенной отладкой в боевом режиме недопустимо.
Будучи включённым, adb делает устройство небезопасным для конечного пользователя.
Последствия проведения транзакций при использовании устройства в режиме отладки ложатся на компанию, запросившую перевод в режим отладки.
Включение режима отладки разрешено только в целях разработки и тестирования.
При использовании устройства только в целях тестирования рекомендуем использовать механизм gray release.
Для включения adb, кроме передачи сотрудникам Мультисофт SN и фото с читаемым SN, необходимо:
* явно сообщить о своём намерении включить режим отладки (adb) на конкретном устройстве путём указания его SN в текстовой форме
* явно указать намерение использовать устройство в целях разработки и тестирования
* явно подтвердить, что последствия работы с включенным adb ясны
*Пример:* "Прошу предоставить код для adb на девайс PExxxxxxxxxx. В целях разработки и тестирования. Последствия ясны, риски приняты."
Включение режима отладки осуществляется путём ввода 4-значного одноразового временного кода.
Код необходимо вводить в специальное меню, которое открывается после 8 нажатий по TUSN в "Настройки" -> "О телефоне".
Срок действия кода: 24 часа.
Если после ввода появилось сообщение об ошибке, повторно вводить не нужно. Вместо этого сообщите о проблеме сотрудникам Мультисофт, по возможности передав текст сообщения.
h2. Q5
h2. *Что делать с Company Registration Certification при регистрации аккаунта в sunmi partners?*
h2. A5
Прикрепите пустую картинку. Эта опция нужна китайским компаниям.
h2. Q6
h2. *Как загрузить приложение в магазин Sunmi?*
h2. A6
Воспользуйтесь "инструкцией по загрузке":http://wiki.multisoft.ru:8881/redmine/projects/mspos-k/wiki/AddAppSunmi
При загрузке укажите правильные модели(Terminals): *приложение будет доступно только на указанных моделях*.
Поле *price* выставлять в соответствии с партнёрским соглашением.
После загрузки каждой версии в магазин требуется около 1 рабочего дня на автоматический аудит.
Если приложение было загружено в магазин в режиме пре-релиза (gray release),
аудит выполняется при первой загрузке и не распространяется на *Change to official version*.
Кнопка *Change to official version* нужна, чтобы применить грей релиз на все аппараты.
Изменение списка устройств для пре-релиза (в т.ч. применение пре-релизана все устройства - change to official version) не сопровождается аудитом.
Изменение атрибутов приложения, таких как скриншоты, описание, поддерживаемые модели и др. вызывает повторный аудит при применении этих свойств (кнопка Save внизу).
*"ТРЕБОВАНИЯ МАГАЗИНА ПРИЛОЖЕНИЙ К ПО":https://developer.sunmi.com/docs/en-US/cdixeghjk491/cireghjk568*
Для *обновления* приложения в магазине мы подготовили "другую инструкцию":http://wiki.multisoft.ru:8881/redmine/projects/mspos-k/wiki/UpdAppSunmi
h2. Q7
h2. *Что нужно знать о регистрации фискального накопителя (ФН)?*
h2. A7
Процедура регистрации выполняется один раз за время жизни ФН.
Регистрация ФН - часть процесса включения фискального режима работы ККТ.
Пока ККТ не зарегистрирована с ФН, она находится в учебном режиме. Об этом свидетельствует надпись * *учебный режим* * в начале чеков.
После регистрации ФН ККТ в процессе работы печатает *фискальные* документы, за исключением нефискальных документов (RecType.Unfiscal),
документов внесения/изъятия (RecType.PayIn/PayOut) и X-отчётов (PrintXReport).
Если ККТ зарегистрирована в неавтономном режиме (отсутствует флаг OperatingMode.Autonomous),
фискальные документы будут отправляться в ОФД по настроенному каналу связи (валидный сервер и порт ОФД,
выход в интернет по Wifi или через мобильную сеть).
Для регистрации фискального накопителя(ФН) нужно следующее:
а) ФН подключен и в состоянии "готов к регистрации" ("FNGetState":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#acccf308edeb4fe120f682cbc3a4b739c == "FnState.ReadyToFiscalization":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html#a48a9c84bbd4107e159399f00ad85fa78).
б) смена должна быть закрыта ("GetDayState":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a75178af4fb3f53fec8ff0a2c5cc14edd == "DayState.DayClosed":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html#ac954685f2b9cd2e40ef72d39f68de124)
в) не должно быть открыто ни одного документа ("GetRecState":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a5f6942bdd312c5a8a52bdd2c4ebd3d7b == "RecState.Closed":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html#a23cd3e5ca25f473990493575a9c2f11c)
после этого можно начинать процедуру регистрации.
h2. Q8
h2. *Как зарегистрировать ФН / включить фискальный режим ККТ?*
h2. A8
Процедура регистрации, в зависимости от желаемых параметров регистрации, может отличаться.
Основные операции при регистрации:
1) установка опций: см. блок "Запрос и установка параметров"
2) сохранение опций (см. "SaveOptions":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a8bf297561df86b0c5e62b8b0adcf670e )
3) регистрация (см. "Register":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a278fd49eca702ca03b239f65f098a245 ).
при каждой регистрации %{color:red}обязательными% для установки на шаге 1 являются:
"SetOrgName":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#ad771825ea775e76666cc09772279767a
"SetOrgAddress":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#ac6650f56de207c2664b8a16f3b63fd32
"SetPhysicalAddress":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#ae09721153004af1fcd47c8dd900666c6
"SetFnsServerAddress":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#ac35b9fefb435f5ade6d337e174fe6190
Если при регистрации в битовом поле "режим работы" (op_mode) %{color:red}не% установлен бит "OperatingMode.Autonomous":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html#af79f7ba66a9ad6fe8763a6f58952a5d2 (0x02), %{color:red}обязательными на шаге 1 также являются%:
"SetSenderEmail":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a47a8880a2cdec8dff31067adc172d161
"SetOfdHost":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#ab616fe44a2bade57e5f11010e277bf11
"SetOfdPort":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a3cd2cb3aac6f6a36989aa099e3ca7a2e
"SetOfdName":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a8f1fb2f7c7eb90a984c5d8fb5bc223bb
"SetOfdTaxId":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a31a1421e3bd6418411e1602765d13b9d
Если при регистрации в битовом поле "режим работы" (op_mode) установлен бит "OperatingMode.Automatic":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html#af79f7ba66a9ad6fe8763a6f58952a5d2 (0x04), %{color:red}на шаге 1 должен быть установлен номер автомата%:
"SetVendingSerial":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a9f854e01cb5b4f40a1b97b2f19c41cae
В зависимости от того, является ли пользователь платёжным агентом (параметр agent в функции Register отличен от 0), %{color:red}на шаге 1 должны быть установлены следующие опции%:
"SetTransferOperatorName":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#abc45417de2caada0426148d08c2f01ab
"SetTransferOperatorTaxId":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a40533b38d11cf5703856b46cd68408a3
"SetTransferOperatorTelNum":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a47846d05cebe797b4c5ee59c097eb2fa
"SetTransferOperatorAddress":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a70a8d8ed1e4f1b1b49f6b21860f4d3df
"SetPaymentAgentTelNum":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#ad9db608d873cd7e60e936ae9fd552e2c
"SetPaymentAgentOperation":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#ad489cb74534c3c0091eac73f8312c7a2
"SetCommissionAgentTelNum":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a537b038aab4c42ed63107e96cd423321
"SetContractorTelNum":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#ab93c7d4caebe3cccbe37cafe525d1dad
Точный список требуемых параметров в зависимости от аргументов функции (пере)регистрации указан в "Q25":http://wiki.multisoft.ru:8881/redmine/projects/mspos-k/wiki/QA#Q25
h2. Q9
h2. *Какие особенности работы с несколькими СНО?*
h2. A9
Пользователь может иметь несколько систем налогообложения (СНО). Запросить СНО, указанную при регистрации, можно функцией "GetTaxation":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a3634272503b0484eae22365fbf21a4a0
При этом в чеках должна быть указана только одна из зарегистированных СНО.
Если пользователь зарегистрировал кассу с несколькими СНО, то перед каждым открытием документа ("OpenRec":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a0652bf6ebf8d2e3147bf45905daa1f1e )
*текущая СНО* должна быть установлена функцией "SetTaxationUsing":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#ab2f0202725597f348727647d33eedaf4 , в параметрах которой передаётся одна из зарегистрированных СНО.
h2. Q10
h2. *Для чего нужна перерегистрация?*
h2. A10
Если параметры кассы и/или реквизитов пользователя изменились, об этом нужно уведомить Федеральную налоговую службу (ФНС)
посредством отправки оператору фискальных данных (ОФД) отчёта о перерегистрации в электронной форме.
Отчёт о перерегистрации формируется функцией "CorrectRegistration":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a24fb9f4f043bd3ec5fed05cb9213db42.
Её параметры аналогичны функции "Register":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a278fd49eca702ca03b239f65f098a245, но нужно установить дополнительный - причину перерегистрации.
Причин перерегистрации может быть 4: замена ФН, смена ОФД, смена реквизитов пользователя и смена настроек ККТ.
h2. Q11
h2. *Как выполнить перерегистрацию?*
h2. A11
Выполняется аналогично "регистрации":http://wiki.multisoft.ru:8881/redmine/projects/mspos-k/wiki/QA#Q8 за исключением пункта 0):
0) убедиться, что в очереди на отправку в ОФД нет документов ("OFDGetFirstQueuedDocNumber":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a973998cafa852d49f1dfa351f336d069 == 0), иначе перерегистрация не будет выполнена.
1) установка опций, которые необходимо изменить, в связи с причиной перерегистрации: см. блок "Запрос и установка параметров"
Точный список требуемых параметров в зависимости от аргументов функции (пере)регистрации указан в "Q25":http://wiki.multisoft.ru:8881/redmine/projects/mspos-k/wiki/QA#Q25
2) сохранение опций (см. "SaveOptions":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a8bf297561df86b0c5e62b8b0adcf670e )
3) перерегистрация(см. "CorrectRegistration":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a24fb9f4f043bd3ec5fed05cb9213db42 ).
В связи с ограничениями ФН %{color:red}нельзя выполнить 1 перерегистрацию на ФФД 1.05 с несколькими причинами одновременно%.
Например, нельзя поменять настройки ОФД и реквизиты пользователя одновременно,
нужно выполнить последовательно 2 перерегистрации в связи с этими причинами, выполняя шаги 1-3.
При этом устанавливаются и сохраняются только те параметры, которые соответствуют причине данной перерегистрации (при условии, что все остальные присутствуют).
h2. Q11_1
h2. *Какую причину перерегистрации выбрать при переключении режима между онлайн и оффлайн?*
h2. A11_1
Правильный подход: при перерегистрации выбрать "смена настроек ккт" "CorrectionReason.ChangeKKTSettings":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html#accde9d8d9055948548d04b24debc5200.
Однако, некоторые ФН не позволяют это сделать, отвечая, например, BadFormat.
В таком случае нужно отменить документ и перерегистрировать с причиной "смена параметров ОФД" "CorrectionReason.ChangeOFD":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html#accde9d8d9055948548d04b24debc5200.
Перед началом перерегистрации необходимо убедиться, что все необходимые параметры(опции) установлены "Q25":http://wiki.multisoft.ru:8881/redmine/projects/mspos-k/wiki/QA#Q25.
h2. Q12
h2. *Как напечатать чек?/ Как сформировать фискальный документ? / Как сформировать нефискальный документ?*
h2. A12
В общем случае печать документа состоит из открытия "OpenRec":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a0652bf6ebf8d2e3147bf45905daa1f1e, наполнения документа и закрытия "CloseRec":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#ad324f3c6dcabcfa6801fc4c166b24244.
Пока документ не закрыт, его можно отменить функцией "RecVoid":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a5654f1a1b77435e97bf8e788df271873
*Если ФН зарегистрирован с несколькими системами налогообложения (СНО),
перед открытием фискального документа с типом Sell/SellRefund/Buy/BuyRefund, либо чека коррекции,
необходимо из зарегистрированных СНО выбрать одну и установить её* функцией "SetTaxationUsing":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#ab2f0202725597f348727647d33eedaf4.
Настраивать СНО не обязательно для каждого документа.
Установленная после соединения с ядром СНО действует до следующей выгрузки ядра из оперативной памяти либо до следующей вызванной "SetTaxationUsing":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#ab2f0202725597f348727647d33eedaf4.
Наполнение *нефискального документа (RecType.Unfiscal)* выполняется командами печати:
"PrintLine":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#afd8854e97d653a91a41735c7750447a9
"PrintLineAligned":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#aeb49685abe791c713497873bd8fbea8a
"PrintQRCode":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a8d298288c9d1497dfee2151155749185
"PrintBarCode":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#ae19113179a5ddc1b386c1a71dc089dca
"SetFont":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a3ec8a35cbbe9f62245e392285087c9e1
"PrintRaster":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#ac36e19f4cc12db659084eb337916f294
Наполнение *фискальных документов с типом Sell/SellRefund/Buy/BuyRefund, а также нефискальных с типом PayIn/PayOut* выполняется по общему алгоритму:
1. Позиции. В случае *PayIn/PayOut* команда также обязательна.
"PrintRecItem":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a33a66c34f73f25247d84a51623516d55 - добавление позиции, можно вызывать сколь угодно много раз.
Только *для Sell/SellRefund/Buy/BuyRefund*:
*Перед "PrintRecItem":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a33a66c34f73f25247d84a51623516d55 необходимо установить налоги* функцией "SetItemTaxes":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#ac3ba54dd76e7efe29870e3117eae41de.
2. Печать итога.
"PrintRecTotal":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#addeeaada4bbd7913f57030efba8662fe - подведение итога. разрешено вызывать не более 1 раза на документ. После итога добавление позиций запрещено, можно вызывать только команды оплаты:
3. Оплата.
"PrintRecItemPay":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a7ca2d5fc505ce74e47ffe6ff77f6ec70 - добавление оплаты, можно вызывать сколь угодно много раз, рекомендуется не более 6 раз на документ (с учётом сдачи).
В некоторых случаях требуется передать телефон или электронный адрес покупателя (тег 1008), об этом в "Q13":http://wiki.multisoft.ru:8881/redmine/projects/mspos-k/wiki/QA/#Q13, "Q14":http://wiki.multisoft.ru:8881/redmine/projects/mspos-k/wiki/QA/#Q14.
Добавление нефискальной информации в фискальный чек допустимо только при следующем условии:
*выводимый на печать текст, штрих-код, QR-код и/или картинка не содержит данных, формат которых похож и/или повторяет формат фискальных данных, печатаемых на чеке.*
При обнаружении нарушений печати нефискальных данных в фискальном чеке приложение удаляется из магазина приложений до устранения нарушений.
h2. Q12_1
h2. *Как сформировать чек коррекции?*
h2. A12_1
*Чек коррекции* отличается от остальных чеков наполнением: оно происходит единственной командой "FNMakeCorrectionRec":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a9bec0b3e80a4299c4e65efc0b553befe, повтор которой недопустим.
Для формирования суммовых налогов в чеке коррекции перед FNMakeCorrectionRec нужно вызвать "SetSumTaxes":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a5d4ba3ce9f1cbeb53f72653642e47908.
*В этом случае параметр taxNum (порядковый номер используемого налога) функции FNMakeCorrectionRec игнорируется*.
Резюмируя: для формирования чека коррекции нужно последовательно и без повторов вызывать:
(если несколько СНО) "SetTaxationUsing":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#ab2f0202725597f348727647d33eedaf4
"OpenRec":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a0652bf6ebf8d2e3147bf45905daa1f1e
(если нужны суммовые налоги)"SetSumTaxes":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a5d4ba3ce9f1cbeb53f72653642e47908
"FNMakeCorrectionRec":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a9bec0b3e80a4299c4e65efc0b553befe
"CloseRec":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#ad324f3c6dcabcfa6801fc4c166b24244
h2. Q13
h2. *Как передать телефон или электронный адрес покупателя (тег 1008)?*
h2. A13
Для передачи этого тега необходимо использовать функцию "SendClientAddress":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a5672fc24a0e68cf06e13a8e73698cb12
Она выполняется один раз на весь документ в любой момент после открытия и до закрытия. %{color:red}Повторная передача ведёт к нарушению ФФД%.
Установка одновременно электронного адреса и телефона покупателя не предусмотрена ФФД 1.05 от 21.03.2017.
Точно так же покупатель не может иметь нескольких телефонов и/или email одновременно.
При использовании SendClientAddress в опциях заранее *должен быть установлен эл. адрес отправителя* "SetSenderEmail":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a47a8880a2cdec8dff31067adc172d161
h2. Q14
h2. *В каком формате передавать телефон или электронный адрес покупателя (тег 1008) в функции "SendClientAddress":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a5672fc24a0e68cf06e13a8e73698cb12 ?*
h2. A14
Телефон или электронный адрес покупатеся следует передавать в соответствии с ФФД 1.05 от 21.03.2017 Таблица 5, тег 1008:
Формат: %{color:red}+{Ц}% или %{color:red}{С}@{C}%,
где Ц - "атрибут, обозначающий, что данные реквизита должны быть представлены в виде цифры",
С- "атрибут, обозначающий, что данные реквизита должны быть представлены в виде символа".
Символы и цифры должны быть представлены в электронной форме %{color:red}"в соответствии с кодовой таблицей CP866"%.
h2. Q15
h2. *Как изменить параметры автоинкассации при закрытии смены?*
h2. A15
Включение или отключение автоинкассации выполняется функцией "SetDayCloseAutoPayOut":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a7412c0fe3ae61fc5a2d54d850e8d0c97
Если необходимо сохранить значение параметра для применения его во всех следующих функциях закрытия смены ("CloseDay":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a45709f692bbe83ec0852e0569b512a01 ),
в т.ч. после перезагрузки, нужно сохранить опции ("SaveOptions":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a8bf297561df86b0c5e62b8b0adcf670e ).
h2. Q16
h2. *Какие типы документа доступны для чека коррекции в аргументе "operation" функции "FNMakeCorrectionRec":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a9bec0b3e80a4299c4e65efc0b553befe ?*
*Почему в чеке коррекции не работает "OperationType.SellRefund":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html#ac61434a729deda0ddd0e8cf6b1bd7123 и "OperationType.BuyRefund":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html#ac61434a729deda0ddd0e8cf6b1bd7123 )?*
h2. A16
В соответствии с ФФД 1.05 от 21.03.2017 Таблица 25 "Реквизит «Признак расчета» (тег 1054) для кассового чека коррекции (БСО коррекции)
может принимать одно из следующих значений: «1» – приход, «3» – расход."
Поэтому чек коррекции на возврат прихода и возват расхода возвращает ошибку.
h2. Q17
h2. *ФН не даёт закрыть архив / зарегистрировали mspos-е-Ф с некорректной датой, и он заблокировался, нет возможности откатить время назад.
Как закрыть ФН аварийно?*
h2. A17
Нужно убедиться, что нет иных способов решить проблему. Часто ФН блокируется, т.к. чеки долго не уходили в ОФД.
Часто причиной могут быть отсутствие связи, отсутствие продлённого договора с ОФД.
Если при регистрации указан ИНН несуществующего ОФД, чеки могут не приниматься, и необходимо аварийное закрытие архива.
*Все операции, связанные с аварийным закрытием необходимо согласовывать с ФНС.
После выполнения шагов данной инструкции старый ФН останется в том же состоянии, что и был*.
Процедура *не закрывает архив в самом ФН*. Она лишь позволяет зарегистрировать ККТ с новым ФН.
Для выполнения аварийного закрытия архива в ККТ необходимо:*
0. выключить ККТ и заменить ФН на незарегистрированный.
1. включить ККТ и открыть mspos-expert. войти в сервисное меню.
2. ввести номер ФН, с которым ККТ была зарегистрирована,
в поле для ввода ЗН ККТ (единственное поле для ввода на сервисной странице).
3. нажать "аварийное закрытие архива", подтвердить выбор. Кнопку "записать ЗН" нажимать ну надо.
h2. Q18
h2. *Как передать признак предмета расчета и признак способа расчета (теги 1212 и 1214)?*
h2. A18
Для передачи свободных тегов используется функция "SetTagAttribute":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a8bce3c5e91220db3f59b0f7491775393 (начиная с 1.8.28).
Её нужно вызывать перед добавлением позиции ("PrintRecItem":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a46ffb2cbf9248c5f138f50a8bef916d9 ), в которой необходимо установить соответствующий тег.
Обращаем внимание на примечания 1 и 2 к таблице 29 ФФД (введены Приказом ФНС России от 09.04.2018 N ММВ-7-20/207@):
1. В случае если в составе кассового чека (БСО) реквизит "предмет расчета" (тег 1059) содержит реквизит "признак предмета расчета" (тег 1212), имеющий значение *"15"*,
то такой кассовый чек (БСО) при передаче в ОФД в электронной форме в реквизите "наименование предмета расчета" (тег 1030)
должен содержать одно из значений *от "1" до "25"*, указанных в таблице 29.1.
2. В случае если в составе кассового чека (БСО) реквизит "предмет расчета" (тег 1059) содержит реквизит "признак предмета расчета" (тег 1212), имеющий значение *"16"*,
то такой кассовый чек (БСО) при передаче в ОФД в электронной форме в реквизите "наименование предмета расчета" (тег 1030)
должен содержать одно из значений *от "26" до "31"*, указанных в таблице 29.1._
В случае передачи в *1212* значений *15* или *16*, в "PrintRecItem":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a46ffb2cbf9248c5f138f50a8bef916d9
в аргумент *itemName* необходимо передавать значение реквизита из таблицы 29.1 ФФД *без дополнительного текста: значения от "1" до "31"*.
Печатная форма формируется ядром.
h2. Q19
h2. *Какие значения передать при установке тегов 1212 и 1214?*
h2. A19
Значения реквизита «признак способа расчета» (тег 1214) в соответствии с ФФД 1.05 от 21.03.2017 Таблица 28:
|1|ПРЕДОПЛАТА 100%|
|2|ПРЕДОПЛАТА|
|3|АВАНС|
|4|ПОЛНЫЙ РАСЧЕТ|
|5|ЧАСТИЧНЫЙ РАСЧЕТ И КРЕДИТ|
|6|ПЕРЕДАЧА В КРЕДИТ|
|7|ОПЛАТА КРЕДИТА|
Значения реквизита «признак предмета расчета» (тег 1212) в соответствии с ФФД 1.05 от 21.03.2017 в ред. Приказа ФНС России от 09.04.2018 Таблица 29:
|1|ТОВАР|
|2|ПОДАКЦИЗНЫЙ ТОВАР|
|3|РАБОТА|
|4|УСЛУГА|
|5|СТАВКА АЗАРТНОЙ ИГРЫ|
|6|ВЫИГРЫШ АЗАРТНОЙ ИГРЫ|
|7|ЛОТЕРЕЙНЫЙ БИЛЕТ|
|8|ВЫИГРЫШ ЛОТЕРЕИ|
|9|ПРЕДОСТАВЛЕНИЕ РИД|
|10|ПЛАТЕЖ|
|11|АГЕНТСКОЕ ВОЗНАГРАЖДЕНИЕ|
|12|СОСТАВНОЙ ПРЕДМЕТ РАСЧЕТА|
|13|ИНОЙ ПРЕДМЕТ РАСЧЕТА|
|14|ИМУЩЕСТВЕННОЕ ПРАВО (с 1.12.37+)|
|15|ВНЕРЕАЛИЗАЦИОННЫЙ ДОХОД (с 1.12.37+)|
|16|СТРАХОВЫЕ ВЗНОСЫ (с 1.12.37+)|
|17|ТОРГОВЫЙ СБОР (с 1.12.37+)|
|18|ТУРИСТИЧЕСКИЙ НАЛОГ (с 1.32.112+)|
|19|ЗАЛОГ (с 1.12.37+)|
h2. Q20
h2. *Как пробить сдачу?*
h2. A20
Сначала пробейте оплату наличными, сумму, которую передал клиент, например, 100р.
<pre><code class="cpp">
IFiscalCore.PrintRecItemPay((int)PayType.Cash, "100.00", "ПРИНЯТО ОТ КЛИЕНТА НАЛИЧНЫМИ:",callback);
</code></pre>
После этого выполните вызов "PrintRecItemPay":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a7ca2d5fc505ce74e47ffe6ff77f6ec70 с параметрами PayType.Cash, в total передайте сумму со знаком "минус".
Например, сдача в 15 рублей 1 копейку оформляется вызовом:
<pre><code class="cpp">
IFiscalCore.PrintRecItemPay((int)PayType.Cash, "-15.01", "СДАЧА:",callback);
</code></pre>
В предыдущих двух командах параметр itemText может быть любым.
В результате после закрытия документ, если "принято" - "сдача" == сумме стоимости всех позиций по документу, на чеке появится 2 последовательные надписи:
"ПРИНЯТО ОТ КЛИЕНТА НАЛИЧНЫМИ: 100.00"
"СДАЧА: 15.01"
и ниже, в соответствии с ФФД:
"НАЛИЧНЫМИ 84.99"
h2. Q21
h2. *Как работать по старому законодательству в режиме ЧПМ ?*
h2. A21
Если клиент по закону имеет право пользоваться ЧПМ, переход в режим ЧПМ осуществляется при соблюдении следующих условий:
1. ККТ не зарегистрирована
2. К ККТ не подключен (зарегистрированный) ФН
3. ПО умеет работать в режиме ЧПМ без обращений к ФН.
4. ПО умеет определять текущий режим работы через вызов функции "DirectIO":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#ad332340d4b162fd5a0fd9a56a364a457
*%{color:red}Внимание!%* Режим работы ККТ, определяемый перечислением "Mode":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html#a6133311b80ad2d8ed53f0a9766094159 *отличается* от режима работы ФН, описанного в "OperatingMode":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html#af79f7ba66a9ad6fe8763a6f58952a5d2
Численные значения перечислений лежат в начале "страницы":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html
Запрос текущего режима работы ККТ (Mode) выполняется следующим образом:
1. Создаётся экземпляр "IAuth":http://doc.multisoft.ru/doc/MSPOS/IAuth.aidl, который реализует все функции интерфейса.
2. Создаётся экземпляр "IExceptionCallback":http://doc.multisoft.ru/doc/MSPOS/IExceptionCallback.aidl по аналогии с любым другим коллбеком об ошибке
3. Выполняется команда DirectIO с параметрами "DirectIOCmd.GetMode":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html#aa03c06b35cfd3f44c06206014cb9d40c,
в качестве второго параметра необходимо передать идентификатор пользовательского ПО, либо package приложения, из которого функция вызывается.
4.1 Если команда выполнена успешно, ядро вызовет auth.Result(currentMode) с параметром currentMode, равном текущему режиму работы ККТ (Mode).
4.2 Пользовательское ПО сохраняет это число и сравнивает с "Mode.OFD":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html#a6133311b80ad2d8ed53f0a9766094159 и "Mode.ENVD":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html#a6133311b80ad2d8ed53f0a9766094159, определяя текущий режим работы.
5.1 Если команда завершилась с ошибкой, коллбек об ошибке передаётся стандартно, через "IExceptionCallback":http://doc.multisoft.ru/doc/MSPOS/IExceptionCallback.aidl
Переход в режим ЧПМ осуществляется через программный вызов DirectIO при выполнении условий 1-3 аналогично запросу текущего режима работы ККТ (Mode).
В качестве первого параметра необходимо использовать константу "DirectIOCmd.ChangeMode":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html#aa03c06b35cfd3f44c06206014cb9d40c
При смене режима в auth.Result возвращается *новый режим работы*. Был режим: "Mode.OFD":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html#a6133311b80ad2d8ed53f0a9766094159. Сменили режим => в auth.Result возвращается "Mode.ENVD":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html#a6133311b80ad2d8ed53f0a9766094159
h2. Q22
h2. *Какие особенности у режима ЧПМ ?*
h2. A22
В режиме ЧПМ все обращения к ФН отключены и будут возвращать "ErrCode.Hardware":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html#af7d268ea5021cfa159aa82b7004da530, "ExtHardwareErr.Nack":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html#a4db5bb9a1e904a00eeee445ac3aa45cc кроме "FNGetNumber":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a8b2c94673f98ad05e485adc28f0bf95d.
Функции, начинающиеся с *FN, OFD, FDI, QueryOFD, OfdOut, QueryFiscal* созданы для работы в режиме ОФД,
обращаются к ФН и будут возвращать указанную выше ошибку в режиме ЧПМ.
В любой момент из режима ЧПМ можно перейти обратно в режим ОФД с потерей всех счётчиков и состояний по вызову команды DirectIO с параметрами для смены режима работы.
Для корректной работы устройства в режиме ЧПМ его необходимо зарегистрировать.
Перед регистрацией необходимо установить и сохранить следующие опции:
"SetOrgName":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#ad771825ea775e76666cc09772279767a
"SetOrgAddress":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#ac6650f56de207c2664b8a16f3b63fd32
Регистрация выполняется стандартной функцией "Register":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a278fd49eca702ca03b239f65f098a245
В качестве параметров необходимо передать: reg_num, равный "00000", а также корректный ИНН и имя кассира. Остальные параметры не влияют на результат выполнения.
h2. Q23
h2. *Как проверить, к какому магазину привязано устройство?*
h2. A23
Откройте App Store или Магазин приложений.
Дождитесь полной загрузки.
Нажмите иконку пользователя справа вверху.
Открывшееся меню прокрутите вниз.
В поле "Service provider" или "поставщик услуг" показывается текущий магазин, к которому привязано устройство. По умолчанию это Multisoft.
h2. Q24
h2. *На устройстве не применяются настройки магазина, что делать?*
h2. A24
Проверьте "A23":http://wiki.multisoft.ru:8881/redmine/projects/mspos-k/wiki/QA#A23 ^. Если наименование магазина соответствует ожидаемому, убедитесь, что устройство подключено по Wifi к интернет,
и выполните перезагрузку. Допускается подключение через сеть sim-карты с доступом в интернет, но предпочтительнее пользоваться Wifi.
Если перезагрузка не помогла, зайдите в *POS Steward -> network -> network test -> start testing*.
Тест пройден успешно, если все три галочки - зелёные.
Если хотя бы одна из них красная, рекомендуется подключиться к другой Wifi сети, где тест пройдёт успешно,
т.к. корректное применение всех параметров магазина гарантируется только при полностью исправном соединении с интернет.
h2. Q25
h2. *Как работать с признаком агента? Что делать, если пользователь - агент/поверенный/комиссионер?*
h2. A25
Если пользователь - агент/поверенный/комиссионер, соответствующий признак агента указывается в параметрах "регистрации":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a278fd49eca702ca03b239f65f098a245.
После регистрации можно установить *текущий признак агента* функцией "SetAgentTagUsing":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a7f0d91ebd3472d213e6be47e4afda0c2 (аналогично установке СНО, выполняется *перед открытием чека*).
Установка признака агента может быть нужна в случае, если необходимо сформировать документ с одним(несколькими) из зарегистрированных признаков агента, к примеру:
при регистрации указан *PayAgent* и *BankPaySubAgent*, а предмет расчёта в чеке относится только к *PayAgent*).
*Текущий признак агента* распространяется на все предметы расчёта (товары, услуги, ...) в чеке.
*По умолчанию* текущий признак агента равен указанному при регистрации.
Запросить признак агента в ФН (указывается при регистрации) можно функцией "GetAgentTag":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a5e918f55014acc144ed14fa618e6ffab
В зависимости от выбранного *текущего признака агента* в чеке должны быть установлены следующие параметры:
если пользователь - платёжный агент или платёжный субагент (установлены биты "AgentTag.PayAgent":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html#a2116155dfaf66d98ad57fa6e59e4550b и/или "AgentTag.PaySubAgent":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html#a2116155dfaf66d98ad57fa6e59e4550b)
"SetCommissionAgentTelNum":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a537b038aab4c42ed63107e96cd423321
"SetPaymentAgentTelNum":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#ad9db608d873cd7e60e936ae9fd552e2c
"SetContractorTelNum":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#ab93c7d4caebe3cccbe37cafe525d1dad
если пользователь - банковский платёжный агент или банковский платёжный субагент (установлены биты "AgentTag.BankPayAgent":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html#a2116155dfaf66d98ad57fa6e59e4550b и/или "AgentTag.BankPaySubAgent":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html#a2116155dfaf66d98ad57fa6e59e4550b)
"SetTransferOperatorName":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#abc45417de2caada0426148d08c2f01ab
"SetTransferOperatorTaxId":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a40533b38d11cf5703856b46cd68408a3
"SetTransferOperatorTelNum":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a47846d05cebe797b4c5ee59c097eb2fa
"SetTransferOperatorAddress":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a70a8d8ed1e4f1b1b49f6b21860f4d3df
"SetPaymentAgentOperation":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#ad489cb74534c3c0091eac73f8312c7a2
"SetPaymentAgentTelNum":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#ad9db608d873cd7e60e936ae9fd552e2c
"SetContractorTelNum":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#ab93c7d4caebe3cccbe37cafe525d1dad
если пользователь - поверенный, комиссионер и/или иной агент (установлен любой из бит "AgentTag.Attorney":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html#a2116155dfaf66d98ad57fa6e59e4550b, "AgentTag.CommissionAgent":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html#a2116155dfaf66d98ad57fa6e59e4550b, "AgentTag.Agent":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html#a2116155dfaf66d98ad57fa6e59e4550b
"SetContractorTelNum":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#ab93c7d4caebe3cccbe37cafe525d1dad
В предмете расчёта можно устанавливать признак агента по предмету расчёта функцией "SetTagAttribute":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a8bce3c5e91220db3f59b0f7491775393.
*Текущий признак агента (current)* добавляется в чек, если он отличен от 0.
При этом предмет расчёта может содержать *признак агента по предмету расчёта*.
Его значение должно быть подмножеством значений текущего признака агента в чеке (current), иначе ФЯ возвращает ошибку "неверный параметр".
Добавление признака агента по предмету расчёта и прочих реквизитов агента в предмет расчёта осуществляется вызовом функции "SetTagAttribute":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a8bce3c5e91220db3f59b0f7491775393 до добавления позиции, в которой данный признак необходимо установить.
*В документ* теги, относящиеся к признаку агента (далее - теги агента), добавляются при выполнении следующих условий:
текущий признак агента требует того по ФФД *И* значение тега не пустое.
Значения тегов агента для *документа* устанавливаются в ФЯ через функции из блока "Установка дополнительных настроек".
Пример: теги X, Y и Z установлены в непустое ненулевое значение, признак агента требует установки X, Y и K, который null.
В этом случае *в документ* будут переданы теги X и Y.
*В предмет расчёта* теги, относящиеся к признаку агента (далее - теги агента), добавляются при выполнении следующих условий:
тег был передан в SetTagAttribute, *И* значение тега не пустое.
Пример: теги X, Y и Z установлены в непустое ненулевое значение через SetTagAttribute, признак агента по предмету расчёта требует установки X, Y и K, который null.
В этом случае *в предмет расчёта* будут переданы теги X, Y и Z.
h2. Q26
h2. *Когда необходимо менять ФН?*
h2. A26
Самый действенный способ - периодически проверять "FNGetWarningFlags":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a0edf8ac570a448c11ccf95d6ec6632a4
Если "WarningFlag":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html#ad042cfb3dda00bd78f8a393ef16133b9 содержит *FNMemoryOverflow* или *UrgentCSReplace* -> пора менять.
Если в ответе на фискальную операцию (открытие/закрытие смены/документа) в "коллбеке об ошибке":http://doc.multisoft.ru/doc/MSPOS/IExceptionCallback.aidl возвращается "ErrCode.Hardware и ExtHardwareErr.Fatal":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html#af7d268ea5021cfa159aa82b7004da530,
а также установлены эти флаги -> пора менять уже прямо сейчас.
h2. Q27
h2. *Как менять ФН?*
h2. A27
1. Закрыть смену, если была открыта
2. Если ккт находится в неавтономном режиме, нужно дождаться отправки всех документов в ОФД ("OFDGetQueuedMessagesCount":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a8043b80c203d843f72cf4f29deef2050 равно нулю)
и состояние ФН ("FNGetState":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#acccf308edeb4fe120f682cbc3a4b739c) равно "FNArchiveRead":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html#a48a9c84bbd4107e159399f00ad85fa78
3. Закрыть архив ФН "CloseFiscalMode":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#af416b8ca943c669a630763d66edfa085
4. Если ккт в неавтономном режиме - дождаться отправки отчёта о закрытии архива в ОФД (аналогично п.2)
5. Вставить новый ФН.
6. Выполнить перерегистрацию "CorrectRegistration":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a24fb9f4f043bd3ec5fed05cb9213db42 в связи с заменой ФН
h2. Q28
h2. *Где посмотреть логи MSPOS-Expert? как выгрузить логи?*
h2. A28
Откройте MSPOS-Expert, перейдите в раздел "Статус", вкладка "Статус", кнопка "Выгрузка лога".
Если выпадет диалог с запросом разрешений, подтвердите их.
После этого логи появятся в корне карты памяти в папке "mspos"
Далее их можно будет выгрузить, подключив устройство к ПК, либо по teamviewer (более быстрый способ).
Начиная с 1.15.41 логи хранятся по пути */sdcard/Android/data/com.multisoft.drivers.fiscalcore* в 2 файлах: архиве и текущем логе.
Текущий лог - текстовый файл, используемый ФЯ в процессе работы для записи.
Архив - файл с расширением .zip.txt (для возможности выгрузки через ЛК sunmi),
содержит все логи с момента последней очистки, включая логи с предыдущей версии mspos-expert, хранящиеся во внутренней памяти.
Архивация текстовых файлов с логами выполняется при каждом старте ФЯ и закрытии смены.
После архивации запускается механизм ротации.
Алгоритм работы ротации:
если суммарный размер архива превышает 200 МБ и количество файлов в архива больше 2,
наиболее ранние логи удаляются, пока выполняется условие выше.
После выгрузки файла архива его необходимо переименовать, удалив расширение .txt в конце.
После этого его можно будет разархивировать и просматривать файлы с логами.
Также можно *выгрузить логи на сервер*. См. "Q54":http://wiki.multisoft.ru:8881/redmine/projects/mspos-k/wiki/QA#Q54
h2. Q29
h2. *Как происходил переход на НДС 20% в 2019 году?*
h2. A29
*Неактуально*
h2. Q30
h2. *Как выполнить возврат с НДС 18% в 2019 году?*
h2. A30
*Неактуально*
h2. Q31
h2. *При закрытии чека (CloseRec) получаем ошибку errCode 1 (ErrCode.WrongArgument), extErrCode 9, message "Некорректное значение параметров команды ФН", хотя параметры заведомо корректные. В логах BadArgument. Что делать?*
h2. A31
Согласно документации на ФН, так он сигнализирует о переполнении итогов смены. Необходимо аннулировать чек и закрыть смену.
Также имеется информация, что *ФН на 36 месяцев под СНО, рассчитанный на работу только под услуги*, отвечает *BadArgument*, если в *1212 указвыается 1 (товар)*.
h2. Q32
h2. *Как программно посмотреть системную информацию об устройстве (номер сборки, firmware version и т.д.)?*
h2. A32
Программный доступ к системной информации на сайте "SUNMI Developers":https://docs.sunmi.com/en/docking-debugging/special-codes-descriptio
h2. Q32_1
h2. *Где найти документацию ко встроенному сканеру?*
h2. A32_1
Документация к встроенному сканеру лежит "здесь":https://docs.sunmi.com/en/general-function-modules/camera-code-scanning/
h2. Q32_2
h2. *Как открыть страницу определённого приложения в App Store (магазине приложений) программно?*
h2. A32_2
Программно "открыть App store со страницей определённого приложения":https://docs.sunmi.com/en/appstore/how-does-the-app-call-the-score-box/, "ещё ссылка":https://docs.sunmi.com/en/docking-debugging/jump-to-the-app-store-app-details/.
h2. Q32_3
h2. *Где найти API для пользовательских действий по кнопкам громкости?*
h2. A32_3
Настройка "пользовательских действий по нажатию на кнопки громкости":https://docs.sunmi.com/en/others/volume-keys-custom/.
h2. Q33
h2. *Как открыть денежный ящик на MSPOS-Т-Ф?*
h2. A33
Воспользуйтесь функцией aidl "OpenDrawer":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a887ea971d2ec2b4940bea20b835be60a (добавлена в 1.13.39)
h2. Q34
h2. *Какая распиновка разъёма денежного ящика на MSPOS-Т-Ф? Куда подключать считыватель карт в MSPOS-Т-Ф ?*
h2. A34
Ответы на эти вопросы, а также полный перечень разъёмов доступны по "ссылке":https://docs.sunmi.com/en/general-function-modules/external-usb-serial-devices/ или "ещё":https://docs.sunmi.com/en/others/usb-device/
h2. Q35
h2. *Какие собенности при подключении тестового ФН (МГМ) ?*
h2. A35
1. МГМ может быть использован только в целях разработки и тестирования
2. МГМ можно сбросить в состояние по умолчанию (готов к регистрации). "FNResetDebug":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#ac536e2612558d0f8c4b7f871b1a82a4e в AIDL.
3. ККТ с МГМ регистрируется только в тестовом контуре ОФД. Информацию по подключению к тестовому контуру нужно уточнять у ОФД, к которому Вы собираетесь подключиться.
h2. Q36
h2. *Переданный в аргументе функции "SetTagAttribute":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a8bce3c5e91220db3f59b0f7491775393 код товара отображается в ОФД некорректно или указан как имеющий невалидный формат. Что делать?
Как передать код товара (КТ, КТН) 1162 в виде массива байтов ?
В каком формате нужно кодировать символы для передачи 1162 через "SetTagByteAttribute":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a5d4da6d198bfd0c9f42a4872775225bb ?*
h2. A36
Некоторые ОФД придумали собственный способ кодирования 1162.
По многочисленным запросам для поддержки передачи кода товара в виде массива байт в 1.14.40 была добавлена функция "SetTagByteAttribute":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a5d4da6d198bfd0c9f42a4872775225bb
*+Вопросы, связанные с форматом/представлением/кодированием данных тега 1162 при передаче в виде массива байт, следует адресовать технической поддержке конкретного ОФД.+*
*UPD: 05.06.2019*
Cтало известно, что некоторые из операторов фискальных данных перестали считать собственные алгоритмы кодирования 1162, противоречащие ФФД, единственно верными.
В личном кабинете ОФД данные тега 1162, переданные через "SetTagAttribute":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a8bce3c5e91220db3f59b0f7491775393 *отображаются как валидные в бинарном виде*, хотя и искажены при представлении в виде строки.
h2. Q37
h2. *Как работать с подакцизными товарами (признак торговли подакцизными товарами) 1207?*
h2. A37
Установите "Tag.ExceiseTag":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html#aad4c955ae1340f0cb8b7d00b2260d43aa3b778def2fdb07151fb33551bfe83e03 функцией "SetTagAttribute":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a8bce3c5e91220db3f59b0f7491775393 до вызова функции (пере)регистрации.
Это нужно, чтобы в последствии можно было передавать 1212 со значением 2.
h2. Q38
h2. *Как быстро применяются настройки в Личном кабинете (ЛК)? Как ускорить применение настроек ТК после изменения?*
h2. A38
Настройки, установленные в ЛК SUNMI влияют только на устройства, привязанные к этому аккаунту.
Настройки магазина прилетают на устройство в течение нескольких минут при наличии стабильного интернет-соединения.
Если устройство в момент изменения настроек было не подключено к сети интерент или выключено, настройки применятся при следующем подключении к интернет.
Для ускорения применения настроек на устройстве необходимо:
0. Обеспечить стабильное подключение к интернет
1. Если приложение "Магазин приложений" было открыто ранее, смахнуть его из списка недавних приложений.
2. Зайти в "Магазин приложений" на устройстве
3. Дождаться полной загрузки магазина. В этот момент настройки применены.
Если устройство было подключено к ПК, настройки adb применятся при следующем подключении к ПК.
4. Если настройки не применены, нужно проверить, к какому магазину привязано устройство (см. "Q23":http://wiki.multisoft.ru:8881/redmine/projects/mspos-k/wiki/QA/#Q23)
5. Если название магазина совпадает с названием ТК, перезагрузите устройство и повторите пп. 1-4, иначе настройки устройства поменять нельзя.
h2. Q39
h2. *Надпись "ККТ блокирована" на автотесте. Что делать?*
h2. A39
Список ошибок на автотестировании, которые блокируют ККТ:
* ККТ зарегистрирована, ФН не подключен (GetFiscalMemoryFiscalized возвращает true, FnGetNumber возвращает NACK).
Необходимо установить корректный ФН.
* ФН зарегистрирован с другой ККТ (ФН зарегистрирован, ККТ - нет и наоборот. ErrCode.Hardware, ExtHardwareErr.Fatal)
Необходимо установить корректный ФН.
* Фискальная плата клонирована (ЗН не установлен, на запрос GetSerial возвращает "XXXXXXXXXXXX").
Необходимо установить ЗН, с которым ККТ была зарегистрирована. ЗН должен долен совпадать с тем, что в паспорте.
* ККТ зарегистрирована с другим ФН (номер ФН не совпадает. ErrCode.Hardware, ExtHardwareErr.Fatal).
Необходимо установить корректный ФН.
h2. Q40
h2. *Когда коллбек об ошибке печати может не возвращаться? Что делать, если закончилась бумага посередине чека?*
h2. A40
Для фискальных документов коллбек об ошибке печати *не вызывается* в следующем случае:
Документ *отправлен в ФН, и датчик бумаги сработал после этого* во время печати ФП и ФД, а в случае кассового чека - ещё и QR.
Это особенность реализации, которая продиктована работой ФН: ФП и ФД возвращаются после передачи документа в ФН.
Если ленты хватило на печать документа, но не хватило на печать QR, коллбека об ошибке печати не будет.
В этом случае ПО верхнего уровня не уведомляется об ошибках печати чека, чтобы избежать дублирования чека в ФН.
Если бумага закончилась посередине чека, когда чек ещё не ушёл в ФН, ФЯ вызовет коллбек об ошибке.
Рекомендуем уведомить пользователя в UI об отсутствии бумаги и предложить сформировать документ заново.
Перед повторным формированием документа необходимо отменить текущий открытый документ.
h2. Q41
h2. *При печати строки накладываются одна на другую. Что делать?*
h2. A41
Зайдите в "Обновление системы" или "Обновление" на домашнем экране устройства. Если есть обновления, установите их.
Если проблема не решилась или обновлений нет, воспользуйтесь "A42":http://wiki.multisoft.ru:8881/redmine/projects/mspos-k/wiki/QA#A42.
h2. Q42
h2. *У нас новая ошибка, которой нет в этом QA. Что делать?*
h2. A42
Сообщите максимум информации об устройстве:
* SN (на первой странице mspos-expert, либо в настройки -> о телефоне -> общая информация)
* версию ОС (настройки -> о телефоне -> номер сборки)
* версию PrinterService либо SunmiPrinterService либо InnerPrinter (в разных версиях ОС приложение называется по-разному).
Посмотреть версию можно зайдя в настройки -> приложения -> справа сверху меню -> показать системные процессы. После этого сервис печати появится в списке
* версию mspos-expert (на первой странице приложения либо в настройки -> приложения -> mspos-expert).
* по возможности, логи mspos-expert
* если речь про терминал с эквайрингом, также сообщить версию платёжного сервиса SunmiPayHardwareService.
h2. Q43
h2. *Куда пропали с чека реквизиты: номер ФД, номер чека\смены и адрес сайта ФНС?*
h2. A43
* Номер ФД находится под QR-кодом;
* Номер чека\смены не имеет печатной формы {{collapse(Выдержка из приказа)
!ffd12_1038_1042.png!
}}
* Адрес сайта ФНС можно не выводить на печать в случае, если он был передан при регистрации.
h2. Q44
h2. *Как пробить чек с маркировкой?*
h2. A44
1. Проверка КМ в ФН: SendMarkupCodeFnCheck;
2. Проверка КМ в ОИСМ: SendMarkupCodeOismCheck;
3. Получение результата проверки в ОИСМ: GetMarkupCodeOismResult;
4. Сохранение результатов проверки: SaveMarkupCodeCheckResult(true);
5. Открыть чек: OpenRec;
6. Передать КМ (тег 1163) с помощью SetTagAttribute(КМ должен быть идентичен отправленному в SendMarkupCodeFnCheck);
7. Пробить позицию PrintRecItem;
...
8. Закрыть чек: CloseRec.
Обращаем внимание, что вызов SendMarkupCodeOismCheck после SendMarkupCodeFnCheck является обязательным вне зависимости от условий оперирования ККТ.
Для получения *[M+]* в чеке необходимо, чтобы проверка КМ прошла успешно как в ФН, так и в ОИСМ.
h2. Q45
h2. *В каком виде передавать КМ в ФЯ?*
h2. A45
Следует передавать КМ в том виде, в котором он пришёл со сканера, без символа FNC1 в начале, если он присутствует. Сканер должен поддерживать символ разделителя GS(0x1D) для GS1 кодов и его также нужно передавать внутри КМ БЕЗ дополнительного экранирования.
{{collapse(Например)
!MC_example.png!
}}
h2. Q46
h2. *Что передавать в параметрах команды SendMarkupCodeFnCheck?*
h2. A46
У команды есть два варианта работы:
1. Указать тип(тег 2100) 0 - тогда ФЯ использует встроенный парсер, который пытается на основе предоставленного КМ сам определить, тип и смещения, если они требуются.
2. Указать тип отличный от 0, - ФЯ использует данные которые получит через параметры команды. Т.е. для типа 2 и 4 (gs1m с длиной кода проверки в 44(с верным crc32) и 88 символов) необходимо передать смещения.
Парсер внутри ФЯ должен поддерживать все типы КМ и первый вариант команды является самодостаточным. Но, если необходимо самостоятельно определять тип и смещения, то можно использовать второй вариант.
h2. Q47
h2. *Как использовать ClearAllMarkupCodeCheckResult? *
h2. A47
Команда ClearAllMarkupCodeCheckResult очищает список уже сохранённых КМ (до 128) и начинает новую сессию проверки КМ.
Согласно протоколу ККТ-ФН, отмена чека не удаляет уже сохранённые результаты проверки КМ, т.е. их не нужно проверять заново, если в чеке после отмены пробиваются товары с тем же КМ. Однако, для полной отмены чека с маркированными товарами (допустим, покупатель отказался от товара и ушёл) необходимо после отмены чека также вызвать команду ClearAllMarkupCodeCheckResult.
Команду ClearAllMarkupCodeCheckResult нельзя вызвать при открытом чеке.
h2. Q48
h2. *Как проверить и сохранить КМ?*
h2. A48
1. Проверить КМ в ФН: SendMarkupCodeFnCheck;
2. Проверить КМ в ОИСМ: SendMarkupCodeOismCheck;
3. Получить результаты проверки в ОИСМ: GetMarkupCodeOismResult;
4. Сохранить результаты проверки: SaveMarkupCodeCheckResult(true);
Сохранённым КМ считается только после вызова SaveMarkupCodeCheckResult(true).
h2. Q49
h2. *Как исключить товар из уведомления с проверенным, но НЕ сохранённым КМ?*
h2. A49
Товар c КМ, который НЕ был передан с помощью SetTagAttribute и PrintRecItem НЕ будет включён ни в чек, ни в уведомление, даже если не было вызова SaveMarkupCodeCheckResult(false).
Важно, что товар с КМ, который был передан с помощью SetTagAttribute и PrintRecItem будет включён в чек, но НЕ будет включён в уведомление, даже если не было вызова SaveMarkupCodeCheckResult(false).
Отменять чек, если он открыт, и вызывать ClearAllMarkupCodeCheckResult также является рабочим вариантом, но потребуется повторная проверка всех ранее сохранённых КМ.
h2. Q50
h2. *Как исключить товар из уведомления с проверенным и сохранённым КМ?*
h2. A50
Товар с КМ, который НЕ был передан с помощью SetTagAttribute и PrintRecItem НЕ будет включён ни в чек, ни в уведомление.
Делать повторную проверку КМ и вызывать SaveMarkupCodeCheckResult(false) в таком случае не нужно.
Отменять чек, если он открыт, и вызывать ClearAllMarkupCodeCheckResult также является рабочим вариантом, но потребуется повторная проверка всех ранее сохранённых КМ.
h2. Q51
h2. *Можно ли повторно проверить КМ в ФН и ОИСМ внутри той же сессии?*
h2. A51
Да, можно, если это сделать ДО пробития позиции через PrintRecItem. В случае повторного вызова SaveMarkupCodeCheckResult(true) с новыми данными при добавлении в уведомление и чек будут использованы данные последней проверки.
h2. Q52
h2. *Как получить возможность пробивать чек с маркировкой по ФФД 1.2?*
h2. A52
Для пробития чеков с маркировкой по ФФД 1.2 следует зарегистрироваться по ФФД 1.2 с признаком продажи маркированных товаров.
# Проверить что ФН поддерживает 1.2 командой "FNGetFnFfdVersion":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a04be93cf644895ecc725282713d17308, должен быть ответ "4, ФФД 1.2":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html#adf30cb237f81266d7015257e16797daf ;
# Проверить что ККТ поддерживает 1.2 командой "GetKktFfdVersion":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a68dc1ba905fa8ce57ec4535517d55193, должен быть ответ "4, ФФД 1.2":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html#adf30cb237f81266d7015257e16797daf ;
# Зарегистрировать (или перерегистрировать) ККТ под ФФД 1.2 командой "Register1_2":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a16730f50a154033496155ddd9db31a54 \ "CorrectRegistration1_2":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#ab7c59fdbd630c35944fa07e38d5292cc с признаком продажи маркированных товаров (marking = true).
Далее можно открыть смену и пробить чек с маркированным товаром "Q44":http://wiki.multisoft.ru:8881/redmine/projects/mspos-k/wiki/QA#Q44.
h2. Q53
h2. *Как подключиться к ФЯ на Android 12?*
h2. A53
Для того, чтобы приложение увидело ФЯ в manifest надо добавить:
<pre><code class="cpp">
<queries>
<package android:name="com.multisoft.drivers.fiscalcore"/>
</queries>
</code></pre>
И перед bindService:
<pre><code class="cpp">
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O)
{
startForegroundService(intent);
}
else
{
startService(intent);
}
</code></pre>
Примеры работы с ФЯ: "Visual Studio":http://doc.multisoft.ru/doc/MSPOS/Examples/ExampleVisualStudio19.zip и "Android Studio":http://doc.multisoft.ru/doc/MSPOS/Examples/ExampleAndroidStudio.zip.
h2. Q54
h2. *Как выгрузить логи на сервер?*
h2. A54
В приложении Mspos Expert во вкладке "Статус", раздел "Статус" нажать на кнопку "Выгрузить логи на сервер" и подтвердить действие. Передать в multisoft информацию о том, что логи были выгружены, SN устройства, дату и время возникновения ошибки и описание возникшей проблемы.
--------------------------------------------------------------------------------------------------------------
Ресурсы:
h2. Ссылки на документацию: "aidl":http://doc.multisoft.ru/doc/MSPOS/, "примеры":http://doc.multisoft.ru/doc/MSPOS/Examples/, "описания функций":http://doc.multisoft.ru/doc/MSPOS/html/, "алгоритм формирования чека продажи с маркированной продукцией":http://doc.multisoft.ru/doc/MSPOS/%d0%90%d0%bb%d0%b3%d0%be%d1%80%d0%b8%d1%82%d0%bc%20%d1%84%d0%be%d1%80%d0%bc%d0%b8%d1%80%d0%be%d0%b2%d0%b0%d0%bd%d0%b8%d1%8f%20%d1%87%d0%b5%d0%ba%d0%b0%20%d0%bf%d1%80%d0%be%d0%b4%d0%b0%d0%b6%d0%b8%20%d1%81%20%d0%bc%d0%b0%d1%80%d0%ba%d0%b8%d1%80%d0%be%d0%b2%d0%b0%d0%bd%d0%bd%d0%be%d0%b9%20%d0%bf%d1%80%d0%be%d0%b4%d1%83%d0%ba%d1%86%d0%b8%d0%b5%d0%b9.pdf, "Алгоритм проверки доступности работы с маркировкой":http://doc.multisoft.ru/doc/MSPOS/%d0%90%d0%bb%d0%b3%d0%be%d1%80%d0%b8%d1%82%d0%bc%20%d0%bf%d1%80%d0%be%d0%b2%d0%b5%d1%80%d0%ba%d0%b8%20%d0%b4%d0%be%d1%81%d1%82%d1%83%d0%bf%d0%bd%d0%be%d1%81%d1%82%d0%b8%20%d1%80%d0%b0%d0%b1%d0%be%d1%82%d1%8b%20%d1%81%20%d0%bc%d0%b0%d1%80%d0%ba%d0%b8%d1%80%d0%be%d0%b2%d0%ba%d0%be%d0%b9.pdf
h2. "Приказ ФНС России от 14.09.2020 № ЕД-7-20/662@":https://www.nalog.gov.ru/rn77/about_fts/docs/10020801/
h2. Перед началом работы: какие модели поддерживаются?
В настоящий момент Фискальное ядро установлено на следующие модели ККТ серии MSPOS: *MSPOS-K, MSPOS-T-Ф, MSPOS-Е-Ф*, *MSPOS-D-Ф*, *MSPOS-kiosk-Ф*, *MSPOS-SE-Ф*, *MSPOS-E-РФ*, *MSPOS-N-Ф*.
Им соответствуют строковые константы моделей (Build.MODEL), бренда (Build.BRAND) и производителя (Build.MANUFACTURER) устройств:
*BRAND = "SUNMI"*
*MODEL:*
* MSPOS-K: "V1S-G", "V1S", "V2"
* MSPOS-T-Ф: "T1MINI-G", "T1MINI", "T2MINI", "T2MINI_S", "D2MINI"
* MSPOS-Е-Ф: "P1_4G", "P1_4G-G", "P1_4G-EU", "P1_4G-R"
* MSPOS-D-Ф: "P2_PRO"
* MSPOS-kiosk-Ф: "K1"
* MSPOS-SE-Ф: "P2_SE", "V2_SE"
*BRAND = "DORO"*
*MANUFACTURER = "TIANYU"*
*MODEL:*
* MSPOS-E-РФ: "P30"
*BRAND = "QCOM"*
*MANUFACTURER = "NEWLAND"*
*MODEL:*
* MSPOS-N-Ф: "N850"
h2. *%{color:red}Вопросы по маркировке%* "тут":http://wiki.multisoft.ru:8881/redmine/projects/mspos-k/wiki/QA#Q44
h2. Q0
h2. *Любые обращения по поводу конкретного устройства/ККТ. Вопросы по переводу устройств между ТК и ОК, а также между субаккаунтами внутри ТК и ОК.*
h2. A0
При обращении по любым вопросам, которые касаются конкретного устройства, в чаты ТП и разработки
нужно указывать *SN* устройства (см. наклейку со штрих-кодами на обратной стороне аппарата).
Если вопрос связан с переводом устройства в тестовый контур или обратно в основной,
*нужно прикладывать фото задней части устройства либо скриншот первой страницы mspos-expert %{color:red}с читаемым SN%*.
Перенос устройств между ТК и ОК, а также между их субаккаунтами осуществляется только после подтверждения права собственности на устройство.
%{color:red}Переводы клиентского оборудования из *кастомного магазина в основной* делаются *по заявке с подписью ответственного лица и печатью организации*%.
Заявки на перевод принимаются *только от той организации, к кастомному магазину которой устройство было привязано при отгрузке*.
Перенос устройств между ТК и ОК после *13-00 МСК* выполняется с большой вероятностью только *на следующий день*.
h2. {{collapse(где найти SN)
!1.png!
}}
Фото не обязательно, если девайс уже привязан к Вашему личному кабинету. Предоставление фото позволяет избежать ошибок при переводе.
{{collapse(Так делать не надо)
!2.png!
}}
h2. Q1
h2. *Как добавить IFiscalCore.aidl в Android Studio?*
h2. A1
0. Скачать IFiscalCore.aidl, IAuth.aidl, IExceptionCallback.aidl с "сервера":http://doc.multisoft.ru/doc/MSPOS/
1. В корневой папке проекта создать папку aidl
2. Внутри папки aidl создать папку с именем, соответствующим package (com.multisoft.drivers.fiscalcore).
3. Правый клик по папке с именем package -> New -> AIDL -> AIDL File
4. Во всплывающем окне ввести имя интерфейса (например, IFiscalCore). Подтвердить выбор.
5. Скопировать содержимое скачанного файла в текстовом виде в созданный без(!) замены файлов.
6. Повторить операции 3-5 для IAuth.aidl и IExceptionCallback.aidl
h2. Q2
h2. *У меня ошибка вида %{color:red}Execution failed for task ':app:compileDebugAidl'%. Либо %{color:red}*.aidl:1: syntax error don't know what to do with "?"%*
h2. A2
Вероятно файлы содержат "BOM":https://ru.wikipedia.org/wiki/%D0%9C%D0%B0%D1%80%D0%BA%D0%B5%D1%80_%D0%BF%D0%BE%D1%81%D0%BB%D0%B5%D0%B4%D0%BE%D0%B2%D0%B0%D1%82%D0%B5%D0%BB%D1%8C%D0%BD%D0%BE%D1%81%D1%82%D0%B8_%D0%B1%D0%B0%D0%B9%D1%82%D0%BE%D0%B2.
Выполните инструкции, описанные в "Q1":http://wiki.multisoft.ru:8881/redmine/projects/mspos-k/wiki/QA#Q1.
h2. Q3
h2. *Как зарегистрироваться в программе Sunmi Partners?*
h2. A3
После подписания партнёрского соглашения на указанную в нём почту придёт приглашение на регистрацию в "Sunmi Partners":https://partner.sunmi.com/login. Регистрироваться без инвайта не нужно.
Откройте присланную ссылку с персонального компьютера (ПК) в "Google Chrome":https://www.google.ru/chrome/browser/desktop/index.html. Рекомендуется использовать его и в дальнейшем для любых действий в "личном кабинете (ЛК)":https://partner.sunmi.com/login.
Первая загрузка сайта может занять некоторое время, подождите полной загрузки и не обновляйте страницу, пока она не будет полностью загружена.
Если страница загрузилась, но открывается пустой список для выбора страны и/или кода телефона - очистите кеш браузера и обновите страницу.
Не обновляйте страницу повторно, пока она не загрузится полностью.
Следуйте шагам реристрации. *Оформлять смс подтверждение не нужно*.
По окончании дождитесь верификации аккаута. Она выполняется автоматически в течение 1 рабочего дня.
В процессе регистрации будет предложено загрузить Company Registration Certification. Подробнее в "Q5":http://wiki.multisoft.ru:8881/redmine/projects/mspos-k/wiki/QA#Q5.
*После регистрации и успешной верификации нужно добавить фискальное ядро в свой магазин.
Для этого выполните пункты "A3_1":http://wiki.multisoft.ru:8881/redmine/projects/mspos-k/wiki/QA#A3_1*
При настройке личного кабинета (ЛК) разработчика установите триггеры в соответствии с картинкой.
Debugger access control рекомендуется установить в положение "выкл", иначе придётся периодически вводить в устройство временный пароль,
который присылается на почту, указанную в ЛК в Development -> Debugger.
*Не включайте Google Play. В основном контуре Google Play выключен* в целях безопасности.
h3. {{collapse(Настройки ТК)
!tk_setttings1.png!
}}
h2. Q3_1
h2. На устройстве нет MSPOS-Expert. Что делать?
На устройстве нет приложения <notextile>%</notextile>AppName<notextile>%</notextile>. Как его добавить?
h2. A3_1
Зайдите в "личный кабинет":https://partner.sunmi.com/login на вкладку *App Store -> App List*,
найдите *MSPOS-Expert* (или <notextile>%</notextile>AppName<notextile>%</notextile>) справа в *"No apps added"*, выделите его галку и нажмите кнопку *"Added apps"*.
После этого приложение появится в *"Apps Selected"*.
Если приложения нет в списке справа, проверьте список слева.
Для добавления приложения, отсутствующего в обоих списках напишите разработчикам этого приложения.
Для того, чтобы приложение появилось в поиске в личном кабинете,
к этому кабинету должен быть привязан *по крайней мере один терминал из списка поддерживаемых приложением* моделей (выбирается при загрузке приложения в магазин).
При публикации приложения разработчик сам указвыает список поддерживаемых моделей и зону видимости: только для своего аккаунта / для своего и субаккаунтов / для всех аккаунтов.
Если приложения нет в поиске, но достоверно известно, что оно загружено, нужно обратиться к авторам приложения с просьбой расширить зону видимости их продукта.
Если разработчик - Вы, можете загружить приложение по "инструкции":http://wiki.multisoft.ru:8881/redmine/projects/mspos-k/wiki/QA/#Q6.
Также рекомендуем добавить *TeamViewerQS* и *TeamViewerQS —APPX*.
В дальнейшем *не удаляйте MSPOS-Expert из магазина*.
h3. {{collapse(Как добавить приложение в ЛК разработчика)
!add_mspos.png!
}}
h2. Q4
h2. *Как подготовить устройство MSPOS к отладке?*
h2. A4
В тестовом контуре возможность отладки автоматически включена для всех устройств, привязанных к тестовому аккаунту.
На своём устройстве *в "Настройки"->"Безопасность" разрешите установку приложений из неизвестных источников*.
Сообщите серийный номер устройств(а) (SN) сотрудникам Multisoft/Альфа-Проект, которые занимаются интеграцией.
Они привяжут его к вашему аккаунту по завершении регистрации в Sunmi Partners.
Для упрощения *разработки в ТК* в Вашем "личном кабинете":https://partner.sunmi.com/login *Device Configuration* -> *Common* -> *Debug Protect* должен быть *выключен*.
В этом случае способ, описанный "здесь":https://developer.sunmi.com/docs/en-US/xeghjk491/ciieghjk579, не актуален.
Там же *Device Configuration* -> *Common* -> *Install by 3rd APP* должен быть *включен*.
Подключите устройство к сети WiFi с открытым доступом и интернет.
Подключите включенное устройство по USB к компьютеру с установленным Android SDK.
Дождитесь установки драйверов (если используется Windows) и появления уведомления "Отладка по USB разрешена" на устройстве.
Если не удалось установить драйвера, и/или устройство не отображается в диспетчере устройств Windows,
попробуйте, если это Type-C, подсоединить разъём другой стороной и/или выбрать другой разъём в ПК для подключения.
Универсальные драйвера под Windows для android-устройств можно найти "здесь":https://developer.android.com/studio/run/win-usb
В *%AndroidSDKInstallDir%\android-sdk\platform-tools\* выполните *"adb devices"* из консоли,
на экран должны быть выведены серийный номер аппарата и *device*, что означает, устройство готово к отладке.
Если эта команда показывает *"unauthorized"*, проверьте подключение к интернет и перезагрузите аппарат.
Если после перезагрузки *adb devices* всё равно возвращает *unauthorized*, либо при отладке возникают ошибки доступа,
попробуйте включить режим разработчика вручную стандартным для android устройств способом:
многократными тапами по *Build.Number (Номер сборки)* в меню *"о телефоне".*
Также попробуйте отключить (если была включена) и включить снова опцию *"Отладка по USB"* в меню *"Для разработчиков"*.
h2. A4_1
*Перевод MSPOS-Е-Ф, MSPOS-D-Ф, MSPOS-SЕ-Ф (с экв.) и других эквайринговых моделей sunmi в режим отладки (включение adb)*:
Данная процедура необратима. По завершении девайс перезагрузится, и на экране ККТ появится неудаляемый водяной знак.
Использование эквайринговых моделей со включенной отладкой в боевом режиме недопустимо.
Будучи включённым, adb делает устройство небезопасным для конечного пользователя.
Последствия проведения транзакций при использовании устройства в режиме отладки ложатся на компанию, запросившую перевод в режим отладки.
Включение режима отладки разрешено только в целях разработки и тестирования.
При использовании устройства только в целях тестирования рекомендуем использовать механизм gray release.
Для включения adb, кроме передачи сотрудникам Мультисофт SN и фото с читаемым SN, необходимо:
* явно сообщить о своём намерении включить режим отладки (adb) на конкретном устройстве путём указания его SN в текстовой форме
* явно указать намерение использовать устройство в целях разработки и тестирования
* явно подтвердить, что последствия работы с включенным adb ясны
*Пример:* "Прошу предоставить код для adb на девайс PExxxxxxxxxx. В целях разработки и тестирования. Последствия ясны, риски приняты."
Включение режима отладки осуществляется путём ввода 4-значного одноразового временного кода.
Код необходимо вводить в специальное меню, которое открывается после 8 нажатий по TUSN в "Настройки" -> "О телефоне".
Срок действия кода: 24 часа.
Если после ввода появилось сообщение об ошибке, повторно вводить не нужно. Вместо этого сообщите о проблеме сотрудникам Мультисофт, по возможности передав текст сообщения.
h2. Q5
h2. *Что делать с Company Registration Certification при регистрации аккаунта в sunmi partners?*
h2. A5
Прикрепите пустую картинку. Эта опция нужна китайским компаниям.
h2. Q6
h2. *Как загрузить приложение в магазин Sunmi?*
h2. A6
Воспользуйтесь "инструкцией по загрузке":http://wiki.multisoft.ru:8881/redmine/projects/mspos-k/wiki/AddAppSunmi
При загрузке укажите правильные модели(Terminals): *приложение будет доступно только на указанных моделях*.
Поле *price* выставлять в соответствии с партнёрским соглашением.
После загрузки каждой версии в магазин требуется около 1 рабочего дня на автоматический аудит.
Если приложение было загружено в магазин в режиме пре-релиза (gray release),
аудит выполняется при первой загрузке и не распространяется на *Change to official version*.
Кнопка *Change to official version* нужна, чтобы применить грей релиз на все аппараты.
Изменение списка устройств для пре-релиза (в т.ч. применение пре-релизана все устройства - change to official version) не сопровождается аудитом.
Изменение атрибутов приложения, таких как скриншоты, описание, поддерживаемые модели и др. вызывает повторный аудит при применении этих свойств (кнопка Save внизу).
*"ТРЕБОВАНИЯ МАГАЗИНА ПРИЛОЖЕНИЙ К ПО":https://developer.sunmi.com/docs/en-US/cdixeghjk491/cireghjk568*
Для *обновления* приложения в магазине мы подготовили "другую инструкцию":http://wiki.multisoft.ru:8881/redmine/projects/mspos-k/wiki/UpdAppSunmi
h2. Q7
h2. *Что нужно знать о регистрации фискального накопителя (ФН)?*
h2. A7
Процедура регистрации выполняется один раз за время жизни ФН.
Регистрация ФН - часть процесса включения фискального режима работы ККТ.
Пока ККТ не зарегистрирована с ФН, она находится в учебном режиме. Об этом свидетельствует надпись * *учебный режим* * в начале чеков.
После регистрации ФН ККТ в процессе работы печатает *фискальные* документы, за исключением нефискальных документов (RecType.Unfiscal),
документов внесения/изъятия (RecType.PayIn/PayOut) и X-отчётов (PrintXReport).
Если ККТ зарегистрирована в неавтономном режиме (отсутствует флаг OperatingMode.Autonomous),
фискальные документы будут отправляться в ОФД по настроенному каналу связи (валидный сервер и порт ОФД,
выход в интернет по Wifi или через мобильную сеть).
Для регистрации фискального накопителя(ФН) нужно следующее:
а) ФН подключен и в состоянии "готов к регистрации" ("FNGetState":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#acccf308edeb4fe120f682cbc3a4b739c == "FnState.ReadyToFiscalization":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html#a48a9c84bbd4107e159399f00ad85fa78).
б) смена должна быть закрыта ("GetDayState":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a75178af4fb3f53fec8ff0a2c5cc14edd == "DayState.DayClosed":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html#ac954685f2b9cd2e40ef72d39f68de124)
в) не должно быть открыто ни одного документа ("GetRecState":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a5f6942bdd312c5a8a52bdd2c4ebd3d7b == "RecState.Closed":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html#a23cd3e5ca25f473990493575a9c2f11c)
после этого можно начинать процедуру регистрации.
h2. Q8
h2. *Как зарегистрировать ФН / включить фискальный режим ККТ?*
h2. A8
Процедура регистрации, в зависимости от желаемых параметров регистрации, может отличаться.
Основные операции при регистрации:
1) установка опций: см. блок "Запрос и установка параметров"
2) сохранение опций (см. "SaveOptions":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a8bf297561df86b0c5e62b8b0adcf670e )
3) регистрация (см. "Register":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a278fd49eca702ca03b239f65f098a245 ).
при каждой регистрации %{color:red}обязательными% для установки на шаге 1 являются:
"SetOrgName":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#ad771825ea775e76666cc09772279767a
"SetOrgAddress":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#ac6650f56de207c2664b8a16f3b63fd32
"SetPhysicalAddress":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#ae09721153004af1fcd47c8dd900666c6
"SetFnsServerAddress":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#ac35b9fefb435f5ade6d337e174fe6190
Если при регистрации в битовом поле "режим работы" (op_mode) %{color:red}не% установлен бит "OperatingMode.Autonomous":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html#af79f7ba66a9ad6fe8763a6f58952a5d2 (0x02), %{color:red}обязательными на шаге 1 также являются%:
"SetSenderEmail":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a47a8880a2cdec8dff31067adc172d161
"SetOfdHost":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#ab616fe44a2bade57e5f11010e277bf11
"SetOfdPort":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a3cd2cb3aac6f6a36989aa099e3ca7a2e
"SetOfdName":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a8f1fb2f7c7eb90a984c5d8fb5bc223bb
"SetOfdTaxId":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a31a1421e3bd6418411e1602765d13b9d
Если при регистрации в битовом поле "режим работы" (op_mode) установлен бит "OperatingMode.Automatic":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html#af79f7ba66a9ad6fe8763a6f58952a5d2 (0x04), %{color:red}на шаге 1 должен быть установлен номер автомата%:
"SetVendingSerial":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a9f854e01cb5b4f40a1b97b2f19c41cae
В зависимости от того, является ли пользователь платёжным агентом (параметр agent в функции Register отличен от 0), %{color:red}на шаге 1 должны быть установлены следующие опции%:
"SetTransferOperatorName":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#abc45417de2caada0426148d08c2f01ab
"SetTransferOperatorTaxId":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a40533b38d11cf5703856b46cd68408a3
"SetTransferOperatorTelNum":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a47846d05cebe797b4c5ee59c097eb2fa
"SetTransferOperatorAddress":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a70a8d8ed1e4f1b1b49f6b21860f4d3df
"SetPaymentAgentTelNum":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#ad9db608d873cd7e60e936ae9fd552e2c
"SetPaymentAgentOperation":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#ad489cb74534c3c0091eac73f8312c7a2
"SetCommissionAgentTelNum":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a537b038aab4c42ed63107e96cd423321
"SetContractorTelNum":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#ab93c7d4caebe3cccbe37cafe525d1dad
Точный список требуемых параметров в зависимости от аргументов функции (пере)регистрации указан в "Q25":http://wiki.multisoft.ru:8881/redmine/projects/mspos-k/wiki/QA#Q25
h2. Q9
h2. *Какие особенности работы с несколькими СНО?*
h2. A9
Пользователь может иметь несколько систем налогообложения (СНО). Запросить СНО, указанную при регистрации, можно функцией "GetTaxation":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a3634272503b0484eae22365fbf21a4a0
При этом в чеках должна быть указана только одна из зарегистированных СНО.
Если пользователь зарегистрировал кассу с несколькими СНО, то перед каждым открытием документа ("OpenRec":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a0652bf6ebf8d2e3147bf45905daa1f1e )
*текущая СНО* должна быть установлена функцией "SetTaxationUsing":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#ab2f0202725597f348727647d33eedaf4 , в параметрах которой передаётся одна из зарегистрированных СНО.
h2. Q10
h2. *Для чего нужна перерегистрация?*
h2. A10
Если параметры кассы и/или реквизитов пользователя изменились, об этом нужно уведомить Федеральную налоговую службу (ФНС)
посредством отправки оператору фискальных данных (ОФД) отчёта о перерегистрации в электронной форме.
Отчёт о перерегистрации формируется функцией "CorrectRegistration":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a24fb9f4f043bd3ec5fed05cb9213db42.
Её параметры аналогичны функции "Register":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a278fd49eca702ca03b239f65f098a245, но нужно установить дополнительный - причину перерегистрации.
Причин перерегистрации может быть 4: замена ФН, смена ОФД, смена реквизитов пользователя и смена настроек ККТ.
h2. Q11
h2. *Как выполнить перерегистрацию?*
h2. A11
Выполняется аналогично "регистрации":http://wiki.multisoft.ru:8881/redmine/projects/mspos-k/wiki/QA#Q8 за исключением пункта 0):
0) убедиться, что в очереди на отправку в ОФД нет документов ("OFDGetFirstQueuedDocNumber":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a973998cafa852d49f1dfa351f336d069 == 0), иначе перерегистрация не будет выполнена.
1) установка опций, которые необходимо изменить, в связи с причиной перерегистрации: см. блок "Запрос и установка параметров"
Точный список требуемых параметров в зависимости от аргументов функции (пере)регистрации указан в "Q25":http://wiki.multisoft.ru:8881/redmine/projects/mspos-k/wiki/QA#Q25
2) сохранение опций (см. "SaveOptions":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a8bf297561df86b0c5e62b8b0adcf670e )
3) перерегистрация(см. "CorrectRegistration":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a24fb9f4f043bd3ec5fed05cb9213db42 ).
В связи с ограничениями ФН %{color:red}нельзя выполнить 1 перерегистрацию на ФФД 1.05 с несколькими причинами одновременно%.
Например, нельзя поменять настройки ОФД и реквизиты пользователя одновременно,
нужно выполнить последовательно 2 перерегистрации в связи с этими причинами, выполняя шаги 1-3.
При этом устанавливаются и сохраняются только те параметры, которые соответствуют причине данной перерегистрации (при условии, что все остальные присутствуют).
h2. Q11_1
h2. *Какую причину перерегистрации выбрать при переключении режима между онлайн и оффлайн?*
h2. A11_1
Правильный подход: при перерегистрации выбрать "смена настроек ккт" "CorrectionReason.ChangeKKTSettings":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html#accde9d8d9055948548d04b24debc5200.
Однако, некоторые ФН не позволяют это сделать, отвечая, например, BadFormat.
В таком случае нужно отменить документ и перерегистрировать с причиной "смена параметров ОФД" "CorrectionReason.ChangeOFD":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html#accde9d8d9055948548d04b24debc5200.
Перед началом перерегистрации необходимо убедиться, что все необходимые параметры(опции) установлены "Q25":http://wiki.multisoft.ru:8881/redmine/projects/mspos-k/wiki/QA#Q25.
h2. Q12
h2. *Как напечатать чек?/ Как сформировать фискальный документ? / Как сформировать нефискальный документ?*
h2. A12
В общем случае печать документа состоит из открытия "OpenRec":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a0652bf6ebf8d2e3147bf45905daa1f1e, наполнения документа и закрытия "CloseRec":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#ad324f3c6dcabcfa6801fc4c166b24244.
Пока документ не закрыт, его можно отменить функцией "RecVoid":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a5654f1a1b77435e97bf8e788df271873
*Если ФН зарегистрирован с несколькими системами налогообложения (СНО),
перед открытием фискального документа с типом Sell/SellRefund/Buy/BuyRefund, либо чека коррекции,
необходимо из зарегистрированных СНО выбрать одну и установить её* функцией "SetTaxationUsing":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#ab2f0202725597f348727647d33eedaf4.
Настраивать СНО не обязательно для каждого документа.
Установленная после соединения с ядром СНО действует до следующей выгрузки ядра из оперативной памяти либо до следующей вызванной "SetTaxationUsing":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#ab2f0202725597f348727647d33eedaf4.
Наполнение *нефискального документа (RecType.Unfiscal)* выполняется командами печати:
"PrintLine":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#afd8854e97d653a91a41735c7750447a9
"PrintLineAligned":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#aeb49685abe791c713497873bd8fbea8a
"PrintQRCode":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a8d298288c9d1497dfee2151155749185
"PrintBarCode":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#ae19113179a5ddc1b386c1a71dc089dca
"SetFont":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a3ec8a35cbbe9f62245e392285087c9e1
"PrintRaster":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#ac36e19f4cc12db659084eb337916f294
Наполнение *фискальных документов с типом Sell/SellRefund/Buy/BuyRefund, а также нефискальных с типом PayIn/PayOut* выполняется по общему алгоритму:
1. Позиции. В случае *PayIn/PayOut* команда также обязательна.
"PrintRecItem":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a33a66c34f73f25247d84a51623516d55 - добавление позиции, можно вызывать сколь угодно много раз.
Только *для Sell/SellRefund/Buy/BuyRefund*:
*Перед "PrintRecItem":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a33a66c34f73f25247d84a51623516d55 необходимо установить налоги* функцией "SetItemTaxes":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#ac3ba54dd76e7efe29870e3117eae41de.
2. Печать итога.
"PrintRecTotal":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#addeeaada4bbd7913f57030efba8662fe - подведение итога. разрешено вызывать не более 1 раза на документ. После итога добавление позиций запрещено, можно вызывать только команды оплаты:
3. Оплата.
"PrintRecItemPay":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a7ca2d5fc505ce74e47ffe6ff77f6ec70 - добавление оплаты, можно вызывать сколь угодно много раз, рекомендуется не более 6 раз на документ (с учётом сдачи).
В некоторых случаях требуется передать телефон или электронный адрес покупателя (тег 1008), об этом в "Q13":http://wiki.multisoft.ru:8881/redmine/projects/mspos-k/wiki/QA/#Q13, "Q14":http://wiki.multisoft.ru:8881/redmine/projects/mspos-k/wiki/QA/#Q14.
Добавление нефискальной информации в фискальный чек допустимо только при следующем условии:
*выводимый на печать текст, штрих-код, QR-код и/или картинка не содержит данных, формат которых похож и/или повторяет формат фискальных данных, печатаемых на чеке.*
При обнаружении нарушений печати нефискальных данных в фискальном чеке приложение удаляется из магазина приложений до устранения нарушений.
h2. Q12_1
h2. *Как сформировать чек коррекции?*
h2. A12_1
*Чек коррекции* отличается от остальных чеков наполнением: оно происходит единственной командой "FNMakeCorrectionRec":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a9bec0b3e80a4299c4e65efc0b553befe, повтор которой недопустим.
Для формирования суммовых налогов в чеке коррекции перед FNMakeCorrectionRec нужно вызвать "SetSumTaxes":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a5d4ba3ce9f1cbeb53f72653642e47908.
*В этом случае параметр taxNum (порядковый номер используемого налога) функции FNMakeCorrectionRec игнорируется*.
Резюмируя: для формирования чека коррекции нужно последовательно и без повторов вызывать:
(если несколько СНО) "SetTaxationUsing":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#ab2f0202725597f348727647d33eedaf4
"OpenRec":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a0652bf6ebf8d2e3147bf45905daa1f1e
(если нужны суммовые налоги)"SetSumTaxes":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a5d4ba3ce9f1cbeb53f72653642e47908
"FNMakeCorrectionRec":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a9bec0b3e80a4299c4e65efc0b553befe
"CloseRec":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#ad324f3c6dcabcfa6801fc4c166b24244
h2. Q13
h2. *Как передать телефон или электронный адрес покупателя (тег 1008)?*
h2. A13
Для передачи этого тега необходимо использовать функцию "SendClientAddress":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a5672fc24a0e68cf06e13a8e73698cb12
Она выполняется один раз на весь документ в любой момент после открытия и до закрытия. %{color:red}Повторная передача ведёт к нарушению ФФД%.
Установка одновременно электронного адреса и телефона покупателя не предусмотрена ФФД 1.05 от 21.03.2017.
Точно так же покупатель не может иметь нескольких телефонов и/или email одновременно.
При использовании SendClientAddress в опциях заранее *должен быть установлен эл. адрес отправителя* "SetSenderEmail":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a47a8880a2cdec8dff31067adc172d161
h2. Q14
h2. *В каком формате передавать телефон или электронный адрес покупателя (тег 1008) в функции "SendClientAddress":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a5672fc24a0e68cf06e13a8e73698cb12 ?*
h2. A14
Телефон или электронный адрес покупатеся следует передавать в соответствии с ФФД 1.05 от 21.03.2017 Таблица 5, тег 1008:
Формат: %{color:red}+{Ц}% или %{color:red}{С}@{C}%,
где Ц - "атрибут, обозначающий, что данные реквизита должны быть представлены в виде цифры",
С- "атрибут, обозначающий, что данные реквизита должны быть представлены в виде символа".
Символы и цифры должны быть представлены в электронной форме %{color:red}"в соответствии с кодовой таблицей CP866"%.
h2. Q15
h2. *Как изменить параметры автоинкассации при закрытии смены?*
h2. A15
Включение или отключение автоинкассации выполняется функцией "SetDayCloseAutoPayOut":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a7412c0fe3ae61fc5a2d54d850e8d0c97
Если необходимо сохранить значение параметра для применения его во всех следующих функциях закрытия смены ("CloseDay":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a45709f692bbe83ec0852e0569b512a01 ),
в т.ч. после перезагрузки, нужно сохранить опции ("SaveOptions":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a8bf297561df86b0c5e62b8b0adcf670e ).
h2. Q16
h2. *Какие типы документа доступны для чека коррекции в аргументе "operation" функции "FNMakeCorrectionRec":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a9bec0b3e80a4299c4e65efc0b553befe ?*
*Почему в чеке коррекции не работает "OperationType.SellRefund":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html#ac61434a729deda0ddd0e8cf6b1bd7123 и "OperationType.BuyRefund":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html#ac61434a729deda0ddd0e8cf6b1bd7123 )?*
h2. A16
В соответствии с ФФД 1.05 от 21.03.2017 Таблица 25 "Реквизит «Признак расчета» (тег 1054) для кассового чека коррекции (БСО коррекции)
может принимать одно из следующих значений: «1» – приход, «3» – расход."
Поэтому чек коррекции на возврат прихода и возват расхода возвращает ошибку.
h2. Q17
h2. *ФН не даёт закрыть архив / зарегистрировали mspos-е-Ф с некорректной датой, и он заблокировался, нет возможности откатить время назад.
Как закрыть ФН аварийно?*
h2. A17
Нужно убедиться, что нет иных способов решить проблему. Часто ФН блокируется, т.к. чеки долго не уходили в ОФД.
Часто причиной могут быть отсутствие связи, отсутствие продлённого договора с ОФД.
Если при регистрации указан ИНН несуществующего ОФД, чеки могут не приниматься, и необходимо аварийное закрытие архива.
*Все операции, связанные с аварийным закрытием необходимо согласовывать с ФНС.
После выполнения шагов данной инструкции старый ФН останется в том же состоянии, что и был*.
Процедура *не закрывает архив в самом ФН*. Она лишь позволяет зарегистрировать ККТ с новым ФН.
Для выполнения аварийного закрытия архива в ККТ необходимо:*
0. выключить ККТ и заменить ФН на незарегистрированный.
1. включить ККТ и открыть mspos-expert. войти в сервисное меню.
2. ввести номер ФН, с которым ККТ была зарегистрирована,
в поле для ввода ЗН ККТ (единственное поле для ввода на сервисной странице).
3. нажать "аварийное закрытие архива", подтвердить выбор. Кнопку "записать ЗН" нажимать ну надо.
h2. Q18
h2. *Как передать признак предмета расчета и признак способа расчета (теги 1212 и 1214)?*
h2. A18
Для передачи свободных тегов используется функция "SetTagAttribute":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a8bce3c5e91220db3f59b0f7491775393 (начиная с 1.8.28).
Её нужно вызывать перед добавлением позиции ("PrintRecItem":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a46ffb2cbf9248c5f138f50a8bef916d9 ), в которой необходимо установить соответствующий тег.
Обращаем внимание на примечания 1 и 2 к таблице 29 ФФД (введены Приказом ФНС России от 09.04.2018 N ММВ-7-20/207@):
1. В случае если в составе кассового чека (БСО) реквизит "предмет расчета" (тег 1059) содержит реквизит "признак предмета расчета" (тег 1212), имеющий значение *"15"*,
то такой кассовый чек (БСО) при передаче в ОФД в электронной форме в реквизите "наименование предмета расчета" (тег 1030)
должен содержать одно из значений *от "1" до "25"*, указанных в таблице 29.1.
2. В случае если в составе кассового чека (БСО) реквизит "предмет расчета" (тег 1059) содержит реквизит "признак предмета расчета" (тег 1212), имеющий значение *"16"*,
то такой кассовый чек (БСО) при передаче в ОФД в электронной форме в реквизите "наименование предмета расчета" (тег 1030)
должен содержать одно из значений *от "26" до "31"*, указанных в таблице 29.1._
В случае передачи в *1212* значений *15* или *16*, в "PrintRecItem":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a46ffb2cbf9248c5f138f50a8bef916d9
в аргумент *itemName* необходимо передавать значение реквизита из таблицы 29.1 ФФД *без дополнительного текста: значения от "1" до "31"*.
Печатная форма формируется ядром.
h2. Q19
h2. *Какие значения передать при установке тегов 1212 и 1214?*
h2. A19
Значения реквизита «признак способа расчета» (тег 1214) в соответствии с ФФД 1.05 от 21.03.2017 Таблица 28:
|1|ПРЕДОПЛАТА 100%|
|2|ПРЕДОПЛАТА|
|3|АВАНС|
|4|ПОЛНЫЙ РАСЧЕТ|
|5|ЧАСТИЧНЫЙ РАСЧЕТ И КРЕДИТ|
|6|ПЕРЕДАЧА В КРЕДИТ|
|7|ОПЛАТА КРЕДИТА|
Значения реквизита «признак предмета расчета» (тег 1212) в соответствии с ФФД 1.05 от 21.03.2017 в ред. Приказа ФНС России от 09.04.2018 Таблица 29:
|1|ТОВАР|
|2|ПОДАКЦИЗНЫЙ ТОВАР|
|3|РАБОТА|
|4|УСЛУГА|
|5|СТАВКА АЗАРТНОЙ ИГРЫ|
|6|ВЫИГРЫШ АЗАРТНОЙ ИГРЫ|
|7|ЛОТЕРЕЙНЫЙ БИЛЕТ|
|8|ВЫИГРЫШ ЛОТЕРЕИ|
|9|ПРЕДОСТАВЛЕНИЕ РИД|
|10|ПЛАТЕЖ|
|11|АГЕНТСКОЕ ВОЗНАГРАЖДЕНИЕ|
|12|СОСТАВНОЙ ПРЕДМЕТ РАСЧЕТА|
|13|ИНОЙ ПРЕДМЕТ РАСЧЕТА|
|14|ИМУЩЕСТВЕННОЕ ПРАВО (с 1.12.37+)|
|15|ВНЕРЕАЛИЗАЦИОННЫЙ ДОХОД (с 1.12.37+)|
|16|СТРАХОВЫЕ ВЗНОСЫ (с 1.12.37+)|
|17|ТОРГОВЫЙ СБОР (с 1.12.37+)|
|18|ТУРИСТИЧЕСКИЙ НАЛОГ (с 1.32.112+)|
|19|ЗАЛОГ (с 1.12.37+)|
h2. Q20
h2. *Как пробить сдачу?*
h2. A20
Сначала пробейте оплату наличными, сумму, которую передал клиент, например, 100р.
<pre><code class="cpp">
IFiscalCore.PrintRecItemPay((int)PayType.Cash, "100.00", "ПРИНЯТО ОТ КЛИЕНТА НАЛИЧНЫМИ:",callback);
</code></pre>
После этого выполните вызов "PrintRecItemPay":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a7ca2d5fc505ce74e47ffe6ff77f6ec70 с параметрами PayType.Cash, в total передайте сумму со знаком "минус".
Например, сдача в 15 рублей 1 копейку оформляется вызовом:
<pre><code class="cpp">
IFiscalCore.PrintRecItemPay((int)PayType.Cash, "-15.01", "СДАЧА:",callback);
</code></pre>
В предыдущих двух командах параметр itemText может быть любым.
В результате после закрытия документ, если "принято" - "сдача" == сумме стоимости всех позиций по документу, на чеке появится 2 последовательные надписи:
"ПРИНЯТО ОТ КЛИЕНТА НАЛИЧНЫМИ: 100.00"
"СДАЧА: 15.01"
и ниже, в соответствии с ФФД:
"НАЛИЧНЫМИ 84.99"
h2. Q21
h2. *Как работать по старому законодательству в режиме ЧПМ ?*
h2. A21
Если клиент по закону имеет право пользоваться ЧПМ, переход в режим ЧПМ осуществляется при соблюдении следующих условий:
1. ККТ не зарегистрирована
2. К ККТ не подключен (зарегистрированный) ФН
3. ПО умеет работать в режиме ЧПМ без обращений к ФН.
4. ПО умеет определять текущий режим работы через вызов функции "DirectIO":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#ad332340d4b162fd5a0fd9a56a364a457
*%{color:red}Внимание!%* Режим работы ККТ, определяемый перечислением "Mode":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html#a6133311b80ad2d8ed53f0a9766094159 *отличается* от режима работы ФН, описанного в "OperatingMode":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html#af79f7ba66a9ad6fe8763a6f58952a5d2
Численные значения перечислений лежат в начале "страницы":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html
Запрос текущего режима работы ККТ (Mode) выполняется следующим образом:
1. Создаётся экземпляр "IAuth":http://doc.multisoft.ru/doc/MSPOS/IAuth.aidl, который реализует все функции интерфейса.
2. Создаётся экземпляр "IExceptionCallback":http://doc.multisoft.ru/doc/MSPOS/IExceptionCallback.aidl по аналогии с любым другим коллбеком об ошибке
3. Выполняется команда DirectIO с параметрами "DirectIOCmd.GetMode":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html#aa03c06b35cfd3f44c06206014cb9d40c,
в качестве второго параметра необходимо передать идентификатор пользовательского ПО, либо package приложения, из которого функция вызывается.
4.1 Если команда выполнена успешно, ядро вызовет auth.Result(currentMode) с параметром currentMode, равном текущему режиму работы ККТ (Mode).
4.2 Пользовательское ПО сохраняет это число и сравнивает с "Mode.OFD":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html#a6133311b80ad2d8ed53f0a9766094159 и "Mode.ENVD":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html#a6133311b80ad2d8ed53f0a9766094159, определяя текущий режим работы.
5.1 Если команда завершилась с ошибкой, коллбек об ошибке передаётся стандартно, через "IExceptionCallback":http://doc.multisoft.ru/doc/MSPOS/IExceptionCallback.aidl
Переход в режим ЧПМ осуществляется через программный вызов DirectIO при выполнении условий 1-3 аналогично запросу текущего режима работы ККТ (Mode).
В качестве первого параметра необходимо использовать константу "DirectIOCmd.ChangeMode":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html#aa03c06b35cfd3f44c06206014cb9d40c
При смене режима в auth.Result возвращается *новый режим работы*. Был режим: "Mode.OFD":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html#a6133311b80ad2d8ed53f0a9766094159. Сменили режим => в auth.Result возвращается "Mode.ENVD":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html#a6133311b80ad2d8ed53f0a9766094159
h2. Q22
h2. *Какие особенности у режима ЧПМ ?*
h2. A22
В режиме ЧПМ все обращения к ФН отключены и будут возвращать "ErrCode.Hardware":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html#af7d268ea5021cfa159aa82b7004da530, "ExtHardwareErr.Nack":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html#a4db5bb9a1e904a00eeee445ac3aa45cc кроме "FNGetNumber":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a8b2c94673f98ad05e485adc28f0bf95d.
Функции, начинающиеся с *FN, OFD, FDI, QueryOFD, OfdOut, QueryFiscal* созданы для работы в режиме ОФД,
обращаются к ФН и будут возвращать указанную выше ошибку в режиме ЧПМ.
В любой момент из режима ЧПМ можно перейти обратно в режим ОФД с потерей всех счётчиков и состояний по вызову команды DirectIO с параметрами для смены режима работы.
Для корректной работы устройства в режиме ЧПМ его необходимо зарегистрировать.
Перед регистрацией необходимо установить и сохранить следующие опции:
"SetOrgName":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#ad771825ea775e76666cc09772279767a
"SetOrgAddress":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#ac6650f56de207c2664b8a16f3b63fd32
Регистрация выполняется стандартной функцией "Register":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a278fd49eca702ca03b239f65f098a245
В качестве параметров необходимо передать: reg_num, равный "00000", а также корректный ИНН и имя кассира. Остальные параметры не влияют на результат выполнения.
h2. Q23
h2. *Как проверить, к какому магазину привязано устройство?*
h2. A23
Откройте App Store или Магазин приложений.
Дождитесь полной загрузки.
Нажмите иконку пользователя справа вверху.
Открывшееся меню прокрутите вниз.
В поле "Service provider" или "поставщик услуг" показывается текущий магазин, к которому привязано устройство. По умолчанию это Multisoft.
h2. Q24
h2. *На устройстве не применяются настройки магазина, что делать?*
h2. A24
Проверьте "A23":http://wiki.multisoft.ru:8881/redmine/projects/mspos-k/wiki/QA#A23 ^. Если наименование магазина соответствует ожидаемому, убедитесь, что устройство подключено по Wifi к интернет,
и выполните перезагрузку. Допускается подключение через сеть sim-карты с доступом в интернет, но предпочтительнее пользоваться Wifi.
Если перезагрузка не помогла, зайдите в *POS Steward -> network -> network test -> start testing*.
Тест пройден успешно, если все три галочки - зелёные.
Если хотя бы одна из них красная, рекомендуется подключиться к другой Wifi сети, где тест пройдёт успешно,
т.к. корректное применение всех параметров магазина гарантируется только при полностью исправном соединении с интернет.
h2. Q25
h2. *Как работать с признаком агента? Что делать, если пользователь - агент/поверенный/комиссионер?*
h2. A25
Если пользователь - агент/поверенный/комиссионер, соответствующий признак агента указывается в параметрах "регистрации":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a278fd49eca702ca03b239f65f098a245.
После регистрации можно установить *текущий признак агента* функцией "SetAgentTagUsing":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a7f0d91ebd3472d213e6be47e4afda0c2 (аналогично установке СНО, выполняется *перед открытием чека*).
Установка признака агента может быть нужна в случае, если необходимо сформировать документ с одним(несколькими) из зарегистрированных признаков агента, к примеру:
при регистрации указан *PayAgent* и *BankPaySubAgent*, а предмет расчёта в чеке относится только к *PayAgent*).
*Текущий признак агента* распространяется на все предметы расчёта (товары, услуги, ...) в чеке.
*По умолчанию* текущий признак агента равен указанному при регистрации.
Запросить признак агента в ФН (указывается при регистрации) можно функцией "GetAgentTag":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a5e918f55014acc144ed14fa618e6ffab
В зависимости от выбранного *текущего признака агента* в чеке должны быть установлены следующие параметры:
если пользователь - платёжный агент или платёжный субагент (установлены биты "AgentTag.PayAgent":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html#a2116155dfaf66d98ad57fa6e59e4550b и/или "AgentTag.PaySubAgent":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html#a2116155dfaf66d98ad57fa6e59e4550b)
"SetCommissionAgentTelNum":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a537b038aab4c42ed63107e96cd423321
"SetPaymentAgentTelNum":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#ad9db608d873cd7e60e936ae9fd552e2c
"SetContractorTelNum":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#ab93c7d4caebe3cccbe37cafe525d1dad
если пользователь - банковский платёжный агент или банковский платёжный субагент (установлены биты "AgentTag.BankPayAgent":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html#a2116155dfaf66d98ad57fa6e59e4550b и/или "AgentTag.BankPaySubAgent":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html#a2116155dfaf66d98ad57fa6e59e4550b)
"SetTransferOperatorName":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#abc45417de2caada0426148d08c2f01ab
"SetTransferOperatorTaxId":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a40533b38d11cf5703856b46cd68408a3
"SetTransferOperatorTelNum":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a47846d05cebe797b4c5ee59c097eb2fa
"SetTransferOperatorAddress":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a70a8d8ed1e4f1b1b49f6b21860f4d3df
"SetPaymentAgentOperation":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#ad489cb74534c3c0091eac73f8312c7a2
"SetPaymentAgentTelNum":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#ad9db608d873cd7e60e936ae9fd552e2c
"SetContractorTelNum":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#ab93c7d4caebe3cccbe37cafe525d1dad
если пользователь - поверенный, комиссионер и/или иной агент (установлен любой из бит "AgentTag.Attorney":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html#a2116155dfaf66d98ad57fa6e59e4550b, "AgentTag.CommissionAgent":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html#a2116155dfaf66d98ad57fa6e59e4550b, "AgentTag.Agent":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html#a2116155dfaf66d98ad57fa6e59e4550b
"SetContractorTelNum":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#ab93c7d4caebe3cccbe37cafe525d1dad
В предмете расчёта можно устанавливать признак агента по предмету расчёта функцией "SetTagAttribute":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a8bce3c5e91220db3f59b0f7491775393.
*Текущий признак агента (current)* добавляется в чек, если он отличен от 0.
При этом предмет расчёта может содержать *признак агента по предмету расчёта*.
Его значение должно быть подмножеством значений текущего признака агента в чеке (current), иначе ФЯ возвращает ошибку "неверный параметр".
Добавление признака агента по предмету расчёта и прочих реквизитов агента в предмет расчёта осуществляется вызовом функции "SetTagAttribute":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a8bce3c5e91220db3f59b0f7491775393 до добавления позиции, в которой данный признак необходимо установить.
*В документ* теги, относящиеся к признаку агента (далее - теги агента), добавляются при выполнении следующих условий:
текущий признак агента требует того по ФФД *И* значение тега не пустое.
Значения тегов агента для *документа* устанавливаются в ФЯ через функции из блока "Установка дополнительных настроек".
Пример: теги X, Y и Z установлены в непустое ненулевое значение, признак агента требует установки X, Y и K, который null.
В этом случае *в документ* будут переданы теги X и Y.
*В предмет расчёта* теги, относящиеся к признаку агента (далее - теги агента), добавляются при выполнении следующих условий:
тег был передан в SetTagAttribute, *И* значение тега не пустое.
Пример: теги X, Y и Z установлены в непустое ненулевое значение через SetTagAttribute, признак агента по предмету расчёта требует установки X, Y и K, который null.
В этом случае *в предмет расчёта* будут переданы теги X, Y и Z.
h2. Q26
h2. *Когда необходимо менять ФН?*
h2. A26
Самый действенный способ - периодически проверять "FNGetWarningFlags":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a0edf8ac570a448c11ccf95d6ec6632a4
Если "WarningFlag":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html#ad042cfb3dda00bd78f8a393ef16133b9 содержит *FNMemoryOverflow* или *UrgentCSReplace* -> пора менять.
Если в ответе на фискальную операцию (открытие/закрытие смены/документа) в "коллбеке об ошибке":http://doc.multisoft.ru/doc/MSPOS/IExceptionCallback.aidl возвращается "ErrCode.Hardware и ExtHardwareErr.Fatal":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html#af7d268ea5021cfa159aa82b7004da530,
а также установлены эти флаги -> пора менять уже прямо сейчас.
h2. Q27
h2. *Как менять ФН?*
h2. A27
1. Закрыть смену, если была открыта
2. Если ккт находится в неавтономном режиме, нужно дождаться отправки всех документов в ОФД ("OFDGetQueuedMessagesCount":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a8043b80c203d843f72cf4f29deef2050 равно нулю)
и состояние ФН ("FNGetState":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#acccf308edeb4fe120f682cbc3a4b739c) равно "FNArchiveRead":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html#a48a9c84bbd4107e159399f00ad85fa78
3. Закрыть архив ФН "CloseFiscalMode":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#af416b8ca943c669a630763d66edfa085
4. Если ккт в неавтономном режиме - дождаться отправки отчёта о закрытии архива в ОФД (аналогично п.2)
5. Вставить новый ФН.
6. Выполнить перерегистрацию "CorrectRegistration":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a24fb9f4f043bd3ec5fed05cb9213db42 в связи с заменой ФН
h2. Q28
h2. *Где посмотреть логи MSPOS-Expert? как выгрузить логи?*
h2. A28
Откройте MSPOS-Expert, перейдите в раздел "Статус", вкладка "Статус", кнопка "Выгрузка лога".
Если выпадет диалог с запросом разрешений, подтвердите их.
После этого логи появятся в корне карты памяти в папке "mspos"
Далее их можно будет выгрузить, подключив устройство к ПК, либо по teamviewer (более быстрый способ).
Начиная с 1.15.41 логи хранятся по пути */sdcard/Android/data/com.multisoft.drivers.fiscalcore* в 2 файлах: архиве и текущем логе.
Текущий лог - текстовый файл, используемый ФЯ в процессе работы для записи.
Архив - файл с расширением .zip.txt (для возможности выгрузки через ЛК sunmi),
содержит все логи с момента последней очистки, включая логи с предыдущей версии mspos-expert, хранящиеся во внутренней памяти.
Архивация текстовых файлов с логами выполняется при каждом старте ФЯ и закрытии смены.
После архивации запускается механизм ротации.
Алгоритм работы ротации:
если суммарный размер архива превышает 200 МБ и количество файлов в архива больше 2,
наиболее ранние логи удаляются, пока выполняется условие выше.
После выгрузки файла архива его необходимо переименовать, удалив расширение .txt в конце.
После этого его можно будет разархивировать и просматривать файлы с логами.
Также можно *выгрузить логи на сервер*. См. "Q54":http://wiki.multisoft.ru:8881/redmine/projects/mspos-k/wiki/QA#Q54
h2. Q29
h2. *Как происходил переход на НДС 20% в 2019 году?*
h2. A29
*Неактуально*
h2. Q30
h2. *Как выполнить возврат с НДС 18% в 2019 году?*
h2. A30
*Неактуально*
h2. Q31
h2. *При закрытии чека (CloseRec) получаем ошибку errCode 1 (ErrCode.WrongArgument), extErrCode 9, message "Некорректное значение параметров команды ФН", хотя параметры заведомо корректные. В логах BadArgument. Что делать?*
h2. A31
Согласно документации на ФН, так он сигнализирует о переполнении итогов смены. Необходимо аннулировать чек и закрыть смену.
Также имеется информация, что *ФН на 36 месяцев под СНО, рассчитанный на работу только под услуги*, отвечает *BadArgument*, если в *1212 указвыается 1 (товар)*.
h2. Q32
h2. *Как программно посмотреть системную информацию об устройстве (номер сборки, firmware version и т.д.)?*
h2. A32
Программный доступ к системной информации на сайте "SUNMI Developers":https://docs.sunmi.com/en/docking-debugging/special-codes-descriptio
h2. Q32_1
h2. *Где найти документацию ко встроенному сканеру?*
h2. A32_1
Документация к встроенному сканеру лежит "здесь":https://docs.sunmi.com/en/general-function-modules/camera-code-scanning/
h2. Q32_2
h2. *Как открыть страницу определённого приложения в App Store (магазине приложений) программно?*
h2. A32_2
Программно "открыть App store со страницей определённого приложения":https://docs.sunmi.com/en/appstore/how-does-the-app-call-the-score-box/, "ещё ссылка":https://docs.sunmi.com/en/docking-debugging/jump-to-the-app-store-app-details/.
h2. Q32_3
h2. *Где найти API для пользовательских действий по кнопкам громкости?*
h2. A32_3
Настройка "пользовательских действий по нажатию на кнопки громкости":https://docs.sunmi.com/en/others/volume-keys-custom/.
h2. Q33
h2. *Как открыть денежный ящик на MSPOS-Т-Ф?*
h2. A33
Воспользуйтесь функцией aidl "OpenDrawer":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a887ea971d2ec2b4940bea20b835be60a (добавлена в 1.13.39)
h2. Q34
h2. *Какая распиновка разъёма денежного ящика на MSPOS-Т-Ф? Куда подключать считыватель карт в MSPOS-Т-Ф ?*
h2. A34
Ответы на эти вопросы, а также полный перечень разъёмов доступны по "ссылке":https://docs.sunmi.com/en/general-function-modules/external-usb-serial-devices/ или "ещё":https://docs.sunmi.com/en/others/usb-device/
h2. Q35
h2. *Какие собенности при подключении тестового ФН (МГМ) ?*
h2. A35
1. МГМ может быть использован только в целях разработки и тестирования
2. МГМ можно сбросить в состояние по умолчанию (готов к регистрации). "FNResetDebug":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#ac536e2612558d0f8c4b7f871b1a82a4e в AIDL.
3. ККТ с МГМ регистрируется только в тестовом контуре ОФД. Информацию по подключению к тестовому контуру нужно уточнять у ОФД, к которому Вы собираетесь подключиться.
h2. Q36
h2. *Переданный в аргументе функции "SetTagAttribute":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a8bce3c5e91220db3f59b0f7491775393 код товара отображается в ОФД некорректно или указан как имеющий невалидный формат. Что делать?
Как передать код товара (КТ, КТН) 1162 в виде массива байтов ?
В каком формате нужно кодировать символы для передачи 1162 через "SetTagByteAttribute":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a5d4da6d198bfd0c9f42a4872775225bb ?*
h2. A36
Некоторые ОФД придумали собственный способ кодирования 1162.
По многочисленным запросам для поддержки передачи кода товара в виде массива байт в 1.14.40 была добавлена функция "SetTagByteAttribute":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a5d4da6d198bfd0c9f42a4872775225bb
*+Вопросы, связанные с форматом/представлением/кодированием данных тега 1162 при передаче в виде массива байт, следует адресовать технической поддержке конкретного ОФД.+*
*UPD: 05.06.2019*
Cтало известно, что некоторые из операторов фискальных данных перестали считать собственные алгоритмы кодирования 1162, противоречащие ФФД, единственно верными.
В личном кабинете ОФД данные тега 1162, переданные через "SetTagAttribute":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a8bce3c5e91220db3f59b0f7491775393 *отображаются как валидные в бинарном виде*, хотя и искажены при представлении в виде строки.
h2. Q37
h2. *Как работать с подакцизными товарами (признак торговли подакцизными товарами) 1207?*
h2. A37
Установите "Tag.ExceiseTag":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html#aad4c955ae1340f0cb8b7d00b2260d43aa3b778def2fdb07151fb33551bfe83e03 функцией "SetTagAttribute":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a8bce3c5e91220db3f59b0f7491775393 до вызова функции (пере)регистрации.
Это нужно, чтобы в последствии можно было передавать 1212 со значением 2.
h2. Q38
h2. *Как быстро применяются настройки в Личном кабинете (ЛК)? Как ускорить применение настроек ТК после изменения?*
h2. A38
Настройки, установленные в ЛК SUNMI влияют только на устройства, привязанные к этому аккаунту.
Настройки магазина прилетают на устройство в течение нескольких минут при наличии стабильного интернет-соединения.
Если устройство в момент изменения настроек было не подключено к сети интерент или выключено, настройки применятся при следующем подключении к интернет.
Для ускорения применения настроек на устройстве необходимо:
0. Обеспечить стабильное подключение к интернет
1. Если приложение "Магазин приложений" было открыто ранее, смахнуть его из списка недавних приложений.
2. Зайти в "Магазин приложений" на устройстве
3. Дождаться полной загрузки магазина. В этот момент настройки применены.
Если устройство было подключено к ПК, настройки adb применятся при следующем подключении к ПК.
4. Если настройки не применены, нужно проверить, к какому магазину привязано устройство (см. "Q23":http://wiki.multisoft.ru:8881/redmine/projects/mspos-k/wiki/QA/#Q23)
5. Если название магазина совпадает с названием ТК, перезагрузите устройство и повторите пп. 1-4, иначе настройки устройства поменять нельзя.
h2. Q39
h2. *Надпись "ККТ блокирована" на автотесте. Что делать?*
h2. A39
Список ошибок на автотестировании, которые блокируют ККТ:
* ККТ зарегистрирована, ФН не подключен (GetFiscalMemoryFiscalized возвращает true, FnGetNumber возвращает NACK).
Необходимо установить корректный ФН.
* ФН зарегистрирован с другой ККТ (ФН зарегистрирован, ККТ - нет и наоборот. ErrCode.Hardware, ExtHardwareErr.Fatal)
Необходимо установить корректный ФН.
* Фискальная плата клонирована (ЗН не установлен, на запрос GetSerial возвращает "XXXXXXXXXXXX").
Необходимо установить ЗН, с которым ККТ была зарегистрирована. ЗН должен долен совпадать с тем, что в паспорте.
* ККТ зарегистрирована с другим ФН (номер ФН не совпадает. ErrCode.Hardware, ExtHardwareErr.Fatal).
Необходимо установить корректный ФН.
h2. Q40
h2. *Когда коллбек об ошибке печати может не возвращаться? Что делать, если закончилась бумага посередине чека?*
h2. A40
Для фискальных документов коллбек об ошибке печати *не вызывается* в следующем случае:
Документ *отправлен в ФН, и датчик бумаги сработал после этого* во время печати ФП и ФД, а в случае кассового чека - ещё и QR.
Это особенность реализации, которая продиктована работой ФН: ФП и ФД возвращаются после передачи документа в ФН.
Если ленты хватило на печать документа, но не хватило на печать QR, коллбека об ошибке печати не будет.
В этом случае ПО верхнего уровня не уведомляется об ошибках печати чека, чтобы избежать дублирования чека в ФН.
Если бумага закончилась посередине чека, когда чек ещё не ушёл в ФН, ФЯ вызовет коллбек об ошибке.
Рекомендуем уведомить пользователя в UI об отсутствии бумаги и предложить сформировать документ заново.
Перед повторным формированием документа необходимо отменить текущий открытый документ.
h2. Q41
h2. *При печати строки накладываются одна на другую. Что делать?*
h2. A41
Зайдите в "Обновление системы" или "Обновление" на домашнем экране устройства. Если есть обновления, установите их.
Если проблема не решилась или обновлений нет, воспользуйтесь "A42":http://wiki.multisoft.ru:8881/redmine/projects/mspos-k/wiki/QA#A42.
h2. Q42
h2. *У нас новая ошибка, которой нет в этом QA. Что делать?*
h2. A42
Сообщите максимум информации об устройстве:
* SN (на первой странице mspos-expert, либо в настройки -> о телефоне -> общая информация)
* версию ОС (настройки -> о телефоне -> номер сборки)
* версию PrinterService либо SunmiPrinterService либо InnerPrinter (в разных версиях ОС приложение называется по-разному).
Посмотреть версию можно зайдя в настройки -> приложения -> справа сверху меню -> показать системные процессы. После этого сервис печати появится в списке
* версию mspos-expert (на первой странице приложения либо в настройки -> приложения -> mspos-expert).
* по возможности, логи mspos-expert
* если речь про терминал с эквайрингом, также сообщить версию платёжного сервиса SunmiPayHardwareService.
h2. Q43
h2. *Куда пропали с чека реквизиты: номер ФД, номер чека\смены и адрес сайта ФНС?*
h2. A43
* Номер ФД находится под QR-кодом;
* Номер чека\смены не имеет печатной формы {{collapse(Выдержка из приказа)
!ffd12_1038_1042.png!
}}
* Адрес сайта ФНС можно не выводить на печать в случае, если он был передан при регистрации.
h2. Q44
h2. *Как пробить чек с маркировкой?*
h2. A44
1. Проверка КМ в ФН: SendMarkupCodeFnCheck;
2. Проверка КМ в ОИСМ: SendMarkupCodeOismCheck;
3. Получение результата проверки в ОИСМ: GetMarkupCodeOismResult;
4. Сохранение результатов проверки: SaveMarkupCodeCheckResult(true);
5. Открыть чек: OpenRec;
6. Передать КМ (тег 1163) с помощью SetTagAttribute(КМ должен быть идентичен отправленному в SendMarkupCodeFnCheck);
7. Пробить позицию PrintRecItem;
...
8. Закрыть чек: CloseRec.
Обращаем внимание, что вызов SendMarkupCodeOismCheck после SendMarkupCodeFnCheck является обязательным вне зависимости от условий оперирования ККТ.
Для получения *[M+]* в чеке необходимо, чтобы проверка КМ прошла успешно как в ФН, так и в ОИСМ.
h2. Q45
h2. *В каком виде передавать КМ в ФЯ?*
h2. A45
Следует передавать КМ в том виде, в котором он пришёл со сканера, без символа FNC1 в начале, если он присутствует. Сканер должен поддерживать символ разделителя GS(0x1D) для GS1 кодов и его также нужно передавать внутри КМ БЕЗ дополнительного экранирования.
{{collapse(Например)
!MC_example.png!
}}
h2. Q46
h2. *Что передавать в параметрах команды SendMarkupCodeFnCheck?*
h2. A46
У команды есть два варианта работы:
1. Указать тип(тег 2100) 0 - тогда ФЯ использует встроенный парсер, который пытается на основе предоставленного КМ сам определить, тип и смещения, если они требуются.
2. Указать тип отличный от 0, - ФЯ использует данные которые получит через параметры команды. Т.е. для типа 2 и 4 (gs1m с длиной кода проверки в 44(с верным crc32) и 88 символов) необходимо передать смещения.
Парсер внутри ФЯ должен поддерживать все типы КМ и первый вариант команды является самодостаточным. Но, если необходимо самостоятельно определять тип и смещения, то можно использовать второй вариант.
h2. Q47
h2. *Как использовать ClearAllMarkupCodeCheckResult? *
h2. A47
Команда ClearAllMarkupCodeCheckResult очищает список уже сохранённых КМ (до 128) и начинает новую сессию проверки КМ.
Согласно протоколу ККТ-ФН, отмена чека не удаляет уже сохранённые результаты проверки КМ, т.е. их не нужно проверять заново, если в чеке после отмены пробиваются товары с тем же КМ. Однако, для полной отмены чека с маркированными товарами (допустим, покупатель отказался от товара и ушёл) необходимо после отмены чека также вызвать команду ClearAllMarkupCodeCheckResult.
Команду ClearAllMarkupCodeCheckResult нельзя вызвать при открытом чеке.
h2. Q48
h2. *Как проверить и сохранить КМ?*
h2. A48
1. Проверить КМ в ФН: SendMarkupCodeFnCheck;
2. Проверить КМ в ОИСМ: SendMarkupCodeOismCheck;
3. Получить результаты проверки в ОИСМ: GetMarkupCodeOismResult;
4. Сохранить результаты проверки: SaveMarkupCodeCheckResult(true);
Сохранённым КМ считается только после вызова SaveMarkupCodeCheckResult(true).
h2. Q49
h2. *Как исключить товар из уведомления с проверенным, но НЕ сохранённым КМ?*
h2. A49
Товар c КМ, который НЕ был передан с помощью SetTagAttribute и PrintRecItem НЕ будет включён ни в чек, ни в уведомление, даже если не было вызова SaveMarkupCodeCheckResult(false).
Важно, что товар с КМ, который был передан с помощью SetTagAttribute и PrintRecItem будет включён в чек, но НЕ будет включён в уведомление, даже если не было вызова SaveMarkupCodeCheckResult(false).
Отменять чек, если он открыт, и вызывать ClearAllMarkupCodeCheckResult также является рабочим вариантом, но потребуется повторная проверка всех ранее сохранённых КМ.
h2. Q50
h2. *Как исключить товар из уведомления с проверенным и сохранённым КМ?*
h2. A50
Товар с КМ, который НЕ был передан с помощью SetTagAttribute и PrintRecItem НЕ будет включён ни в чек, ни в уведомление.
Делать повторную проверку КМ и вызывать SaveMarkupCodeCheckResult(false) в таком случае не нужно.
Отменять чек, если он открыт, и вызывать ClearAllMarkupCodeCheckResult также является рабочим вариантом, но потребуется повторная проверка всех ранее сохранённых КМ.
h2. Q51
h2. *Можно ли повторно проверить КМ в ФН и ОИСМ внутри той же сессии?*
h2. A51
Да, можно, если это сделать ДО пробития позиции через PrintRecItem. В случае повторного вызова SaveMarkupCodeCheckResult(true) с новыми данными при добавлении в уведомление и чек будут использованы данные последней проверки.
h2. Q52
h2. *Как получить возможность пробивать чек с маркировкой по ФФД 1.2?*
h2. A52
Для пробития чеков с маркировкой по ФФД 1.2 следует зарегистрироваться по ФФД 1.2 с признаком продажи маркированных товаров.
# Проверить что ФН поддерживает 1.2 командой "FNGetFnFfdVersion":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a04be93cf644895ecc725282713d17308, должен быть ответ "4, ФФД 1.2":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html#adf30cb237f81266d7015257e16797daf ;
# Проверить что ККТ поддерживает 1.2 командой "GetKktFfdVersion":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a68dc1ba905fa8ce57ec4535517d55193, должен быть ответ "4, ФФД 1.2":http://doc.multisoft.ru/doc/MSPOS/html/a00023.html#adf30cb237f81266d7015257e16797daf ;
# Зарегистрировать (или перерегистрировать) ККТ под ФФД 1.2 командой "Register1_2":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#a16730f50a154033496155ddd9db31a54 \ "CorrectRegistration1_2":http://doc.multisoft.ru/doc/MSPOS/html/a00037.html#ab7c59fdbd630c35944fa07e38d5292cc с признаком продажи маркированных товаров (marking = true).
Далее можно открыть смену и пробить чек с маркированным товаром "Q44":http://wiki.multisoft.ru:8881/redmine/projects/mspos-k/wiki/QA#Q44.
h2. Q53
h2. *Как подключиться к ФЯ на Android 12?*
h2. A53
Для того, чтобы приложение увидело ФЯ в manifest надо добавить:
<pre><code class="cpp">
<queries>
<package android:name="com.multisoft.drivers.fiscalcore"/>
</queries>
</code></pre>
И перед bindService:
<pre><code class="cpp">
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O)
{
startForegroundService(intent);
}
else
{
startService(intent);
}
</code></pre>
Примеры работы с ФЯ: "Visual Studio":http://doc.multisoft.ru/doc/MSPOS/Examples/ExampleVisualStudio19.zip и "Android Studio":http://doc.multisoft.ru/doc/MSPOS/Examples/ExampleAndroidStudio.zip.
h2. Q54
h2. *Как выгрузить логи на сервер?*
h2. A54
В приложении Mspos Expert во вкладке "Статус", раздел "Статус" нажать на кнопку "Выгрузить логи на сервер" и подтвердить действие. Передать в multisoft информацию о том, что логи были выгружены, SN устройства, дату и время возникновения ошибки и описание возникшей проблемы.
--------------------------------------------------------------------------------------------------------------
Ресурсы: