Account — обслуживание абонентов (для обслуживающей организации)

Ниже описаны методы группы Account внешнего программного интерфейса Менеджера сервиса, предназначенные для обслуживания абонентов их обслуживающей организацией.

Методы группы account, доступные пользователям обычных абонентов (не обслуживающих организаций), описаны здесь.

Сводка по методам

Метод	Назначение
account/attached_info_for_subscribing	Дополнительные сведения абонента, нужные для оформления платной подписки
account/confirm_sso_key	Подтвердить получение и активировать ключ SSO авторизации пользователей абонентов
account/truncate_sso_key	Удалить все ключи SSO авторизации, кроме актуального
account/update_attached_info	Обновить дополнительные реквизиты и сведения абонента
account/update_sso_key	Отправить запрос на обновление ключа SSO авторизации
account/customer_subscriptions/create	Создать новую подписку обслуживаемого абонента
account/customer_subscriptions/create_enhanced	Создать новую подписку обслуживаемого абонента на расширение тарифа
account/customer_subscriptions/create_upgrade	Создать новую подписку обслуживаемого абонента на апгрейд тарифа
account/customer_subscriptions/extend	Создать расширяющую подписку обслуживаемого абонента
account/customer_subscriptions/info	Информация о подписке обслуживаемого абонента
account/customer_subscriptions/list	Cписок подписок обслуживаемых абонентов
account/customer_subscriptions/prolong	Создать продлевающую подписку обслуживаемого абонента
account/customer_subscriptions/renew	Возобновить подписку обслуживаемого абонента с другим сроком действия
account/customer_subscriptions/set_servant_tariff	Установить тариф обслуживающей организации в существующей подписке
account/customers/attached_info	Значения дополнительных реквизитов и сведений обслуживаемого абонента
account/customers/fill_by_public_id	Заполнение сведений абонента по публичному идентификатору
account/customers/info	Свойства и контактные данные обслуживаемого абонента
account/customers/list	Cписок обслуживаемых абонентов
account/customers/update_attached_info	Обновить дополнительные реквизиты и сведения обслуживаемого абонента
account/site/list	Cписок сайтов обслуживающей организации для внешней регистрации
account/users/update	Обновить пользователя абонента

account/attached_info_for_subscribing

Дополнительные сведения абонента, нужные для оформления платной подписки

Параметр	Тип	Описание	Пример
Запрос
id	Число (+12.0)	Код абонента	1010
Ответ
errors	Булево	Признак наличия ошибок заполнения	false
properties	Список (0..*)	Дополнительные сведения
- key	Строка переменная (100)	Имя свойства	ТребуетсяПроверка
- name *	Строка переменная (75)	Заголовок свойства	Требуется проверка
- value *	Число (любое), Строка неограниченной длины, Дата и время в строке формата ISO, Булево	Значение свойства	true
- type	Строка (перечисление)	Тип свойства: additional_value (Дополнительное значение) additional_value_group (Дополнительное значение (иерархия)) boolean (Булево) date (Дата) decimal (Число) service (Услуга) service_provider_tariff (Тариф поставщика услуг) string (Строка) subscriber (Абонент) subscription (Подписка) tariff (Тариф) tariff_period (Период действия) undefined (Не определено) user (Пользователь)	boolean
- required *	Булево	Заполнять обязательно	true
- tooltip *	Строка неограниченной длины	Подсказка	Текст подсказки.
- error *	Булево	Признак ошибки	false
- message *	Строка неограниченной длины	Описание ошибки
fields	Список (0..*)	Дополнительные реквизиты
- key	Строка переменная (100)	Имя реквизита	ТребуетсяПроверка
- name *	Строка переменная (75)	Заголовок реквизита	Требуется проверка
- value *	Число (любое), Строка неограниченной длины, Дата и время в строке формата ISO, Булево	Значение реквизита	true
- type	Строка (перечисление)	Тип реквизита: additional_value (Дополнительное значение) additional_value_group (Дополнительное значение (иерархия)) boolean (Булево) date (Дата) decimal (Число) service (Услуга) service_provider_tariff (Тариф поставщика услуг) string (Строка) subscriber (Абонент) subscription (Подписка) tariff (Тариф) tariff_period (Период действия) undefined (Не определено) user (Пользователь)	boolean
- required *	Булево	Заполнять обязательно	true
- tooltip *	Строка неограниченной длины	Подсказка	Текст подсказки.
- error *	Булево	Признак ошибки	false
- message *	Строка неограниченной длины	Описание ошибки

Пример запроса Развернуть

POST https://1cfresh.com/a/adm/hs/ext_api/execute/usr/account/attached_info_for_subscribing
Authorization: Basic base64_encode(user:password) или Bearer access_token

{
  "id": 1010,
  "auth": {
    "account": 1010
  }
}

Пример ответа Развернуть

{
  "errors": false,
  "properties": [
    {
      "key": "ТребуетсяПроверка",
      "name": "Требуется проверка",
      "value": true,
      "type": "boolean",
      "required": true,
      "tooltip": "Текст подсказки.",
      "error": false,
      "message": ""
    }
  ],
  "fields": [
    {
      "key": "ТребуетсяПроверка",
      "name": "Требуется проверка",
      "value": true,
      "type": "boolean",
      "required": true,
      "tooltip": "Текст подсказки.",
      "error": false,
      "message": ""
    }
  ],
  "general": {
    "response": 10200,
    "error": false,
    "message": "",
    "version": 37,
    "sm_version": "1.1.48.6",
    "sm_timezone": "Europe/Moscow"
  }
}

Вверх

account/confirm_sso_key

Подтвердить получение и активировать ключ SSO авторизации пользователей абонентов

Параметр	Тип	Описание	Пример
Запрос
account	Число (+12.0)	Код обслуживающей организации	1000
key_id	Уникальный идентификатор	Идентификатор ключа SSO авторизации	abf7c2a7-1df7-4646-9327-2866804b6ce2
Ответ
Нет параметров

Пример запроса Развернуть

