Различия

Показаны различия между двумя версиями страницы.

--- external:pro_bonus:10_probonus_api:01_scheme [2026/02/16 10:12] – [Начисление лояльности за покупки во внешней системе] Александр Ильин
+++ external:pro_bonus:10_probonus_api:01_scheme [2026/02/16 10:29] (текущий) – [Типовые сценарии] Александр Ильин
@@ Строка 2: / Строка 2: @@
 В зависимости от целей и задач которые преследует внешняя система во взаимодействии с системой лояльности ProBonus можно выделить несколько типовых сценариев интеграции.
-В данном разделе описаны базовые кейсы и указаны конкретные методы API необходимые для из реализации.
+В данном разделе описаны базовые кейсы и указаны конкретные методы API необходимые для их реализации.
 Если требуемая вам логика взаимодействия не описана в данном разделе, вы можете написать нам на [[soft@carbis.ru]] и мы обязательно поможем найти решение.
@@ Строка 14: / Строка 14: @@
 {{:external:pro_bonus:10_probonus_api:pasted:20260216-093451.png}}
-===== Работа с анкетными данными на уровне ЛК внешней системы =====
+===== Работа с анкетными данными на уровне личного кабинета внешней системы =====
   - В качестве сквозного идентификатора гостя используем номер телефона.
-  - Если бизнес логика подразумевает создание новых счетов из внешней системы, тогда каждого нового гостя вы создаете в ПБ методом **/api/v0/accounts/insert_by_template**. \\ По минимум нужно передать только анкетные данные и телефон (email и доп идентификаторы - по желанию). Счет для гостя будет создан в группу accountGroupId и данному гостю будет автоматически назначена лояльность по шаблону настроенному для этой группы в рамках системы ProBonus (уровень, приветственные бонусы, установлено сгорание и т.п.) \\ Id нужной группы мы можете получить по API методом **/api/v0/account_groups/list**, или просто посмотреть в админке (http://probonus.pro:6896/account-groups/) и вынести в настройки на своей стороне. \\ **ВАЖНО:** Для корректного создания новых счетов по шаблону нужна группа с признаком «Шаблон для API» (haveTemplate=true). В тестовой БД это «Самостоятельно зарегистрировавшиеся» (id=3).
+  - Если бизнес-логика подразумевает создание новых счетов из внешней системы, тогда каждого нового гостя вы создаете в ProBonus методом **/api/v0/accounts/insert_by_template**. \\ По минимуму нужно передать только анкетные данные и телефон (email и доп. идентификаторы - по желанию). Счет для гостя будет создан в группу accountGroupId и данному гостю будет автоматически назначена лояльность по шаблону настроенному для этой группы в рамках системы ProBonus (уровень, приветственные бонусы, установлено сгорание и т. п.) \\ Id нужной группы мы можете получить по API методом **/api/v0/account_groups/list**, или просто посмотреть в админке (http://probonus.pro:6896/account-groups/) и вынести в настройки на своей стороне. \\ **ВАЖНО:** Для корректного создания новых счетов по шаблону нужна группа с признаком «Шаблон для API» (haveTemplate=true). В тестовой БД это «Самостоятельно зарегистрировавшиеся» (id=3).
-  - Проверить гостя на существование в СЛ можно при помощи метода **/api/v0/accounts/find_by_phone**. Ищет гостя по номеру телефона. Если гость с указанным номером телефона существует, то в ответ вернется практически вся информация о нем: анкета, текущий остаток на счете, текущий уровень, купоны и так далее.
+  - Проверить гостя на существование в системе лояльности можно при помощи метода **/api/v0/accounts/find_by_phone**. Ищет гостя по номеру телефона. Если гость с указанным номером телефона существует, то в ответ вернется практически вся информация о нем: анкета, текущий остаток на счете, текущий уровень, купоны и так далее.
 ===== Дополнительные методы API ProBonus =====
@@ Строка 35: / Строка 35: @@
 **checkGuid** - Уникальный номер внешней транзакции (в формате GUID). Важно! Система ProBonus не контролирует уникальность переданного GUID в рамках своей БД. Контроль уникальности лежит на внешней системе.
 **accountId** - id счета по которому совершена транзакция.
-**rkUnit** - Код станции (рабочего места) в ресторане, к которому нужно отнести данную транзакцию для отчетов.
+**rkUnit** - Код станции (рабочего места) в ресторане, к которому нужно отнести данную транзакцию для отчетов. Рекомендуем указывать код, заведомо определяющий что это не настоящая станция в ресторане. Например, 999 или 888 или любой другой трёхзначный.
 **externalCheck** - Номер транзакции во внешней системе (может использоваться для дальнейшей сверки транзакций между двумя отчетами).
 **bonusSpentSum** - Сумма (в копейках), которую нужно списать со счета в оплату транзакции.