Проект

Общее

Профиль

QA » История » Версия 131

as multisoft, 05.03.2019 12:03

1 1 as multisoft
h1. QA Вопросы и ответы
2 1 as multisoft
3 78 as multisoft
h2. Ссылки на документацию: "aidl":http://doc.multisoft.ru/doc/MSPOS/, "примеры":http://doc.multisoft.ru/doc/MSPOS/Examples/, "описания функций":http://doc.multisoft.ru/doc/MSPOS/html/
4 43 as multisoft
5 43 as multisoft
h2. Перед началом работы: какие модели поддерживаются?
6 43 as multisoft
7 43 as multisoft
В настоящий момент Фискальное ядро установлено на следующие модели ККТ: *MSPOS-K, MSPOS-T-Ф, MSPOS-Е-Ф*.
8 43 as multisoft
Им соответствуют строковые константы моделей (Build.MODEL) устройств:
9 43 as multisoft
* MSPOS-K: "V1S-G", "V1S", "V2"
10 43 as multisoft
* MSPOS-T-Ф: "T1MINI-G", "T1MINI"
11 43 as multisoft
* MSPOS-Е-Ф: "P1_4G", "P1_4G-G", "P1_4G-EU"
12 43 as multisoft
13 43 as multisoft
14 29 as multisoft
h2. Q0:
15 29 as multisoft
16 32 as multisoft
h2. *Любые обращения по поводу конерктного устройства/ККТ. Вопросы по переводу устройств между ТК и ОК, а также между субаккаунтами внутри ТК и ОК.*
17 29 as multisoft
18 29 as multisoft
h2. A0:
19 29 as multisoft
20 129 as multisoft
При обращении по любым вопросам, которые касаются конкретного устройства, в чаты ТП и разработки
21 29 as multisoft
нужно указывать *SN* устройства (см. наклейку со штрих-кодами на обратной стороне аппарата).
22 30 as multisoft
Если вопрос связан с переводом устройства в тестовый контур или обратно в основной,
23 1 as multisoft
*нужно прикладывать фото задней части устройства либо скриншот первой страницы mspos-expert %{color:red}с читаемым SN%*.
24 33 as multisoft
Перенос устройств между ТК и ОК, а также между их субаккаунтами осуществляется только после подтверждения права собственности на устройство.
25 1 as multisoft
26 129 as multisoft
%{color:red}Переводы клиентского оборудования из *кастомного магазина в основной* делаются *по заявке с подписью ответственного лица и печатью организации*%.
27 47 as multisoft
Заявки на перевод принимаются *только от той организации, к кастомному магазину которой устройство было привязано при отгрузке*.
28 46 as multisoft
29 129 as multisoft
Перенос устройств между ТК и ОК после *13-00 МСК* выполняется с большой вероятностью только *на следующий день*.
30 64 as multisoft
31 42 as multisoft
h2. {{collapse(где найти SN)
32 30 as multisoft
!1.png!
33 30 as multisoft
}} 
34 30 as multisoft
35 129 as multisoft
Фото не обязательно, если девайс уже привязан к Вашему личному кабинету. Предоставление фото позволяет избежать ошибок при переводе.
36 30 as multisoft
37 30 as multisoft
{{collapse(Так делать не надо)
38 30 as multisoft
!2.png!
39 34 as multisoft
}}
40 29 as multisoft
41 2 as multisoft
h2. Q1:
42 1 as multisoft
43 2 as multisoft
h2. *Как добавить IFiscalCore.aidl в Android Studio?*
44 2 as multisoft
45 2 as multisoft
h2. A1:
46 2 as multisoft
47 129 as multisoft
0. Скачать IFiscalCore.aidl, IAuth.aidl, IExceptionCallback.aidl с "сервера":http://doc.multisoft.ru/doc/MSPOS/
48 1 as multisoft
1. В корневой папке проекта создать папку aidl
49 1 as multisoft
2. Внутри папки aidl создать папку с именем, соответствуюим package (com.multisoft.drivers.fiscalcore).
50 1 as multisoft
3. Правый клик по папке с именем package -> New -> AIDL -> AIDL File
51 1 as multisoft
4. Во всплывающем окне ввести имя интерфейса (например, IFiscalCore). Подтвердить выбор.
52 1 as multisoft
5. Скопировать содержимое скачанного файла в текстовом виде в созданный без(!) замены файлов.
53 1 as multisoft
6. Повторить операции 3-5 для IAuth.aidl и IExceptionCallback.aidl
54 1 as multisoft
55 2 as multisoft
h2. Q2:
56 1 as multisoft
57 2 as multisoft
h2. *У меня ошибка вида %{color:red}Execution failed for task ':app:compileDebugAidl'%. Либо %{color:red}*.aidl:1: syntax error don't know what to do with "?"%*
58 2 as multisoft
59 2 as multisoft
h2. A2:
60 2 as multisoft
61 129 as multisoft
Вероятно файлы содержат "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.
62 60 as multisoft
Выполните инструкции, описанные в "Q1":http://77.243.109.96:8881/redmine/projects/mspos-k/wiki/QA#Q1.
63 1 as multisoft
64 2 as multisoft
h2. Q3:
65 1 as multisoft
66 2 as multisoft
h2. *Как зарегистрироваться в программе Sunmi Partners?*
67 2 as multisoft
68 2 as multisoft
h2. A3:
69 2 as multisoft
70 129 as multisoft
После подписания партнёрского соглашения на указанную в нём почту придёт приглашение на регистрацию в "Sunmi Partners":https://partner.sunmi.com/login. Регистрироваться без инвайта не нужно.
71 56 as multisoft
Откройте присланную ссылку с персонального компьютера (ПК) в "Google Chrome":https://www.google.ru/chrome/browser/desktop/index.html. Рекомендуется использовать его и в дальнейшем для любых действий в "личном кабинете (ЛК)":https://partner.sunmi.com/login.
72 1 as multisoft
Первая загрузка сайта может занять некоторое время, подождите полной загрузки и не обновляйте страницу, пока она не будет полностью загружена.
73 1 as multisoft
Если страница загрузилась, но открывается пустой список для выбора страны и/или кода телефона - очистите кеш браузера и обновите страницу.
74 1 as multisoft
Не обновляйте страницу повторно, пока она не загрузится полностью.
75 1 as multisoft
76 129 as multisoft
Следуйте шагам реристрации. *Оформлять смс подтверждение не нужно*.
77 57 as multisoft
По окончании дождитесь верификации аккаута. Она выполняется автоматически в течение 1 рабочего дня.
78 57 as multisoft
В процессе регистрации будет предложено загрузить Company Registration Certification. Подробнее в "Q5":http://77.243.109.96:8881/redmine/projects/mspos-k/wiki/QA#Q5.
79 88 as multisoft
*После регистрации и успешной верификации нужно добавить фискальное ядро в свой магазин.
80 96 as multisoft
Для этого выполните пункты "A3_1":http://77.243.109.96:8881/redmine/projects/mspos-k/wiki/QA#A3_1*
81 88 as multisoft
82 129 as multisoft
При настройке личного кабинета (ЛК) разработчика установите триггеры в соответствии с картинкой. 
83 97 as multisoft
Debugger access control рекомендуется установить в положение "выкл", иначе придётся периодически вводить в устройство временный пароль,
84 1 as multisoft
который присылается на почту, указанную в ЛК в Development -> Debugger.
85 1 as multisoft
*Не включайте Google Play. В основном контуре Google Play выключен* в целях безопасности.
86 100 as multisoft
87 129 as multisoft
h3. {{collapse(Настройки ТК)
88 100 as multisoft
!tk_setttings1.png!
89 100 as multisoft
}} 
90 97 as multisoft
91 93 as multisoft
h2. Q3_1:
92 88 as multisoft
93 104 as multisoft
h2. На устройстве нет MSPOS-Expert. Что делать?
94 104 as multisoft
 На устройстве нет прилоения <notextile>%</notextile>AppName<notextile>%</notextile>. Как его добавить?
95 88 as multisoft
96 94 as multisoft
h2. A3_1:
97 88 as multisoft
  
