Заявки на загрузку чеков (чеки из ФНС)

Система предоставляет возможность для привязки чека к контакту путем сканирования QR кода с кассового чека, например, в мобильном приложении участника программы лояльности.

Принцип работы функциональности следующий:

• В мобильном приложении программы лояльности участник сканирует QR код с кассового чека.
• Приложение передаёт в систему ML посредством запроса сервиса OData реквизиты отсканированного из QR кода чека (сумма, дата чека, ФН, ФД и ФПД).
• Система ML обращается к сервису НДС+ для получения содержимого чека из ФНС и затем привязывает чек к одной из активных карт данного контакта для предоставления привилегий (начисления бонусов, изменения уровня и т.д.).

При обработке чека в системе происходят различные проверки, в том числе следующие: чек не просрочен (есть возможность для настройки допустимого периода сканирования чека контактом), чек не был отсканирован ранее (один чек может быть отсканирован только один раз), чек имеет тип операции «Приход».

См. подробнее описание метода по привязке чека в документации API для интеграции с ЛК или МП.

Ошибочные чеки, по которым вернулась ошибка от сервиса НДС+ (например, чек отсутствует в ФНС) или по которым произошла ошибка при привязке чека в базе лояльности (например, не найден pos-терминал), а также успешно привязанные чеки – все чеки сохраняются с соответствующим статусом в базу данных и отображаются в интерфейсе ML в отдельном представлении заявок на загрузку чеков.

Оператор программы лояльности может выполнять различные действия с заявками на загрузку чеков в интерфейсе: создавать новые заявки вручную, искать чек из заявки в ФНС (для получения содержимого чека из ФНС), подтвердить чек из заявки (привязка чека к контакту, по которому успешно получена информация из ФНС), отклонить заявку с указанием причины отклонения.

Участник программы лояльности может просмотреть в МП все свои отсканированные чеки со статусами их обработки, в том числе с причиной отклонения оператором.

Записи заявок на загрузку чеков доступны в меню системы:

Рис. Справочник заявок на загрузку чеков в системе

Запись заявки на загрузку чека содержит следующие параметры:

Для того чтобы сделать поиск чека в ФНС должны быть вначале заполнены следующие поля в заявке на загрузку чека:

• Контакт
• Дата покупки
• Сумма покупки
• ФН
• ФД
• ФПД

Дополнительно чтобы можно было сделать поиск чека в ФНС заявка должна иметь общий статус, равный «Новая» или «Ошибка обработки» и при этом иметь статус чека из ФНС, не равный «Данные чека получены (успешный запрос)».

Рис. Поиск чека в ФНС

Подтвердить (привязать) чек к контакту можно после того, как получено успешно содержимое чека из ФНС, т.е. когда «Статус чека из ФНС» = «Данные чека получены (успешный запрос)» и при этом общий статус равен «Новая» или «Ошибка обработки».

Отклонить можно только заявку с общим статусом, равным «Новая» или «Ошибка обработки». При нажатии на кнопку «Отклонить» требуется указать причину отклонения.

Рис. Отклонение заявки

Рис. Окно для указания причины отклонения заявки на загрузку чека

Редактировать можно только заявку, имеющую общий статус «Новая» или «Ошибка обработки» и при этом имеющей статус чека из ФНС, не равный «Данные чека получены (успешный запрос)».

Создавать вручную позиции заявки на загрузку чека не требуется. Позиции заявки создаются автоматически после поиска чека в ФНС. Ссылка на товар заполняется в позиции заявки после подтверждения (привязки) чека.

Рис. Подтвержденная заявка на загрузку чека

Заявки на загрузку чека (чеки ФНС) можно просмотреть в соответствующем рефересном представлении в карточке контакта.

Рис. Заявки на загрузку чека в карточке контакта

Сканированные чеки не ФНС. Исключительная обработка через внешний запрос.

