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/prolong	Создать продлевающую подписку обслуживаемого абонента
account/customer_subscriptions/list	Cписок подписок обслуживаемых абонентов
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/attached_info_for_subscribing

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

Параметр	Тип	Описание	Пример
Запрос
id	Число (+12.0)	Код абонента	1010
Ответ
errors	Булево	Признак наличия ошибок заполнения	false
properties	Список (0..*)	Дополнительные сведения
- key	Строка переменная (100)	Имя свойства	Тариф
- name *	Строка переменная (75)	Заголовок свойства	Тариф
- value *	Число (любое), Строка неограниченной длины, Дата и время в строке формата ISO, Булево	Значение свойства	Базовый
- type	Строка (перечисление)	Тип свойства: additional_value (Дополнительное значение) additional_value_group (Дополнительное значение (иерархия)) boolean (Булево) date (Дата) decimal (Число) service (Услуга) service_provider_tariff (Тариф поставщика услуг) string (Строка) subscriber (Абонент) subscription (Подписка) tariff (Тариф) tariff_period (Период действия) undefined (Не определено) user (Пользователь)	additional_value
- required *	Булево	Заполнять обязательно	true
- tooltip *	Строка неограниченной длины	Подсказка	Текст подсказки.
- error *	Булево	Признак ошибки	false
- message *	Строка неограниченной длины	Описание ошибки
fields	Список (0..*)	Дополнительные реквизиты
- key	Строка переменная (100)	Имя реквизита	ИНН
- name *	Строка переменная (75)	Заголовок реквизита	ИНН
- value *	Число (любое), Строка неограниченной длины, Дата и время в строке формата ISO, Булево	Значение реквизита	7799555550
- type	Строка (перечисление)	Тип реквизита: additional_value (Дополнительное значение) additional_value_group (Дополнительное значение (иерархия)) boolean (Булево) date (Дата) decimal (Число) service (Услуга) service_provider_tariff (Тариф поставщика услуг) string (Строка) subscriber (Абонент) subscription (Подписка) tariff (Тариф) tariff_period (Период действия) undefined (Не определено) user (Пользователь)	string
- 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": "Базовый",
      "type": "additional_value",
      "required": true,
      "tooltip": "Текст подсказки.",
      "error": false,
      "message": ""
    }
  ],
  "fields": [
    {
      "key": "ИНН",
      "name": "ИНН",
      "value": "7799555550",
      "type": "string",
      "required": true,
      "tooltip": "Текст подсказки.",
      "error": false,
      "message": ""
    }
  ],
  "general": {
    "response": 10200,
    "error": false,
    "message": "",
    "version": 31,
    "sm_version": "1.1.39.17",
    "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": 31,
    "sm_version": "1.1.39.17",
    "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": 31,
    "sm_version": "1.1.39.17",
    "sm_timezone": "Europe/Moscow"
  }
}

Вверх

account/update_attached_info

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

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

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

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": "Базовый",
      "type": "additional_value"
    }
  ],
  "fields": [
    {
      "key": "ИНН",
      "value": "7799555550",
      "type": "string"
    }
  ],
  "auth": {
    "account": 1010
  }
}

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

{
  "general": {
    "response": 10200,
    "error": false,
    "message": "",
    "version": 31,
    "sm_version": "1.1.39.17",
    "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": 31,
    "sm_version": "1.1.39.17",
    "sm_timezone": "Europe/Moscow"
  }
}

Вверх

account/customer_subscriptions/create

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