POST https://1cfresh.com/a/adm/hs/ext_api/execute/usr/account/confirm_sso_key
Authorization: Basic base64_encode(user:password) или Bearer access_token

{
  "account": 1000,
  "key_id": "abf7c2a7-1df7-4646-9327-2866804b6ce2",
  "auth": {
    "account": 1000
  }
}

Пример ответа Развернуть

{
  "general": {
    "response": 10200,
    "error": false,
    "message": "",
    "version": 37,
    "sm_version": "1.1.48.6",
    "sm_timezone": "Europe/Moscow"
  }
}

Вверх

account/truncate_sso_key

Удалить все ключи SSO авторизации, кроме актуального

Параметр	Тип	Описание	Пример
Запрос
account	Число (+12.0)	Код обслуживающей организации	1000
actual_key_id	Уникальный идентификатор	Идентификатор актуального ключа SSO авторизации	abf7c2a7-1df7-4646-9327-2866804b6ce2
Ответ
Нет параметров

Пример запроса Развернуть

POST https://1cfresh.com/a/adm/hs/ext_api/execute/usr/account/truncate_sso_key
Authorization: Basic base64_encode(user:password) или Bearer access_token

{
  "account": 1000,
  "actual_key_id": "abf7c2a7-1df7-4646-9327-2866804b6ce2",
  "auth": {
    "account": 1000
  }
}

Пример ответа Развернуть

{
  "general": {
    "response": 10200,
    "error": false,
    "message": "",
    "version": 37,
    "sm_version": "1.1.48.6",
    "sm_timezone": "Europe/Moscow"
  }
}

Вверх

account/update_attached_info

Обновить дополнительные реквизиты и сведения абонента

Параметр	Тип	Описание	Пример
Запрос
id	Число (+12.0)	Код абонента	1010
properties *		Дополнительные сведения
- key	Строка переменная (100)	Имя свойства	ТребуетсяПроверка
- value *	Число (любое), Строка неограниченной длины, Дата и время в строке формата ISO, Булево	Значение свойства	true
- type *	Строка (перечисление)	Тип свойства: additional_value (Дополнительное значение) additional_value_group (Дополнительное значение (иерархия)) boolean (Булево) date (Дата) decimal (Число) service (Услуга) service_provider_tariff (Тариф поставщика услуг) string (Строка) subscriber (Абонент) subscription (Подписка) tariff (Тариф) tariff_period (Период действия) undefined (Не определено) user (Пользователь)	boolean
fields *		Дополнительные реквизиты
- key	Строка переменная (100)	Имя реквизита	ТребуетсяПроверка
- value *	Число (любое), Строка неограниченной длины, Дата и время в строке формата ISO, Булево	Значение реквизита	true
- type *	Строка (перечисление)	Тип реквизита: additional_value (Дополнительное значение) additional_value_group (Дополнительное значение (иерархия)) boolean (Булево) date (Дата) decimal (Число) service (Услуга) service_provider_tariff (Тариф поставщика услуг) string (Строка) subscriber (Абонент) subscription (Подписка) tariff (Тариф) tariff_period (Период действия) undefined (Не определено) user (Пользователь)	boolean
Ответ
Нет параметров

Пример запроса Развернуть

POST https://1cfresh.com/a/adm/hs/ext_api/execute/usr/account/update_attached_info
Authorization: Basic base64_encode(user:password) или Bearer access_token

{
  "id": 1010,
  "properties": [
    {
      "key": "ТребуетсяПроверка",
      "value": true,
      "type": "boolean"
    }
  ],
  "fields": [
    {
      "key": "ТребуетсяПроверка",
      "value": true,
      "type": "boolean"
    }
  ],
  "auth": {
    "account": 1010
  }
}

Пример ответа Развернуть

{
  "general": {
    "response": 10200,
    "error": false,
    "message": "",
    "version": 37,
    "sm_version": "1.1.48.6",
    "sm_timezone": "Europe/Moscow"
  }
}

Вверх

account/update_sso_key

Отправить запрос на обновление ключа SSO авторизации

Параметр	Тип	Описание	Пример
Запрос
account	Число (+12.0)	Код обслуживающей организации	1000
key_id	Уникальный идентификатор	Идентификатор ключа SSO авторизации	abf7c2a7-1df7-4646-9327-2866804b6ce3
max_age	Число (+7.0)	Срок жизни ключа SSO авторизации	1800
Ответ: key_id (1)
Нет параметров

Пример запроса Развернуть

POST https://1cfresh.com/a/adm/hs/ext_api/execute/usr/account/update_sso_key
Authorization: Basic base64_encode(user:password) или Bearer access_token

{
  "account": 1000,
  "key_id": "abf7c2a7-1df7-4646-9327-2866804b6ce3",
  "max_age": 1800,
  "auth": {
    "account": 1000
  }
}

Пример ответа Развернуть

{
  "key_id": "abf7c2a7-1df7-4646-9327-2866804b6ce3",
  "general": {
    "response": 10200,
    "error": false,
    "message": "",
    "version": 37,
    "sm_version": "1.1.48.6",
    "sm_timezone": "Europe/Moscow"
  }
}

Вверх

account/customer_subscriptions/create

Создать новую подписку обслуживаемого абонента

Параметр	Тип	Описание	Пример
Запрос
servant	Число (+12.0)	Код ведущего абонента	1000
account	Число (+12.0)	Код обслуживаемого абонента	1010
start	Дата и время в строке формата ISO	Начало действия	03.09.2025 0:00:00
completion *	Дата и время в строке формата ISO	Завершение действия	02.09.2026 23:59:59
servant_tariff *	Строка переменная (9)	Код тарифа обслуживающей организации	SERV00001
tariff *	Строка переменная (9)	Код тарифа - обязательно, если не указан servant_tariff (Код тарифа обслуживающей организации)	PROV00001
period *	Строка переменная (10)	Код периода действия	1YR
accept_intersections *	Булево	Допустимо наличие пересечений по периоду действия с имеющимися подписками на тот же тариф	true
Ответ
id *	Строка переменная (9)	Номер созданной подписки	000000002
completion *	Дата и время в строке формата ISO	Завершение действия	02.09.2026 23:59:59

