Другие модули на выбор

Модуль интеграции UDS и CMS 1С-Битрикс

Стоимость: руб.
Этот компонент мы сможете использовать только при наличии лицензии. Подходящие редакции:

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

💡 Нужна консультация и помощь по работе?
Установка и настройка UDS интеграции


1. Подготовка

Для работы модуля необходимо сотрудничество с UDS Бизнес и доступ к API UDS. Если вы ещё не подключены, зарегистрируйте компанию и оформите необходимые условия работы с UDS.

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

2. Основные настройки
  1. Установите модуль стандартным способом через Маркетплейс 1С-Битрикс. В административной панели откройте настройки модуля «Модуль интеграции UDS и CMS 1С-Битрикс».
  2. При необходимости активируйте лицензию модуля в соответствующем блоке настроек.
  3. Введите ID компании и API Key из личного кабинета UDS.
  4. Проверьте путь страницы оформления заказа без домена, например /personal/order/make/.
  5. Включите интеграцию для нужного сайта и сохраните настройки.

Статус лицензии модуля. Домен активации скрыт на иллюстрации.

На скриншотах показаны настройки версии 0.2.4. Ключи подключения и личные данные не опубликованы. Значения полей и ID правил приведены как примеры: используйте данные и параметры вашего сайта. Для просмотра изображения в полном размере нажмите на него.

3. Когда отправлять операцию в UDS

Параметр «Статус заказа для отправки транзакции в UDS» выбирает один из двух режимов:

  • «Новый заказ» (NEW). Операция отправляется при создании заказа. Бонусная скидка сохраняется после подтверждения операции UDS. При однозначном отказе заказ остаётся без этой скидки. Режим подходит, в частности, для магазина без онлайн-оплаты и без проведения документов оплаты в Битрикс.
  • «Оплачен» (PAID). Операция отправляется после полной оплаты денежной части заказа. Перед отправкой повторно проверяется расчёт UDS. Если есть денежный остаток, одной смены статуса заказа на «Оплачен» недостаточно: оплата должна быть отражена в документах оплаты Битрикс. Если денежной части нет и вся разрешённая стоимость покрывается бонусами, ожидать денежную оплату не требуется.

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

Код покупателя должен быть действителен к моменту операции. Отправка по произвольно выбранному статусу заказа и продление кода до 24 часов в версии 0.2.4 не предусмотрены.

4. Вывод при оформлении и в каталоге

По умолчанию модуль предназначен для стандартного компонента оформления заказа 1С-Битрикс bitrix:sale.order.ajax и его стандартного шаблона. Для нестандартного шаблона на основе этого компонента можно настроить три селектора: основной контейнер, контейнер способов оплаты и блок итоговой суммы заказа. В зависимости от изменений шаблона также может потребоваться адаптация JavaScript интеграции.

Если нестандартный шаблон не создаёт BX.Sale.OrderAjaxComponent, в настройках нужного сайта предусмотрена галочка «Режим нестандартного шаблона компонента оформления заказа». Она включает отдельный AJAX-адаптер UDS. После включения проверьте расчёт и сохранение заказа на вашем шаблоне.

Использование с другим компонентом оформления заказа возможно после адаптации интеграции. В таком случае разработчику необходимо согласовать передачу данных заказа, обработку событий и обновление блока бонусов с механизмом этого компонента. Одной замены селекторов может быть недостаточно. Возможность и объём такой адаптации оцениваются по конкретному сайту.

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

Для надписи о кешбэке в каталоге, карточке товара и корзине подключается компонент artnet:uds.cashback в соответствующих шаблонах сайта. Само включение модуля не добавляет его во все произвольные шаблоны. Компонент учитывает исключения начисления при передаче корректных данных товара или корзины.

Для товара передавайте PRODUCT_ID выбранного товара или предложения, PRICE после скидок и BASE_PRICE до скидок за ту же единицу. Для строки корзины или общих итогов используйте BASKET_ITEMS: строки с PRODUCT_ID, PRICE, BASE_PRICE и QUANTITY. Стоимость доставки в этот массив не включается.

5. Исключения по правилам корзины и скидочным товарам

