Штрих-М: Документация

Эта страница только для чтения. Вы можете посмотреть её исходный текст, но не можете его изменить. Сообщите администратору, если считаете, что это неправильно.
======Сервис TaxFree (Global Blue IC2 INTEGRA Web)======
Функционал в Кассир 5:\\
  - выпуск форм TaxFree;
  - повторная печать форм TaxFree;
  - аннулирование форм TaxFree.

=====Настройка=====
====Перед началом работы====
Разархивировать модуль логики "БД Кассир5\ExtFiles\LogicalModules\GlobalBlueIC2.zip".\\

====Основные====
Настройки работы с сервисом выполняются в настройках Кассир 5, на закладке "Модули логики"-"GBIC2".\\
1. При первоначальной настройке нужно нажать кнопку "Установить компоненту для работы с сервисом".\\
2. Для включения модуля TaxFree "Global Blue" нужно **снять** флаг **Отключить модуль**\\
3. Если загружен модуль TaxFree "Planet PI", то на закладке "PPI" нужно **установить** флаг **Отключить модуль**.\\
===Настройки для подключения к сервису===
Параметры для работы с сервисом предоставляет GlobalBlue при регистрации магазина в системе.\\
**Логин**\\
**Пароль**\\
**API URL**, **UI URL**:\\
Тестовое подключение:\\
API URL: https://ic2integra-api.mspe.globalblue.com\\
UI URL: https://ic2integra-web.mspe.globalblue.com/ui\\
Промышленное подключение:\\
API URL: https://ic2integrawag.globalblue.com\\
UI URL: https://ic2integra.globalblue.com/ui\\
**ИД отправителя** - отвечает за идентификацию отправителя запросов в сервисе. Обязательный.
**ИД магазина** - идентификатор магазина.\\
**ИД рабочего места** - идентификатор рабочего места.\\
\\
**Таймаут запросов** - определяет время ожидания ответа при работе с сервисом. Измеряется в секундах.\\
\\
Параметры **ИД магазина** и **ИД рабочего места** являются необязательными ((чтобы создались документы в ТП7 поля нужно заполнить)), но если заполнен один - другой тоже должен быть заполнен.\\

===Настройки ограничений===
Для настройки ограничений при оформлении формы TaxFree нужно нажать кнопку **Открыть настройку ограничений**.\\
**Минимальная общая сумма покупки** - отвечает за минимальную сумму покупки в рублях, которую необходимо преодолеть для возможности начала оформления ваучера TaxFree. По умолчанию 10000.\\
Таблица **Список запрещенных к исп. сервиса субъектов**  - определяет перечень запрещенных к использованию сервиса стран. После чтения паспорта туриста, система не даст начать оформлять ваучер TaxFree, если страна выдачи паспорта попадает в этот список.\\
В эту таблицу можно добавлять строки вручную (иконка с плюсом над таблицей) или переносом из левой таблицы. Для последнего, выделите переносимую строку в левой таблице и нажмите на кнопку ">>" между таблицами для её переноса.\\
**Выбор принтера** - для печати форм TaxFree нужен настроенный принтер.\\
а) Если необходимый принтер является принтером по умолчанию, ничего делать не нужно;\\
б) Иначе, в настройках модуля логики нажмите на кнопку "Выбрать принтер для печати форм";\\
в) На открывшейся форме, в списке, выделите строку с необходимым принтером, и нажмите на кнопку **✓** над таблицей.\\

