Создание Клиента Реселлера

Метод Create a Reseller's Account используется для создания Клиента для текущего Реселлера или любого из его нижестоящих Реселлеров.

Доступ к текущему Реселлеру, относительно которого формируется список нижестоящих Реселлеров, определяется по токену Сотрудника, указанному в заголовке запроса.

POST {base_url}/api/v3/resellers/{reseller_id}/accounts

Аргументы

Название

Тип параметра

Тип данных

Обязательный/ 
Опциональный

Описание

X-Api-TokenheaderstringОбязательныйAPI токен Сотрудника, выполняющего операцию (см. Просмотр и обновление информации о сотруднике)
Content-TypeheaderstringОбязательныйПредназначен для идентификации формата и способа представления сущности
AcceptheaderstringОбязательныйПредназначен для информирования сервера о типах данных, которые поддерживаются клиентом (браузером)
reseller_idpathintegerОбязательныйID Реселлера. Возможно указать ID текущего Реселлера или ID любого из его нижестоящих Реселлеров (см. Просмотр информации о реселлере)
dataformobjectОбязательныйИнформация об атрибутах операции

attributesformobjectОбязательныйАтрибуты операции


account_type_idformintegerОбязательныйID Типа клиента (см. Просмотр списка типов клиентов)


primary_nameformstringОпциональныйОсновное имя Клиента (например, название компании для юридического лица)


first_nameformstringОбязательныйИмя лица, уполномоченного на заключение договора


middle_nameformstringОпциональныйОтчество лица, уполномоченного на заключение договора


last_nameformstringОбязательныйФамилия лица, уполномоченного на заключение договора


emailformstringОбязательныйEmail лица, уполномоченного на заключение договора


owner_idformintegerОпциональныйID существующего Пользователя, который будет связан с данным Клиентом и получит уровень доступа Владелец в Панель управления Клиента. Обязательный, когда не требуется создавать нового Пользователя с уровнем доступа Владелец


new_owner_first_name

formstringОпциональныйИмя нового Пользователя с уровнем доступа Владелец, который будет создан и прикреплен к данному Клиенту. Обязательный, если не задан owner_id


new_owner_middle_name

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


new_owner_last_name

formstringОпциональныйФамилия нового Пользователя с уровнем доступа Владелец, который будет создан и прикреплен к данному Клиенту. Обязательный, если не задан owner_id


new_owner_email

formstringОпциональный

Email нового Пользователя с уровнем доступа Владелец, который будет создан и прикреплен к данному Клиенту. Обязательный, если не задан owner_id



manager_id

form

integer

Опциональный

ID Менеджера (Сотрудника Реселлера), который будет прикреплен к данному Клиенту

Менеджер должен иметь роль Менеджер по продажам и статус Активный (см. Получение информации о Менеджере Реселлера по ID)



account_class_key

form

string

Обязательный

Ключ Правила обслуживания, по которому будет обслуживаться данный Клиент (см. Правила обслуживания)



country

form

string

Обязательный

Контакты: Код страны ISO 3166-1 alpha-2

Реселлер может ограничить список стран, доступных при создании Клиента. См. раздел Настройки региона в Задание общих системных настроек.



region

form

string

Обязательный

Контакты: Регион (Область)



city

form

string

Обязательный

Контакты: Город



street

form

string

Обязательный

Контакты: Улица



building

form

string

Опциональный

Контакты: Дом



office

form

string

Опциональный

Контакты: Номер офиса (Помещение)



zip

form

string

Обязательный

Контакты: Почтовый индекс



phone

form

string

Обязательный

Контакты: Телефон в международном формате:

  • + < код страны > < код города или сети > < номер телефона >.
  • 00 < код страны > < код города или сети > < номер телефона >.


custom_attributesformobjectОпциональныйДополнительные параметры Клиента (см. Настройка дополнительных параметров).



dataformarrayОпциональныйИнформация о дополнительных параметрах Клиента 




keyform

string

Зависит от Типа клиента

Ключ дополнительного параметра Клиента




valueform

string

Зависит от Типа клиента

Значение Дополнительного параметра Клиента.

В зависимости от типа данных значение Дополнительного параметра Менеджера указывается в следующем формате:

  • Логический тип:
    • 1 соответствует true.
    • 0 соответствует false.
  • ДатаДД.ММ.ГГГГ.
  • СписокКлюч элемента.

Модель ответа

В случае отсутствия ошибок метод возвращает данные о созданном Клиенте (см. Получение информации о Клиенте Реселлера по ID). Статус ответа: 201 Created.

Клиент будет создан без принятия Согласия с общими условиями работы. При входе в Панель управления Клиента для начала работы потребуется его принять (см. Вход в Панель управления Клиента).

В случае создания нового Пользователя с уровнем доступа Владелец, для него будет принято

Ошибки

