Функционал в Кассир 5:

1. выпуск форм TaxFree;
2. повторная печать форм TaxFree;
3. аннулирование форм TaxFree.

Настройки работы с сервисом выполняются в настройках Кассир 5, на закладке «Модули логики»-«PPI».
1. Для включения модуля TaxFree «Planet» нужно снять флаг Отключить модуль
2. Если загружен модуль TaxFree «Global Blue», то на закладке «GBIC2» нужно установить флаг Отключить модуль.

Параметры для работы с сервисом предоставляет Planet при регистрации магазина в системе.
API URL
Тестовое подключение:
https://pipreprod.fintrax.com/pi_public_v2/service.asmx
Промышленное подключение:
https://pi.fintrax.com/pi_public_v2/service.asmx
ИД магазина - идентификатор магазина. Обязательный.
ИНН магазина - ИНН магазина. Обязательный.
Страна магазина - страна, в которой находится магазин. Обязательный.
ИД раб. места - идентификатор рабочего места. По умолчанию номер ПОС. Обязательный.
Наим. магазина - наименование магазина для печати на формах TaxFree.
Адрес магазина - адрес магазина для печати на формах TaxFree.

Таймаут запросов - определяет время ожидания ответа при работе с сервисом. Измеряется в секундах.

Показывать владельца ваучера в визуальном отображении чеков - флаг для показа номера паспорта на чеках, на которых оформлен TaxFree.
Путь к логам - каталог, в который будет сохраняться лог запросов к сервису. По умолчанию /ExtFiles в каталоге программы.

Для настройки ограничений при оформлении формы TaxFree нужно нажать кнопку Открыть настройку ограничений.
Минимальная общая сумма покупки - отвечает за минимальную сумму покупки в рублях, которую необходимо преодолеть для возможности начала оформления ваучера TaxFree. По умолчанию 10000.
Таблица Список запрещенных к исп. сервиса субъектов - определяет перечень запрещенных к использованию сервиса стран. После чтения паспорта туриста, система не даст начать оформлять ваучер TaxFree, если страна выдачи паспорта попадает в этот список.
В эту таблицу можно добавлять строки вручную (иконка с плюсом над таблицей) или переносом из левой таблицы. Для последнего, выделите переносимую строку в левой таблице и нажмите на кнопку «»» между таблицами для её переноса.

1. Форма TaxFree оформляется только на товары с признаком TaxFree. В Кассир 5 это товары с доп. реквизитом с кодом 38 и значением 1. В ТП 7 это флаг «TaxFree» в справочнике номенклатуры.
2. У товара должен быть указан номер налоговой группы с налогами со ставками 20% или 10%.

1. Подключите устройство к компьютеру.
   
2. В настройках Кассира, на закладке «Оборудование», в разделе «Работа со сканерами и ридерами» нажмите кнопку «Настройка».
3. Если в таблице устройств не добавлено устройство с типом «Штрих-М: Драйвер сканера», то добавьте его.
4. Откройте настройки драйвера сканера, нажав на кнопку с троеточием в строке с устройством.
5. Нажмите кнопку «Поиск» и считайте паспорт на устройстве.
6. Выберите COM-порт или HID-устройство, с которого были получены данные.
7. Нажмите кнопку «ОК».
8. Выберите модель: «Считыватель магнитных карт клавиатурный» или «Считыватель магнитных карт RS-232».
9. Выберите следующие настройки:
10. «Старт-флаг» - Отсутствует
11. «Стоп-флаг» - Отсутствует
12. «Разделять дорожки» - снять флаг
13. «Монопольный режим» (если клавиатурный ридер) - снять флаг
14. Установите флаг «Устройство включено» и нажмите кнопку «Применить».
15. Считайте паспорт, если в поле результат вывелись данные с паспорта - значит ридер настроен правильно.
16. Если при считывании паспорта окно закрывается - проверьте выполнены ли все вышеперечисленные пункты.