98 129 as multisoft
Зайдите в "личный кабинет":https://partner.sunmi.com/login на вкладку *App Store -> App List*,
99 105 as multisoft
найдите *MSPOS-Expert* (или <notextile>%</notextile>AppName<notextile>%</notextile>) справа в *"No apps added"*, выделите его галку и нажмите кнопку *"Added apps"*.
100 1 as multisoft
После этого приложение появится в *"Apps Selected"*.
101 103 as multisoft
Если приложения нет в списке справа, проверьте список слева.
102 103 as multisoft
Для добавления приложения, отсутствующего в обоих списках напишите разработчикам этого приложения.
103 51 as multisoft
Также рекомендуем добавить *TeamViewerQS* и *TeamViewerQS —APPX*.
104 37 as multisoft
В дальнейшем *не удаляйте MSPOS-Expert из магазина*.
105 36 as multisoft
106 129 as multisoft
h3. {{collapse(Как добавить приложение в ЛК разработчика)
107 101 as multisoft
!add_mspos.png!
108 105 as multisoft
}}
109 101 as multisoft
110 2 as multisoft
h2. Q4:
111 1 as multisoft
112 2 as multisoft
h2. *Как подготовить устройство MSPOS-K к отладке?*
113 2 as multisoft
114 2 as multisoft
h2. A4:
115 2 as multisoft
116 127 as multisoft
В тестовом контуре возможность отладки автоматически включена для всех устройств, привязанных к тестовому аккаунту.
117 53 as multisoft
На своём устройстве *в "Настройки"->"Безопасность" разрешите установку приложений из неизвестных источников*.
118 1 as multisoft
119 127 as multisoft
Сообщите серийный номер устройств(а) (SN) сотрудникам Multisoft/Альфа-Проект, которые занимаются интеграцией.
120 1 as multisoft
Они привяжут его к вашему аккаунту по завершении регистрации в Sunmi Partners.
121 7 as multisoft
122 127 as multisoft
Для упрощения *разработки в ТК* в Вашем "личном кабинете":https://partner.sunmi.com/login *device configuration* -> *common* -> *debugger access control* должен быть *выключен*.
123 7 as multisoft
В этом случае способ, описанный "здесь":https://docs.sunmi.com/htmls/index.html?lang=en##Debug%20device , не имеет смысла и его не нужно использовать.
124 7 as multisoft
125 127 as multisoft
Подключите устройство к сети WiFi с открытым доступом и интернет.
126 1 as multisoft
Подключите включенное устройство по USB к компьютеру с установленным Android SDK.
127 7 as multisoft
Дождитесь установки драйверов (если используется Windows) и появления уведомления "Отладка по USB разрешена" на устройстве
128 52 as multisoft
В *%AndroidSDKInstallDir%\android-sdk\platform-tools\* выполните *"adb devices"* из консоли,
129 7 as multisoft
на экран должны будут выведены серийный номер аппарата и *device*, что означает, устройство готово к отладке.
130 52 as multisoft
Если эта команда показывает *"unauthorized"*, проверьте подключение к интернет и перезагрузите аппарат.
131 1 as multisoft
132 127 as multisoft
Если после перезагрузки *adb devices* всё равно возвращает *unauthorized*, либо при отладке возникают ошибки доступа,
133 1 as multisoft
попробуйте включить режим разработчика вручную стандартным для android устройств способом:
134 1 as multisoft
многократными тапами по *Build.Number (Номер сборки)* в меню *"о телефоне".*
135 1 as multisoft
Также попробуйте отключить (если была включена) и включить снова опцию *"Отладка по USB"* в меню *"Для разработчиков"*.
136 127 as multisoft
137 127 as multisoft
*Перевод MSPOS-Е-Ф в режим отладки (включение adb)*:
138 127 as multisoft
Данная процедура необратима. По завершении на экране ККТ появится водяной знак.
139 127 as multisoft
Использование MSPOS-Е-Ф со включенной отладкой в боевом режиме недопустимо.
140 127 as multisoft
Будучи включённым, adb делает устройство небезопасным дял конечного пользователя.
141 127 as multisoft
Последствия проведения транзакций при использовании устройства в режиме отладки ложатся на компанию, запросившую перевод в режим отладки.
142 131 as multisoft
Включение режима отладки разрешено только в целях разработки и тестирования.
143 131 as multisoft
При исользовании устройства только в целях тестирования рекомендуем использовать механизм gray release.
144 127 as multisoft
Для включения adb на MSPOS-Е-Ф кроме передачи сотрудникам Мультисофт SN и фото с читаемым SN необходимо:
145 127 as multisoft
146 127 as multisoft
* явно сообщить о своём намерении включить режим отладки (adb) на конкретном устройстве путём указания его SN в текстовой форме
147 127 as multisoft
* явно указать намерение использовать устройство в целях разработки и тестирования
148 130 as multisoft
* явно подтвердить, что последствия работы с включенным adb ясны
149 127 as multisoft
150 127 as multisoft
Включение режима отладки осуществляется путём ввода 4-значного одноразового временного кода.
151 127 as multisoft
Код необходимо вводить в специальное меню, которое открыватеся после 8 нажатий по TUSN в "Настройки" -> "О телефоне".
152 127 as multisoft
Срок действия пароля: 24 часа.
153 127 as multisoft
Пример: "Прошу предоствить код для adb на девайс PExxxxxxxxxx. В целях разработки и тестирования. Последствия ясны, риски приняты."
154 2 as multisoft
155 1 as multisoft
h2. Q5:
156 2 as multisoft
157 2 as multisoft
h2. *Что делать с Company Registration Certification при регистрации аккаунта в sunmi partners?*
158 2 as multisoft
159 2 as multisoft
h2. A5:
160 1 as multisoft
161 129 as multisoft
Прикрепите пустую картинку. Эта опция нужна китайским компаниям.
162 2 as multisoft
163 1 as multisoft
h2. Q6:
164 2 as multisoft
165 61 as multisoft
h2. *Как загрузить приложение в магазин Sunmi?*
166 2 as multisoft
167 2 as multisoft
h2. A6:
168 1 as multisoft
169 129 as multisoft
Воспользуйтесь "инструкцией по загрузке":http://77.243.109.96:8881/redmine/projects/mspos-k/wiki/AddAppSunmi
170 26 as multisoft
При загрузке укажите правильные модели(Terminals): *приложение будет доступно только на указанных моделях*.
171 26 as multisoft
Поле *price* выставлять в соответствии с партнёрским соглашением.
172 26 as multisoft
После загрузки каждой версии в магазин требуется около 1 рабочего дня на автоматический аудит.
173 55 as multisoft
Если приложение было загружено в магазин в режиме пре-релиза (gray release),
174 55 as multisoft
аудит выполняется при первой загрузке и не распространяется на *Change to official version*.
175 54 as multisoft
Кнопка *Change to official version* нужна, чтобы применить грей релиз на все аппараты.
176 1 as multisoft
Изменение списка устройств для пре-релиза (в т.ч. применение пре-релизана все устройства - change to official version) не сопровождается аудитом.
177 1 as multisoft
Изменение атрибутов приложения, таких как скриншоты, описание, поддерживаемые модели и др. вызывает повторный аудит при применении этих свойств (кнопка Save внизу).
178 111 as multisoft
*"ТРЕБОВАНИЯ МАГАЗИНА ПРИЛОЖЕНИЙ К ПО":https://docs.sunmi.com/htmls/index.html?lang=en##App%20Test%20Specifications*
179 26 as multisoft
180 129 as multisoft
Для *обновления* приложения в магазине мы подготовили "другую инструкцию":http://77.243.109.96:8881/redmine/projects/mspos-k/wiki/UpdAppSunmi
181 2 as multisoft
182 1 as multisoft
h2. Q7:
183 3 as multisoft
184 2 as multisoft
h2. *Что нужно знать о регистрации фискального накопителя (ФН)?*
185 2 as multisoft
186 1 as multisoft
h2. A7: 
187 3 as multisoft
188 129 as multisoft
Процедура регистрации выполняется один раз за время жизни ФН.
189 3 as multisoft
Регистрация ФН - часть процесса включения фискального режима работы ККТ.
190 3 as multisoft
Пока ККТ не зарегистрирована с ФН, она находится в учебном режиме. Об этом свидетельствует надпись * *учебный режим* * в начале чеков.
191 11 as multisoft
После регистрации ФН ККТ в процессе работы печатает *фискальные* документы, за исключением нефискальных документов (RecType.Unfiscal),
192 11 as multisoft
документов внесения/изъятия (RecType.PayIn/PayOut) и X-отчётов (PrintXReport).
193 1 as multisoft
Если ККТ зарегистрирована в неавтономном режиме (отсутствует флаг OperatingMode.Autonomous),
194 11 as multisoft
фискальные документы будут отправляться в ОФД по настроенному каналу связи (валидный сервер и порт ОФД,
195 11 as multisoft
выход в интернет по Wifi или через мобильную сеть).
196 1 as multisoft
197 129 as multisoft
Для регистрации фискального накопителя(ФН) нужно следующее:
198 28 as multisoft
а) ФН подключен и в состоянии "готов к регистрации" ("FNGetState":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#acccf308edeb4fe120f682cbc3a4b739c/ == "FnState.ReadyToFiscalization":http://doc.multisoft.ru/doc/MSPOS/html/namespacecom_1_1multisoft_1_1drivers_1_1fiscalcore.html#a48a9c84bbd4107e159399f00ad85fa78).
199 28 as multisoft
б) смена должна быть закрыта ("GetDayState":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a75178af4fb3f53fec8ff0a2c5cc14edd == "DayState.DayClosed":http://doc.multisoft.ru/doc/MSPOS/html/namespacecom_1_1multisoft_1_1drivers_1_1fiscalcore.html#ac954685f2b9cd2e40ef72d39f68de124)
200 28 as multisoft
в) не должно быть открыто ни одного документа ("GetRecState":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a5f6942bdd312c5a8a52bdd2c4ebd3d7b == "RecState.Closed":http://doc.multisoft.ru/doc/MSPOS/html/namespacecom_1_1multisoft_1_1drivers_1_1fiscalcore.html#a23cd3e5ca25f473990493575a9c2f11c)
201 1 as multisoft
после этого можно начинать процедуру регстрации.
202 2 as multisoft
203 1 as multisoft
h2. Q8:
204 3 as multisoft
205 2 as multisoft
h2. *Как зарегистрировать ФН / включить фискальный режим ККТ?*
206 2 as multisoft
207 2 as multisoft
h2. A8:
208 1 as multisoft
209 129 as multisoft
Процедура регистрации, в зависимости от желаемых параметров регистрации, может отличаться.
210 1 as multisoft
Основные операции при регистрации:
211 1 as multisoft
1) установка опций: см. блок "Запрос и установка параметров"
212 28 as multisoft
2) сохранение опций (см. "SaveOptions":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a8bf297561df86b0c5e62b8b0adcf670e )
213 28 as multisoft
3) регистрация (см. "Register":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a278fd49eca702ca03b239f65f098a245 ).
214 1 as multisoft
215 129 as multisoft
при каждой регистрации %{color:red}обязательными% для установки на шаге 1 являются:
216 28 as multisoft
"SetOrgName":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#ad771825ea775e76666cc09772279767a
217 28 as multisoft
"SetOrgAddress":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#ac6650f56de207c2664b8a16f3b63fd32
218 1 as multisoft
"SetPhysicalAddress":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#ae09721153004af1fcd47c8dd900666c6
219 1 as multisoft
"SetFnsServerAddress":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#ac35b9fefb435f5ade6d337e174fe6190
220 1 as multisoft
221 129 as multisoft
Если при регистрации в битовом поле "режим работы" (op_mode) %{color:red}не% установлен бит "OperatingMode.Autonomous":http://doc.multisoft.ru/doc/MSPOS/html/a00014.html#af79f7ba66a9ad6fe8763a6f58952a5d2a6aec1991f208e2948db5e4eee6e1ccff (0x02), %{color:red}обязательными на шаге 1 также являются%:
222 38 as multisoft
"SetSenderEmail":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a47a8880a2cdec8dff31067adc172d161
223 35 as multisoft
"SetOfdHost":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#ab616fe44a2bade57e5f11010e277bf11
224 35 as multisoft
"SetOfdPort":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a3cd2cb3aac6f6a36989aa099e3ca7a2e
225 35 as multisoft
"SetOfdName":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a8f1fb2f7c7eb90a984c5d8fb5bc223bb
226 35 as multisoft
"SetOfdTaxId":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a31a1421e3bd6418411e1602765d13b9d
227 35 as multisoft
228 129 as multisoft
Если при регистрации в битовом поле "режим работы" (op_mode) установлен бит "OperatingMode.Automatic":http://doc.multisoft.ru/doc/MSPOS/html/namespacecom_1_1multisoft_1_1drivers_1_1fiscalcore.html#af79f7ba66a9ad6fe8763a6f58952a5d2 (0x04), %{color:red}на шаге 1 должен быть установлен номер автомата%:
229 35 as multisoft
"SetVendingSerial":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a9f854e01cb5b4f40a1b97b2f19c41cae
230 35 as multisoft
231 129 as multisoft
В зависимости от того, является ли пользователь платёжным агентом (параметр agent в функции Register отличен от 0), %{color:red}на шаге 1 должны быть установлены следующие опции%:
232 28 as multisoft
"SetTransferOperatorName":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#abc45417de2caada0426148d08c2f01ab
233 28 as multisoft
"SetTransferOperatorTaxId":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a40533b38d11cf5703856b46cd68408a3
234 28 as multisoft
"SetTransferOperatorTelNum":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a47846d05cebe797b4c5ee59c097eb2fa
235 28 as multisoft
"SetTransferOperatorAddress":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a70a8d8ed1e4f1b1b49f6b21860f4d3df
236 28 as multisoft
"SetPaymentAgentTelNum":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#ad9db608d873cd7e60e936ae9fd552e2c
237 28 as multisoft
"SetPaymentAgentOperation":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#ad489cb74534c3c0091eac73f8312c7a2
238 1 as multisoft
"SetCommissionAgentTelNum":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a537b038aab4c42ed63107e96cd423321
239 1 as multisoft
"SetContractorTelNum":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#ab93c7d4caebe3cccbe37cafe525d1dad
240 110 as multisoft
Точный список требуемых параметров в зависимости от аргументов функции (пере)регистрации указан в "Q25":http://77.243.109.96:8881/redmine/projects/mspos-k/wiki/QA#Q25
241 28 as multisoft
242 2 as multisoft
243 1 as multisoft
h2. Q9:
244 2 as multisoft
245 2 as multisoft
h2. *Какие особенности работы с несколькими СНО?*
246 2 as multisoft
247 1 as multisoft
h2. A9: 
248 1 as multisoft
249 129 as multisoft
Пользователь может иметь несколько систем налогообложения (СНО). Запросить СНО, указанную при регистрации, можно функцией  "GetTaxation":http://doc.multisoft.ru/doc/MSPOS/html/a00031.html#a3634272503b0484eae22365fbf21a4a0
250 38 as multisoft
При этом в чеках должна быть указана только одна из зарегистированных СНО.
251 28 as multisoft
Если пользователь зарегистрировал кассу с несколькими СНО, то перед каждым открытием документа ("OpenRec":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a0652bf6ebf8d2e3147bf45905daa1f1e )
252 38 as multisoft
*текущая СНО* должна быть установлена функцией "SetTaxationUsing":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#ab2f0202725597f348727647d33eedaf4 , в параметрах которой передаётся одна из зарегистрированных СНО.
253 2 as multisoft
254 1 as multisoft
h2. Q10:
255 2 as multisoft
256 2 as multisoft
h2. *Для чего нужна перерегистрация?*
257 2 as multisoft
258 2 as multisoft
h2. A10: 
259 1 as multisoft
260 129 as multisoft
Если параметры кассы и/или реквизитов пользователя изменились, об этом нужно уведомить Федеральную налоговую службу (ФНС)
261 12 as multisoft
посредством отправки оператору фискальных данных (ОФД) отчёта о перерегистрации в электронной форме.
262 28 as multisoft
Отчёт о перерегистрации формируется функцией "CorrectRegistration":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a24fb9f4f043bd3ec5fed05cb9213db42.
263 28 as multisoft
Её параметры аналогичны функции "Register":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a278fd49eca702ca03b239f65f098a245, но нужно установить дополнительный - причину перерегистрации.
264 1 as multisoft
Причин перерегистрации может быть 4: замена ФН, смена ОФД, смена реквизитов пользователя и смена настроек ККТ.
265 2 as multisoft
266 2 as multisoft
h2. Q11:
267 2 as multisoft
268 2 as multisoft
h2. *Как выполнить перерегистрацию?*
269 2 as multisoft
270 1 as multisoft
h2. A11:
271 1 as multisoft
 