Пример запроса Развернуть

POST https://1cfresh.com/a/adm/hs/ext_api/execute/usr/account/customer_subscriptions/create
Authorization: Basic base64_encode(user:password) или Bearer access_token

{
  "servant": 1000,
  "account": 1010,
  "start": "2025-09-03T00:00:00",
  "completion": "2026-09-02T23:59:59",
  "servant_tariff": "SERV00001",
  "tariff": "PROV00001",
  "period": "1YR",
  "accept_intersections": true,
  "auth": {
    "account": 1010
  }
}

Пример ответа Развернуть

{
  "id": "000000002",
  "completion": "2026-09-02T23:59:59",
  "general": {
    "response": 10200,
    "error": false,
    "message": "",
    "version": 37,
    "sm_version": "1.1.48.6",
    "sm_timezone": "Europe/Moscow"
  }
}

Вверх

account/customer_subscriptions/create_enhanced

Создать новую подписку обслуживаемого абонента на расширение тарифа

Параметр	Тип	Описание	Пример
Запрос
servant	Число (+12.0)	Код ведущего абонента	1000
account	Число (+12.0)	Код обслуживаемого абонента	1010
start *	Дата и время в строке формата ISO	Начало действия	03.09.2025 0:00:00
completion *	Дата и время в строке формата ISO	Завершение действия	02.09.2026 23:59:59
period *	Строка переменная (10)	Код периода действия	1YR
tariff	Строка переменная (9)	Код расширяющего тарифа	000000002
servant_tariff *	Строка переменная (9)	Код тарифа обслуживающей организации	SERV00001
parent	Строка переменная (9)	Номер основной подписки	000000001
amount *	Число (+3.0)	Количество создаваемых подписок	1
Ответ
subscription	Список (0..*)	Список номеров созданных подписок	["000000002"]
subscription_info	Список (0..*)	Список завершений созданных подписок
- id	Строка переменная (9)	Номер созданной подписки	000000002
- completion	Дата и время в строке формата ISO	Завершение действия	02.09.2026 23:59:59

Пример запроса Развернуть

POST https://1cfresh.com/a/adm/hs/ext_api/execute/usr/account/customer_subscriptions/create_enhanced
Authorization: Basic base64_encode(user:password) или Bearer access_token

{
  "servant": 1000,
  "account": 1010,
  "start": "2025-09-03T00:00:00",
  "completion": "2026-09-02T23:59:59",
  "period": "1YR",
  "tariff": "000000002",
  "servant_tariff": "SERV00001",
  "parent": "000000001",
  "amount": 1,
  "auth": {
    "account": 1010
  }
}

Пример ответа Развернуть

{
  "subscription": [
    "000000002"
  ],
  "subscription_info": [
    {
      "id": "000000002",
      "completion": "2026-09-02T23:59:59"
    }
  ],
  "general": {
    "response": 10200,
    "error": false,
    "message": "",
    "version": 37,
    "sm_version": "1.1.48.6",
    "sm_timezone": "Europe/Moscow"
  }
}

Вверх

account/customer_subscriptions/create_upgrade

Создать новую подписку обслуживаемого абонента на апгрейд тарифа

Параметр	Тип	Описание	Пример
Запрос
account	Число (+12.0)	Код обслуживаемого абонента	1010
start *	Дата и время в строке формата ISO	Начало действия	03.09.2025 0:00:00
period *	Строка переменная (10)	Код периода действия	1YR
tariff	Строка переменная (9)	Код тарифа-апгрейда	000000002
servant_tariff *	Строка переменная (9)	Код тарифа обслуживающей организации	SERV00001
parent	Строка переменная (9)	Номер основной подписки	000000001
Ответ
id *	Строка переменная (9)	Номер созданной подписки	000000002
completion *	Дата и время в строке формата ISO	Завершение действия	02.09.2026 23:59:59

Пример запроса Развернуть

POST https://1cfresh.com/a/adm/hs/ext_api/execute/usr/account/customer_subscriptions/create_upgrade
Authorization: Basic base64_encode(user:password) или Bearer access_token

{
  "account": 1010,
  "start": "2025-09-03T00:00:00",
  "period": "1YR",
  "tariff": "000000002",
  "servant_tariff": "SERV00001",
  "parent": "000000001",
  "auth": {
    "account": 1010
  }
}

Пример ответа Развернуть

{
  "id": "000000002",
  "completion": "2026-09-02T23:59:59",
  "general": {
    "response": 10200,
    "error": false,
    "message": "",
    "version": 37,
    "sm_version": "1.1.48.6",
    "sm_timezone": "Europe/Moscow"
  }
}

Вверх

account/customer_subscriptions/extend

Создать расширяющую подписку обслуживаемого абонента

Параметр	Тип	Описание	Пример
Запрос
servant	Число (+12.0)	Код ведущего абонента	1000
account	Число (+12.0)	Код обслуживаемого абонента	1010
id	Строка переменная (9)	Номер основной подписки	000000001
Ответ: id (1)
Нет параметров

Пример запроса Развернуть

POST https://1cfresh.com/a/adm/hs/ext_api/execute/usr/account/customer_subscriptions/extend
Authorization: Basic base64_encode(user:password) или Bearer access_token

{
  "servant": 1000,
  "account": 1010,
  "id": "000000001",
  "auth": {
    "account": 1010
  }
}

Пример ответа Развернуть

{
  "id": "000000002",
  "general": {
    "response": 10200,
    "error": false,
    "message": "",
    "version": 37,
    "sm_version": "1.1.48.6",
    "sm_timezone": "Europe/Moscow"
  }
}

Вверх

account/customer_subscriptions/info

Информация о подписке обслуживаемого абонента

