Получение информации о Клиенте Реселлера по ID
Метод Get the Reseller's Account by ID используется для получения информации о Клиенте Реселлера по указанному ID Клиента для текущего Реселлера или любого из его нижестоящих Реселлеров.
Доступ к текущему Реселлеру, относительно которого формируется список нижестоящих Реселлеров, определяется по токену Сотрудника, указанному в заголовке запроса.
GET {base_url}/api/v3/resellers/{reseller_id}/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 | string | Полный Баланс клиента как сумма свободных средств (см. usable_balance) и всех заблокированных Списаний | ||||
usable_balance | string | Свободные средства на Балансе клиента | ||||
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/accounts/505
Host: test.activeplatform.com
Content-Type: application/vnd.api+json
X-Api-Token: vY5fwetestK3gJXZH5uHCw
Accept: application/vnd.api+json
Пример ответа
{
"data": {
"id": "505",
"type": "accounts",
"attributes": {
"created_at": "2019-10-15T13:08:36.440+03:00",
"updated_at": "2020-07-07T11:06:27.264+03:00",
"reseller_id": 1,
"name": "Marcelo Ivanou",
"account_class_id": 1,
"primary_name": "Test api doc",
"first_name": "Marcelo",
"middle_name": "",
"last_name": "Ivanou",
"country": "BY",
"region": "Минская область",
"city": "Минск",
"street": "Lenina",
"building": "1",
"office": "",
"zip": "220007",
"phone": "+375295555555",
"email": "test@example.com",
"status": "active",
"balance": "380.39",
"usable_balance": "380.39",
"current_debt": 0.0,
"subscription_credit_limit": 11000.0,
"financial_blocking_threshold": 0.0,
"account_type_id": 1,
"manager_id": 50,
"owner_id": 874,
"tech_user_id": 874,
"bill_user_id": 874,
"custom_attributes": {
"birth_date": "10.08.2016",
"dns": "",
"invoice": "",
"passport_date_of_issue": "01.07.2016",
"passport_issued_by": "Goverment",
"passport_number": "1124111111122",
"personal_number": "A4411111BB1199"
},
"manager": {
"created_at": "2016-11-30T13:16:27.169+03:00",
"updated_at": "2019-11-22T14:13:28.970+03:00",
"reseller_id": 1,
"id": 50,
"name": "Sales Manager",
"status": "active",
"email": "test@gmail.com",
"role": "sales",
"custom_attributes": {
"ManagerString": "Test"
}
},
"owner": {
"created_at": "2016-10-26T17:38:37.551+03:00",
"updated_at": "2016-12-23T15:04:48.172+03:00",
"email": "owner@example.by",
"account_status": "active",
"global_status": "active",
"first_name": "Alex",
"middle_name": "",
"last_name": "Owner"
},
"account_product_managers": [
{
"id": 431,
"account_id": 710,
"product_id": 400,
"responsible_product_manager_id": 3,
"manager_product_role_id": 2,
"created_at": "2020-12-09T06:15:52.348+03:00",
"updated_at": "2020-12-16T15:38:56.541+03:00"
},
{
"id": 9,
"account_id": 710,
"product_id": 400,
"responsible_product_manager_id": 1,
"manager_product_role_id": 1,
"created_at": "2020-12-09T06:13:40.744+03:00",
"updated_at": "2020-12-16T15:38:56.533+03:00"
}
],
"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": "2021-03-04T06:12:01.425+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": true
},
"account_class": {
"id": 1,
"reseller_id": 1,
"name": "Default",
"created_at": "2016-08-25T09:26:12.820+03:00",
"updated_at": "2020-09-05T10:29:21.844+03:00",
"financial_blocking_threshold": "0.0",
"due_order_period": 90,
"subzero_period": 0,
"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": "postpay",
"default": true,
"due_payment_period": 3,
"subscription_credit_limit": "222.0"
}
},
"relationships": {
"subscriptions": {
"data": [
{
"id": "3005863",
"type": "subscriptions"
},
{
"id": "3005862",
"type": "subscriptions"
},
{
"id": "3005749",
"type": "subscriptions"
},
{
"id": "3005691",
"type": "subscriptions"
},
{
"id": "3006017",
"type": "subscriptions"
},
{
"id": "3005871",
"type": "subscriptions"
},
{
"id": "3005868",
"type": "subscriptions"
},
{
"id": "3006016",
"type": "subscriptions"
},
{
"id": "3005870",
"type": "subscriptions"
},
{
"id": "3005869",
"type": "subscriptions"
},
{
"id": "3005867",
"type": "subscriptions"
},
{
"id": "3005865",
"type": "subscriptions"
},
{
"id": "3005875",
"type": "subscriptions"
},
{
"id": "3005866",
"type": "subscriptions"
},
{
"id": "3005864",
"type": "subscriptions"
},
{
"id": "3005861",
"type": "subscriptions"
},
{
"id": "3006034",
"type": "subscriptions"
}
]
}
}
}
}