272 129 as multisoft
Выполняется аналогично "регистрации":http://77.243.109.96:8881/redmine/projects/mspos-k/wiki/QA#Q8 за исключением пункта 0):
273 1 as multisoft
0) убедиться, что в очереди на отправку в ОФД нет документов ("OFDGetFirstQueuedDocNumber":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a973998cafa852d49f1dfa351f336d069 == 0), иначе перерегистрация не будет выполнена.
274 28 as multisoft
1) установка опций, которые необходимо изменить, в связи с причиной перерегистрации: см. блок "Запрос и установка параметров"
275 110 as multisoft
Точный список требуемых параметров в зависимости от аргументов функции (пере)регистрации указан в "Q25":http://77.243.109.96:8881/redmine/projects/mspos-k/wiki/QA#Q25
276 28 as multisoft
2) сохранение опций (см. "SaveOptions":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a8bf297561df86b0c5e62b8b0adcf670e )
277 28 as multisoft
3) перерегистрация(см. "CorrectRegistration":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a24fb9f4f043bd3ec5fed05cb9213db42 ).
278 1 as multisoft
 
279 129 as multisoft
В связи с ограничениями ФН %{color:red}нельзя выполнить 1 перерегистрацию с несколькими причинами одновременно%.
280 13 as multisoft
Например, нельзя поменять настройки ОФД и реквизиты пользователя одновременно,
281 13 as multisoft
нужно выполнить последовательно 2 перерегистрации в связи с этими причинами, выполняя шаги 1-3.
282 1 as multisoft
При этом устанавливаются и сохраняются только те параметры, которые соответствуют причине данной перерегистрации (при условии, что все остальные присутствуют).
283 2 as multisoft
284 107 as multisoft
h2. Q11.1:
285 107 as multisoft
286 107 as multisoft
h2. *Какую причину перерегистрации выбрать при переключении режима между онлайн и оффдайн?*
287 107 as multisoft
288 107 as multisoft
h2. A11.1:
289 107 as multisoft
290 129 as multisoft
Правильный подход: при перерегистрации выбрать "смена настроек ккт" "CorrectionReason.ChangeKKTSettings":http://doc.multisoft.ru/doc/MSPOS/html/a00017.html#accde9d8d9055948548d04b24debc5200.
291 109 as multisoft
Однако, некоторые ФН не позволяют это сделать.
292 109 as multisoft
В таком случае нужно отменить документ и перерегистрировать с причиной "смена параметров ОФД" "CorrectionReason.ChangeOFD":http://doc.multisoft.ru/doc/MSPOS/html/a00017.html#accde9d8d9055948548d04b24debc5200.
293 107 as multisoft
Перед началом перерегистрации необходимо убедиться, что все необходимые параметры(опции) установлены "Q25":http://77.243.109.96:8881/redmine/projects/mspos-k/wiki/QA#Q25.
294 107 as multisoft
295 1 as multisoft
h2. Q12:
296 6 as multisoft
297 2 as multisoft
h2. *Как напечатать чек?/ Как сформировать фискальный документ? / Как сформировать нефискальный документ?*
298 2 as multisoft
299 1 as multisoft
h2. A12:
300 6 as multisoft
301 129 as multisoft
В общем случае печать документа состоит из открытия "OpenRec":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a0652bf6ebf8d2e3147bf45905daa1f1e, наполнения документа и закрытия "CloseRec":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#ad324f3c6dcabcfa6801fc4c166b24244.
302 28 as multisoft
Пока документ не закрыт, его можно отменить функцией "RecVoid":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a5654f1a1b77435e97bf8e788df271873
303 6 as multisoft
304 129 as multisoft
*Если ФН зарегистрирован с несколькими системами налогообложения (СНО),
305 6 as multisoft
перед открытием фискального документа с типом Sell/SellRefund/Buy/BuyRefund, либо чека коррекции,
306 28 as multisoft
необходимо из зарегистрированных СНО выбрать одну и установить её* функцией "SetTaxationUsing":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#ab2f0202725597f348727647d33eedaf4.
307 6 as multisoft
Настраивать СНО не обязательно для каждого документа.
308 28 as multisoft
Установленная после соединения с ядром СНО действует до следующей выгрузки ядра из оперативной памяти либо до следующей вызванной "SetTaxationUsing":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#ab2f0202725597f348727647d33eedaf4.
309 6 as multisoft
310 129 as multisoft
Наполнение *нефискального документа (RecType.Unfiscal)* выполняется командами печати:
311 106 as multisoft
"PrintLine":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#afd8854e97d653a91a41735c7750447a9
312 106 as multisoft
"PrintLineAligned":http://doc.multisoft.ru/doc/MSPOS/html/a00034.html#aeb49685abe791c713497873bd8fbea8a
313 1 as multisoft
"PrintQRCode":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a8d298288c9d1497dfee2151155749185
314 1 as multisoft
"PrintBarCode":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#ae19113179a5ddc1b386c1a71dc089dca
315 106 as multisoft
"SetFont":http://doc.multisoft.ru/doc/MSPOS/html/a00034.html#a3ec8a35cbbe9f62245e392285087c9e1
316 106 as multisoft
"PrintRaster":http://doc.multisoft.ru/doc/MSPOS/html/a00034.html#ac36e19f4cc12db659084eb337916f294
317 106 as multisoft
318 129 as multisoft
Наполнение *фискальных документов с типом Sell/SellRefund/Buy/BuyRefund, а также нефискальных с типом PayIn/PayOut* выполняется командами:
319 28 as multisoft
"PrintRecItem":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a33a66c34f73f25247d84a51623516d55 - добавление позиции, можно вызывать сколь угодно много раз.
320 28 as multisoft
"PrintRecTotal":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#addeeaada4bbd7913f57030efba8662fe - подведение итога. разрешено вызывать не более 1 раза на документ. После итога добавление позиций запрещено, можно вызывать только команды оплаты:
321 28 as multisoft
"PrintRecItemPay":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a7ca2d5fc505ce74e47ffe6ff77f6ec70 - добавление оплаты, можно вызывать сколь угодно много раз, рекомендуется не более 6 раз на документ (с учётом сдачи).
322 6 as multisoft
Только *для Sell/SellRefund/Buy/BuyRefund*:
323 28 as multisoft
 *Перед "PrintRecItem":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a33a66c34f73f25247d84a51623516d55 необходимо установить налоги*  функцией "SetItemTaxes":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#ac3ba54dd76e7efe29870e3117eae41de.
