Проект

Общее

Профиль

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

as multisoft, 04.03.2019 17:42

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