======Сервис 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. Если передать неопределено, откроется форма выбора чека.\\ ФормаРегистрации - форма регистрации. Обязательный.\\ \\ Пример функции раскладки клавиатуры:\\ GlobalBlueIC2 = МенеджерОбъектов.ПолучитьОбщийОбъект("МЛ.GBIC2"); Если GlobalBlueIC2 <> Неопределено Тогда GlobalBlueIC2.Функция_ОформитьФормуTaxFree(Неопределено, ЭтаФорма); КонецЕсли; б) Функция аннулирования имеет следующий вид: Функция_АннулироватьФормуTaxFree(ДанныеФормы), где:\\ ДанныеФормы - строка таблицы с 3мя колонками: НомерФормы, НомераЧеков и СуммаЧеков. Если передать неопределено, откроется формы поиска формы.\\ Пример функции раскладки клавиатуры: GlobalBlueIC2 = МенеджерОбъектов.ПолучитьОбщийОбъект("МЛ.GBIC2"); Если GlobalBlueIC2 <> Неопределено Тогда GlobalBlueIC2.Функция_АннулироватьФормуTaxFree(Неопределено); КонецЕсли; в) Функция повторной печати имеет следующий вид: Функция_ПовторноРаспечататьФормуTaxFree(ДанныеФормы), где:\\ ДанныеФормы - строка таблицы с 3мя колонками: НомерФормы, НомераЧеков и СуммаЧеков. Если передать неопределено, откроется формы поиска формы.\\ Пример функции раскладки клавиатуры:\\ GlobalBlueIC2 = МенеджерОбъектов.ПолучитьОбщийОбъект("МЛ.GBIC2"); Если GlobalBlueIC2 <> Неопределено Тогда GlobalBlueIC2.Функция_ПовторноРаспечататьФормуTaxFree(Неопределено); КонецЕсли;