Проект

Общее

Профиль

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

as multisoft, 10.07.2018 12:09

1 1 as multisoft
h1. QA Вопросы и ответы
2 1 as multisoft
3 29 as multisoft
h2. Q0:
4 29 as multisoft
5 32 as multisoft
h2. *Любые обращения по поводу конерктного устройства/ККТ. Вопросы по переводу устройств между ТК и ОК, а также между субаккаунтами внутри ТК и ОК.*
6 29 as multisoft
7 29 as multisoft
h2. A0:
8 29 as multisoft
9 29 as multisoft
 При обращении по любым вопросам, которые касаются конкретного устройства, в чаты ТП и разработки
10 29 as multisoft
нужно указывать *SN* устройства (см. наклейку со штрих-кодами на обратной стороне аппарата).
11 30 as multisoft
Если вопрос связан с переводом устройства в тестовый контур или обратно в основной,
12 1 as multisoft
*нужно прикладывать фото задней части устройства либо скриншот первой страницы mspos-expert %{color:red}с читаемым SN%*.
13 33 as multisoft
Перенос устройств между ТК и ОК, а также между их субаккаунтами осуществляется только после подтверждения права собственности на устройство.
14 1 as multisoft
15 30 as multisoft
{{collapse(где найти SN)
16 30 as multisoft
!1.png!
17 30 as multisoft
}} 
18 30 as multisoft
19 34 as multisoft
 Фото не обязательно, если девайс уже привязан к Вашему личному кабинету. Предоставление фото позволяет избежать ошибок при переводе.
20 30 as multisoft
21 30 as multisoft
{{collapse(Так делать не надо)
22 30 as multisoft
!2.png!
23 34 as multisoft
}}
24 29 as multisoft
25 2 as multisoft
h2. Q1:
26 1 as multisoft
27 2 as multisoft
h2. *Как добавить IFiscalCore.aidl в Android Studio?*
28 2 as multisoft
29 2 as multisoft
h2. A1:
30 2 as multisoft
31 21 as multisoft
 0. Скачать IFiscalCore.aidl, IAuth.aidl, IExceptionCallback.aidl с "сервера":http://doc.multisoft.ru/doc/MSPOS/
32 1 as multisoft
1. В корневой папке проекта создать папку aidl
33 1 as multisoft
2. Внутри папки aidl создать папку с именем, соответствуюим package (com.multisoft.drivers.fiscalcore).
34 1 as multisoft
3. Правый клик по папке с именем package -> New -> AIDL -> AIDL File
35 1 as multisoft
4. Во всплывающем окне ввести имя интерфейса (например, IFiscalCore). Подтвердить выбор.
36 1 as multisoft
5. Скопировать содержимое скачанного файла в текстовом виде в созданный без(!) замены файлов.
37 1 as multisoft
6. Повторить операции 3-5 для IAuth.aidl и IExceptionCallback.aidl
38 1 as multisoft
39 2 as multisoft
h2. Q2:
40 1 as multisoft
41 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 "?"%*
42 2 as multisoft
43 2 as multisoft
h2. A2:
44 2 as multisoft
45 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.
46 1 as multisoft
Выполните инструкции, описанные в Q1.
47 1 as multisoft
48 2 as multisoft
h2. Q3:
49 1 as multisoft
50 2 as multisoft
h2. *Как зарегистрироваться в программе Sunmi Partners?*
51 2 as multisoft
52 2 as multisoft
h2. A3:
53 2 as multisoft
54 1 as multisoft
 После подписания партнёрского соглашения на указанную в нём почту придёт приглашение на регистрацию в Sunmi Partners.
55 1 as multisoft
Откройте присланную ссылку в "Google Chrome":https://www.google.ru/chrome/browser/desktop/index.html. Рекомендуется использовать его и в дальнейшем для любых действий в личном кабинете.
56 1 as multisoft
Первая загрузка сайта может занять некоторое время, подождите полной загрузки и не обновляйте страницу, пока она не будет полностью загружена.
57 1 as multisoft
Если страница загрузилась, но открывается пустой список для выбора страны и/или кода телефона - очистите кеш браузера и обновите страницу.
58 1 as multisoft
Не обновляйте страницу повторно, пока она не загрузится полностью.
59 1 as multisoft
60 36 as multisoft
 После регистрации нужно добавить фискальное ядро в свой магазин. 