Параметр	Тип	Описание	Пример
Запрос
servant *	Число (+12.0)	Код ведущего абонента	1000
account *	Число (+12.0)	Код обслуживаемого абонента	1010
id	Строка переменная (9)	Номер подписки	000000001
Ответ: subscription (1)
id	Строка переменная (9)	Номер подписки	000000001
created	Дата и время в строке формата ISO	Дата оформления подписки	28.02.2019 10:00:00
updated *	Дата и время в строке формата ISO	Дата изменения подписки	28.02.2019 10:00:00
start	Дата и время в строке формата ISO	Начало действия	03.09.2025 0:00:00
completion	Дата и время в строке формата ISO	Завершение действия	02.09.2026 23:59:59
account	Число (+12.0)	Код обслуживаемого абонента	1010
servant	Число (+12.0)	Код ведущего абонента	1000
servant_tariff *	Строка переменная (9)	Код тарифа обслуживающей организации	SERV00001
tariff	Строка переменная (9)	Код тарифа	PROV00001
period *	Строка переменная (10)	Код периода действия	1YR
parent *	Строка переменная (9)	Номер основной подписки
type	Строка (перечисление)	Тип подписки: basic (Основная) extending (Расширяющая) prolonging (Продлевающая)	basic
amount	Число (+10.0)	Количество	1
bill *	Строка переменная (9)	Номер счета на оплату	000000001
bill_id *	Строка переменная (36)	Идентификатор счета на оплату	00000000-0000-0000-0000-000000000000
services	Список (0..*)	Услуги
- id	Строка переменная (9)	Код услуги	000000001
- name	Строка переменная (100)	Наименование услуги	Количество прав пользователей на запуск приложений
- service_id	Строка переменная (50)	Идентификатор услуги	КоличествоПравПользователейНаЗапускПриложений
- provider_name	Строка переменная (150)	Наименование поставщика услуги	Менеджер сервиса
- provider_id	Строка переменная (50)	Идентификатор поставщика услуги	sm
- description *	Строка неограниченной длины	Описание
- type	Строка (перечисление)	Тип услуги: limited (Лимитированная) unique (Уникальная) unlimited (Безлимитная)	limited
- activation_status *	Строка (перечисление)	Состояние активации: activated (Активирована) error (Ошибка при активации) in_process (В процессе активации)	activated
- amount	Число (+10.0)	Количество лицензий	1
- start_date *	Дата и время в строке формата ISO	Дата подключения	01.01.2020 0:00:00
- end_date *	Дата и время в строке формата ISO	Дата отключения	28.02.2020 0:00:00

Пример запроса Развернуть

POST https://1cfresh.com/a/adm/hs/ext_api/execute/usr/account/customer_subscriptions/info
Authorization: Basic base64_encode(user:password) или Bearer access_token

{
  "servant": 1000,
  "account": 1010,
  "id": "000000001",
  "auth": {
    "account": 1010
  }
}

Пример ответа Развернуть

{
  "subscription": {
    "id": "000000001",
    "created": "2019-02-28T10:00:00",
    "updated": "2019-02-28T10:00:00",
    "start": "2025-09-03T00:00:00",
    "completion": "2026-09-02T23:59:59",
    "account": 1010,
    "servant": 1000,
    "servant_tariff": "SERV00001",
    "tariff": "PROV00001",
    "period": "1YR",
    "parent": "",
    "type": "basic",
    "amount": 1,
    "bill": "000000001",
    "bill_id": "00000000-0000-0000-0000-000000000000",
    "services": [
      {
        "id": "000000001",
        "name": "Количество прав пользователей на запуск приложений",
        "service_id": "КоличествоПравПользователейНаЗапускПриложений",
        "provider_name": "Менеджер сервиса",
        "provider_id": "sm",
        "description": "",
        "type": "limited",
        "activation_status": "activated",
        "amount": 1,
        "start_date": "2020-01-01T00:00:00",
        "end_date": "2020-02-28T00:00:00"
      }
    ]
  },
  "general": {
    "response": 10200,
    "error": false,
    "message": "",
    "version": 37,
    "sm_version": "1.1.48.6",
    "sm_timezone": "Europe/Moscow"
  }
}

Вверх

account/customer_subscriptions/list

Cписок подписок обслуживаемых абонентов

Параметр	Тип	Описание	Пример
Запрос
scope *	Массив из Строка (перечисление)	Параметры получения данных: services (Включать услуги)	["services"]
servant	Число (+12.0)	Код ведущего абонента	1000
account *	Число (+12.0)	Код обслуживаемого абонента	1010
active *	Булево	Получение только активных подписок	true
basic *	Булево	Получение только основных подписок	false
start_date *	Дата и время в строке формата ISO	Дата создания подписки. Начальная, для отбора по периоду	01.01.2020 0:00:00
end_date *	Дата и время в строке формата ISO	Дата создания подписки. Конечная, для отбора по периоду	28.02.2020 0:00:00
Ответ: subscription (0..*)
id	Строка переменная (9)	Номер подписки	000000001
created	Дата и время в строке формата ISO	Дата оформления подписки	28.02.2019 10:00:00
updated *	Дата и время в строке формата ISO	Дата изменения подписки	28.02.2019 10:00:00
start	Дата и время в строке формата ISO	Начало действия	03.09.2025 0:00:00
completion	Дата и время в строке формата ISO	Завершение действия	02.09.2026 23:59:59
account	Число (+12.0)	Код обслуживаемого абонента	1010
servant	Число (+12.0)	Код ведущего абонента	1000
servant_tariff *	Строка переменная (9)	Код тарифа обслуживающей организации	SERV00001
tariff	Строка переменная (9)	Код тарифа	PROV00001
period *	Строка переменная (10)	Код периода действия	1YR
parent *	Строка переменная (9)	Номер основной подписки
type	Строка (перечисление)	Тип подписки: basic (Основная) extending (Расширяющая) prolonging (Продлевающая)	basic
amount	Число (+10.0)	Количество	1
bill *	Строка переменная (9)	Номер счета на оплату	000000001
bill_id *	Строка переменная (36)	Идентификатор счета на оплату	00000000-0000-0000-0000-000000000000
services	Список (0..*)	Услуги
- id	Строка переменная (9)	Код услуги	000000001
- name	Строка переменная (100)	Наименование услуги	Количество прав пользователей на запуск приложений
- service_id	Строка переменная (50)	Идентификатор услуги	КоличествоПравПользователейНаЗапускПриложений
- provider_name	Строка переменная (150)	Наименование поставщика услуги	Менеджер сервиса
- provider_id	Строка переменная (50)	Идентификатор поставщика услуги	sm
- description *	Строка неограниченной длины	Описание
- type	Строка (перечисление)	Тип услуги: limited (Лимитированная) unique (Уникальная) unlimited (Безлимитная)	limited
- activation_status *	Строка (перечисление)	Состояние активации: activated (Активирована) error (Ошибка при активации) in_process (В процессе активации)	activated
- amount	Число (+10.0)	Количество лицензий	1
- start_date *	Дата и время в строке формата ISO	Дата подключения	01.01.2020 0:00:00
- end_date *	Дата и время в строке формата ISO	Дата отключения	28.02.2020 0:00:00