1. Форма TaxFree может быть оформлена на закрытые чеки, в составе которых есть товары с признаком «TaxFree».
2. Для добавления чека в форму TaxFree нужно его выбрать. Способы выбора чека:

• Считать QR код фискального чека в форме регистрации и выбрать пункт меню «Оформить форму TaxFree».
• В форме регистрации в меню Сервис выбрать пункт «Оформить форму TaxFree» и нажать на кнопку «Выбрать». В открывшейся форме можно считать QR код фискального чека или ввести вручную номер ФН (фискального накопителя) и ФД (фискального документа) чека. Затем нажать кнопку «ВВОД».
• Найти чек через расширенный отчет «Визуальное отображение чеков» и выбрать доп. действие «Оформить форму TaxFree».

3. Если подобранный чек удовлетворяет условиям оформления, тогда в состав чека добавятся товары с признаком «TaxFree», режим кассира поменяется на «Ваучер TaxFree», а кнопка «ОПЛАТА» (любая кнопка с функцией оплаты наличными) станет кнопкой «ОФОРМИТЬ».
4. Можно добавить несколько чеков в форму TaxFree (см. п. 2).
5. В режиме «Ваучер TaxFree» на форме регистрации можно считать данные паспорта туриста специальным ридером паспортов. Эти данные будут использоваться для проверки страны выдачи паспорта и для заполнения полей в форме TaxFree.
6. Для завершения процесса оформления ваучера, нужно нажать на кнопку «ОФОРМИТЬ». Откроется окно выпуска, в котором нужно заполнить все поля, помеченные красной звездочкой «*» и нажать на кнопку «ВЫПУСК».
7. При успехе, окно выпуска закроется, и откроется окно с предпросмотром ваучера.
8. В предпросмотре можно:

• Распечатать форму на принтере по умолчанию (кнопка 1).
• Распечатать форму с выбором принтера и настроек печати (кнопка 2).
• Сохранить форму в файл таблиц (кнопка 3).
• Сохранить форму в формате PDF (кнопка «Сохранить в PDF»).

9. После, закройте окно предпросмотра. Кассир выдаст сообщение «Форма TaxFree успешно выпущена».

Аналогично обычному оформлению. Перед пунктом 6 необходимо выполнить следующие действия: 1. В форме регистрации в меню Сервис выбрать пункт «Alipay Instant Store» и нажать на кнопку «Выбрать».
2. В открывшейся форме:

• Считать QR код Alipay Instant Store.
• Ввести код Alipay Instant Store вручную и нажать на кнопку «ВВОД».

После, можно продолжать оформление с пункта 6.

Для аннулирования формы TaxFree, в Кассире должны быть оформлены ваучеры TaxFree.
Аннулирование формы может быть выполнено вручную или автоматически - при возврате продажи по номеру чека, на который была оформлена форма.
Для ручного аннулирования нужно выполнить следующие действия:
1. Выбрать форму TaxFree для аннулирования:

• Считать QR код фискального чека в форме регистрации и выбрать пункт меню «Аннулировать форму TaxFree».
• В форме регистрации в меню Сервис выбрать пункт «Аннулировать форму TaxFree», нажать на кнопку «Выбрать» в открывшемся окне найти нужную форму (Окно поиска формы TaxFree).
• Найти чек через расширенный отчет «Визуальное отображение чеков» и выбрать доп. действие «Аннулировать форму TaxFree».

2. После выполнения предыдущего пункта, при успешном аннулировании формы выведется сообщение «Форма TaxFree успешно аннулирована по кассовым чекам «N1, N2, N3»».

Для повторной печати нужно выполнить следующие действия:
1. Выбрать форму TaxFree для повторной печати:

• Считать QR код фискального чека в форме регистрации и выбрать пункт меню «Повторно распечатать форму TaxFree».
• В форме регистрации в меню Сервис выбрать пункт «Повторно распечатать форму TaxFree», нажать на кнопку «Выбрать» в открывшемся окне найти нужную форму (Окно поиска формы TaxFree).
• Найти чек через расширенный отчет «Визуальное отображение чеков» и выбрать доп. действие «Повторно распечатать форму TaxFree».