61 36 as multisoft
Для этого зайдите в личный кабинет на вкладку App Store -> App List,
62 36 as multisoft
найдите MSPOS-Expert справа в "No apps added" и добавьте его в "Apps Selected",
63 36 as multisoft
выделив его галку и нажав кнопку "Added apps".
64 36 as multisoft
Также рекомендуем добавить TeamViewerQS и TeamViewerQS —APPX.
65 37 as multisoft
В дальнейшем *не удаляйте MSPOS-Expert из магазина*.
66 36 as multisoft
67 2 as multisoft
h2. Q4:
68 1 as multisoft
69 2 as multisoft
h2. *Как подготовить устройство MSPOS-K к отладке?*
70 2 as multisoft
71 2 as multisoft
h2. A4:
72 2 as multisoft
73 1 as multisoft
 В тестовом контуре возможность отладки автоматически включена для всех устройств, привязанных к тестовому аккаунту.
74 1 as multisoft
На своём устройстве в "Настройки"->"Безопасность" разрешите установку приложений из неизвестных источников.
75 1 as multisoft
76 9 as multisoft
 Сообщите серийный номер устройств(а) (SN) сотрудникам Multisoft/Альфа-Проект, которые занимаются интеграцией.
77 1 as multisoft
Они привяжут его к вашему аккаунту по завершении регистрации в Sunmi Partners.
78 7 as multisoft
79 7 as multisoft
 Для упрощения *разработки в ТК* в Вашем личном кабинете *device configuration* -> *common* -> *debugger access control* должен быть *выключен*.
80 7 as multisoft
В этом случае способ, описанный "здесь":https://docs.sunmi.com/htmls/index.html?lang=en##Debug%20device , не имеет смысла и его не нужно использовать.
81 7 as multisoft
82 7 as multisoft
 Подключите устройство к сети WiFi с открытым доступом и интернет.
83 1 as multisoft
Подключите включенное устройство по USB к компьютеру с установленным Android SDK.
84 7 as multisoft
Дождитесь установки драйверов (если используется Windows) и появления уведомления "Отладка по USB разрешена" на устройстве
85 7 as multisoft
В %AndroidSDKInstallDir%\android-sdk\platform-tools\ выполните "adb devices" из консоли,
86 7 as multisoft
на экран должны будут выведены серийный номер аппарата и *device*, что означает, устройство готово к отладке.
87 1 as multisoft
Если эта команда показывает "unauthorized", проверьте подключение к интернет и перезагрузите аппарат.
88 7 as multisoft
89 8 as multisoft
 Если после перезагрузки adb devices всё равно возвращает unauthorized, либо при отладке возникают ошибки доступа,
90 8 as multisoft
попробуйте включить режим разработчика вручную стандартным для android устройств способом:
91 8 as multisoft
многократными тапами по Build.Number (Номер сборки) в меню "о телефоне".
92 27 as multisoft
Также попробуйте отключить (если была включена) и включить снова опцию "Отладка по USB" в меню "Для разработчиков".
93 2 as multisoft
94 1 as multisoft
h2. Q5:
95 2 as multisoft
96 2 as multisoft
h2. *Что делать с Company Registration Certification при регистрации аккаунта в sunmi partners?*
97 2 as multisoft
98 2 as multisoft
h2. A5:
99 1 as multisoft
100 1 as multisoft
 Прикрепите пустую картинку. Эта опция нужна китайским компаниям.
101 2 as multisoft
102 1 as multisoft
h2. Q6:
103 2 as multisoft
104 2 as multisoft
h2. *Как загрузить приложеине в магазин Sunmi?*
105 2 as multisoft
106 2 as multisoft
h2. A6:
107 1 as multisoft
108 26 as multisoft
 Воспользуйтесь "инструкцией по загрузке":http://77.243.109.96:8881/redmine/projects/mspos-k/wiki/AddAppSunmi
109 26 as multisoft
При загрузке укажите правильные модели(Terminals): *приложение будет доступно только на указанных моделях*.
110 26 as multisoft
Поле *price* выставлять в соответствии с партнёрским соглашением.
111 26 as multisoft
После загрузки каждой версии в магазин требуется около 1 рабочего дня на автоматический аудит.
112 1 as multisoft
Если приложение было загружено в магазин в режиме пре-релиза (gray release), аудит выполняется при первой загрузке.
113 1 as multisoft
Изменение списка устройств для пре-релиза (в т.ч. применение пре-релизана все устройства - change to official version) не сопровождается аудитом.
114 1 as multisoft
Изменение атрибутов приложения, таких как скриншоты, описание, поддерживаемые модели и др. вызывает повторный аудит при применении этих свойств (кнопка Save внизу).
115 26 as multisoft
116 26 as multisoft
 Для *обновления* приложения в магазине мы подготовили "другую инструкцию":http://77.243.109.96:8881/redmine/projects/mspos-k/wiki/UpdAppSunmi