Пример запроса Развернуть

POST https://1cfresh.com/a/adm/hs/ext_api/execute/usr/account/customer_subscriptions/list
Authorization: Basic base64_encode(user:password) или Bearer access_token

{
  "servant": 1000,
  "auth": {
    "account": 1010
  }
}

Пример ответа Развернуть

{
  "subscription": [
    {
      "id": "000000001",
      "created": "2019-02-28T10:00:00",
      "updated": "2019-02-28T10:00:00",
      "start": "2025-09-03T00:00:00",
      "completion": "2026-09-02T23:59:59",
      "account": 1010,
      "servant": 1000,
      "servant_tariff": "SERV00001",
      "tariff": "PROV00001",
      "period": "1YR",
      "parent": "",
      "type": "basic",
      "amount": 1,
      "bill": "000000001",
      "bill_id": "00000000-0000-0000-0000-000000000000",
      "services": [
        {
          "id": "000000001",
          "name": "Количество прав пользователей на запуск приложений",
          "service_id": "КоличествоПравПользователейНаЗапускПриложений",
          "provider_name": "Менеджер сервиса",
          "provider_id": "sm",
          "description": "",
          "type": "limited",
          "activation_status": "activated",
          "amount": 1,
          "start_date": "2020-01-01T00:00:00",
          "end_date": "2020-02-28T00:00:00"
        }
      ]
    }
  ],
  "general": {
    "response": 10200,
    "error": false,
    "message": "",
    "version": 37,
    "sm_version": "1.1.48.6",
    "sm_timezone": "Europe/Moscow"
  }
}

Вверх

account/customer_subscriptions/prolong

Создать продлевающую подписку обслуживаемого абонента

Параметр	Тип	Описание	Пример
Запрос
servant	Число (+12.0)	Код ведущего абонента	1000
account	Число (+12.0)	Код обслуживаемого абонента	1010
id	Строка переменная (9)	Номер основной подписки	000000001
Ответ: id (1)
Нет параметров

Пример запроса Развернуть

POST https://1cfresh.com/a/adm/hs/ext_api/execute/usr/account/customer_subscriptions/prolong
Authorization: Basic base64_encode(user:password) или Bearer access_token

{
  "servant": 1000,
  "account": 1010,
  "id": "000000001",
  "auth": {
    "account": 1010
  }
}

Пример ответа Развернуть

{
  "id": "000000002",
  "general": {
    "response": 10200,
    "error": false,
    "message": "",
    "version": 37,
    "sm_version": "1.1.48.6",
    "sm_timezone": "Europe/Moscow"
  }
}

Вверх

account/customer_subscriptions/renew

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

Параметр	Тип	Описание	Пример
Запрос
servant	Число (+12.0)	Код ведущего абонента	1000
account	Число (+12.0)	Код обслуживаемого абонента	1010
start *	Дата и время в строке формата ISO	Начало действия	03.09.2025 0:00:00
completion *	Дата и время в строке формата ISO	Завершение действия	02.09.2026 23:59:59
id	Строка переменная (9)	Номер основной подписки	000000001
period *	Строка переменная (10)	Код периода действия	1YR
accept_intersections *	Булево	Допустимо наличие пересечений по периоду действия с имеющимися подписками на тот же тариф	true
Ответ
id *	Строка переменная (9)	Номер созданной подписки	000000002
completion *	Дата и время в строке формата ISO	Завершение действия	02.09.2026 23:59:59

Пример запроса Развернуть

POST https://1cfresh.com/a/adm/hs/ext_api/execute/usr/account/customer_subscriptions/renew
Authorization: Basic base64_encode(user:password) или Bearer access_token

{
  "servant": 1000,
  "account": 1010,
  "start": "2025-09-03T00:00:00",
  "completion": "2026-09-02T23:59:59",
  "id": "000000001",
  "period": "1YR",
  "accept_intersections": true,
  "auth": {
    "account": 1010
  }
}

Пример ответа Развернуть

{
  "id": "000000002",
  "completion": "2026-09-02T23:59:59",
  "general": {
    "response": 10200,
    "error": false,
    "message": "",
    "version": 37,
    "sm_version": "1.1.48.6",
    "sm_timezone": "Europe/Moscow"
  }
}

Вверх

account/customer_subscriptions/set_servant_tariff

Установить тариф обслуживающей организации в существующей подписке

Параметр	Тип	Описание	Пример
Запрос
servant	Число (+12.0)	Код ведущего абонента	1000
account	Число (+12.0)	Код обслуживаемого абонента	1010
id	Строка переменная (9)	Номер подписки	000000001
servant_tariff	Строка переменная (9)	Код тарифа обслуживающей организации	SERV00001
Ответ
Нет параметров

Пример запроса Развернуть

POST https://1cfresh.com/a/adm/hs/ext_api/execute/usr/account/customer_subscriptions/set_servant_tariff
Authorization: Basic base64_encode(user:password) или Bearer access_token

