Подарочные карты 1С

Подарочные карты для 1С: описание работы


Важно! Артикул карты необходим для создания товара в номенклатуре (иначе товар не будет расцениваться как подарочная карта).
Для получения номеров карт необходимо открыть ранее созданную карту и нажать на "Выгрузить коды в файл". После, зайти снова в созданную карту, там можно будет увидеть список номеров карт (или же выгрузить их). Можно сделать запросом generate-gift-card.

Выдача подарочной карты

Для того, чтобы товар кассовая система начала воспринимать как подарочную карту необходимо добавить его в номенклатуру. Артикул должен иметь такое же значение, как и в maxma.

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

Применение подарочной карты

Для применения подарочной карты на кассовом терминале необходимо пробить нужные товары и нажать на кнопку "Промокод" в подразделе Операции maxma:

Важно не путать с кнопкой "Сертификат" стандартного интерфейса РМК.
В открывшемся окне вводим идентификатор код подарочной карты и жмем "Enter". Скидка применится сразу после этого.

Для 1С специалиста

Изменения:
- Обработка ИнтеграцияССервисомCloudLoyalty:
модуль менеджера, добавлено 2 новые формы ФормаУказанияКодаПодарочнойКарты и СписокПодарочныхКарт
- Добавлен новый общий модуль CLПрограммаЛояльностиПовтИсп
- Изменен общий модуль CLПрограммаЛояльностиКлиентСервер
Помимо этого в форму добавлена новая команда CLПодарочныеКарты (вместе с кнопкой) и новый реквизит CLПодарочныеКарты
Также изменения в функции СоздатьПречекНаСервере и процедуре ОчиститьСлужебныеПоля

Подарочные карты создаются в личном кабинете maxma, после переносятся в кассовое ПО/сайт и т.п.
Активация происходит через запрос activate-gift-card, в котором указывает SKU подарочной карты (Код номенклатуры или артикул) и code (Уникальный код подарочной карты).
пример запроса активации:
{
"txid": "tx-001",
"giftCard": {
"sku": "MXGC123",
"code": 2020728300990364
}
}
при успешной активации возвращаем инфу о карте:
{
"giftCard": {
"number": 405,
"code": "ABC123",
"initAmount": 500,
"validUntil": "2022-11-25T10:09:56Z"
}
}
Деактивация проходит идентично созданию запросом discard-gift-card:
{
"txid": "tx-001",
"giftCard": {
"sku": "MXGC123",
"code": 2020728300990364
}
}
при успешной деактивации возвращаем 200
Также, создать карты можно запросом не только через ЛК, а запросом generate-gift-card:
!ВАЖНО номинал карты должен быть предварительно настроен в программе лояльности, его идентификатор указывается в запросе.
{
"code": "gift1000"
}
в ответе получаем данные выпущенной карты:
{
"giftCard": {
"number": 405,
"code": "ABC123",
"initAmount": 500,
"validUntil": "2022-11-25T10:09:56Z"
}
}