324 92 as multisoft
 В некоторых случаях требуется передать телефон или электронный адрес покупателя (тег 1008), об этом в "Q13":http://77.243.109.96:8881/redmine/projects/mspos-k/wiki/QA/edit#Q13, "Q14":http://77.243.109.96:8881/redmine/projects/mspos-k/wiki/QA/edit#Q14.
325 6 as multisoft
326 92 as multisoft
h2. Q12_1:
327 86 as multisoft
328 86 as multisoft
h2. *Как сформировать чек коррекции?*
329 86 as multisoft
330 91 as multisoft
h2. A12_1:
331 86 as multisoft
332 129 as multisoft
*Чек коррекции* отличается от остальных чеков наполнением: оно происходит единственной командой "FNMakeCorrectionRec":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a4f682ac24587eb357468ab574fa5c7f5, повтор которой недопустим.
333 87 as multisoft
Для формирования суммовых налогов в чеке коррекции перед FNMakeCorrectionRec нужно вызвать "SetSumTaxes":http://doc.multisoft.ru/doc/MSPOS/html/a00034.html#a79d22ae4a8cd4fc35e077659c58e6aa3.
334 87 as multisoft
*В этом случае параметр taxNum (порядоковый номер используемого налога) функции FNMakeCorrectionRec игнорируется*.
335 86 as multisoft
Резюмируя: для формирования чека коррекции нужно последовательно и без повторов вызывать:
336 86 as multisoft
(если несколько СНО) "SetTaxationUsing":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#ab2f0202725597f348727647d33eedaf4
337 86 as multisoft
"OpenRec":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a0652bf6ebf8d2e3147bf45905daa1f1e
338 86 as multisoft
(если нужны суммовые налоги)"SetSumTaxes":http://doc.multisoft.ru/doc/MSPOS/html/a00034.html#a79d22ae4a8cd4fc35e077659c58e6aa3
339 86 as multisoft
"FNMakeCorrectionRec":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a4f682ac24587eb357468ab574fa5c7f5
340 86 as multisoft
"CloseRec":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#ad324f3c6dcabcfa6801fc4c166b24244
341 86 as multisoft
342 6 as multisoft
h2. Q13:
343 6 as multisoft
344 6 as multisoft
h2. *Как передать телефон или электронный адрес покупателя (тег 1008)?*
345 6 as multisoft
346 6 as multisoft
h2. A13:
347 2 as multisoft
348 129 as multisoft
Для передачи этого тега необходимо использовать функцию "SendClientAddress":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a5672fc24a0e68cf06e13a8e73698cb12
349 2 as multisoft
Она выполняется один раз на весь документ в любой момент после открытия и до закрытия. %{color:red}Повторная передача ведёт к нарушению ФФД%.
350 1 as multisoft
Установка одновременно электронного адреса и телефона покупателя не предусмотрена ФФД 1.05 от 21.03.2017.
351 1 as multisoft
Точно так же покупатель не может иметь нескольких телефонов и/или email одновременно.
352 116 as multisoft
При использовании SendClientAddress в опциях заранее *должен быть установлен эл. адрес отправителя* "SetSenderEmail":http://doc.multisoft.ru/doc/MSPOS/html/a00034.html#a47a8880a2cdec8dff31067adc172d161
353 116 as multisoft
354 6 as multisoft
355 1 as multisoft
h2. Q14:
356 6 as multisoft
357 28 as multisoft
h2. *В каком формате передавать телефон или электронный адрес покупателя (тег 1008) в функции "SendClientAddress":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a5672fc24a0e68cf06e13a8e73698cb12 ?*
358 6 as multisoft
359 1 as multisoft
h2. A14:
360 2 as multisoft
361 129 as multisoft
Телефон или электронный адрес покупатеся следует передавать в соответствии с ФФД 1.05 от 21.03.2017 Таблица 5, тег 1008:
362 2 as multisoft
Формат: %{color:red}+{Ц}% или %{color:red}{С}@{C}%,
363 2 as multisoft
где Ц - "атрибут, обозначающий, что данные реквизита должны быть представлены в виде цифры",
364 1 as multisoft
С- "атрибут, обозначающий, что данные реквизита должны быть представлены в виде символа".
365 2 as multisoft
Символы и цифры должны быть представлены в электронной форме %{color:red}"в соответствии с кодовой таблицей CP866"%.
366 6 as multisoft
367 1 as multisoft
h2. Q15:
368 1 as multisoft
369 6 as multisoft
h2. *Как изменить параметры автоинкассации при закрытии смены?*
370 1 as multisoft
371 2 as multisoft
h2. A15:
372 28 as multisoft
373 129 as multisoft
Включение или отключение автоинкассации выполняется функцией "SetDayCloseAutoPayOut":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a7412c0fe3ae61fc5a2d54d850e8d0c97
374 28 as multisoft
Если необходимо сохранить значение параметра для применения его во всех следующих функциях закрытия смены ("CloseDay":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a45709f692bbe83ec0852e0569b512a01 ),
375 6 as multisoft
в т.ч. после перезагрузки, нужно сохранить опции ("SaveOptions":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a8bf297561df86b0c5e62b8b0adcf670e ).
376 2 as multisoft
377 1 as multisoft
h2. Q16, Q17:
378 1 as multisoft
379 107 as multisoft
h2. *Какие типы документа доступны для чека коррекции в аргументе "operation" функции "FNMakeCorrectionRec":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a4f682ac24587eb357468ab574fa5c7f5 ?*
380 2 as multisoft
381 48 as multisoft
h2. *Почему в чеке коррекции не работает "OperationType.SellRefund":http://doc.multisoft.ru/doc/MSPOS/html/namespacecom_1_1multisoft_1_1drivers_1_1fiscalcore.html#ac61434a729deda0ddd0e8cf6b1bd7123 и "OperationType.BuyRefund":http://doc.multisoft.ru/doc/MSPOS/html/namespacecom_1_1multisoft_1_1drivers_1_1fiscalcore.html#ac61434a729deda0ddd0e8cf6b1bd7123 )?*
382 6 as multisoft
383 1 as multisoft
h2. A16, A17:
384 1 as multisoft
385 129 as multisoft
В соответствии с ФФД 1.05 от 21.03.2017 Таблица 25 "Реквизит «Признак расчета» (тег 1054) для кассового чека коррекции (БСО коррекции)
386 15 as multisoft
может принимать одно из следующих значений: «1» – приход, «3» – расход."
387 1 as multisoft
Поэтому чек коррекции на возврат прихода и возват расхода возвращает ошибку.
388 6 as multisoft
389 1 as multisoft
h2. Q18:
390 1 as multisoft
391 1 as multisoft
h2. *Как передать признак предмета расчета и признак способа расчета (теги 1212 и 1214)?*
392 6 as multisoft
393 1 as multisoft
h2. A18:
394 1 as multisoft
395 129 as multisoft
Для передачи свободных тегов используется функция "SetTagAttribute":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a8bce3c5e91220db3f59b0f7491775393 (начиная с 1.8.28).
396 28 as multisoft
Её нужно вызывать перед добавлением позиции ("PrintRecitem":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a33a66c34f73f25247d84a51623516d55 ), в которой необходимо установить соответствующий тег.
397 6 as multisoft
398 129 as multisoft
Обращаем внимание на примечания 1 и 2 к таблице 29 ФФД (введены Приказом ФНС России от 09.04.2018 N ММВ-7-20/207@):
399 120 as multisoft
400 129 as multisoft
1. В случае если в составе кассового чека (БСО) реквизит "предмет расчета" (тег 1059) содержит реквизит "признак предмета расчета" (тег 1212), имеющий значение *"15"*,
401 122 as multisoft
то такой кассовый чек (БСО) при передаче в ОФД в электронной форме в реквизите "наименование предмета расчета" (тег 1030) 
402 122 as multisoft
должен содержать одно из значений *от "1" до "25"*, указанных в таблице 29.1.
403 1 as multisoft
2. В случае если в составе кассового чека (БСО) реквизит "предмет расчета" (тег 1059) содержит реквизит "признак предмета расчета" (тег 1212), имеющий значение *"16"*,
404 122 as multisoft
то такой кассовый чек (БСО) при передаче в ОФД в электронной форме в реквизите "наименование предмета расчета" (тег 1030)
405 122 as multisoft
должен содержать одно из значений *от "26" до "31"*, указанных в таблице 29.1._
406 120 as multisoft
407 129 as multisoft
В случае передачи в *1212* значений *15* или *16*, в "PrintRecItem":http://doc.multisoft.ru/doc/MSPOS/html/a00034.html#a46ffb2cbf9248c5f138f50a8bef916d9
408 126 as multisoft
в аргумент *itemName* необходимо передавать значение реквизита из таблицы 29.1 ФФД *без дополнительного текста: значения от "1" до "31"*.
409 126 as multisoft
Печатная форма формируется ядром.
410 120 as multisoft
411 1 as multisoft
h2. Q19:
412 1 as multisoft
413 1 as multisoft
h2. *Какие значения передать при установке тегов 1212 и 1214?*
414 6 as multisoft
415 3 as multisoft
h2. A19:
416 1 as multisoft
417 129 as multisoft
Значения реквизита «признак способа расчета» (тег 1214) в соответствии с ФФД 1.05 от 21.03.2017 Таблица 28:
418 3 as multisoft
419 3 as multisoft
 |1|ПРЕДОПЛАТА 100%|