2. При успехе, откроется окно с предпросмотром ваучера.
3. В предпросмотре можно:

• Распечатать форму на принтере по умолчанию (кнопка 1).
• Распечатать форму с выбором принтера и настроек печати (кнопка 2).
• Сохранить форму в файл таблиц (кнопка 3).
• Сохранить форму в файл документа формата PDF (кнопка «Сохранить в PDF»).

4. После, закройте окно предпросмотра. Кассир выдаст сообщение «Форма TaxFree успешно напечатана».

В данном окне поиск может осуществляться по номеру формы или по номеру ФД чека, у которого есть привязка к форме TaxFree.
1. Нужно указать Номер формы или Номер ФД.
Номер формы можно заполнить следующими способами:

• Сосканировать штрихкод с номером формы TaxFree.
  
• Нажать на серое поле правее надписи «Номер формы:» и ввести 20-значный номер формы вручну.
  

Номер ФД можно заполнить следующими способами:

• Сосканировать QR код чека.
  
• Нажать на серое поле правее надписи «Номер ФД:» и ввести номер ФД вручную.

2. Нажать на кнопку », в таблице выбрать нужную форму TaxFree, и нажать кнопку «ВВОД».

1. Функции оформления, ввода кода Alipay Instant Store, аннулирования и повторной печати можно вывести на кнопки кассира. Для этого необходимо добавить или отредактировать функцию раскладки клавиатуры.
а) Функция оформления имеет следующий вид: Функция_ОформитьФормуTaxFree(ТаблицаТранзакций, ФормаРегистрации), где: ТаблицаТранзакций - таблица транзакций чека, на который нужно оформить форму TaxFree. Если передать неопределено, откроется форма выбора чека.
ФормаРегистрации - форма регистрации. Обязательный.

Пример функции раскладки клавиатуры:

Planet = МенеджерОбъектов.ПолучитьОбщийОбъект("МЛ.PPI");
Если Planet <> Неопределено Тогда
	Planet.Функция_ОформитьФормуTaxFree(Неопределено, ЭтаФорма);
КонецЕсли;

б) Функция ввода кода Alipay Instant Store имеет следующий вид: Функция_СчитатьКодМгновенногоВозврата(ПолученныйКодМгновенногоВозврата), где: ПолученныйКодМгновенногоВозврата - строка с кодом Alipay Instant Store. Если передать неопределено, откроется форма ввода кода.

Пример функции раскладки клавиатуры:

Planet = МенеджерОбъектов.ПолучитьОбщийОбъект("МЛ.PPI");
Если Planet <> Неопределено Тогда
	Planet.Функция_СчитатьКодМгновенногоВозврата(Неопределено);
КонецЕсли;

в) Функция аннулирования имеет следующий вид: Функция_АннулироватьФормуTaxFree(ДанныеФормы), где:
ДанныеФормы - строка таблицы с 3мя колонками: НомерФормы, НомераЧеков и СуммаЧеков. Если передать неопределено, откроется формы поиска формы.

		
Пример функции раскладки клавиатуры:
Planet = МенеджерОбъектов.ПолучитьОбщийОбъект("МЛ.PPI");
Если Planet <> Неопределено Тогда
	Planet.Функция_АннулироватьФормуTaxFree(Неопределено);
КонецЕсли;			

г) Функция повторной печати имеет следующий вид: Функция_ПовторноРаспечататьФормуTaxFree(ДанныеФормы), где:
ДанныеФормы - строка таблицы с 3мя колонками: НомерФормы, НомераЧеков и СуммаЧеков. Если передать неопределено, откроется формы поиска формы.
Пример функции раскладки клавиатуры:

Planet = МенеджерОбъектов.ПолучитьОбщийОбъект("МЛ.PPI");
Если Planet <> Неопределено Тогда
	Planet.Функция_ПовторноРаспечататьФормуTaxFree(Неопределено);
КонецЕсли;