# Экспорт клиентов

В системе есть возможность подписаться на отправку клиентов по HTTP протоколу при их создании и изменении

# Настройка экспорта

Для того чтобы приходили клиенты, нам необходимо сообщить адреса для импорта клиентов на вашей стороне, например https://your-domain.com/client/import. Настроить аутентификацию по Bearer токену, далее выдать этот токен нам, чтобы мы вам присылали запросы с этим токеном

# Как работает экспорт

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

# Описание параметров можно посмотреть тут

Кроме параметров описанных выше в тело запроса на экспорт будут добавлены следующие

Название	Тип	Обязательный	Описание
coins_amount	float	true	Кол-во баллов системы лояльности на счету клиента
organization	object	false	Организация, привязанная к адресу
additional_phones	array	false	Дополнительные телефоны клиента как они заведены у нас, например `["+7(908)328-08-33"]`

В атрибуты адреса добавлены координаты и готовое название

Название	Тип	Обязательный	Описание
coordinates	object	false	Координаты адреса, `null` если их нет
name	string(255)	false	Готовое название адреса, как оно показывается в нашей системе

Часть параметров в экспорте ведёт себя иначе, чем в импорте

Название	Описание
phones	Всегда один элемент - основной телефон клиента без кода страны, например `9083280832`. Дополнительные номера уходят в `additional_phones`
product_price_list	Массив цен, а если индивидуальных цен у клиента нет - `null`
requisites	Не передаётся

Атрибуты объекта organization

Название	Тип	Обязательный	Описание
id	integer	true	Идентификатор организации
uuid	string	true	UUID организации
inn	string	true	ИНН
ogrn	string	true	ОГРН
kpp	string	false	КПП
name	string	true	Название организации
fullName	string	true	Полное название организации
stopShipment	boolean	true	Признак остановки отгрузки
comment	string	false	Комментарий

# Тело запроса при экспорте клиентов

[
  {
    "id": "68",
    "external_id": "jqLbQR3be8jlJZIh4dBrUCyyIhFzuAKK",
    "username": "Василий Тестовый",
    "comment": null,
    "email": "ognev@baitek.org",
    "account_number": 68,
    "type": "fiz",
    "phones": [
      "9083280832"
    ],
    "additional_phones": [
      "+7(908)328-08-33",
      "+7 (818) 188-18-18"
    ],
    "addresses": [
      {
        "id": "2647",
        "external_id": null,
        "name": "Кутузова, д. 21, эт. 1, кв./оф. 1, под. 2, г. Сыктывкар – Орбита ближняя (Париж)",
        "city": "Сыктывкар",
        "street": "Кутузова",
        "house": "21",
        "room": "1",
        "entrance": "2",
        "floor": "1",
        "loyalty_system": false,
        "district_id": "1",
        "str": "Кутузова, д. 21, эт. 1, кв./оф. 1, под. 2, г. Сыктывкар   Орбита ближняя (Париж)",
        "coordinates": {
          "longitude": "50.83757400",
          "latitude": "61.66857200"
        },
        "organization": {
          "id": 4,
          "uuid": "c3c841cf-7166-402a-87fd-88fe709326d3",
          "inn": "1101163130",
          "ogrn": "1181121002754",
          "kpp": "168301001",
          "name": "ООО \"МОБИЛЬНОЕ РЕШЕНИЕ\"",
          "fullName": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"МОБИЛЬНОЕ РЕШЕНИЕ\"",
          "stopShipment": false,
          "comment": null
        }
      }
    ],
    "legal_address": [
      "г. Сыктывкар,ул. Кутузова,д. 21"
    ],
    "product_price_list": [
      {
        "product_id": "36",
        "external_product_id": null,
        "price": "101.00",
        "active": false
      }
    ],
    "coins_amount": 800,
    "loyalty_system_is_active": true
  }
]

# Как формировать ответ на принимающей стороне

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

← Импорт клиентов Получить список наборов →