Получение информации о Клиенте нижестоящего Реселлера по ID
Метод Get the Child Reseller's Account by ID используется для получения информации о Клиенте Реселлера по указанному ID Клиента Реселлера, являющегося нижестоящим по отношению к текущему Реселлеру, или по отношению к его выбранному нижестоящему Реселлеру.
Доступ к текущему Реселлеру, относительно которого формируется список нижестоящих Реселлеров, определяется по токену Сотрудника, указанному в заголовке запроса.
GET {base_url}/api/v3/resellers/{reseller_id}/child_reseller_accounts/{account_id}
Аргументы
Название | Тип параметра | Тип данных | Обязательный/ | Описание |
---|---|---|---|---|
X-Api-Token | header | string | Обязательный | API токен Сотрудника, выполняющего операцию (см. Просмотр и обновление информации о сотруднике) |
Content-Type | header | string | Обязательный | Предназначен для идентификации формата и способа представления сущности |
Accept | header | string | Обязательный | Предназначен для информирования сервера о типах данных, которые поддерживаются клиентом (браузером) |
reseller_id | path | integer | Обязательный | ID Реселлера. Возможно указать ID текущего Реселлера или ID любого из его нижестоящих Реселлеров (см. Просмотр информации о реселлере) |
account_id | path | integer | Обязательный | ID Клиента |
Модель ответа
Название | Тип данных | Описание | ||||
---|---|---|---|---|---|---|
data | object | Данные ответа | ||||
id | integer | ID Клиента | ||||
type | string | Тип данных | ||||
attributes | object | Информация о Клиенте | ||||
created_at | date | Дата и время создания Клиента | ||||
updated_at | date | Дата и время последнего обновления Клиента | ||||
reseller_id | integer | ID Реселлера, к которому относится Клиент | ||||
name | string | Имя Клиента | ||||
account_class_id | integer | ID Правила обслуживания Клиента | ||||
primary_name | string | Основное имя Клиента (например, название компании для юридического лица) | ||||
first_name | string | Имя лица, уполномоченного на заключение договора | ||||
middle_name | string | Отчество лица, уполномоченного на заключение договора | ||||
last_name | string | Фамилия лица, уполномоченного на заключение договора | ||||
country | string | Контакты: Код страны ISO 3166-1 alpha-2 | ||||
region | string | Контакты: Регион | ||||
city | string | Контакты: Город | ||||
street | string | Контакты: Улица | ||||
building | string | Контакты: Дом | ||||
office | string | Контакты: Номер офиса | ||||
zip | string | Контакты: Почтовый индекс | ||||
phone | string | Контакты: Телефон в международном формате:
| ||||
string | Email лица, уполномоченного на заключение договора | |||||
status | string | Статус Клиента (см. Просмотр и обновление информации о клиенте) | ||||
balance | float | Текущее состояние Баланса клиента | ||||
current_debt | float | Величина текущей задолженности по всем Подпискам Клиента с моделью оплаты Постоплата | ||||
subscription_credit_limit | float | Величина Кредитного лимита по подписке, заданная на уровне Правила обслуживания или переопределенная на уровне Клиента | ||||
financial_blocking_threshold | float | Величина Порога срабатывания финансовой блокировки, заданная на уровне Правила обслуживания или переопределенная на уровне Клиента | ||||
account_type_id | integer | ID Типа клиента (см. Просмотр списка типов клиентов) | ||||
manager_id | integer | ID Сотрудника, к которому относится Клиент | ||||
owner_id | integer | ID Пользователя с правами Владелец для Клиента | ||||
tech_user_id | integer | ID Пользователя, указанного как Технический контакт (см. Просмотр и обновление информации о клиенте) | ||||
bill_user_id | integer | ID Пользователя, указанного как Финансовый контакт (см. Просмотр и обновление информации о клиенте) | ||||
custom_attributes | object | Дополнительные параметры Клиента (см. Настройка дополнительных параметров) | ||||
attributes.custom-attributes['custom-attribute-key'] | string | Значение Дополнительного параметра | ||||
manager | object | Информация о Менеджере, к которому относится Клиент (см. Просмотр и обновление информации о сотруднике) | ||||
created_at | date | Дата и время создания Менеджера | ||||
updated_at | date | Дата и время последнего изменения Менеджера | ||||
reseller_id | integer | ID Реселлера, к которому относится Менеджер | ||||
id | integer | ID Менеджера | ||||
name | string | Имя Менеджера | ||||
status | string | Статус Менеджера:
| ||||
string | Адрес email Менеджера, который используется для входа в Панель управления Оператора | |||||
role | string | Уровень доступа Менеджера в Панель управления Оператора (список ролей см. в Роли сотрудников) | ||||
custom_attributes | object | Перечень дополнительных параметров Менеджера (см. Просмотр списка Дополнительных параметров) | ||||
manager.custom-attributes['custom-attribute-key'] | string | Значение параметра | ||||
owner | object | Информация о связанном Пользователе с правами Владелец для Клиента | ||||
created_at | string | Дата и время создания Пользователя с правами Владелец для Клиента | ||||
updated_at | string | Дата и время последнего изменения Пользователя с правами Владелец для Клиента | ||||
email | string | E-mail Пользователя с правами Владелец для Клиента | ||||
account_status | string | Текущий статус Пользователя для выбранного Клиента (подробнее о статусах см. Управление пользователями клиента) | ||||
global_status | string | Глобальный статус Пользователя с правами Владелец для Клиента | ||||
string | Имя Пользователя с правами Владелец для Клиента | |||||
middle_name | string | Отчество Пользователя с правами Владелец для Клиента | ||||
last_name | string | Фамилия Пользователя с правами Владелец для Клиента | ||||
account_product_managers | array of objects | Ответственные сотрудники для Клиента (см. Управление ответственными сотрудниками) | ||||
id | integer | ID записи об Ответственном сотруднике | ||||
account_id | integer | ID Клиента | ||||
product_id | integer | ID Продукта | ||||
responsible_product_manager_id | integer | ID Ответственного сотрудника в рамках Продукта | ||||
manager_product_role_id | integer | ID Роли сотрудника в рамках Продукта | ||||
created_at | date | Дата и время создания записи об Ответственном сотруднике | ||||
updated_at | date | Дата и время последнего обновления записи об Ответственном сотруднике | ||||
self_registration | bool | Признак того, что Клиент зарегистрировался в платформе самостоятельно через Панель управления Клиента:
| ||||
default_payment_model | string | Модель оплаты по умолчанию для данного Клиента. Возможные значения:
| ||||
account_type | object | Информация о Типе клиента (см. Типы клиентов) | ||||
id | integer | ID Типа клиента | ||||
name | string | Имя Типа клиента | ||||
created_at | date | Дата и время создания Типа клиента | ||||
updated_at | date | Дата и время последнего обновления Типа клиента | ||||
reseller_id | integer | ID Реселлера, к которому относится Тип клиента | ||||
name_pattern | string | Шаблон отображения имени Клиента в платформе | ||||
primary_name | string | Название поля с основным именем Клиента. Например, для Типа клиента Юридическое лицо это может быть Название компании | ||||
key | string | Ключ Типа клиентов | ||||
default_payment_method_id | integer | ID способа оплаты (см. Способы оплаты), который используется по умолчанию для данного Типа клиентов | ||||
ancestry | integer | ID родительского Типа клиентов | ||||
account_class | object | Информация о Правиле обслуживания Клиента (см. Правила обслуживания) | ||||
id | integer | ID Правила обслуживания | ||||
reseller_id | integer | ID Реселлера, к которому относится Правило обслуживания | ||||
name | string | Название Правила обслуживания | ||||
created_at | date | Дата и время создания Правила обслуживания | ||||
updated_at | date | Дата и время последнего обновления Правила обслуживания | ||||
financial_blocking_threshold | float | Величина Порога срабатывания финансовой блокировки, заданная на уровне Правила обслуживания | ||||
due_order_period | integer | Период отсрочки оплаты Заказа по предоплате в днях | ||||
subzero_period | integer | Разрешенный период отрицательного баланса в днях. Значение "-1" подразумевает бесконечный период | ||||
stop_subscription_type | string | Способ остановки Подписок Клиента при переходе Клиента в статус Финансовая блокировка (список способов остановки Подписок см. в Создание Правила обслуживания) | ||||
key | string | Ключ Правила обслуживания. Ключ может быть использован при обращении к правилу обслуживания через API или при настройке Событий уведомлений | ||||
color | string | Цвет метки в Списке клиентов, который используется для Клиентов, обслуживаемых по данному Правилу | ||||
guaranteed_payment_limit | integer | Лимит (максимальная величина) Обещанного платежа | ||||
guaranteed_payment_period | integer | Период обещанного платежа в днях | ||||
delete_subscription_type | string | Способ удаления Подписок Клиента (список способов удаления Подписок см. в Создание Правила обслуживания) | ||||
denominated | bool | Признак выполнения деноминации Правила обслуживания:
| ||||
buy_with_negative_balance | bool | Признак доступности оплаты с отрицательным балансом по предоплате:
| ||||
receipt_day | integer | День выставления счетов (поле устарело и не используется) | ||||
payment_model | string | Модель оплаты:
| ||||
default | bool | Признак Правила обслуживания по умолчанию для новых Клиентов:
| ||||
due_payment_period | integer | Период отсрочки Платежа по постоплате в днях | ||||
subscription_credit_limit | float | Величина Кредитного лимита по подписке, заданная на уровне Правила обслуживания | ||||
relationships | object | Информация о связанных объектах | ||||
subscriptions | object | Информация о связанных Подписках | ||||
data | array | Информация о Подписке | ||||
id | integer | ID Подписки | ||||
type | string | Тип данных |
Пример запроса
GET /api/v3/resellers/1/child_reseller_accounts/167
Host: test.activeplatform.com
Content-Type: application/vnd.api+json
X-Api-Token: vY5fwetestK3gJXZH5uHCw
Accept: application/vnd.api+json
Пример ответа
{
"data": {
"id": "167",
"type": "accounts",
"attributes": {
"created_at": "2017-08-16T12:48:21.629+03:00",
"updated_at": "2020-03-02T01:18:33.431+03:00",
"reseller_id": 1,
"name": "John New",
"account_class_id": 1,
"primary_name": "",
"first_name": "John",
"middle_name": "",
"last_name": "New",
"country": "BY",
"region": "1",
"city": "Brest",
"street": "Main",
"building": "",
"office": "29",
"zip": "200000",
"phone": "+375292000000",
"email": "example@gmail.com",
"status": "active",
"balance": "123423.0",
"current_debt": 0.0,
"subscription_credit_limit": 0.0,
"financial_blocking_threshold": 100.0,
"account_type_id": 1,
"manager_id": 50,
"owner_id": 447,
"tech_user_id": 447,
"bill_user_id": 447,
"custom_attributes": {
"personal_number": "1234123",
"birth_date": "03.08.2017",
"passport_date_of_issue": "22.08.2017",
"passport_number": "qwer",
"passport_issued_by": "432",
"dns": "0",
"invoice": "0"
},
"manager": {
"created_at": "2016-11-30T13:16:27.169+03:00",
"updated_at": "2019-05-29T10:24:04.734+03:00",
"reseller_id": 1,
"id": 50,
"name": "Sales Manager",
"status": "active",
"email": "example@gmail.com",
"role": "sales",
"custom_attributes": {
"manager": "",
"m_anager": "",
"manager_attribute": "1"
}
},
"owner": {
"created_at": "2020-11-19T11:42:21.421+03:00",
"updated_at": "2020-11-19T11:42:21.421+03:00",
"email": "kristoffer.haag@example.com",
"account_status": "active",
"global_status": "active",
"first_name": "Carlo",
"middle_name": "",
"last_name": "Yundt"
},
"account_product_managers": [],
"self_registration": false,
"default_payment_model": "prepay",
"account_type": {
"id": 1,
"name": "Personal BLR",
"created_at": "2016-08-25T09:26:12.658+03:00",
"updated_at": "2019-05-08T07:21:42.843+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": 1,
"reseller_id": 1,
"name": "Default",
"created_at": "2016-08-25T09:26:12.820+03:00",
"updated_at": "2019-09-20T10:45:48.595+03:00",
"financial_blocking_threshold": "100.0",
"due_order_period": 90,
"subzero_period": 1,
"stop_subscription_type": "automatically",
"key": "default",
"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": "prepay",
"default": false,
"due_payment_period": 30,
"subscription_credit_limit": "0.0"
}
},
"relationships": {
"subscriptions": {
"data": [
{
"id": "3002319",
"type": "subscriptions"
}
]
}
}
}
}