===Настройка справочников===
1. Форма TaxFree оформляется только на товары с признаком TaxFree. В Кассир 5 это товары с доп. реквизитом с кодом 38 и значением 1. В ТП 7 это флаг "TaxFree" в справочнике номенклатуры.\\
2. У товара должна быть указана единица измерения. Если её не указать, единицей будет считаться штука (шт).
Список доступных единиц измерения:\\
"шт" - штука;\\
"кг" - килограмм;\\
"г" - грамм;\\
"м" - метр;\\
"м2" - квадратный метр;\\
"м3" - кубический метр;\\
"л" - литр.\\
===Подключение ридера паспортов===
  - Подключите устройство к компьютеру.\\
  - В настройках Кассира, на закладке "Оборудование", в разделе "Работа со сканерами и ридерами" нажмите кнопку "Настройка".
  - Если в таблице устройств не добавлено устройство с типом "Штрих-М: Драйвер сканера", то добавьте его.
  - Откройте настройки драйвера сканера, нажав на кнопку с троеточием в строке с устройством.
  - Нажмите кнопку "Поиск" и считайте паспорт на устройстве.
  - Выберите COM-порт или HID-устройство, с которого были получены данные.
  - Нажмите кнопку "ОК".
  - Выберите модель: "Считыватель магнитных карт клавиатурный" или "Считыватель магнитных карт RS-232".
  - Выберите следующие настройки: 
   - "Старт-флаг" - Отсутствует
   - "Стоп-флаг" - Отсутствует
   - "Разделять дорожки" - снять флаг
   - "Монопольный режим" (если клавиатурный ридер) - снять флаг
  - Установите флаг "Устройство включено" и нажмите кнопку "Применить".
  - Считайте паспорт, если в поле результат вывелись данные с паспорта - значит ридер настроен правильно.
  - Если при считывании паспорта окно закрывается - проверьте выполнены ли все вышеперечисленные пункты.
=====Основные функции=====
====Оформить форму TaxFree====
1. Форма TaxFree может быть оформлена на закрытые чеки, в составе которых есть товары с признаком "TaxFree".\\
2. Для добавления чека в форму TaxFree нужно его выбрать. Способы выбора чека:\\
  * Считать QR код фискального чека в форме регистрации и выбрать пункт меню "Оформить форму TaxFree".
  * В форме регистрации в меню Сервис выбрать пункт "Оформить форму TaxFree" и нажать на кнопку "Выбрать". В открывшейся форме можно считать QR код фискального чека или ввести вручную номер ФН (фискального накопителя) и ФД (фискального документа) чека. Затем нажать кнопку "ВВОД".
  * Найти чек через расширенный отчет "Визуальное отображение чеков" и выбрать доп. действие "Оформить форму TaxFree".
3. Если подобранный чек удовлетворяет условиям оформления, тогда в состав чека добавятся товары с признаком "TaxFree", режим кассира поменяется на "Ваучер TaxFree", а кнопка "ОПЛАТА" (любая кнопка с функцией оплаты наличными) станет кнопкой "ОФОРМИТЬ".\\
4. Можно добавить несколько чеков в форму TaxFree (см. п. 2).\\
5. В режиме "Ваучер TaxFree" на форме регистрации можно считать данные паспорта туриста специальным ридером паспортов. Эти данные будут использоваться для проверки страны выдачи паспорта и для заполнения полей в форме TaxFree.\\
6. Для завершения процесса оформления ваучера, нужно нажать на кнопку "ОФОРМИТЬ". Откроется окно браузера, в котом нужно заполнить все поля, помеченные красной звездочкой "*" и нажать на кнопку "ВЫПУСК".\\
7. При успехе, окно браузера закроется, а Кассир выдаст сообщение "Форма TaxFree успешно выпущена".\\