117 2 as multisoft
118 1 as multisoft
h2. Q7:
119 3 as multisoft
120 2 as multisoft
h2. *Что нужно знать о регистрации фискального накопителя (ФН)?*
121 2 as multisoft
122 1 as multisoft
h2. A7: 
123 3 as multisoft
124 3 as multisoft
 Процедура регистрации выполняется один раз за время жизни ФН.
125 3 as multisoft
Регистрация ФН - часть процесса включения фискального режима работы ККТ.
126 3 as multisoft
Пока ККТ не зарегистрирована с ФН, она находится в учебном режиме. Об этом свидетельствует надпись * *учебный режим* * в начале чеков.
127 11 as multisoft
После регистрации ФН ККТ в процессе работы печатает *фискальные* документы, за исключением нефискальных документов (RecType.Unfiscal),
128 11 as multisoft
документов внесения/изъятия (RecType.PayIn/PayOut) и X-отчётов (PrintXReport).
129 1 as multisoft
Если ККТ зарегистрирована в неавтономном режиме (отсутствует флаг OperatingMode.Autonomous),
130 11 as multisoft
фискальные документы будут отправляться в ОФД по настроенному каналу связи (валидный сервер и порт ОФД,
131 11 as multisoft
выход в интернет по Wifi или через мобильную сеть).
132 1 as multisoft
133 3 as multisoft
 Для регистрации фискального накопителя(ФН) нужно следующее:
134 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).
135 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)
136 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)
137 1 as multisoft
после этого можно начинать процедуру регстрации.
138 2 as multisoft
139 1 as multisoft
h2. Q8:
140 3 as multisoft
141 2 as multisoft
h2. *Как зарегистрировать ФН / включить фискальный режим ККТ?*
142 2 as multisoft
143 2 as multisoft
h2. A8:
144 1 as multisoft
145 1 as multisoft
 Процедура регистрации, в зависимости от желаемых параметров регистрации, может отличаться.
146 1 as multisoft
Основные операции при регистрации:
147 1 as multisoft
1) установка опций: см. блок "Запрос и установка параметров"
148 28 as multisoft
2) сохранение опций (см. "SaveOptions":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a8bf297561df86b0c5e62b8b0adcf670e )
149 28 as multisoft
3) регистрация (см. "Register":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a278fd49eca702ca03b239f65f098a245 ).
150 1 as multisoft
151 1 as multisoft
 при каждой регистрации %{color:red}обязательными% для установки на шаге 1 являются:
152 28 as multisoft
"SetOrgName":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#ad771825ea775e76666cc09772279767a
153 28 as multisoft
"SetOrgAddress":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#ac6650f56de207c2664b8a16f3b63fd32
154 1 as multisoft
"SetPhysicalAddress":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#ae09721153004af1fcd47c8dd900666c6
155 1 as multisoft
"SetSenderEmail":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a47a8880a2cdec8dff31067adc172d161
156 1 as multisoft
"SetFnsServerAddress":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#ac35b9fefb435f5ade6d337e174fe6190
157 1 as multisoft
158 35 as multisoft
 Если при регистрации в битовом поле "режим работы" (op_mode) %{color:red}не% установлен бит "OperatingMode.Autonomous":http://doc.multisoft.ru/doc/MSPOS/html/a00014.html#af79f7ba66a9ad6fe8763a6f58952a5d2a6aec1991f208e2948db5e4eee6e1ccff (0x02), %{color:red}обязательными на шаге 1 также являются%:
159 35 as multisoft
"SetOfdHost":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#ab616fe44a2bade57e5f11010e277bf11
160 35 as multisoft
"SetOfdPort":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a3cd2cb3aac6f6a36989aa099e3ca7a2e
161 35 as multisoft
"SetOfdName":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a8f1fb2f7c7eb90a984c5d8fb5bc223bb
162 35 as multisoft
"SetOfdTaxId":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a31a1421e3bd6418411e1602765d13b9d
163 35 as multisoft
164 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 должен быть установлен номер автомата%:
165 35 as multisoft
"SetVendingSerial":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a9f854e01cb5b4f40a1b97b2f19c41cae
166 35 as multisoft
167 35 as multisoft
 В зависимости от того, является ли пользователь платёжным агентом (параметр agent в функции Register отличен от 0), %{color:red}на шаге 1 должны быть установлены следующие опции%:
168 28 as multisoft
"SetTransferOperatorName":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#abc45417de2caada0426148d08c2f01ab
169 28 as multisoft
"SetTransferOperatorTaxId":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a40533b38d11cf5703856b46cd68408a3
170 28 as multisoft
"SetTransferOperatorTelNum":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a47846d05cebe797b4c5ee59c097eb2fa
171 28 as multisoft
"SetTransferOperatorAddress":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a70a8d8ed1e4f1b1b49f6b21860f4d3df
172 28 as multisoft
"SetPaymentAgentTelNum":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#ad9db608d873cd7e60e936ae9fd552e2c
173 28 as multisoft
"SetPaymentAgentOperation":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#ad489cb74534c3c0091eac73f8312c7a2
174 1 as multisoft
"SetCommissionAgentTelNum":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a537b038aab4c42ed63107e96cd423321
175 28 as multisoft
"SetContractorTelNum":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#ab93c7d4caebe3cccbe37cafe525d1dad
176 28 as multisoft
177 2 as multisoft
178 1 as multisoft
h2. Q9:
179 2 as multisoft
180 2 as multisoft
h2. *Какие особенности работы с несколькими СНО?*
181 2 as multisoft
182 2 as multisoft
h2. A9: 
183 1 as multisoft
184 5 as multisoft
 Пользователь может иметь несколько систем налогообложения (СНО).
185 28 as multisoft
Если пользователь зарегистрировал кассу с несколькими СНО, то перед каждым открытием документа ("OpenRec":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a0652bf6ebf8d2e3147bf45905daa1f1e )
186 28 as multisoft
должна быть вызвана функция "SetTaxationUsing":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#ab2f0202725597f348727647d33eedaf4 , в параметрах которой передаётся одна из зарегистрированных СНО.
187 2 as multisoft
188 1 as multisoft
h2. Q10:
189 2 as multisoft
190 2 as multisoft
h2. *Для чего нужна перерегистрация?*
191 2 as multisoft
192 2 as multisoft
h2. A10: 
193 1 as multisoft
194 12 as multisoft
 Если параметры кассы и/или реквизитов пользователя изменились, об этом нужно уведомить Федеральную налоговую службу (ФНС)
195 12 as multisoft
посредством отправки оператору фискальных данных (ОФД) отчёта о перерегистрации в электронной форме.
196 28 as multisoft
Отчёт о перерегистрации формируется функцией "CorrectRegistration":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a24fb9f4f043bd3ec5fed05cb9213db42.
197 28 as multisoft
Её параметры аналогичны функции "Register":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a278fd49eca702ca03b239f65f098a245, но нужно установить дополнительный - причину перерегистрации.
198 1 as multisoft
Причин перерегистрации может быть 4: замена ФН, смена ОФД, смена реквизитов пользователя и смена настроек ККТ.
199 2 as multisoft
200 2 as multisoft
h2. Q11:
201 2 as multisoft
202 2 as multisoft
h2. *Как выполнить перерегистрацию?*
203 2 as multisoft
204 1 as multisoft
h2. A11:
205 1 as multisoft
 
206 1 as multisoft
 Выполняется аналогично регистрации:
207 28 as multisoft
0) убедиться, что в очереди на отправку в ОФД нет документов ("OFDGetFirstQueuedDocNumber":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a973998cafa852d49f1dfa351f336d069 == 0), иначе перерегистрация не будет выполнена.
208 1 as multisoft
1) установка опций, которые необходимо изменить, в связи с причиной перерегистрации: см. блок "Запрос и установка параметров"
209 28 as multisoft
2) сохранение опций (см. "SaveOptions":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a8bf297561df86b0c5e62b8b0adcf670e )
210 28 as multisoft
3) перерегистрация(см. "CorrectRegistration":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a24fb9f4f043bd3ec5fed05cb9213db42 ).
211 1 as multisoft
 
212 1 as multisoft
 В связи с ограничениями ФН %{color:red}нельзя выполнить 1 перерегистрацию с несколькими причинами одновременно%.
213 13 as multisoft
Например, нельзя поменять настройки ОФД и реквизиты пользователя одновременно,
214 13 as multisoft
нужно выполнить последовательно 2 перерегистрации в связи с этими причинами, выполняя шаги 1-3.
215 1 as multisoft
При этом устанавливаются и сохраняются только те параметры, которые соответствуют причине данной перерегистрации (при условии, что все остальные присутствуют).
216 2 as multisoft
217 1 as multisoft
h2. Q12:
218 6 as multisoft
219 2 as multisoft
h2. *Как напечатать чек?/ Как сформировать фискальный документ? / Как сформировать нефискальный документ?*
220 2 as multisoft
221 1 as multisoft
h2. A12:
222 6 as multisoft
223 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.
224 28 as multisoft
Пока документ не закрыт, его можно отменить функцией "RecVoid":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a5654f1a1b77435e97bf8e788df271873
225 6 as multisoft
226 6 as multisoft
 *Если ФН зарегистрирован с несколькими системами налогообложения (СНО),