При новой установке создаются два правила работы с корзиной:

  • «UDS исключения товаров, без начисления баллов» — определяет товары, за которые не начисляются бонусы.
  • «UDS исключения товаров, без списания баллов» — определяет товары, стоимость которых нельзя оплачивать бонусами.

Для настройки откройте правило и на вкладке «Действия и условия» задайте нужные товары или условия для действия со скидкой 0%. ID правил должны быть указаны в соответствующих полях настроек модуля. Для нескольких сайтов проверьте привязки правил к сайтам.

Дополнительно доступны галочки:

  • «Не начислять баллы за товары, на которые действуют скидки»;
  • «Не давать списывать баллы с товаров, на которые уже действуют скидки».

Включённая галочка имеет приоритет над соответствующим правилом корзины: это правило перестаёт использоваться, а исключение определяется наличием скидки. Свойства товара и основного раздела проверяются дополнительно. Процент товара не отменяет действующий запрет по общей галочке или правилу корзины.

Запрет начисления и запрет списания независимы. При необходимости отдельно включите «Исключить доставку из списания бонусов».

6. Свойства товаров и пользовательские поля разделов

Модуль читает существующие поля каталога. Создайте необходимые поля и укажите их коды в настройках модуля. Названия кодов ниже приведены как пример: можно использовать свои.

Настройка модуляПример кода поляНазначение и рекомендуемый типPROPERTY_EXCLUDE_FROM_CASHBACKUDS_NO_CASHBACKСвойство товара: запрет начисления. Список с XML_ID Y/N или строка 1/0.PROPERTY_EXCLUDE_FROM_REDEEMUDS_NO_REDEEMСвойство товара: запрет списания. Список с XML_ID Y/N или строка 1/0.PROPERTY_REDEEM_PERCENTUDS_REDEEM_PERCENTНеобязательное числовое или строковое свойство товара: максимальный процент списания.SECTION_PROPERTY_EXCLUDE_FROM_CASHBACKUF_UDS_NO_CASHBACKПользовательское поле раздела «Да/Нет»: запрет начисления.SECTION_PROPERTY_EXCLUDE_FROM_REDEEMUF_UDS_NO_REDEEMПользовательское поле раздела «Да/Нет»: запрет списания.SECTION_PROPERTY_REDEEM_PERCENTUF_UDS_REDEEM_PERCENTНеобязательная строка без значения по умолчанию: максимальный процент списания раздела.

Поля должны быть одиночными. Для списка используется XML_ID выбранного варианта. Пустая строка, 0, N, no, нет или false означают снятый запрет; остальные непустые значения включают запрет. Это правило относится к полям-флагам; у процентного поля явно заданный 0 имеет другое значение — полный запрет списания.

У разделов используются пользовательские поля UF_* объекта IBLOCK_<ID каталога>_SECTION, а не обычные свойства товаров. Если код поля раздела в настройках не задан, модуль использует UF_ плюс код соответствующего свойства товара. Если оба кода не заданы, эта проверка не выполняется.

Проверяется только основной раздел товара из IBLOCK_SECTION_ID. Дополнительные привязки и разделы выше по дереву не проверяются. Для торговых предложений сначала проверяются свойства предложения, затем товара-владельца; основной раздел берётся у владельца.

Для начисления достаточно запрета на любом из этих применимых уровней. Снятая галочка товара не отменяет запрет его основного раздела. Отдельного процентного свойства начисления нет.

Передачу значений из 1С или «МойСклад» нужно настроить в используемом механизме обмена. Сам модуль UDS не создаёт такой обмен и не добавляет выгрузку пользовательских полей разделов.

7. Максимальный процент списания

Менеджер может задавать значения от 0 до 100 включительно, в том числе дробные. В числовом свойстве вводится число без знака процента, например 20 или 20,5, если такой формат принимает поле. В строковом свойстве допустимы также 20%, дроби с точкой или запятой. Значения вне диапазона и некорректный текст модуль не использует как процент.

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