{
  "servant": 1000,
  "account": 1010,
  "id": "000000001",
  "servant_tariff": "SERV00001",
  "auth": {
    "account": 1010
  }
}

Пример ответа Развернуть

{
  "general": {
    "response": 10200,
    "error": false,
    "message": "",
    "version": 37,
    "sm_version": "1.1.48.6",
    "sm_timezone": "Europe/Moscow"
  }
}

Вверх

account/customers/attached_info

Значения дополнительных реквизитов и сведений обслуживаемого абонента

Параметр	Тип	Описание	Пример
Запрос
id	Число (+12.0)	Код ведущего абонента	1000
account	Число (+12.0)	Код обслуживаемого абонента	1010
Ответ
public_id *	Строка переменная (36)	Публичный идентификатор	7713754211
properties	Список (0..*)	Дополнительные сведения
- key	Строка переменная (100)	Имя свойства	ТребуетсяПроверка
- name *	Строка переменная (75)	Заголовок свойства	Требуется проверка
- value *	Число (любое), Строка неограниченной длины, Дата и время в строке формата ISO, Булево	Значение свойства	true
- type	Строка (перечисление)	Тип свойства: additional_value (Дополнительное значение) additional_value_group (Дополнительное значение (иерархия)) boolean (Булево) date (Дата) decimal (Число) service (Услуга) service_provider_tariff (Тариф поставщика услуг) string (Строка) subscriber (Абонент) subscription (Подписка) tariff (Тариф) tariff_period (Период действия) undefined (Не определено) user (Пользователь)	boolean
fields	Список (0..*)	Дополнительные реквизиты
- key	Строка переменная (100)	Имя реквизита	ТребуетсяПроверка
- name *	Строка переменная (75)	Заголовок реквизита	Требуется проверка
- value *	Число (любое), Строка неограниченной длины, Дата и время в строке формата ISO, Булево	Значение реквизита	true
- type	Строка (перечисление)	Тип реквизита: additional_value (Дополнительное значение) additional_value_group (Дополнительное значение (иерархия)) boolean (Булево) date (Дата) decimal (Число) service (Услуга) service_provider_tariff (Тариф поставщика услуг) string (Строка) subscriber (Абонент) subscription (Подписка) tariff (Тариф) tariff_period (Период действия) undefined (Не определено) user (Пользователь)	boolean

Пример запроса Развернуть

POST https://1cfresh.com/a/adm/hs/ext_api/execute/usr/account/customers/attached_info
Authorization: Basic base64_encode(user:password) или Bearer access_token

{
  "id": 1000,
  "account": 1010,
  "auth": {
    "account": 1010
  }
}

Пример ответа Развернуть

{
  "public_id": "7713754211",
  "properties": [
    {
      "key": "ТребуетсяПроверка",
      "name": "Требуется проверка",
      "value": true,
      "type": "boolean"
    }
  ],
  "fields": [
    {
      "key": "ТребуетсяПроверка",
      "name": "Требуется проверка",
      "value": true,
      "type": "boolean"
    }
  ],
  "general": {
    "response": 10200,
    "error": false,
    "message": "",
    "version": 37,
    "sm_version": "1.1.48.6",
    "sm_timezone": "Europe/Moscow"
  }
}

Вверх

account/customers/fill_by_public_id

Заполнение сведений абонента по публичному идентификатору

Параметр	Тип	Описание	Пример
Запрос
id	Число (+12.0)	Код ведущего абонента	1000
account	Число (+12.0)	Код обслуживаемого абонента	1010
public_id	Строка переменная (36)	Публичный идентификатор	7713754211
Ответ
public_id	Строка переменная (36)	Публичный идентификатор	7713754211
properties	Список (0..*)	Дополнительные сведения
- key	Строка переменная (100)	Имя свойства	ТребуетсяПроверка
- name *	Строка переменная (75)	Заголовок свойства	Требуется проверка
- value *	Число (любое), Строка неограниченной длины, Дата и время в строке формата ISO, Булево	Значение свойства	true
- type	Строка (перечисление)	Тип свойства: additional_value (Дополнительное значение) additional_value_group (Дополнительное значение (иерархия)) boolean (Булево) date (Дата) decimal (Число) service (Услуга) service_provider_tariff (Тариф поставщика услуг) string (Строка) subscriber (Абонент) subscription (Подписка) tariff (Тариф) tariff_period (Период действия) undefined (Не определено) user (Пользователь)	boolean
fields	Список (0..*)	Дополнительные реквизиты
- key	Строка переменная (100)	Имя реквизита	ТребуетсяПроверка
- name *	Строка переменная (75)	Заголовок реквизита	Требуется проверка
- value *	Число (любое), Строка неограниченной длины, Дата и время в строке формата ISO, Булево	Значение реквизита	true
- type	Строка (перечисление)	Тип реквизита: additional_value (Дополнительное значение) additional_value_group (Дополнительное значение (иерархия)) boolean (Булево) date (Дата) decimal (Число) service (Услуга) service_provider_tariff (Тариф поставщика услуг) string (Строка) subscriber (Абонент) subscription (Подписка) tariff (Тариф) tariff_period (Период действия) undefined (Не определено) user (Пользователь)	boolean

Пример запроса Развернуть

POST https://1cfresh.com/a/adm/hs/ext_api/execute/usr/account/customers/fill_by_public_id
Authorization: Basic base64_encode(user:password) или Bearer access_token

{
  "id": 1000,
  "account": 1010,
  "public_id": "7713754211",
  "auth": {
    "account": 1010
  }
}

Пример ответа Развернуть

{
  "public_id": "7713754211",
  "properties": [
    {
      "key": "ТребуетсяПроверка",
      "name": "Требуется проверка",
      "value": true,
      "type": "boolean"
    }
  ],
  "fields": [
    {
      "key": "ТребуетсяПроверка",
      "name": "Требуется проверка",
      "value": true,
      "type": "boolean"
    }
  ],
  "general": {
    "response": 10200,
    "error": false,
    "message": "",
    "version": 37,
    "sm_version": "1.1.48.6",
    "sm_timezone": "Europe/Moscow"
  }
}