Статус ошибкиТекст ошибкиКомментарий
422Менеджер аккаунта должен иметь роль 'менеджер по продажам' и находится в статусе 'активный'Если требуется прикрепить менеджера к Клиенту, необходимо указать ID Менеджера (Сотрудника Реселлера), который имеет роль Менеджер по продажам и статус Активный (см. Получение информации о Менеджере Реселлера по ID)
Клиент не может быть создан с указанной страной. Доступные варианты: <перечень>Реселлер ограничил список стран, доступных при создании Клиента. См. раздел Настройки региона в Задание общих системных настроек
Ошибки валидации параметров Клиента отображаются аналогично Панели управления Оператора (см. Создание клиента в ActivePlatform. Панель управления Оператора)

Пример запроса

POST /api/v3/resellers/1/accounts
Host: test.activeplatform.com
Content-Type: application/vnd.api+json
X-Api-Token: vY5fwetestK3gJXZH5uHCw
Accept: application/vnd.api+json
{
    "data": {
        "attributes": {
            "account_type_id": 1,
            "first_name": "Clotilde",
            "middle_name": "",
            "last_name": "Ledner",
            "email": "ClotildeLedner@example.com",
            "new_owner_first_name": "Alba",
            "new_owner_middle_name": "",
            "new_owner_last_name": "Stehr",
            "new_owner_email": "AlbaStehr@example.com",
            "manager_id": 188,
            "account_class_key": "postpaytest",
            "country": "BY",
            "region": "Minsk",
            "city": "Minsk",
            "street": "Mira",
            "building": "1",
            "office": "2",
            "zip": "220000",
            "phone": "+375290000000",
            "custom_attributes": {
                "data": [
                    {
                        "key": "signer_name",
                        "value": "Signer"
                    }
                ]
            }
        }
    }
}

Пример ответа

{
    "data": {
        "id": "789",
        "type": "accounts",
        "attributes": {
            "created_at": "2021-02-11T10:18:19.148+03:00",
            "updated_at": "2021-02-11T10:18:19.180+03:00",
            "reseller_id": 1,
            "name": "Clotilde  Ledner",
            "account_class_id": 2121,
            "primary_name": "",
            "first_name": "Clotilde",
            "middle_name": "",
            "last_name": "Ledner",
            "country": "BY",
            "region": "Minsk",
            "city": "Minsk",
            "street": "Mira",
            "building": "1",
            "office": "2",
            "zip": "220000",
            "phone": "+375290000000",
            "email": "ClotildeLedner@example.com",
            "status": "active",
            "balance": "0.0",
            "usable_balance": "0.0",
            "current_debt": 0.0,
            "subscription_credit_limit": 10000.0,
            "financial_blocking_threshold": 0.0,
            "account_type_id": 1,
            "manager_id": 188,
            "owner_id": 987,
            "tech_user_id": 987,
            "bill_user_id": 987,
            "custom_attributes": {
                "signer_name": "Signer"
            },
            "manager": {
                "created_at": "2017-10-12T15:27:56.354+03:00",
                "updated_at": "2020-08-07T05:32:53.522+03:00",
                "reseller_id": 1,
                "id": 188,
                "name": "Alena R",
                "status": "active",
                "email": "alena87@example.com",
                "role": "sales",
                "phone": null,
                "photo": null,
                "custom_attributes": {
                    "manager": ""
                }
            },
            "owner": {
                "created_at": "2021-02-11T10:18:19.128+03:00",
                "updated_at": "2021-02-11T10:18:19.128+03:00",
                "email": "AlbaStehr@example.com",
                "account_status": "active",
                "global_status": "active",
                "first_name": "Alba",
                "middle_name": "",
                "last_name": "Stehr"
            },
			"account_product_managers": [],
			"self_registration": false,
            "default_payment_model": "postpay",
            "account_type": {
                "id": 1,
                "name": "Personal BLR",
                "created_at": "2016-08-25T09:26:12.658+03:00",
                "updated_at": "2019-10-02T03:30:11.716+03:00",
                "reseller_id": 1,
                "name_pattern": "%first_name %middle_name %last_name",
                "primary_name": "",
                "key": "personalblr",
                "default_payment_method_id": 2,
                "ancestry": null,
                "use_by_default": false
            },
            "account_class": {
                "id": 2121,
                "reseller_id": 1,
                "name": "POSTPAY",
                "created_at": "2019-12-20T08:52:04.909+03:00",
                "updated_at": "2019-12-20T08:59:36.544+03:00",
                "financial_blocking_threshold": "0.0",
                "due_order_period": 15,
                "subzero_period": 1,
                "stop_subscription_type": "automatically",
                "key": "postpaytest",
                "color": "grey",
                "guaranteed_payment_limit": 1000,
                "guaranteed_payment_period": 7,
                "delete_subscription_type": "automatically",
                "denominated": false,
                "buy_with_negative_balance": false,
                "receipt_day": null,
                "payment_model": "postpay",
                "default": false,
                "due_payment_period": 3,
                "subscription_credit_limit": "10000.0"
            }
        },
        "relationships": {
            "subscriptions": {
                "data": []
            }
        }
    }
}