227 6 as multisoft
перед открытием фискального документа с типом Sell/SellRefund/Buy/BuyRefund, либо чека коррекции,
228 28 as multisoft
необходимо из зарегистрированных СНО выбрать одну и установить её* функцией "SetTaxationUsing":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#ab2f0202725597f348727647d33eedaf4.
229 6 as multisoft
Настраивать СНО не обязательно для каждого документа.
230 28 as multisoft
Установленная после соединения с ядром СНО действует до следующей выгрузки ядра из оперативной памяти либо до следующей вызванной "SetTaxationUsing":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#ab2f0202725597f348727647d33eedaf4.
231 6 as multisoft
232 6 as multisoft
 Наполнение *нефискального документа (RecType.Unfiscal)* выполняется командами печати:
233 28 as multisoft
"PrintLine":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#afd8854e97d653a91a41735c7750447a9, 
234 28 as multisoft
"PrintQRCode":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a8d298288c9d1497dfee2151155749185
235 28 as multisoft
"PrintBarCode":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#ae19113179a5ddc1b386c1a71dc089dca
236 6 as multisoft
Наполнение *фискальных документов с типом Sell/SellRefund/Buy/BuyRefund, а также нефискальных с типом PayIn/PayOut* выполняется командами:
237 28 as multisoft
"PrintRecItem":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a33a66c34f73f25247d84a51623516d55 - добавление позиции, можно вызывать сколь угодно много раз.
238 28 as multisoft
"PrintRecTotal":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#addeeaada4bbd7913f57030efba8662fe - подведение итога. разрешено вызывать не более 1 раза на документ. После итога добавление позиций запрещено, можно вызывать только команды оплаты:
239 28 as multisoft
"PrintRecItemPay":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a7ca2d5fc505ce74e47ffe6ff77f6ec70 - добавление оплаты, можно вызывать сколь угодно много раз, рекомендуется не более 6 раз на документ (с учётом сдачи).
240 6 as multisoft
Только *для Sell/SellRefund/Buy/BuyRefund*:
241 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.
242 6 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. 
243 28 as multisoft
Наполнение *чека коррекции* происходит единственной командой "FNMakeCorrectionRec":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a4f682ac24587eb357468ab574fa5c7f5, повтор которой недопустим.
244 6 as multisoft
245 6 as multisoft
246 6 as multisoft
h2. Q13:
247 6 as multisoft
248 6 as multisoft
h2. *Как передать телефон или электронный адрес покупателя (тег 1008)?*
249 6 as multisoft
250 6 as multisoft
h2. A13:
251 2 as multisoft
252 28 as multisoft
 Для передачи этого тега необходимо использовать функцию "SendClientAddress":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a5672fc24a0e68cf06e13a8e73698cb12
253 2 as multisoft
Она выполняется один раз на весь документ в любой момент после открытия и до закрытия. %{color:red}Повторная передача ведёт к нарушению ФФД%.
254 1 as multisoft
Установка одновременно электронного адреса и телефона покупателя не предусмотрена ФФД 1.05 от 21.03.2017.
255 1 as multisoft
Точно так же покупатель не может иметь нескольких телефонов и/или email одновременно.
256 6 as multisoft
257 1 as multisoft
h2. Q14:
258 6 as multisoft
259 28 as multisoft
h2. *В каком формате передавать телефон или электронный адрес покупателя (тег 1008) в функции "SendClientAddress":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a5672fc24a0e68cf06e13a8e73698cb12 ?*
260 6 as multisoft
261 1 as multisoft
h2. A14:
262 2 as multisoft
263 1 as multisoft
 Телефон или электронный адрес покупатеся следует передавать в соответствии с ФФД 1.05 от 21.03.2017 Таблица 5, тег 1008:
264 2 as multisoft
Формат: %{color:red}+{Ц}% или %{color:red}{С}@{C}%,
265 2 as multisoft
где Ц - "атрибут, обозначающий, что данные реквизита должны быть представлены в виде цифры",
266 1 as multisoft
С- "атрибут, обозначающий, что данные реквизита должны быть представлены в виде символа".
267 2 as multisoft
Символы и цифры должны быть представлены в электронной форме %{color:red}"в соответствии с кодовой таблицей CP866"%.
268 6 as multisoft
269 1 as multisoft
h2. Q15:
270 1 as multisoft
271 1 as multisoft
h2. *Как изменить параметры автоинкассации при закрытии смены?*
272 6 as multisoft
273 1 as multisoft
h2. A15:
274 2 as multisoft
275 28 as multisoft
 Включение или отключение автоинкассации выполняется функцией "SetDayCloseAutoPayOut":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a7412c0fe3ae61fc5a2d54d850e8d0c97