Вверх

account/customers/info

Свойства и контактные данные обслуживаемого абонента

Параметр	Тип	Описание	Пример
Запрос
id	Число (+12.0)	Код ведущего абонента	1000
account	Число (+12.0)	Код обслуживаемого абонента	1010
Ответ: customer (1)
name *	Строка переменная (64)	Наименование абонента	Конфетпром
id	Число (+12.0)	Код абонента	1010
city *	Строка переменная (500)	Город	Москва
site *	Строка переменная (500)	Сайт	www.example.com
email *	Строка переменная (500)	Почта	abramov@example.com
phone *	Строка переменная (500)	Телефон	+7 (495) 123-45-67
site_id *	Число (+9.0)	Идентификатор сайта	123
invitation_id *	Строка переменная (9)	Номер приглашения для регистрации	000000123
comment *	Строка переменная (255)	Комментарий	Пример комментария

Пример запроса Развернуть

POST https://1cfresh.com/a/adm/hs/ext_api/execute/usr/account/customers/info
Authorization: Basic base64_encode(user:password) или Bearer access_token

{
  "id": 1000,
  "account": 1010,
  "auth": {
    "account": 1010
  }
}

Пример ответа Развернуть

{
  "customer": {
    "name": "Конфетпром",
    "id": 1010,
    "city": "Москва",
    "site": "www.example.com",
    "email": "abramov@example.com",
    "phone": "+7 (495) 123-45-67",
    "site_id": 123,
    "invitation_id": "000000123",
    "comment": "Пример комментария"
  },
  "general": {
    "response": 10200,
    "error": false,
    "message": "",
    "version": 37,
    "sm_version": "1.1.48.6",
    "sm_timezone": "Europe/Moscow"
  }
}

Вверх

account/customers/list

Cписок обслуживаемых абонентов

Параметр	Тип	Описание	Пример
Запрос
id	Число (+12.0)	Код ведущего абонента	1000
scope *	Массив из Строка (перечисление)	Параметры получения данных: calculated_properties (Получить вычисляемые свойства) fields (Получить доп. реквизиты) properties (Получить доп. сведения)	["calculated_properties"]
Ответ: customer (0..*)
id	Число (+12.0)	Код абонента	1010
name	Строка переменная (64)	Наименование абонента	Конфетпром
public_id *	Строка переменная (36)	Публичный идентификатор	123
email *	Строка переменная (500)	Адрес электронной почты	info@example.com
calculated_properties	Список (0..*)	Вычисляемые свойства	calculated_properties
- key	Строка переменная (100)	Имя свойства	КоличествоПриложенийАбонента
- name *	Строка переменная (75)	Заголовок свойства	Количество приложений
- value *	Число (любое), Строка неограниченной длины, Дата и время в строке формата ISO, Булево	Значение свойства	3
- type	Строка (перечисление)	Тип свойства: additional_value (Дополнительное значение) additional_value_group (Дополнительное значение (иерархия)) boolean (Булево) date (Дата) decimal (Число) service (Услуга) service_provider_tariff (Тариф поставщика услуг) string (Строка) subscriber (Абонент) subscription (Подписка) tariff (Тариф) tariff_period (Период действия) undefined (Не определено) user (Пользователь)	decimal
properties	Список (0..*)	Дополнительные сведения
- key	Строка переменная (100)	Имя свойства	ТребуетсяПроверка
- name *	Строка переменная (75)	Заголовок свойства	Требуется проверка
- value *	Число (любое), Строка неограниченной длины, Дата и время в строке формата ISO, Булево	Значение свойства	true
- type	Строка (перечисление)	Тип свойства: additional_value (Дополнительное значение) additional_value_group (Дополнительное значение (иерархия)) boolean (Булево) date (Дата) decimal (Число) service (Услуга) service_provider_tariff (Тариф поставщика услуг) string (Строка) subscriber (Абонент) subscription (Подписка) tariff (Тариф) tariff_period (Период действия) undefined (Не определено) user (Пользователь)	boolean
fields	Список (0..*)	Дополнительные реквизиты
- key	Строка переменная (100)	Имя реквизита	ТребуетсяПроверка
- name *	Строка переменная (75)	Заголовок реквизита	Требуется проверка
- value *	Число (любое), Строка неограниченной длины, Дата и время в строке формата ISO, Булево	Значение реквизита	true
- type	Строка (перечисление)	Тип реквизита: additional_value (Дополнительное значение) additional_value_group (Дополнительное значение (иерархия)) boolean (Булево) date (Дата) decimal (Число) service (Услуга) service_provider_tariff (Тариф поставщика услуг) string (Строка) subscriber (Абонент) subscription (Подписка) tariff (Тариф) tariff_period (Период действия) undefined (Не определено) user (Пользователь)	boolean

Пример запроса Развернуть

POST https://1cfresh.com/a/adm/hs/ext_api/execute/usr/account/customers/list
Authorization: Basic base64_encode(user:password) или Bearer access_token

{
  "id": 1000,
  "auth": {
    "account": 1010
  }
}

Пример ответа Развернуть

{
  "customer": [
    {
      "id": 1010,
      "name": "Конфетпром",
      "public_id": "123",
      "email": "info@example.com",
      "calculated_properties": [
        {
          "key": "КоличествоПриложенийАбонента",
          "name": "Количество приложений",
          "value": 3,
          "type": "decimal"
        }
      ],
      "properties": [
        {
          "key": "ТребуетсяПроверка",
          "name": "Требуется проверка",
          "value": true,
          "type": "boolean"
        }
      ],
      "fields": [
        {
          "key": "ТребуетсяПроверка",
          "name": "Требуется проверка",
          "value": true,
          "type": "boolean"
        }
      ]
    }
  ],
  "general": {
    "response": 10200,
    "error": false,
    "message": "",
    "version": 37,
    "sm_version": "1.1.48.6",
    "sm_timezone": "Europe/Moscow"
  }
}