Параметр	Тип	Описание	Пример
Запрос
servant	Число (+12.0)	Код ведущего абонента	1000
account	Число (+12.0)	Код обслуживаемого абонента	1010
start	Дата и время в строке формата ISO	Начало действия	02.12.2024 0:00:00
completion *	Дата и время в строке формата ISO	Завершение действия	01.12.2025 23:59:59
servant_tariff *	Строка переменная (9)	Код тарифа обслуживающей организации	SERV00001
tariff *	Строка переменная (9)	Код тарифа - обязательно, если не указан servant_tariff (Код тарифа обслуживающей организации)	PROV00001
period *	Строка переменная (10)	Код периода действия	1YR
accept_intersections *	Булево	Допустимо наличие пересечений по периоду действия с имеющимися подписками на тот же тариф	true
Ответ
id *	Строка переменная (9)	Номер созданной подписки	000000002
completion *	Дата и время в строке формата ISO	Завершение действия	01.12.2025 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": "2024-12-02T00:00:00",
  "completion": "2025-12-01T23:59:59",
  "servant_tariff": "SERV00001",
  "tariff": "PROV00001",
  "period": "1YR",
  "accept_intersections": true,
  "auth": {
    "account": 1010
  }
}

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

{
  "id": "000000002",
  "completion": "2025-12-01T23:59:59",
  "general": {
    "response": 10200,
    "error": false,
    "message": "",
    "version": 31,
    "sm_version": "1.1.39.17",
    "sm_timezone": "Europe/Moscow"
  }
}

Вверх

account/customer_subscriptions/create_enhanced

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

Параметр	Тип	Описание	Пример
Запрос
servant	Число (+12.0)	Код ведущего абонента	1000
account	Число (+12.0)	Код обслуживаемого абонента	1010
start *	Дата и время в строке формата ISO	Начало действия	02.12.2024 0:00:00
completion *	Дата и время в строке формата ISO	Завершение действия	01.12.2025 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	Завершение действия	01.12.2025 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": "2024-12-02T00:00:00",
  "completion": "2025-12-01T23:59:59",
  "period": "1YR",
  "tariff": "000000002",
  "servant_tariff": "SERV00001",
  "parent": "000000001",
  "amount": 1,
  "auth": {
    "account": 1010
  }
}

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

{
  "subscription": [
    "000000002"
  ],
  "subscription_info": [
    {
      "id": "000000002",
      "completion": "2025-12-01T23:59:59"
    }
  ],
  "general": {
    "response": 10200,
    "error": false,
    "message": "",
    "version": 31,
    "sm_version": "1.1.39.17",
    "sm_timezone": "Europe/Moscow"
  }
}

Вверх

account/customer_subscriptions/create_upgrade

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

Параметр	Тип	Описание	Пример
Запрос
account	Число (+12.0)	Код обслуживаемого абонента	1010
start *	Дата и время в строке формата ISO	Начало действия	02.12.2024 0:00:00
period *	Строка переменная (10)	Код периода действия	1YR
tariff	Строка переменная (9)	Код тарифа-апгрейда	000000002
servant_tariff *	Строка переменная (9)	Код тарифа обслуживающей организации	SERV00001
parent	Строка переменная (9)	Номер основной подписки	000000001
Ответ
id *	Строка переменная (9)	Номер созданной подписки	000000002
completion *	Дата и время в строке формата ISO	Завершение действия	01.12.2025 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": "2024-12-02T00:00:00",
  "period": "1YR",
  "tariff": "000000002",
  "servant_tariff": "SERV00001",
  "parent": "000000001",
  "auth": {
    "account": 1010
  }
}

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

{
  "id": "000000002",
  "completion": "2025-12-01T23:59:59",
  "general": {
    "response": 10200,
    "error": false,
    "message": "",
    "version": 31,
    "sm_version": "1.1.39.17",
    "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": 31,
    "sm_version": "1.1.39.17",
    "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	Начало действия	02.12.2024 0:00:00
completion	Дата и время в строке формата ISO	Завершение действия	01.12.2025 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": "2024-12-02T00:00:00",
    "completion": "2025-12-01T23: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": 31,
    "sm_version": "1.1.39.17",
    "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": 31,
    "sm_version": "1.1.39.17",
    "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	Начало действия	02.12.2024 0:00:00
completion	Дата и время в строке формата ISO	Завершение действия	01.12.2025 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": "2024-12-02T00:00:00",
      "completion": "2025-12-01T23: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": 31,
    "sm_version": "1.1.39.17",
    "sm_timezone": "Europe/Moscow"
  }
}

Вверх

account/customer_subscriptions/renew

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