В случае, когда необходимо обработать чек, не попадающий в ФНС, используется партнерская настройка Loyalty.Processing.FnsCheque.DirectRegistration.POSExID, в которой перечисляются идентификаторы касс, запрос чеков которых не требуют обращения в сервис ФНС, но регистрируются напрямую в базе данных программы лояльности. Сервис ОData запрашивает значение настройки. Если приходит запрос на формирование чека с кассой из списка по настройке - сервис не посылает запрос в ФНС, а сразу посылает запрос на создание чека без позиций, но с картой лояльности.

Оформление возвратов по чекам ФНС

Для осуществления возврата по чеку из ФНС в разделе системы «Заявки на загрузку чеков» необходимо нажать кнопку «Возврат». Кнопка доступна для нажатия, если заявка с типом операции «Покупка» и имеет "Статус процессинга" = "OK".

 Рис. Форма «Заявки на загрузку чека» с активной кнопкой «Возврат».

При нажатии на кнопку «Возврат» в карточке заявки открывается карточка для создания новой заявки с тем же составом полей, как и в заявке с типом «Покупка», но со следующими предустановленными значениями полей:

•          «Общий статус» = «Новая»;

•          «Тип операции» = «Возврат»;

•          «Контакт» = значение поля «Контакт» в исходной заявке с типом «Покупка»;

•          «Карта» = значение поля «Карта» в исходной заявке с типом «Покупка»;

•          «Магазин» = значение поля «Магазин» в исходной заявке с типом «Покупка»;

•          «POS» = значение поля «POS» в исходной заявке с типом «Покупка».

На форме необходимо заполнить обязательные поля:

•          «Дата возврата»».

•          «Сумма возврата»: указывается сумма возврата либо одной позиции, либо несколько. Сумма возврата равно сумме возвращаемых позиций.

Также на форме заявки с типом «Возврат» отображается необязательное поле «Обращение», содержащее ссылку на сущность «Обращение».

Рис. Карточка для создания заявки на возврат

После заполнения полей и сохранения данных формируется заявка на возврат.

Рис. Заявка на возврат

При нажатии на кнопку «Добавить позиции для возврата» открывается окно «Добавление позиции заявки/чека» со списком позиций из чека покупки. Пользователь выбирает позиции, которые необходимо вернуть и нажимает кнопку «Добавить».

Рис. Окно для добавления позиции заявки/чека

С заявкой с типом «Возврат» связываются выбранные позиции с заполненными полями (номер позиции, товар, цена, количество и сумма).

Рис. Позиции для возврата

В рамках одной заявки на загрузку чека можно совершать несколько возвратов: на форме заявки с типом «Покупка» все возвраты по данной заявке находятся в одноименном табе.

Рис. Записи возвратов в форме «Заявки на загрузку чека»

Кнопки на форме заявки на загрузку чека с типом «Возврат»

Если заявка с типом «Возврат» имеет "Общий статус" = "Новая" или "Ошибка обработки", то на форме заявки с типом «Возврат» отображается кнопка «Подтвердить». При нажатии на кнопку «Подтвердить» происходит проверка на связь заявки на возврат с позицией чека покупки: если к связанной с заявкой с типом «Возврат» заявке с типом «Покупка» привязана хотя бы одна позиция, а к заявке с типом «Возврат» не привязана ни одна позиция, то отображается ошибка с текстом «Возврат не связан с позициями. Добавьте возвращаемые позиции».

Если проверка пройдена успешно, то отображается одно из следующих всплывающих сообщений, в зависимости от того, указана или нет в заявке возврата ссылка на обращение:

 Рис. Окна с вариантами запросов подтверждения возврата

При нажатии на «Да, подтвердить» происходит передача чека возврата на обработку. После получения ответа от процессинга в заявке обновляется поле «Статус процессинга» и «Общий статус». Поле «Статус процессинга» может принимать следующие значения:

• «Начислено: (кол-во возвращенных баллов со знаком «-»)
• «Чек покупки не содержит информацию о позициях чека возврата»
• «Чек для возврата не найден»