Вверх

account/customers/update_attached_info

Обновить дополнительные реквизиты и сведения обслуживаемого абонента

Параметр	Тип	Описание	Пример
Запрос
id	Число (+12.0)	Код ведущего абонента	1000
account	Число (+12.0)	Код обслуживаемого абонента	1010
public_id *	Строка переменная (36)	Публичный идентификатор	7713754211
properties *		Дополнительные сведения
- key	Строка переменная (100)	Имя свойства	ТребуетсяПроверка
- value *	Число (любое), Строка неограниченной длины, Дата и время в строке формата ISO, Булево	Значение свойства	true
- type *	Строка (перечисление)	Тип свойства: additional_value (Дополнительное значение) additional_value_group (Дополнительное значение (иерархия)) boolean (Булево) date (Дата) decimal (Число) service (Услуга) service_provider_tariff (Тариф поставщика услуг) string (Строка) subscriber (Абонент) subscription (Подписка) tariff (Тариф) tariff_period (Период действия) undefined (Не определено) user (Пользователь)	boolean
fields *		Дополнительные реквизиты
- key	Строка переменная (100)	Имя реквизита	ТребуетсяПроверка
- value *	Число (любое), Строка неограниченной длины, Дата и время в строке формата ISO, Булево	Значение реквизита	true
- type *	Строка (перечисление)	Тип реквизита: additional_value (Дополнительное значение) additional_value_group (Дополнительное значение (иерархия)) boolean (Булево) date (Дата) decimal (Число) service (Услуга) service_provider_tariff (Тариф поставщика услуг) string (Строка) subscriber (Абонент) subscription (Подписка) tariff (Тариф) tariff_period (Период действия) undefined (Не определено) user (Пользователь)	boolean
Ответ: customer (0..*)
Нет параметров

Пример запроса Развернуть

POST https://1cfresh.com/a/adm/hs/ext_api/execute/usr/account/customers/update_attached_info
Authorization: Basic base64_encode(user:password) или Bearer access_token

{
  "id": 1000,
  "account": 1010,
  "public_id": "7713754211",
  "properties": [
    {
      "key": "ТребуетсяПроверка",
      "value": true,
      "type": "boolean"
    }
  ],
  "fields": [
    {
      "key": "ТребуетсяПроверка",
      "value": true,
      "type": "boolean"
    }
  ],
  "auth": {
    "account": 1000
  }
}

Пример ответа Развернуть

{
  "general": {
    "response": 10200,
    "error": false,
    "message": "",
    "version": 37,
    "sm_version": "1.1.48.6",
    "sm_timezone": "Europe/Moscow"
  }
}

Вверх

account/site/list

Cписок сайтов обслуживающей организации для внешней регистрации

Параметр	Тип	Описание	Пример
Запрос
account	Число (+12.0)	Код обслуживающей организации	1000
Ответ: sites (0..*)
site_id	Число (+9.0)	Код страницы внешней регистрации	123
name	Строка переменная (64)	Наименование страницы внешней регистрации	1С_ОбслуживающаяОрганизация

Пример запроса Развернуть

POST https://1cfresh.com/a/adm/hs/ext_api/execute/usr/account/site/list
Authorization: Basic base64_encode(user:password) или Bearer access_token

{
  "account": 1000,
  "auth": {
    "account": 1000
  }
}

Пример ответа Развернуть

{
  "sites": [
    {
      "site_id": 123,
      "name": "1С_ОбслуживающаяОрганизация"
    }
  ],
  "general": {
    "response": 10200,
    "error": false,
    "message": "",
    "version": 37,
    "sm_version": "1.1.48.6",
    "sm_timezone": "Europe/Moscow"
  }
}

Вверх

account/users/update

Обновить пользователя абонента

Параметр	Тип	Описание	Пример
Запрос
login	Строка переменная (50)	Логин пользователя	Abramov
session_restriction *	Число (+10.0)	Разрешенное количество сеансов	5
role *	Строка (перечисление)	Роль пользователя абонента: administrator (Администраторы абонента) ext_administrator (Администраторы средств адаптации) operator (Операторы обслуживающей организации) owner (Владельцы абонента) user (Пользователи абонента)	owner
tenants *		Права на приложения.
- id	Число (+7.0)	Номер приложения	2000
- role *	Строка (перечисление)	Роль пользователя абонента: administrator (Запуск и администрирование) api (Доступ к API) user (Запуск)	administrator
fields *		Дополнительные реквизиты
- key	Строка переменная (100)	Имя реквизита	ТребуетсяПроверка
- value *	Число (любое), Строка неограниченной длины, Дата и время в строке формата ISO, Булево	Значение реквизита	true
- type *	Строка (перечисление)	Тип реквизита: additional_value (Дополнительное значение) additional_value_group (Дополнительное значение (иерархия)) boolean (Булево) date (Дата) decimal (Число) service (Услуга) service_provider_tariff (Тариф поставщика услуг) string (Строка) subscriber (Абонент) subscription (Подписка) tariff (Тариф) tariff_period (Период действия) undefined (Не определено) user (Пользователь)	boolean
Ответ: sites (0..*)
Нет параметров

Пример запроса Развернуть

POST https://1cfresh.com/a/adm/hs/ext_api/execute/usr/account/users/update
Authorization: Basic base64_encode(user:password) или Bearer access_token

{
  "login": "Abramov",
  "session_restriction": 5,
  "role": "owner",
  "tenants": [
    {
      "id": 2000,
      "role": "administrator"
    }
  ],
  "fields": [
    {
      "key": "ТребуетсяПроверка",
      "value": true,
      "type": "boolean"
    }
  ],
  "auth": {
    "account": 1010
  }
}

Пример ответа Развернуть

{
  "general": {
    "response": 10200,
    "error": false,
    "message": "",
    "version": 37,
    "sm_version": "1.1.48.6",
    "sm_timezone": "Europe/Moscow"
  }
}

Вверх