276 28 as multisoft
Если необходимо сохранить значение параметра для применения его во всех следующих функциях закрытия смены ("CloseDay":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a45709f692bbe83ec0852e0569b512a01 ),
277 28 as multisoft
в т.ч. после перезагрузки, нужно сохранить опции ("SaveOptions":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a8bf297561df86b0c5e62b8b0adcf670e ).
278 6 as multisoft
279 2 as multisoft
h2. Q16, Q17:
280 1 as multisoft
281 28 as multisoft
h2. *Какие типы документа доступны для чека коррекции в аргументе "opertation" функции "FNMakeCorrectionRec":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a4f682ac24587eb357468ab574fa5c7f5 ?*
282 2 as multisoft
283 28 as multisoft
h2. *Почему в чеке коррекции не работает "RecType.SellRefund":http://doc.multisoft.ru/doc/MSPOS/html/namespacecom_1_1multisoft_1_1drivers_1_1fiscalcore.html#a14260733ecd53b5cbb33930937cbb52e и "RecType.BuyRefund":http://doc.multisoft.ru/doc/MSPOS/html/namespacecom_1_1multisoft_1_1drivers_1_1fiscalcore.html#a14260733ecd53b5cbb33930937cbb52e )?*
284 6 as multisoft
285 1 as multisoft
h2. A16, A17:
286 1 as multisoft
287 15 as multisoft
  В соответствии с ФФД 1.05 от 21.03.2017 Таблица 25 "Реквизит «Признак расчета» (тег 1054) для кассового чека коррекции (БСО коррекции)
288 15 as multisoft
может принимать одно из следующих значений: «1» – приход, «3» – расход."
289 1 as multisoft
Поэтому чек коррекции на возврат прихода и возват расхода возвращает ошибку.
290 6 as multisoft
291 1 as multisoft
h2. Q18:
292 1 as multisoft
293 1 as multisoft
h2. *Как передать признак предмета расчета и признак способа расчета (теги 1212 и 1214)?*
294 6 as multisoft
295 1 as multisoft
h2. A18:
296 1 as multisoft
297 28 as multisoft
 Для передачи свободных тегов используется функция "SetTagAttribute":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a8bce3c5e91220db3f59b0f7491775393 (начиная с 1.8.28).
298 28 as multisoft
Её нужно вызывать перед добавлением позиции ("PrintRecitem":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a33a66c34f73f25247d84a51623516d55 ), в которой необходимо установить соответствующий тег.
299 6 as multisoft
300 1 as multisoft
h2. Q19:
301 1 as multisoft
302 1 as multisoft
h2. *Какие значения передать при установке тегов 1212 и 1214?*
303 6 as multisoft
304 3 as multisoft
h2. A19:
305 3 as multisoft
306 3 as multisoft
 Значения реквизита «признак способа расчета» (тег 1214) в соответствии с ФФД 1.05 от 21.03.2017 Таблица 28:
307 3 as multisoft
308 4 as multisoft
 |1|ПРЕДОПЛАТА 100%|
309 3 as multisoft
 |2|ПРЕДОПЛАТА|
310 1 as multisoft
 |3|АВАНС|
311 3 as multisoft
 |4|ПОЛНЫЙ РАСЧЕТ|
312 5 as multisoft
 |5|ЧАСТИЧНЫЙ РАСЧЕТ И КРЕДИТ|
313 5 as multisoft
 |6|ПЕРЕДАЧА В КРЕДИТ|
314 4 as multisoft
 |7|ОПЛАТА КРЕДИТА|
315 5 as multisoft
316 5 as multisoft
 Значения реквизита «признак предмета расчета» (тег 1212) в соответствии с ФФД 1.05 от 21.03.2017 Таблица 29:
317 5 as multisoft
318 1 as multisoft
 |1|ТОВАР|
319 4 as multisoft
 |2|ПОДАКЦИЗНЫЙ ТОВАР|
320 4 as multisoft
 |3|РАБОТА|
321 1 as multisoft
 |4|УСЛУГА|
322 1 as multisoft
 |5|СТАВКА АЗАРТНОЙ ИГРЫ|