420 4 as multisoft
 |2|ПРЕДОПЛАТА|
421 3 as multisoft
 |3|АВАНС|
422 1 as multisoft
 |4|ПОЛНЫЙ РАСЧЕТ|
423 3 as multisoft
 |5|ЧАСТИЧНЫЙ РАСЧЕТ И КРЕДИТ|
424 5 as multisoft
 |6|ПЕРЕДАЧА В КРЕДИТ|
425 5 as multisoft
 |7|ОПЛАТА КРЕДИТА|
426 4 as multisoft
427 129 as multisoft
Значения реквизита «признак предмета расчета» (тег 1212) в соответствии с ФФД 1.05 от 21.03.2017 в ред. Приказа ФНС России от 09.04.2018 Таблица 29:
428 63 as multisoft
429 5 as multisoft
 |1|ТОВАР|
430 1 as multisoft
 |2|ПОДАКЦИЗНЫЙ ТОВАР|
431 4 as multisoft
 |3|РАБОТА|
432 4 as multisoft
 |4|УСЛУГА|
433 1 as multisoft
 |5|СТАВКА АЗАРТНОЙ ИГРЫ|
434 1 as multisoft
 |6|ВЫИГРЫШ АЗАРТНОЙ ИГРЫ|
435 3 as multisoft
 |7|ЛОТЕРЕЙНЫЙ БИЛЕТ|
436 4 as multisoft
 |8|ВЫИГРЫШ ЛОТЕРЕИ|
437 1 as multisoft
 |9|ПРЕДОСТАВЛЕНИЕ РИД|
438 5 as multisoft
 |10|ПЛАТЕЖ|
439 1 as multisoft
 |11|АГЕНТСКОЕ ВОЗНАГРАЖДЕНИЕ|
440 4 as multisoft
 |12|СОСТАВНОЙ ПРЕДМЕТ РАСЧЕТА|
441 1 as multisoft
 |13|ИНОЙ ПРЕДМЕТ РАСЧЕТА|
442 1 as multisoft
 |14|ИМУЩЕСТВЕННОЕ ПРАВО (с 1.12.37+)|
443 72 as multisoft
 |15|ВНЕРЕАЛИЗАЦИОННЫЙ ДОХОД (с 1.12.37+)|