Поле «Ошибка обработки» принимает 3 значения «Успешно», «Отклонена» «Ошибка обработки».

Кнопка «Редактировать» доступна для нажатия, если заявка с типом «Возврат» имеет "Общий статус" = "Новая" или "Ошибка обработки" и при этом "Статус чека из ФНС" не равно "Данные чека получены (успешный запрос)". При нажатии открывается карточка заявки на возврат.

Кнопка «Отклонить» доступна для нажатия, если заявка с типом «Возврат» имеет "Общий статус" = "Новая" или "Ошибка обработки". При нажатии на кнопку «Отклонить» открывается окно для указания причины отклонения, далее обновляется поля "Общий статус" на значение «Отклонена» и в заявке фиксируется причина отклонения.

Рис. Окно причины отклонения возврата и обновленные поля карточки возврата после отмены

Кнопки «Поиск в ФНС» и «Возврат» недоступны для нажатия в заявке с типом «Возврат».

Рис. Кнопки на форме заявки на загрузку чека с типом «Возврат»

Подстановка в чеки ФНС универсального товара

Возможны случаи, когда из магазинов поступают чеки, в которых не указаны артикулы товаров. При сканировании такого чека возникает ошибка «не все коды товаров определены». Система не может идентифицировать товар\создать товар, в результате нет возможности провести чек.

Для исключения ошибок в товарном справочнике системы должен быть заведен универсальный товар и создана системная/партнерская настройка.

Loyalty.FtsReceipt.ArticleStub - настройка, в которой передается внешний идентификатор товара, который подставляется в чеки ФНС, когда в сканированных чеках отсутствует артикул товара. Значение по умолчанию – ПУСТО.

В значение подставляется наименование универсального товара.

Создание ручного чека через «Заявки на загрузку чека»

Заявки на загрузку чеков – это возможность создания чека без взаимодействия с POS-терминалом, а непосредственным вводом чека в систему через пользовательский интерфейс системы.

Для создания ручного чека необходимо зайти в раздел интерфейса «Заявки на загрузку чеков» => Создать.

Рис. Создание заявки на загрузку чека

Процессинга мягких чеков нет. Ручные чеки можно проводить только как фискальные. Через ручные чеки можно сделать возврат только без ссылки на чек покупки.

Ручные чеки с оплатой денежными средствами можно создавать только, когда отключена функциональность подтверждения операции оплаты денежными средствами.

Ручные чеки могут использоваться, например, когда выписанный фискальный чек по каким-либо причинам не был зарегистрирован в системе.

Для создания ручного чека необходимо заполнить следующие поля в карточке Заявки на загрузку чека:

Рис. Карточка заявки на загрузку чека

Далее сохранить заполненную форму и проверить, что все поля заполнены корректно.

Рис. Заполненная карточка заявки на загрузку чека со связанными представлениями

Вручную позиции заявки на загрузку ручного чека не создаются. Они появляются автоматически после поиска чека в ФНС и его подтверждения с помощью соответствующих кнопок в верхней части формы заявки.

Если никаких ошибок при заведении чека не было допущено, после обработки будет отображаться «Статус процессинга» = «ОК», если сработали какие-то правила начисления, в данном статусе будет также указано, сколько начислено бонусных баллов при регистрации чека в системе, и «Общий статус» = «Успешно».

При успешной регистрации чека пересчет уровня контакта происходит в течение 5-10 мин.

Рис. Успешная обработки заявки на загрузку чека

При успешной регистрации чека пересчет уровня контакта происходит в течение 5-10 мин.

Статус обработки чека может принимать другие значения:

Для «Общего статуса»:

• Новая
• Отклонена
• Ошибка обработки

Для «Статуса процессинга»:

• Не все коды товаров определены
• Не может быть чека от того же POS в тот же день с тем же номером
• В системе отсутствует активная или новая карта с заданным номером мобильного телефона
• Операция запрещена по лимиту операций по карте в этом магазине
• Операция запрещена по статусу карты

Рис. Ошибка обработки заявки на загрузку чека