Параметр	Тип	Описание	Пример
Запрос
servant	Число (+12.0)	Код ведущего абонента	1000
account	Число (+12.0)	Код обслуживаемого абонента	1010
start *	Дата и время в строке формата ISO	Начало действия	02.12.2024 0:00:00
completion *	Дата и время в строке формата ISO	Завершение действия	01.12.2025 23:59:59
id	Строка переменная (9)	Номер основной подписки	000000001
period *	Строка переменная (10)	Код периода действия	1YR
accept_intersections *	Булево	Допустимо наличие пересечений по периоду действия с имеющимися подписками на тот же тариф	true
Ответ
id *	Строка переменная (9)	Номер созданной подписки	000000002
completion *	Дата и время в строке формата ISO	Завершение действия	01.12.2025 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": "2024-12-02T00:00:00",
  "completion": "2025-12-01T23:59:59",
  "id": "000000001",
  "period": "1YR",
  "accept_intersections": true,
  "auth": {
    "account": 1010
  }
}

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

{
  "id": "000000002",
  "completion": "2025-12-01T23:59:59",
  "general": {
    "response": 10200,
    "error": false,
    "message": "",
    "version": 31,
    "sm_version": "1.1.39.17",
    "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": 31,
    "sm_version": "1.1.39.17",
    "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, Булево	Значение свойства	Базовый
- type	Строка (перечисление)	Тип свойства: additional_value (Дополнительное значение) additional_value_group (Дополнительное значение (иерархия)) boolean (Булево) date (Дата) decimal (Число) service (Услуга) service_provider_tariff (Тариф поставщика услуг) string (Строка) subscriber (Абонент) subscription (Подписка) tariff (Тариф) tariff_period (Период действия) undefined (Не определено) user (Пользователь)	additional_value
fields	Список (0..*)	Дополнительные реквизиты
- key	Строка переменная (100)	Имя реквизита	ИНН
- name *	Строка переменная (75)	Заголовок реквизита	ИНН
- value *	Число (любое), Строка неограниченной длины, Дата и время в строке формата ISO, Булево	Значение реквизита	7799555550
- type	Строка (перечисление)	Тип реквизита: additional_value (Дополнительное значение) additional_value_group (Дополнительное значение (иерархия)) boolean (Булево) date (Дата) decimal (Число) service (Услуга) service_provider_tariff (Тариф поставщика услуг) string (Строка) subscriber (Абонент) subscription (Подписка) tariff (Тариф) tariff_period (Период действия) undefined (Не определено) user (Пользователь)	string

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

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": "Базовый",
      "type": "additional_value"
    }
  ],
  "fields": [
    {
      "key": "ИНН",
      "name": "ИНН",
      "value": "7799555550",
      "type": "string"
    }
  ],
  "general": {
    "response": 10200,
    "error": false,
    "message": "",
    "version": 31,
    "sm_version": "1.1.39.17",
    "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, Булево	Значение свойства	Базовый
- type	Строка (перечисление)	Тип свойства: additional_value (Дополнительное значение) additional_value_group (Дополнительное значение (иерархия)) boolean (Булево) date (Дата) decimal (Число) service (Услуга) service_provider_tariff (Тариф поставщика услуг) string (Строка) subscriber (Абонент) subscription (Подписка) tariff (Тариф) tariff_period (Период действия) undefined (Не определено) user (Пользователь)	additional_value
fields	Список (0..*)	Дополнительные реквизиты
- key	Строка переменная (100)	Имя реквизита	ИНН
- name *	Строка переменная (75)	Заголовок реквизита	ИНН
- value *	Число (любое), Строка неограниченной длины, Дата и время в строке формата ISO, Булево	Значение реквизита	7799555550
- type	Строка (перечисление)	Тип реквизита: additional_value (Дополнительное значение) additional_value_group (Дополнительное значение (иерархия)) boolean (Булево) date (Дата) decimal (Число) service (Услуга) service_provider_tariff (Тариф поставщика услуг) string (Строка) subscriber (Абонент) subscription (Подписка) tariff (Тариф) tariff_period (Период действия) undefined (Не определено) user (Пользователь)	string

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

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": "Базовый",
      "type": "additional_value"
    }
  ],
  "fields": [
    {
      "key": "ИНН",
      "name": "ИНН",
      "value": "7799555550",
      "type": "string"
    }
  ],
  "general": {
    "response": 10200,
    "error": false,
    "message": "",
    "version": 31,
    "sm_version": "1.1.39.17",
    "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": 31,
    "sm_version": "1.1.39.17",
    "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
fields	Список (0..*)	Доп. реквизиты
- key	Строка переменная (100)	Имя реквизита	ИНН
- name *	Строка переменная (75)	Заголовок реквизита	ИНН
- value *	Число (любое), Строка неограниченной длины, Дата и время в строке формата ISO, Булево	Значение реквизита	7799555550
- type	Строка (перечисление)	Тип реквизита: additional_value (Дополнительное значение) additional_value_group (Дополнительное значение (иерархия)) boolean (Булево) date (Дата) decimal (Число) service (Услуга) service_provider_tariff (Тариф поставщика услуг) string (Строка) subscriber (Абонент) subscription (Подписка) tariff (Тариф) tariff_period (Период действия) undefined (Не определено) user (Пользователь)	string
properties	Список (0..*)	Доп. сведения
- key	Строка переменная (100)	Имя свойства	Тариф
- name *	Строка переменная (75)	Заголовок свойства	Тариф
- value *	Число (любое), Строка неограниченной длины, Дата и время в строке формата ISO, Булево	Значение свойства	Базовый
- type	Строка (перечисление)	Тип свойства: additional_value (Дополнительное значение) additional_value_group (Дополнительное значение (иерархия)) boolean (Булево) date (Дата) decimal (Число) service (Услуга) service_provider_tariff (Тариф поставщика услуг) string (Строка) subscriber (Абонент) subscription (Подписка) tariff (Тариф) tariff_period (Период действия) undefined (Не определено) user (Пользователь)	additional_value

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

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"
        }
      ],
      "fields": [
        {
          "key": "ИНН",
          "name": "ИНН",
          "value": "7799555550",
          "type": "string"
        }
      ],
      "properties": [
        {
          "key": "Тариф",
          "name": "Тариф",
          "value": "Базовый",
          "type": "additional_value"
        }
      ]
    }
  ],
  "general": {
    "response": 10200,
    "error": false,
    "message": "",
    "version": 31,
    "sm_version": "1.1.39.17",
    "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, Булево	Значение свойства	Базовый
- type *	Строка (перечисление)	Тип свойства: additional_value (Дополнительное значение) additional_value_group (Дополнительное значение (иерархия)) boolean (Булево) date (Дата) decimal (Число) service (Услуга) service_provider_tariff (Тариф поставщика услуг) string (Строка) subscriber (Абонент) subscription (Подписка) tariff (Тариф) tariff_period (Период действия) undefined (Не определено) user (Пользователь)	additional_value
fields *		Дополнительные реквизиты
- key	Строка переменная (100)	Имя реквизита	ИНН
- value *	Число (любое), Строка неограниченной длины, Дата и время в строке формата ISO, Булево	Значение реквизита	7799555550
- type *	Строка (перечисление)	Тип реквизита: additional_value (Дополнительное значение) additional_value_group (Дополнительное значение (иерархия)) boolean (Булево) date (Дата) decimal (Число) service (Услуга) service_provider_tariff (Тариф поставщика услуг) string (Строка) subscriber (Абонент) subscription (Подписка) tariff (Тариф) tariff_period (Период действия) undefined (Не определено) user (Пользователь)	string
Ответ: 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": "Базовый",
      "type": "additional_value"
    }
  ],
  "fields": [
    {
      "key": "ИНН",
      "value": "7799555550",
      "type": "string"
    }
  ],
  "auth": {
    "account": 1000
  }
}

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

{
  "general": {
    "response": 10200,
    "error": false,
    "message": "",
    "version": 31,
    "sm_version": "1.1.39.17",
    "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": 31,
    "sm_version": "1.1.39.17",
    "sm_timezone": "Europe/Moscow"
  }
}

Вверх