444 72 as multisoft
 |16|СТРАХОВЫЕ ВЗНОСЫ (с 1.12.37+)|
445 72 as multisoft
 |17|ТОРГОВЫЙ СБОР (с 1.12.37+)|
446 72 as multisoft
 |18|КУРОРТНЫЙ СБОР (с 1.12.37+)|
447 72 as multisoft
 |19|ЗАЛОГ (с 1.12.37+)|
448 72 as multisoft
449 1 as multisoft
h2. Q20:
450 1 as multisoft
451 4 as multisoft
h2. *Как пробить сдачу?*
452 1 as multisoft
453 3 as multisoft
h2. A20:
454 1 as multisoft
455 129 as multisoft
Сначала пробейте оплату наличными, сумму, которую передал клиент, например, 100р.
456 1 as multisoft
<pre><code class="cpp">
457 4 as multisoft
IFiscalCore.PrintRecItemPay((int)PayType.Cash, "100.00", "ПРИНЯТО ОТ КЛИЕНТА НАЛИЧНЫМИ:",callback);
458 1 as multisoft
</code></pre>
459 129 as multisoft
460 129 as multisoft
После этого выполните вызов "PrintRecItemPay":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a7ca2d5fc505ce74e47ffe6ff77f6ec70 с параметрами PayType.Cash, в total передайте сумму со знаком "минус".
461 10 as multisoft
Например, сдача в 15 рублей 1 копейку оформляется вызовом:
462 1 as multisoft
<pre><code class="cpp">
463 3 as multisoft
IFiscalCore.PrintRecItemPay((int)PayType.Cash, "-15.01", "СДАЧА:",callback);
464 4 as multisoft
</code></pre>
465 5 as multisoft
В предыдущих двух командах параметр itemText может быть любым.
466 4 as multisoft
В результате после закрытия документ, если "принято" - "сдача" == сумме стоимости всех позиций по документу, на чеке появится 2 последовательные надписи:
467 4 as multisoft
 "ПРИНЯТО ОТ КЛИЕНТА НАЛИЧНЫМИ:  100.00"
468 4 as multisoft
 "СДАЧА:                          15.01"
469 4 as multisoft
и ниже, в соответствии с ФФД:
470 1 as multisoft
 "НАЛИЧНЫМИ                       84.99"
471 17 as multisoft
472 17 as multisoft
473 17 as multisoft
h2. Q21:
474 1 as multisoft
475 17 as multisoft
h2. *Как работать по старому законотадельству в режиме ЧПМ ?*
476 17 as multisoft
477 17 as multisoft
h2. A21:
478 17 as multisoft
479 129 as multisoft
Если клиент по закону имеет право пользоваться ЧПМ, переход в режим ЧПМ осуществляется при соблюдении следующих условий:
480 17 as multisoft
1. ККТ не зарегистрирована
481 17 as multisoft
2. К ККТ не подключен (зарегистрированный) ФН
482 17 as multisoft
3. ПО умеет работать в режиме ЧПМ без обращений к ФН.
483 1 as multisoft
4. ПО умеет определять текущий режим работы через вызов функции "DirectIO":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#ad332340d4b162fd5a0fd9a56a364a457
484 17 as multisoft
485 129 as multisoft
*%{color:red}Внимание!%* Режим работы ККТ, определяемый перечислением "Mode":http://doc.multisoft.ru/doc/MSPOS/html/namespacecom_1_1multisoft_1_1drivers_1_1fiscalcore.html#a6133311b80ad2d8ed53f0a9766094159 *отличается* от режима работы ФН, описанного в "OperatingMode":http://doc.multisoft.ru/doc/MSPOS/html/namespacecom_1_1multisoft_1_1drivers_1_1fiscalcore.html#af79f7ba66a9ad6fe8763a6f58952a5d2
486 17 as multisoft
Численные значения перечислений лежат в начале "страницы":http://doc.multisoft.ru/doc/MSPOS/html/namespacecom_1_1multisoft_1_1drivers_1_1fiscalcore.html
487 17 as multisoft
488 129 as multisoft
Запрос текущего режима работы ККТ (Mode) выполняется следующим образом:
489 28 as multisoft
1. Создаётся экземпляр "IAuth":http://doc.multisoft.ru/doc/MSPOS/IAuth.aidl, который реализует все функции интерфейса.
490 28 as multisoft
2. Создаётся экземпляр "IExceptionCallback":http://doc.multisoft.ru/doc/MSPOS/IExceptionCallback.aidl по аналогии с любым другим коллбеком об ошибке
491 18 as multisoft
3. Выполняется команда DirectIO с параметрами "DirectIOCmd.GetMode":http://doc.multisoft.ru/doc/MSPOS/html/namespacecom_1_1multisoft_1_1drivers_1_1fiscalcore.html#aa03c06b35cfd3f44c06206014cb9d40c,
492 17 as multisoft
в качестве второго параметра необходимо передать идентификатор пользовательского ПО, либо package приложения, из которого функция вызвыается.
493 28 as multisoft
4.1 Если команда выполнена успешно, ядро вызовет auth.Result(currentMode) с параметром currentMode, равном текущему режиму работы ККТ (Mode).
494 28 as multisoft
4.2 Пользовательское ПО сохраняет это число и сравнивает с "Mode.OFD":http://doc.multisoft.ru/doc/MSPOS/html/namespacecom_1_1multisoft_1_1drivers_1_1fiscalcore.html#a6133311b80ad2d8ed53f0a9766094159 и "Mode.ENVD":http://doc.multisoft.ru/doc/MSPOS/html/namespacecom_1_1multisoft_1_1drivers_1_1fiscalcore.html#a6133311b80ad2d8ed53f0a9766094159, определяя текущий режим работы.
495 17 as multisoft
5.1 Если команда завершилась с ошибкой, коллбек об ошибке передаётся стандартно, через "IExceptionCallback":http://doc.multisoft.ru/doc/MSPOS/IExceptionCallback.aidl
496 17 as multisoft
497 129 as multisoft
Переход в режим ЧПМ осуществляется через программный вызов DirectIO при выполнении условий 1-3 аналогично запросу текущего режима работы ККТ (Mode).
498 28 as multisoft
В качестве первого параметра необходимо использовать константу "DirectIOCmd.ChangeMode":http://doc.multisoft.ru/doc/MSPOS/html/namespacecom_1_1multisoft_1_1drivers_1_1fiscalcore.html#aa03c06b35cfd3f44c06206014cb9d40c
499 28 as multisoft
При смене режима в auth.Result возвращается *новый режим работы*. Был режим: "Mode.OFD":http://doc.multisoft.ru/doc/MSPOS/html/namespacecom_1_1multisoft_1_1drivers_1_1fiscalcore.html#a6133311b80ad2d8ed53f0a9766094159. Сменили режим => в auth.Result возвращается "Mode.ENVD":http://doc.multisoft.ru/doc/MSPOS/html/namespacecom_1_1multisoft_1_1drivers_1_1fiscalcore.html#a6133311b80ad2d8ed53f0a9766094159
500 17 as multisoft
501 17 as multisoft
h2. Q22:
502 17 as multisoft
503 17 as multisoft
h2. *Какие особенности у режима ЧПМ ?*
504 17 as multisoft
505 17 as multisoft
h2. A22:
506 17 as multisoft
507 129 as multisoft
В режиме ЧПМ все обращения к ФН отключены и будут возвращать "ErrCode.Hardware":http://doc.multisoft.ru/doc/MSPOS/html/namespacecom_1_1multisoft_1_1drivers_1_1fiscalcore.html#af7d268ea5021cfa159aa82b7004da530, "ExtHardwareErr.Nack":http://doc.multisoft.ru/doc/MSPOS/html/namespacecom_1_1multisoft_1_1drivers_1_1fiscalcore.html#a4db5bb9a1e904a00eeee445ac3aa45cc кроме "FNGetNumber":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a8b2c94673f98ad05e485adc28f0bf95d.
508 19 as multisoft
 