====Аннулировать форму TaxFree====
Для аннулирования формы TaxFree, в Кассире должны быть оформлены ваучеры TaxFree.\\
Аннулирование формы может быть выполнено вручную или автоматически - при возврате продажи по номеру чека, на который была оформлена форма.\\
Для ручного аннулирования нужно выполнить следующие действия: \\
1. Выбрать форму TaxFree для аннулирования:\\
  * Считать QR код фискального чека в форме регистрации и выбрать пункт меню "Аннулировать форму TaxFree".
  * В форме регистрации в меню Сервис выбрать пункт "Аннулировать форму TaxFree", нажать на кнопку "Выбрать" в открывшемся окне найти нужную форму ([[#окно_поиска_формы_TaxFree|Окно поиска формы TaxFree]]).  
  * Найти чек через расширенный отчет "Визуальное отображение чеков" и выбрать доп. действие "Аннулировать форму TaxFree".
2. После выполнения предыдущего пункта, при успешном аннулировании формы выведется сообщение "Форма TaxFree успешно аннулирована по кассовым чекам «N1, N2, N3»".\\

====Повторная печать формы TaxFree====
Для повторной печати нужно выполнить следующие действия: \\
1. Выбрать форму TaxFree для повторной печати:\\
  * Считать QR код фискального чека в форме регистрации и выбрать пункт меню "Повторно распечатать форму TaxFree".
  * В форме регистрации в меню Сервис выбрать пункт "Повторно распечатать форму TaxFree", нажать на кнопку "Выбрать" в открывшемся окне найти нужную форму ([[#окно_поиска_формы_TaxFree|Окно поиска формы TaxFree]]). 
  * Найти чек через расширенный отчет "Визуальное отображение чеков" и выбрать доп. действие "Повторно распечатать форму TaxFree".
2. После выполнения предыдущего пункта, при успешной печати формы выведется сообщение "Форма TaxFree успешно напечатана".\\

===Окно поиска формы TaxFree===
В данной окне поиск может осуществляться по номеру формы или по номеру ФД чека, у которого есть привязка к форме TaxFree.\\
1. Нужно указать **Номер формы** или **Номер ФД**.\\
**Номер формы** можно заполнить следующими способами:\\
  * Сосканировать штрихкод с номером формы TaxFree.\\
  * Нажать на серое поле правее надписи "Номер формы:" и ввести 20-значный номер формы вручну.\\
**Номер ФД** можно заполнить следующими способами:\\
  * Сосканировать QR код чека.\\
  * Нажать на серое поле правее надписи "Номер ФД:" и ввести номер ФД вручную.
2. Нажать на кнопку **>>**, в таблице выбрать нужную форму TaxFree, и нажать кнопку "ВВОД".\\

=====Возможные проблемы=====
1. После открытия окна браузера, через какое-то время оно закрывается, а Кассир выдает ошибку "Ошибка запроса данных: Не удалось выпустить ваучер".\\
 а) Проверьте правильность логина/пароля;\\
 б) Если поля ИД магазина и ИД рабочего места заполнены, проверьте их правильность;\\
 в) Если ничего не помогает, найдите файл лога по пути "%APPDATA%\SHTRIH-M\Ic2Logs\Main.log" и обратитесь с ним в тех. поддержку.\\
		
=====Пользовательские доработки=====
1. Функции оформления, аннулирования и повторной печати можно вывести на кнопки кассира. Для этого необходимо добавить или отредактировать функцию раскладки клавиатуры.\\
 а) Функция оформления имеет следующий вид: Функция_ОформитьФормуTaxFree(ТаблицаТранзакций, ФормаРегистрации), где:
ТаблицаТранзакций - таблица транзакций чека, на который нужно оформить форму TaxFree. Если передать неопределено, откроется форма выбора чека.\\
ФормаРегистрации - форма регистрации. Обязательный.\\
\\
Пример функции раскладки клавиатуры:\\
<code>
GlobalBlueIC2 = МенеджерОбъектов.ПолучитьОбщийОбъект("МЛ.GBIC2");
Если GlobalBlueIC2 <> Неопределено Тогда
	GlobalBlueIC2.Функция_ОформитьФормуTaxFree(Неопределено, ЭтаФорма);
КонецЕсли;
</code>
 б) Функция аннулирования имеет следующий вид: Функция_АннулироватьФормуTaxFree(ДанныеФормы), где:\\
ДанныеФормы - строка таблицы с 3мя колонками: НомерФормы, НомераЧеков и СуммаЧеков. Если передать неопределено, откроется формы поиска формы.\\
<code>		
Пример функции раскладки клавиатуры:
GlobalBlueIC2 = МенеджерОбъектов.ПолучитьОбщийОбъект("МЛ.GBIC2");
Если GlobalBlueIC2 <> Неопределено Тогда
	GlobalBlueIC2.Функция_АннулироватьФормуTaxFree(Неопределено);
КонецЕсли;			
</code>		
 в) Функция повторной печати имеет следующий вид: Функция_ПовторноРаспечататьФормуTaxFree(ДанныеФормы), где:\\
ДанныеФормы - строка таблицы с 3мя колонками: НомерФормы, НомераЧеков и СуммаЧеков. Если передать неопределено, откроется формы поиска формы.\\
Пример функции раскладки клавиатуры:\\
<code>
GlobalBlueIC2 = МенеджерОбъектов.ПолучитьОбщийОбъект("МЛ.GBIC2");
Если GlobalBlueIC2 <> Неопределено Тогда
	GlobalBlueIC2.Функция_ПовторноРаспечататьФормуTaxFree(Неопределено);
КонецЕсли;
</code>
Штрих-М: Документация

Инструменты пользователя

Инструменты сайта

Инструменты страницы
