Вход / Регистрация 0
Реферальная программа лояльности

sw24loyaltyprogram.bonus.Add

Время чтения: ~2 мин.
Обновлено: 28.10.2022

Назначение метода

Метод sw24loyaltyprogram.bonus.Add позволяет поставить начисление или списание бонусов в очередь.

Параметры

Параметр Обязательный Описание
user_id да

ID пользователя

целое число

bonus да

Число бонусов

Можно указать отрицательное значение, тогда бонусы будут списаны, а не начислены.

дробное число

currency

Валюта

строка

comment

Комментарий к бонусам

строка

date_add

Дата начисления

время в формате unixtime

date_remove

Дата сгорания (будет заполнен в случае если бонусы не отрицательное число)

время в формате unixtime

order_id

Номер заказа за который начислены бонусы1

целое число

profile_type

Тип профиля по которому прошли начисления (узнать доступные типы можно с помощью метода sw24loyaltyprogram.profile.list)1

строка

profile_id

Идентификатор профиля по которому прошли начисления (узнать доступные профили можно с помощью метода sw24loyaltyprogram.profile.list)1

целое число

action_id

Идентификатор действия профиля по которому прошли начисления (узнать доступные действия можно с помощью метода sw24loyaltyprogram.profile.list)1

целое число

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

Результат

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

Ключ Значение
id

Идентификатор добавленной записи

целое число

status

Статус завершения операции

значение "success"

В случае неудачи метод вернёт массив со следующими ключами:

Ключ Значение
error

Идентификатор ошибки (если есть)

целое число

error_description

Описание возникшей ошибки

Пример вызова

https://{адрес_сайта}/rest/{id_пользователя}/{код_доступа}/sw24loyaltyprogram.bonus.add/?user_id=ID_ПОЛЬЗОВАТЕЛЯ&bonus=ЧИСЛО_БОНУСОВ