509 129 as multisoft
Функции, начинающиеся с *FN, OFD, FDI, QueryOFD, OfdOut, QueryFiscal* созданы для работы в режиме ОФД,
510 22 as multisoft
обращаются к ФН и будут возвращать указанную выше ошибку в режиме ЧПМ.
511 19 as multisoft
В любой момент из режима ЧПМ можно перейти обратно в режим ОФД с потерей всех счётчиков и состояний по вызову команды DirectIO с параметрами для смены режима работы.
512 19 as multisoft
513 129 as multisoft
Для корректной работы устройства в режиме ЧПМ его необходимо зарегистрировать.
514 19 as multisoft
Перед регистрацией необходимо установить и сохранить следующие опции:
515 28 as multisoft
"SetOrgName":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#ad771825ea775e76666cc09772279767a
516 28 as multisoft
"SetOrgAddress":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#ac6650f56de207c2664b8a16f3b63fd32
517 28 as multisoft
Регистрация выполняется стандартной функцией "Register":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a278fd49eca702ca03b239f65f098a245
518 19 as multisoft
В качестве параметров необходимо передать: reg_num, равный "00000", а также корректный ИНН и имя кассира. Остальные параметры не влияют на результат выполнения.
519 23 as multisoft
520 23 as multisoft
h2. Q23:
521 23 as multisoft
522 25 as multisoft
h2. *Как проверить, к какому магазину привязано устройство?*
523 23 as multisoft
524 23 as multisoft
h2. A23:
525 23 as multisoft
526 129 as multisoft
Откройте App Store или Магазин приложений. Нажмите иконку пользователя справа вверху.
527 23 as multisoft
Открывшееся меню прокрутите вниз.
528 23 as multisoft
В поле "Service provider" или "поставщик услуг" показывается текущий магазин, к которому привязано устройство. По умолчанию это Multisoft.
529 23 as multisoft
530 23 as multisoft
h2. Q24:
531 23 as multisoft
532 23 as multisoft
h2. *На устройстве не применяются настройки магазина, что делать?*
533 23 as multisoft
534 23 as multisoft
h2. A24:
535 1 as multisoft
536 129 as multisoft
Проверьте "A23":http://77.243.109.96:8881/redmine/projects/mspos-k/wiki/QA#A23 ^. Если наименование магазина соответствует ожидаемому, убедитесь, что устройство подключено по Wifi к интернет,
537 23 as multisoft
и выполните перезагрузку. Допускается подключение через сеть sim-карты с доступом в интернет, но предпочтительнее пользоваться Wifi.
538 24 as multisoft
Если перезагрузка не помогла, зайдите в *POS Steward -> network -> network test -> start testing*.
539 1 as multisoft
Тест пройден успешно, если все три галочки - зелёные.
540 1 as multisoft
Если хотя бы одна из них красная, рекомендуется подключиться к другой Wifi сети, где тест пройдёт успешно,
541 38 as multisoft
т.к. корректное применение всех параметров магазина гарантируется только при полностью исправном соединении с интернет.
542 38 as multisoft
543 38 as multisoft
h2. Q25:
544 38 as multisoft
545 1 as multisoft
h2. *Как работать с признаком агента? Что делать, если пользователь - агент/поверенный/комиссионер?*
546 38 as multisoft
547 38 as multisoft
h2. A25:
548 38 as multisoft
549 128 as multisoft
Если пользователь - агент/поверенный/комиссионер, соответствующий признак агента указывается в параметрах "регистрации":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a278fd49eca702ca03b239f65f098a245.
550 44 as multisoft
После регистрации можно установить *текущий признак агента* функцией "SetAgentTagUsing":http://doc.multisoft.ru/doc/MSPOS/html/a00031.html#a7f0d91ebd3472d213e6be47e4afda0c2 (аналогично установке СНО, выполняется *перед открытием чека*).
551 45 as multisoft
Установка признака агента может быть нужна в случае, если необходимо сформировать документ с одним(несколькими) из зарегистрированных признаков агента, к примеру:
552 45 as multisoft
при регистрации указан *PayAgent* и *BankPaySubAgent*, а предмет расчёта в чеке относится только к *PayAgent*).
553 45 as multisoft
*Текущий признак агента* распространяется на все предметы расчёта (товары, услуги, ...) в чеке.
554 44 as multisoft
*По умолчанию* текущий признак агента равен указанному при регистрации.
555 44 as multisoft
Запросить признак агента в ФН (указывается при регистрации) можно функцией "GetAgentTag":http://doc.multisoft.ru/doc/MSPOS/html/a00031.html#a5e918f55014acc144ed14fa618e6ffab
556 45 as multisoft
В зависимости от выбранного *текущего признака агента* в чеке должны быть установлены следующие параметры:
557 1 as multisoft
558 128 as multisoft
если пользователь - платёжный агент или платёжный субагент (установлены биты "AgentTag.PayAgent":http://doc.multisoft.ru/doc/MSPOS/html/a00014.html#a2116155dfaf66d98ad57fa6e59e4550b и/или "AgentTag.PaySubAgent":http://doc.multisoft.ru/doc/MSPOS/html/a00014.html#a2116155dfaf66d98ad57fa6e59e4550b)
559 1 as multisoft
"SetCommissionAgentTelNum":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a537b038aab4c42ed63107e96cd423321
560 80 as multisoft
"SetPaymentAgentTelNum":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#ad9db608d873cd7e60e936ae9fd552e2c
561 38 as multisoft
"SetContractorTelNum":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#ab93c7d4caebe3cccbe37cafe525d1dad
562 38 as multisoft
563 128 as multisoft
если пользователь - банковский платёжный агент или банковскиий платёжный субагент (установлены биты "AgentTag.BankPayAgent":http://doc.multisoft.ru/doc/MSPOS/html/a00014.html#a2116155dfaf66d98ad57fa6e59e4550b и/или "AgentTag.BankPaySubAgent":http://doc.multisoft.ru/doc/MSPOS/html/a00014.html#a2116155dfaf66d98ad57fa6e59e4550b)
564 38 as multisoft
"SetTransferOperatorName":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#abc45417de2caada0426148d08c2f01ab
565 38 as multisoft
"SetTransferOperatorTaxId":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a40533b38d11cf5703856b46cd68408a3
566 38 as multisoft
"SetTransferOperatorTelNum":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a47846d05cebe797b4c5ee59c097eb2fa
567 38 as multisoft
"SetTransferOperatorAddress":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a70a8d8ed1e4f1b1b49f6b21860f4d3df
568 1 as multisoft
"SetPaymentAgentOperation":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#ad489cb74534c3c0091eac73f8312c7a2
569 38 as multisoft
"SetPaymentAgentTelNum":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#ad9db608d873cd7e60e936ae9fd552e2c
570 1 as multisoft
"SetContractorTelNum":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#ab93c7d4caebe3cccbe37cafe525d1dad
571 1 as multisoft
572 128 as multisoft
если пользователь - поверенный, комиссионер и/или иной агент (установлен любой из бит "AgentTag.Attorney":http://doc.multisoft.ru/doc/MSPOS/html/a00014.html#a2116155dfaf66d98ad57fa6e59e4550b, "AgentTag.CommissionAgent":http://doc.multisoft.ru/doc/MSPOS/html/a00014.html#a2116155dfaf66d98ad57fa6e59e4550b, "AgentTag.Agent":http://doc.multisoft.ru/doc/MSPOS/html/a00014.html#a2116155dfaf66d98ad57fa6e59e4550b
573 1 as multisoft
"SetContractorTelNum":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#ab93c7d4caebe3cccbe37cafe525d1dad
574 128 as multisoft
575 128 as multisoft
В предмете расчёта можно устанавливать признак агента по предмету расчёта функцией "SetTagAttribute":http://doc.multisoft.ru/doc/MSPOS/html/a00034.html#a8bce3c5e91220db3f59b0f7491775393.
576 128 as multisoft
577 128 as multisoft
*Текущий признак агента (current)* добавляется в чек, если он отличен от 0.
578 128 as multisoft
При этом предмет расчёта может содержать *признак агента по предмету расчёта*.
579 128 as multisoft
Его значение должно быть подмножеством значений текущего признака агента в чеке (current), иначе ФЯ возвращает ошибку "неверный параметр".
580 128 as multisoft
Добавление признака агента по предмету расчёта осуществляется вызовом функции "SetTagAttribute":http://doc.multisoft.ru/doc/MSPOS/html/a00034.html#a8bce3c5e91220db3f59b0f7491775393 до добавления позиции, в которой данный признак необходимо установить.
581 128 as multisoft
582 1 as multisoft
583 62 as multisoft
h2. Q26:
584 62 as multisoft
585 62 as multisoft
h2. *Когда необходимо менять ФН?*
586 62 as multisoft
587 62 as multisoft
h2. A26:
588 62 as multisoft
 
589 129 as multisoft
Самый действенный способ  - периодически проверять "FNGetWarningFlags":http://doc.multisoft.ru/doc/MSPOS/html/a00031.html#a0edf8ac570a448c11ccf95d6ec6632a4
590 62 as multisoft
Если "WarningFlag":http://doc.multisoft.ru/doc/MSPOS/html/a00014.html#ad042cfb3dda00bd78f8a393ef16133b9 содержит *FNMemoryOverflow* или *UrgentCSReplace* -> пора менять.
591 62 as multisoft
Если в ответе на фискальную операцию (открытие/закрытие смены/документа) в "коллбеке об ошибке":http://doc.multisoft.ru/doc/MSPOS/IExceptionCallback.aidl возвращается "ErrCode.Hardware и ExtHardwareErr.Fatal":http://doc.multisoft.ru/doc/MSPOS/html/a00014.html#af7d268ea5021cfa159aa82b7004da530,
592 62 as multisoft
а также установлены эти флаги -> пора менять уже прямо сейчас.
593 62 as multisoft
594 62 as multisoft
h2. Q27:
595 1 as multisoft
596 1 as multisoft
h2. *Как менять ФН?*
597 62 as multisoft
598 62 as multisoft
h2. A27:
599 62 as multisoft
600 129 as multisoft
1. Закрыть смену, если была открыта
601 62 as multisoft
2. Если ккт находится в неавтономном режиме, нужно дождаться отправки всех документов в ОФД ("OFDGetQueuedMessagesCount":http://doc.multisoft.ru/doc/MSPOS/html/a00031.html#a8043b80c203d843f72cf4f29deef2050 равно нулю)
602 62 as multisoft
3. Закрыть архив ФН "CloseFiscalMode":http://doc.multisoft.ru/doc/MSPOS/html/a00031.html#af416b8ca943c669a630763d66edfa085
603 1 as multisoft
4. Если ккт в неавтономном режиме - дождаться отправки отчёта о закрытии архива в ОФД (аналогично п.2)
604 62 as multisoft
5. Вставить новый ФН.
605 62 as multisoft
6. Выполнить перерегистрацию "CorrectRegistration":http://doc.multisoft.ru/doc/MSPOS/html/a00031.html#a24fb9f4f043bd3ec5fed05cb9213db42 в связи с заменой ФН
606 65 as multisoft
607 65 as multisoft
h2. Q28:
608 65 as multisoft
609 65 as multisoft
h2. *Где посмотреть логи MSPOS-Expert? как выгрузить логи?*
610 65 as multisoft
611 65 as multisoft
h2. A28:
612 65 as multisoft
613 129 as multisoft
Откройте MSPOS-Expert, перейдите на страницу "статус", внизу нажмите кнопку "выгрузка лога".
614 65 as multisoft
Если выпадет диалог с запросом разрешений, подтвердите их.
615 65 as multisoft
После этого логи появятся в корне карты памяти в папке "mspos"
616 66 as multisoft
Далее их можно будет выгрузить, подключив устройство к ПК, либо по teamviewer (более быстрый способ).
617 71 as multisoft
618 71 as multisoft
619 71 as multisoft
h2. Q29:
620 1 as multisoft
621 71 as multisoft
h2. *Как будет происходить переход на НДС 20% в 2019 году?*
622 71 as multisoft
623 71 as multisoft
h2. A29:
624 71 as multisoft
625 129 as multisoft
Ниже при упоминании НДС 18% имеются ввиду ставки 18 и 18/118, которым соответствуют коды налогов TaxNum._18 (0) и  TaxNum._18_118(2).
626 71 as multisoft
*В соответствии с ФФД, 01.01.2019 НДС 18% должен быть заменён на НДС 20%*. При этом номера ставок не изменились.
627 71 as multisoft
Мы сделали соответствующие изменения, согласно которым индексы останутся прежними, но в чеках, открытых после 1го января 2019 года включительно,
628 71 as multisoft
сумма НДС вместо 18% будет *рассчитываться* по ставке 20%.
629 71 as multisoft
Чеки, открытые до полуночи с 31 декабря на 1е января закрываются по времени открытия, т.е. ставка в них будет 18%.
630 71 as multisoft
Печатные формы будут также соответствовать ФФД, при условии, что MSPOS-Expert обновлён.
631 71 as multisoft
*Для перехода с 18% на 20% от пользовательского ПО не требуется изменений в части общения с ФЯ*, т.к. установка ставки НДС ведётся по её индексу.
632 71 as multisoft
Рекомендуется с 1го января контролировать версию ФЯ через GetAidlVersion, чтобы пользователь обновил mspos-expert.
633 71 as multisoft
634 71 as multisoft
h2. Q30:
635 71 as multisoft
636 71 as multisoft
h2. *Как выполнить возврат с НДС 18% в 2019 году?*
637 71 as multisoft
638 71 as multisoft
h2. A30:
639 84 as multisoft
640 129 as multisoft
Ниже при упоминании ставки 18% имеется ввиду ставка НДС 18% или 18/118%.
641 84 as multisoft
До 2019 года кодам налогов TaxNum._18 (0) и  TaxNum._18_118(2) соответствуют ставки НДС 18% и 18/118%.
642 82 as multisoft
После полуночи с 31.12.2018 на 1.01.2019 этим кодами будут соответствовать ставки 20% и 20/120%.
643 82 as multisoft
Для возвратов мы расширили ставки налогов TaxNum: добавлены индексы _REFUND_18 = 6 и _REFUND_18_118 = 7.
644 83 as multisoft
Чтобы после 01.01.2019 сделать возврат со ставкой 18%, необходимо использовать коды _REFUND_18 или _REFUND_18_118.
645 82 as multisoft
Добавлена блокировка установки ставок налогов _REFUND_18 и _REFUND_18_118 в чеках Sell и Buy. Чеки коррекции можно формировать с любой доступной ставкой.
646 71 as multisoft
В сформированном чеке *сумма* налогов по ставке будет рассчитана корректно.
647 73 as multisoft
648 73 as multisoft
h2. Q31:
649 1 as multisoft
650 113 as multisoft
h2. *При закрытии чека (CloseRec) получаем ошибку errCode 1 (ErrCode.WrongArgument), extErrCode 9, message "Некорректное значение параметров команды ФН", хотя параметры заведомо корректные. В логах BadArgument. Что делать?*
651 1 as multisoft
652 73 as multisoft
h2. A31:
653 74 as multisoft
654 129 as multisoft
Согласно документации на ФН, так он сигнализирует о переполнении итогов смены. Необходимо аннулировать чек и закрыть смену.
655 111 as multisoft
656 129 as multisoft
Также имеется информация, что *ФН на 36 месяцев под СНО, рассчитанный на работу только под услуги*, отвечает *BadArgument*, если в *1212 указвыается 1 (товар)*.
657 117 as multisoft
658 111 as multisoft
h2. Q32:
659 111 as multisoft
660 112 as multisoft
h2. Как программно посмотреть системную информацию об устройстве (номер сборки, firmware version и т.д.)?
661 111 as multisoft
662 111 as multisoft
h2. A32:
663 111 as multisoft
664 129 as multisoft
Программный доступ к системной информации на сайте "SUNMI Developers":https://docs.sunmi.com/htmls/index.html?lang=en##Special%20Codes%20Description
665 111 as multisoft
Документация к встроенному сканеру лежит "здесь":https://docs.sunmi.com/htmls/index.html?lang=en##Camera%20Code%20Scanning
666 111 as multisoft
Программно "открыть App store со страницей определённого приложения":https://docs.sunmi.com/htmls/index.html?lang=en##How%20does%20the%20APP%20call%20the%20score%20box, "ещё ссылка":https://docs.sunmi.com/htmls/index.html?lang=en##Jump%20to%20the%20app%20store%20app%20details.
667 111 as multisoft
Настройка "пользовательских действий по нажатию на кнопки громкости":https://docs.sunmi.com/htmls/Volume%20keys%20custom.html.
668 114 as multisoft
669 114 as multisoft
h2. Q33
670 114 as multisoft
671 114 as multisoft
h2. Как открыть денежный ящик на MSPOS-Т-Ф?
672 114 as multisoft
673 114 as multisoft
h2. A33:
674 114 as multisoft
675 129 as multisoft
Воспользуйтесь функцией aidl "OpenDrawer":http://doc.multisoft.ru/doc/MSPOS/html/a00034.html#a887ea971d2ec2b4940bea20b835be60a (добавлена в 1.13.39)
676 114 as multisoft
677 114 as multisoft
h2. Q34
678 114 as multisoft
679 114 as multisoft
h2. Какая распиновка разъёма денежного ящика на MSPOS-Т-Ф? Куда подключать считыватель карт в MSPOS-Т-Ф ?
680 114 as multisoft
681 114 as multisoft
h2. A34:
682 114 as multisoft
683 129 as multisoft
Ответы на эти вопросы, а также полный перечень разъёмов доступны по "ссылке":https://docs.sunmi.com/htmls/index.html?lang=en##External%20USB%20Serial%20Devices