Публичное пространство

SetLoyalty ◾️ Экспорт анкетных данных покупателей через топик Kafka

Owned by Ксения Лебедева
Last updated: апр. 19, 2024
6 min read

Включение и настройка функциональности производится сотрудниками CSI и только по запросу. По умолчанию выгрузка данных выключена.

SLS-3355 - Получение подробных данных проблемы… СТАТУС

CR-10605 - Получение подробных данных проблемы… СТАТУС

Описание

В Set Loyalty реализована возможность передачи информации о покупателях в топик брокера сообщений Kafka для чтения внешними системами. В соответствующий топик будут выгружаться сообщения в JSON-формате при создании и редактировании анкет в Set Loyalty.

Настройка 

Топик Kafka создает DevOps CSI через запрос менеджеру проекта.

Ограничения

  • Срок хранения сообщений в Kafka: 7 дней по умолчанию.
  • Данные начнут выгружаться с момента включения топика. Изменения, внесенные ранее, не попадут в Kafka.
  • Данные по бонусным операциям, уровневой программе лояльности и другая информация, не относящаяся к анкетным данным, передаваться в сообщении не будет.

Список выгружаемых данных

ПолеОписание
idКод (ID) покупателя
type

Тип сообщения:

  • CREATE - создать анкету
  • UPDATE - обновить анкету
dataidКод (ID) покупателя
firstNameИмя
lastNameФамилия
middleNameОтчество
phoneНомер телефона
emailАдрес электронной почты
createdDateДата регистрации покупателя
activatedDateДата активации (для случаев, когда профиль изначально был анонимным)
updatedDateДата последнего изменения профиля
shopМагазин, где был зарегистрирован покупатель ("0", если регистрация произведена через UI или API)
registrationPlaceКанал регистрации
agreeEmailСогласие на коммуникацию по e-mail
agreeSMSСогласие на коммуникацию по SMS
childrennameИмя ребенка
birthDateДата рождения ребенка
genderПол ребенка
customFieldsid

ID поля

  • birthday - дата рождения
  • comments - комментарий
  • family_status - семейное положение
  • gender - пол
  • city - город
  • mobile_registration - регистрация в мобильном приложении
  • house - дом
  • building - корпус
  • automobile - наличие автомобиля
  • street - улица
  • socialLevel - социальный статус
  • animals - домашние животные
  • region - регион
  • apartment - квартира
  • refuse_receipt - отказ от чека
  • field_X - произвольное созданное поле анкеты, где X - номер поля
valueЗначение
completedПризнак заполненности анкеты
deletedПризнак архивации покупателя

Пример сообщений

Пример сообщения при создании анкеты покупателя:

{
  "id": "6",
  "type": "CREATE",
  "data": {
    "id": "6",
    "firstName": "Иван",
    "lastName": "Иванов",
    "middleName": null,
    "phone": "79173332486",
    "email": "ivanov_ivan1254@hotmail.com",
    "createdDate": "2024-03-13T16:10:37.27163+03:00",
    "activatedDate": "2024-03-15T11:49:35.292411594+03:00",
    "updatedDate": "2024-03-15T11:49:35.292411594+03:00",
    "shop": "0",
    "registrationPlace": "INFO_STAND",
    "agreeEmail": true,
    "agreeSMS": true,
    "children": [
      {
        "name": "Петр",
        "birthDate": "2024-03-12",
        "gender": "UNKNOWN"
      }
    ],
    "customFields": [
      {
        "id": "birthday",
        "value": "2024-03-06"
      },
      {
        "id": "comments",
        "value": "qwe"
      },
      {
        "id": "family_status",
        "value": "married"
      },
      {
        "id": "gender",
        "value": "male"
      },
      {
        "id": "city",
        "value": "СПБ"
      },
      {
        "id": "field_1",
        "value": "123"
      },
      {
        "id": "mobile_registration",
        "value": "true"
      },
      {
        "id": "house",
        "value": "1"
      },
      {
        "id": "building",
        "value": "1"
      },
      {
        "id": "automobile",
        "value": "true"
      },
      {
        "id": "street",
        "value": "Невский"
      },
      {
        "id": "socialLevel",
        "value": "1"
      },
      {
        "id": "animals",
        "value": "FISH,DOG"
      },
      {
        "id": "region",
        "value": "РФ"
      },
      {
        "id": "apartment",
        "value": "1"
      },
      {
        "id": "refuse_receipt",
        "value": "true"
      }
    ],
    "completed": true,
    "deleted": false
  }
}


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

{
  "id": "6",
  "type": "UPDATE",
  "data": {
    "id": "6",
    "firstName": "Иван",
    "lastName": "Иванов",
    "middleName": null,
    "phone": "79173332486",
    "email": "ivanov_ivan_new@hotmail.com",
    "createdDate": "2024-03-13T16:10:37.27163+03:00",
    "activatedDate": "2024-03-15T11:49:35.292411594+03:00",
    "updatedDate": "2024-03-15T11:49:35.292411594+03:00",
    "shop": "0",
    "registrationPlace": "INFO_STAND",
    "agreeEmail": true,
    "agreeSMS": true,
    "children": [
      {
        "name": "Петр",
        "birthDate": "2024-03-12",
        "gender": "UNKNOWN"
      }
    ],
    "customFields": [
      {
        "id": "birthday",
        "value": "2024-03-06"
      },
      {
        "id": "comments",
        "value": "qwe"
      },
      {
        "id": "family_status",
        "value": "married"
      },
      {
        "id": "gender",
        "value": "male"
      },
      {
        "id": "city",
        "value": "СПБ"
      },
      {
        "id": "field_1",
        "value": "123"
      },
      {
        "id": "mobile_registration",
        "value": "true"
      },
      {
        "id": "house",
        "value": "1"
      },
      {
        "id": "building",
        "value": "1"
      },
      {
        "id": "automobile",
        "value": "true"
      },
      {
        "id": "street",
        "value": "Невский"
      },
      {
        "id": "socialLevel",
        "value": "1"
      },
      {
        "id": "animals",
        "value": "FISH,DOG"
      },
      {
        "id": "region",
        "value": "РФ"
      },
      {
        "id": "apartment",
        "value": "1"
      },
      {
        "id": "refuse_receipt",
        "value": "true"
      }
    ],
    "completed": true,
    "deleted": false
  }
}

© 1994-2023, ООО «Кристалл Сервис Интеграция».
Все права защищены..

Политика обработки персональных данных