Значение процентаГалочка на том же уровнеРезультатПустоУстановленаСписание запрещено.ПустоСнятаДля товара проверяется основной раздел; у раздела нет локального запрета.0Любое состояниеСписание запрещено.20 или 20%Любое состояниеРазрешено списать максимум 20% стоимости.100 или 100%Любое состояниеЛокальное ограничение снято: до всей стоимости в пределах остальных правил.

Если у товара стоит запрет и собственного процента нет, процент раздела его не отменит. Чтобы переопределить запрет раздела для отдельного товара, задайте процент непосредственно у товара, например 100.

Пример: при цене 1 000 ₽ и собственном лимите 20% на товар можно направить до 200 бонусов, даже если на том же уровне стоит галочка запрета. Баланс покупателя, условия UDS и общие исключения магазина могут уменьшить эту сумму. Лимит применяется к каждой позиции с учётом количества и округления; округление не должно увеличивать разрешённую сумму.

Пустое значение и 0 различаются. Поэтому у поля процента раздела рекомендуется необязательная строка без значения по умолчанию: незаполненное поле должно оставаться пустым, а не превращаться в 0.

8. Ошибки UDS, уведомления и действия менеджера

Если ответ на отправку покупки потерян, выполняется один повтор с той же сохранённой квитанцией и идентификатором запроса. Дальнейшие автоматические попытки прекращаются, если результат остался неизвестным. Заказ получает пометку проблемы; русский статус в карточке объясняет результат.

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

При отказе UDS или неизвестном результате после предусмотренного повтора модуль ставит письма о проблеме в почтовую очередь Битрикс. Менеджер получает уведомление по адресу из настройки «E-mail менеджера для сообщений о проблемах»; если поле пустое, используется e-mail сайта. Убедитесь, что адрес получателя заполнен и корректен. Покупателю письмо направляется на e-mail из заказа, если включена галочка «Оповещать покупателя о проблеме применения бонусов»; по умолчанию уведомления покупателю включены.

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

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

  • связать подтверждённую операцию по её ID после проверки соответствия заказу;
  • согласовать доплату, если списание не выполнено;
  • оставить скидку за счёт магазина без нового списания бонусов.

Для решения нужны права на заказ, комментарий и подтверждение сверки. Эти действия не возвращают уже списанные в UDS бонусы сами по себе.

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

9. Письмо о новом заказе

В шаблоне почтового события SALE_NEW_ORDER доступны дополнительные поля, когда бонусная скидка уже сохранена к моменту формирования письма:

  • #BONUS_DISCOUNT_TOTAL# — сумма применённой бонусной скидки в валюте заказа;
  • #BONUS_ORIGINAL_TOTAL# — сумма заказа до бонусной скидки;
  • #BONUS_CURRENT_TOTAL# — сумма заказа после бонусной скидки;
  • #BONUS_ITEMS_HTML# — HTML-список позиций с применённой бонусной скидкой.

Это данные заказа на момент письма, а не подтверждение списания в UDS. В отложенном режиме операция может ещё ожидать оплаты. Ориентируйтесь на статус UDS в карточке заказа.

10. Обновление существующего модуля

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

Страница /bitrix/admin/artnet_uds_recovery_setup.php нужна администратору в двух случаях:

  • Ручная замена файлов, например через FTP, либо восстановление незавершённой настройки. Кнопка «Обновить обработчики и шаблоны писем» создаёт или обновляет служебные обработчики, хранилище и почтовые шаблоны. При копировании файлов штатный скрипт обновления Битрикс автоматически не запускается.
  • Перенос старых служебных состояний UDS. Та же кнопка переносит прежние состояния операций в новое хранилище. Старые неподтверждённые квитанции передаются на ручную сверку без автоматической отправки покупок. Она не отправляет заново транзакции по всем старым заказам.

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

11. Проверка перед запуском

Проверьте заказ без бонусов и со списанием, исключённые товары, основной раздел, пустой процент, 0, 20 и 100, выбранный режим отправки, отображение результата в UDS и возврат при отмене. Для нестандартного шаблона отдельно проверьте обновление сумм, отсутствие дублирования блоков и отображение на мобильных устройствах.

Для помощи в установке и настройке обращайтесь по электронной почте manager@artnetstudio.ru. Стоимость услуги — 5 000 руб.