Интеграция GIFTD и 1С-Битрикс

Интеграция Giftd и 1С-Битрикс установка или обновление

Установка или обновление модуля делается через Маркетплейс 1С-Битрикса — https://marketplace.1c-bitrix.ru/solutions/giftd.coupon.

Если вы устанавливаете этот модуль впервые (а не обновляете), то после установки нужно его настроить:

  1. Привяжите аккаунт Giftd Partner к установленному расширению:
    • Зайдите в панели администратора в настройки модуля «Электронные подарочные карты Giftd»
    • Нажмите там «Получить параметры для доступа к API Giftd»
  2. После того, как закроется окно авторизации в Giftd, все поля автоматически будут заполнены.
  3. Финальный момент: зайдите в настройки модуля «Интернет-магазин» и снимите галочку «Процентная скидка/наценка рассчитывается для полной цены товара»:

Теперь ваши клиенты могут дарить и использовать подарочные карты.

Если что-то пошло не так — скопируйте все данные из раздела Интеграция → Параметры для подключения к API.
 

Алгоритм взаимодействия Giftd и 1С-Битрикс

Информация ниже приведена для технических специалистов.

  1. Вы устанавливаете наш модуль для Битрикса,
  2. При вводе промо-кода в соответствующее поле на вашем сайте наш модуль проверяет, похож ли этот промо-код на код подарочной карты Giftd (есть ли у него соответствующий префикс)
  3. Если промо-код похож на код подарочной карты, наш модуль делает запрос к API Giftd для валидации кода
  4. Если код валиден, модуль делает следующее:
    • Проверяет существование соответствующего номиналу карты типа скидки — если такого типа не было, то он создается,
    • Создает скидку нужного типа с кодом, равным коду подарочной карты
  5. Пользователь видит, что промо-код сработал и соответствующая сумма вычлась из суммы корзины,
  6. Если пользователь дошел до конца и оформил заказ, то происходит следующее:
    • Ранее созданная скидка в Битриксе помечается как использованная;
    • Наш модуль делает второй запрос к API Giftd, чтобы подарочная карта была помечена как использованная на стороне Giftd;

Таким образом, интеграция Giftd и 1С-Битрикс происходит полностью в автоматическом режиме — никакой ручной работы не требуется.
 

Ручная установка модуля Giftd для 1С-Битрикс

 Устанавливайте вручную только в том случае, когда нет доступа к Маркетплейсу 1С-Битрикса.

  1. Возьмите код с https://bitbucket.org/nevidimov/giftd-bitrix
    • git clone https://bitbucket.org/nevidimov/giftd-bitrix
  2. Залейте его в директорию /path/to/project/bitrix/modules/giftd.coupon/
  3. Зайдите в админке Битрикса в раздел «Маркетплейс → Установленные решения» — там должен появиться наш пункт (со словом «Giftd» в названии)
  4. Нажмите «Установить» у нашего модуля
  5. После этого в разделе настроек модулей появится наш пункт — «Подарочные карты Giftd».

 

Установка модуля GIFTD для мультисайтовых инсталлов Битрикса

Для того, чтобы все работало, необходимо вставить специальный JSON в раздел “Дополнительные настройки”

Пример JSON:

{

   "FIRST_SITE_ID_HERE":{

      "USER_ID":"id1",

      "API_KEY":"secret1",

      "PARTNER_CODE":"code1",

      "PARTNER_TOKEN_PREFIX":"12"

   },

   "SECOND_SITE_ID_HERE":{

      "USER_ID":"id2",

      "API_KEY":"secret2",

      "PARTNER_CODE":"code2",

      "PARTNER_TOKEN_PREFIX":"34"

   }

}