323 3 as multisoft
 |6|ВЫИГРЫШ АЗАРТНОЙ ИГРЫ|
324 4 as multisoft
 |7|ЛОТЕРЕЙНЫЙ БИЛЕТ|
325 1 as multisoft
 |8|ВЫИГРЫШ ЛОТЕРЕИ|
326 5 as multisoft
 |9|ПРЕДОСТАВЛЕНИЕ РИД|
327 5 as multisoft
 |10|ПЛАТЕЖ|
328 4 as multisoft
 |11|АГЕНТСКОЕ ВОЗНАГРАЖДЕНИЕ|
329 4 as multisoft
 |12|СОСТАВНОЙ ПРЕДМЕТ РАСЧЕТА|
330 3 as multisoft
 |13|ИНОЙ ПРЕДМЕТ РАСЧЕТА|
331 1 as multisoft
332 1 as multisoft
h2. Q20:
333 4 as multisoft
334 1 as multisoft
h2. *Как пробить сдачу?*
335 3 as multisoft
336 1 as multisoft
h2. A20:
337 4 as multisoft
338 1 as multisoft
 Сначала пробейте оплату наличными, сумму, которую передал клиент, например, 100р.
339 4 as multisoft
<pre><code class="cpp">
340 4 as multisoft
IFiscalCore.PrintRecItemPay((int)PayType.Cash, "100.00", "ПРИНЯТО ОТ КЛИЕНТА НАЛИЧНЫМИ:",callback);
341 4 as multisoft
</code></pre>
342 28 as multisoft
 После этого выполните вызов "PrintRecItemPay":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a7ca2d5fc505ce74e47ffe6ff77f6ec70 с параметрами PayType.Cash, в total передайте сумму со знаком "минус".
343 10 as multisoft
Например, сдача в 15 рублей 1 копейку оформляется вызовом:
344 3 as multisoft
<pre><code class="cpp">
345 3 as multisoft
IFiscalCore.PrintRecItemPay((int)PayType.Cash, "-15.01", "СДАЧА:",callback);
346 4 as multisoft
</code></pre>
347 5 as multisoft
В предыдущих двух командах параметр itemText может быть любым.
348 4 as multisoft
В результате после закрытия документ, если "принято" - "сдача" == сумме стоимости всех позиций по документу, на чеке появится 2 последовательные надписи:
349 4 as multisoft
 "ПРИНЯТО ОТ КЛИЕНТА НАЛИЧНЫМИ:  100.00"
350 4 as multisoft
 "СДАЧА:                          15.01"
351 4 as multisoft
и ниже, в соответствии с ФФД:
352 1 as multisoft
 "НАЛИЧНЫМИ                       84.99"
353 17 as multisoft
354 17 as multisoft
355 17 as multisoft
h2. Q21:
356 17 as multisoft
357 17 as multisoft
h2. *Как работать по старому законотадельству в режиме ЧПМ ?*
358 17 as multisoft
359 17 as multisoft
h2. A21:
360 17 as multisoft
361 17 as multisoft
 Если клиент по закону имеет право пользоваться ЧПМ, переход в режим ЧПМ осуществляется при соблюдении следующих условий:
362 17 as multisoft
1. ККТ не зарегистрирована
363 17 as multisoft
2. К ККТ не подключен (зарегистрированный) ФН
364 17 as multisoft
3. ПО умеет работать в режиме ЧПМ без обращений к ФН.
365 28 as multisoft
4. ПО умеет определять текущий режим работы через вызов функции "DirectIO":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#ad332340d4b162fd5a0fd9a56a364a457
366 17 as multisoft
367 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
368 28 as multisoft
Численные значения перечислений лежат в начале "страницы":http://doc.multisoft.ru/doc/MSPOS/html/namespacecom_1_1multisoft_1_1drivers_1_1fiscalcore.html
369 17 as multisoft
370 17 as multisoft
 Запрос текущего режима работы ККТ (Mode) выполняется следующим образом:
371 28 as multisoft
1. Создаётся экземпляр "IAuth":http://doc.multisoft.ru/doc/MSPOS/IAuth.aidl, который реализует все функции интерфейса.
372 28 as multisoft
2. Создаётся экземпляр "IExceptionCallback":http://doc.multisoft.ru/doc/MSPOS/IExceptionCallback.aidl по аналогии с любым другим коллбеком об ошибке
373 28 as multisoft
3. Выполняется команда DirectIO с параметрами "DirectIOCmd.GetMode":http://doc.multisoft.ru/doc/MSPOS/html/namespacecom_1_1multisoft_1_1drivers_1_1fiscalcore.html#aa03c06b35cfd3f44c06206014cb9d40c,
374 18 as multisoft
в качестве второго параметра необходимо передать идентификатор пользовательского ПО, либо package приложения, из которого функция вызвыается.
375 17 as multisoft
4.1 Если команда выполнена успешно, ядро вызовет auth.Result(currentMode) с параметром currentMode, равном текущему режиму работы ККТ (Mode).
376 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, определяя текущий режим работы.
377 28 as multisoft
5.1 Если команда завершилась с ошибкой, коллбек об ошибке передаётся стандартно, через "IExceptionCallback":http://doc.multisoft.ru/doc/MSPOS/IExceptionCallback.aidl
378 17 as multisoft
379 17 as multisoft
380 17 as multisoft
 Переход в режим ЧПМ осуществляется через программный вызов DirectIO при выполнении условий 1-3 аналогично запросу текущего режима работы ККТ (Mode).
381 28 as multisoft
В качестве первого параметра необходимо использовать константу "DirectIOCmd.ChangeMode":http://doc.multisoft.ru/doc/MSPOS/html/namespacecom_1_1multisoft_1_1drivers_1_1fiscalcore.html#aa03c06b35cfd3f44c06206014cb9d40c
382 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
383 17 as multisoft
384 17 as multisoft
h2. Q22:
385 17 as multisoft
386 17 as multisoft
h2. *Какие особенности у режима ЧПМ ?*
387 17 as multisoft
388 17 as multisoft
h2. A22:
389 17 as multisoft
390 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.
391 19 as multisoft
 
392 22 as multisoft
 Функции, начинающиеся с *FN, OFD, FDI, QueryOFD, OfdOut, QueryFiscal* созданы для работы в режиме ОФД,
393 22 as multisoft
обращаются к ФН и будут возвращать указанную выше ошибку в режиме ЧПМ.
394 19 as multisoft
В любой момент из режима ЧПМ можно перейти обратно в режим ОФД с потерей всех счётчиков и состояний по вызову команды DirectIO с параметрами для смены режима работы.
395 19 as multisoft
396 19 as multisoft
 Для корректной работы устройства в режиме ЧПМ его необходимо зарегистрировать.
397 19 as multisoft
Перед регистрацией необходимо установить и сохранить следующие опции:
398 28 as multisoft
"SetOrgName":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#ad771825ea775e76666cc09772279767a
399 28 as multisoft
"SetOrgAddress":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#ac6650f56de207c2664b8a16f3b63fd32
400 28 as multisoft
Регистрация выполняется стандартной функцией "Register":http://doc.multisoft.ru/doc/MSPOS/html/interface_i_fiscal_core.html#a278fd49eca702ca03b239f65f098a245
401 19 as multisoft
В качестве параметров необходимо передать: reg_num, равный "00000", а также корректный ИНН и имя кассира. Остальные параметры не влияют на результат выполнения.
402 23 as multisoft
403 23 as multisoft
h2. Q23:
404 23 as multisoft
405 25 as multisoft
h2. *Как проверить, к какому магазину привязано устройство?*
406 23 as multisoft
407 23 as multisoft
h2. A23:
408 23 as multisoft
409 23 as multisoft
 Откройте App Store или Магазин приложений. Нажмите иконку пользователя справа вверху.
410 23 as multisoft
Открывшееся меню прокрутите вниз.
411 23 as multisoft
В поле "Service provider" или "поставщик услуг" показывается текущий магазин, к которому привязано устройство. По умолчанию это Multisoft.
412 23 as multisoft
413 23 as multisoft
h2. Q24:
414 23 as multisoft
415 23 as multisoft
h2. *На устройстве не применяются настройки магазина, что делать?*
416 23 as multisoft
417 23 as multisoft
h2. A24:
418 23 as multisoft
419 23 as multisoft
 Проверьте A23 ^. Если наименование магазина соответствует ожидаемому, убедитесь, что устройство подключено по Wifi к интернет,
420 23 as multisoft
и выполните перезагрузку. Допускается подключение через сеть sim-карты с доступом в интернет, но предпочтительнее пользоваться Wifi.
421 24 as multisoft
Если перезагрузка не помогла, зайдите в *POS Steward -> network -> network test -> start testing*.
422 23 as multisoft
Тест пройден успешно, если все три галочки - зелёные.
423 23 as multisoft
Если хотя бы одна из них красная, рекомендуется подключиться к другой Wifi сети, где тест пройдёт успешно,
424 23 as multisoft
т.к. корректное применение всех параметров магазина гарантируется только при полностью исправном соединении с интернет.