Tariff — информация о тарифах сервиса, доступных абоненту

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

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

Метод	Назначение
tariff/info	Информация о тарифе провайдера
tariff/list	Список тарифов провайдера

tariff/info

Информация о тарифе провайдера

Параметр	Тип	Описание	Пример
Запрос
id	Строка переменная (9)	Код тарифа	000000001
Ответ: tariff (1)
id	Строка переменная (9)	Код тарифа	000000001
name	Строка переменная (150)	Наименование тарифа	Основной тариф
updated *	Дата и время в строке формата ISO	Дата изменения
start *	Дата в строке формата ISO (без времени)	Начало действия
expiration *	Дата в строке формата ISO (без времени)	Окончание действия
description *	Строка неограниченной длины	Описание
prolongation_validity *	Число (+10.0)	Число дней действия продлевающей подписки	3
extension_validity *	Число (+10.0)	Число дней действия расширяющей подписки	3
prolongation_during *	Число (+10.0)	Число дней для создания продлевающей подписки после завершения основной	7
is_extension	Булево	Это расширение тарифа	false
type	Строка (перечисление)	Тип тарифа: basic (Основной) extension (Расширение) upgrade (Апгрейд)	basic
is_payable	Булево	Это платный тариф	true
is_trial	Булево	Это тестовый тариф	false
has_condition	Булево	Есть условие	true
condition *		Условие использования	Пример описания условия
- code *	Число (+9.0)	Код условия	1
- name *	Строка переменная (120)	Наименование условия	Пример наименования условия
- description *	Строка неограниченной длины	Описание условия	Пример описания условия
description_for_subscribers *		Информация для абонентов
- html *	Строка неограниченной длины	HTML-код описания для абонентов	<html><body><img src="image001?_=1761827163"/><p>Пример описания тарифа</p></body></html>
- images	Список (0..*)	Картинки описания
- images.name	Строка переменная (255)	Имя картинки	image001
- images.data	Двоичные данные размером до 1048576 байт в строке Base64	Данные картинки, размер до 1 Мб	3C 3F 78 6D 6C 20 76 65 72 73 69 6F 6E 3D 22 31 2E 30 22 3F 3E 0A 3C 73 76 67 20 77 69 64 74 68 3D 2...
services	Список (0..*)	Предоставляемые услуги
- id	Строка переменная (9)	Код услуги	000000001
- name	Строка переменная (100)	Наименование услуги	Количество прав пользователей на запуск приложений
- service_id	Строка переменная (50)	Идентификатор услуги	КоличествоПравПользователейНаЗапускПриложений
- provider_name	Строка переменная (150)	Наименование поставщика услуги	Менеджер сервиса
- provider_id	Строка переменная (50)	Идентификатор поставщика услуги	sm
- description *	Строка неограниченной длины	Описание
- type	Строка (перечисление)	Тип услуги: limited (Лимитированная) unique (Уникальная) unlimited (Безлимитная)	limited
- amount *	Число (+10.0)	Количество предоставляемых лицензий	10
- extend_amount *	Число (+10.0)	Количество лицензий, которое может быть предоставлено расширяющей подпиской	5
applications	Список (1..*)	Виды приложений	Работа в модели сервиса
- name	Строка переменная (150)	Наименование вида приложения	Работа в модели сервиса
- id	Строка переменная (22)	Код вида приложения	mt
- description *	Строка неограниченной длины	Описание вида приложения
validity_periods	Список (0..*)	Периоды действия тарифа
- id	Строка переменная (10)	Код периода	1YR
- name	Строка переменная (50)	Наименование периода	1 год
- quantity	Число (+10.0)	Количество периодов	1
- cost *	Число (+10.2)	Стоимость	1500
- comment *	Строка переменная (1024)	Комментарий	Комментарий периода действия
- period	Строка (перечисление)	Тип периода действия: day (День) decade (Декада) half_year (Полугодие) month (Месяц) quarter (Квартал) week (Неделя) year (Год)	year
extensions	Список (0..*)	Расширения тарифа
- id	Строка переменная (9)	Код тарифа	000000002
- name	Строка переменная (150)	Наименование тарифа	Расширение тарифа
notification_periods	Список (0..*)	Периоды оповещений об окончании подписки	7
- days_quantity *	Число (2.0)	Количество дней	7

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

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

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

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

{
  "tariff": {
    "id": "000000001",
    "name": "Основной тариф",
    "updated": "0001-01-01T00:00:00",
    "start": "0001-01-01T00:00:00",
    "expiration": "0001-01-01T00:00:00",
    "description": "",
    "prolongation_validity": 3,
    "extension_validity": 3,
    "prolongation_during": 7,
    "is_extension": false,
    "type": "basic",
    "is_payable": true,
    "is_trial": false,
    "has_condition": true,
    "condition": {
      "code": 1,
      "name": "Пример наименования условия",
      "description": "Пример описания условия"
    },
    "description_for_subscribers": {
      "html": "<html><body><img src=\"image001\"/><p>Пример описания тарифа</p></body></html>",
      "images": [
        {
          "name": "image001",
          "data": "PD94bWwgdmVyc2lvbj0iMS4wIj8+Cjxzdmcgd2lkdGg9IjE2IiBoZWlnaHQ9IjE2\r\nIiB2aWV3Qm94PSIwIDAgODYwIDg2MCIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3Jn\r\nLzIwMDAvc3ZnIiB4bWxuczpzdmc9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3Zn\r\nIj4KIDxnIGNsYXNzPSJsYXllciI+CiAgPHRpdGxlPkxheWVyIDE8L3RpdGxlPgog\r\nIDxwYXRoIGQ9Im00MzIuOTYsNjQwcTE3LjQyLDAgMjkuMjMsLTExLjc5cTExLjgx\r\nLC0xMS43OSAxMS44MSwtMjkuMjFsMCwtMTY5cTAsLTE3LjQyIC0xMS43OCwtMjku\r\nMjFxLTExLjc3LC0xMS43OSAtMjkuMTgsLTExLjc5dC0yOS4yMywxMS43OXEtMTEu\r\nODEsMTEuNzkgLTExLjgxLDI5LjIxbDAsMTY5cTAsMTcuNDIgMTEuNzgsMjkuMjFx\r\nMTEuNzcsMTEuNzkgMjkuMTgsMTEuNzl6bS0yLjg5LC0zMTBxMjAuNDMsMCAzNC4x\r\nOCwtMTMuNTFxMTMuNzUsLTEzLjUyIDEzLjc1LC0zMy40OXEwLC0yMS45NSAtMTMu\r\nNzksLTM1LjQ3cS0xMy44LC0xMy41MyAtMzQuMTksLTEzLjUzcS0yMS41MiwwIC0z\r\nNC43NywxMy41M3EtMTMuMjUsMTMuNTIgLTEzLjI1LDM0Ljk3cTAsMjAuNiAxMy44\r\nMiwzNC4wNXExMy44MiwxMy40NSAzNC4yNSwxMy40NXptMC4zMyw1MjRxLTg4Ljg3\r\nLDAgLTE2Ni4xMiwtMzMuMDhxLTc3LjI1LC0zMy4wOSAtMTM1LjE4LC05MS4wMnEt\r\nNTcuOTMsLTU3LjkzIC05MS4wMiwtMTM1LjEycS0zMy4wOCwtNzcuMTkgLTMzLjA4\r\nLC0xNjYuMTRxMCwtODguOTYgMzMuMDgsLTE2Ni4yOXEzMy4wOSwtNzcuMzIgOTAu\r\nODYsLTEzNC44MXE1Ny43NywtNTcuNDggMTM1LjAzLC05MS4wMXE3Ny4yNywtMzMu\r\nNTMgMTY2LjMxLC0zMy41M3QxNjYuNDksMzMuNDVxNzcuNDQsMzMuNDYgMTM0Ljg1\r\nLDkwLjgxdDkwLjg5LDEzNC44N3EzMy40OSw3Ny41MyAzMy40OSwxNjYuNnEwLDg5\r\nLjAxIC0zMy41MywxNjYuMjV0LTkxLjAxLDEzNC44NnEtNTcuNDksNTcuNjIgLTEz\r\nNC44Myw5MC44OXEtNzcuMzUsMzMuMjcgLTE2Ni4yMywzMy4yN3ptMC4xLC05NHEx\r\nMzcuNSwwIDIzNCwtOTYuMzd0OTYuNSwtMjM1LjEzcTAsLTEzNy41IC05Ni4zMSwt\r\nMjM0dC0yMzUuMTksLTk2LjVxLTEzNy41LDAgLTIzNCw5Ni4zMXQtOTYuNSwyMzUu\r\nMTlxMCwxMzcuNSA5Ni4zNywyMzR0MjM1LjEzLDk2LjV6bS0wLjUsLTMzMXoiIGZp\r\nbGw9IiMyODU0YzUiIGlkPSJzdmdfMSIvPgogPC9nPgo8L3N2Zz4="
        }
      ]
    },
    "services": [
      {
        "id": "000000001",
        "name": "Количество прав пользователей на запуск приложений",
        "service_id": "КоличествоПравПользователейНаЗапускПриложений",
        "provider_name": "Менеджер сервиса",
        "provider_id": "sm",
        "description": "",
        "type": "limited",
        "amount": 10,
        "extend_amount": 5
      }
    ],
    "applications": [
      {
        "name": "Работа в модели сервиса",
        "id": "mt",
        "description": ""
      }
    ],
    "validity_periods": [
      {
        "id": "1YR",
        "name": "1 год",
        "quantity": 1,
        "cost": 1500,
        "comment": "Комментарий периода действия",
        "period": "year"
      }
    ],
    "extensions": [
      {
        "id": "000000002",
        "name": "Расширение тарифа"
      }
    ],
    "notification_periods": [
      {
        "days_quantity": 7
      }
    ]
  },
  "general": {
    "response": 10200,
    "error": false,
    "message": "",
    "version": 37,
    "sm_version": "1.1.48.6",
    "sm_timezone": "Europe/Moscow"
  }
}

Вверх

tariff/list

Список тарифов провайдера

Параметр	Тип	Описание	Пример
Запрос
name *	Строка переменная (150)	Фильтр по наименованию тарифа	Основной
scope *	Массив из Строка (перечисление)	Параметры получения данных: is_extension (Только тарифы с типом "Расширение") is_payable (Только платные тарифы) services (Включать услуги) validity_periods (Включать периоды действия)	["is_payable","validity_periods","services","is_extension"]
available_tariffs *	Массив из Строка переменная (9)	Отбор доступных тарифов расширений	["000000002","000000003"]
Ответ: tariff (0..*)
id	Строка переменная (9)	Код тарифа	000000001
name	Строка переменная (150)	Наименование тарифа	Основной тариф
updated *	Дата и время в строке формата ISO	Дата изменения
start *	Дата в строке формата ISO (без времени)	Начало действия
expiration *	Дата в строке формата ISO (без времени)	Окончание действия
description *	Строка неограниченной длины	Описание
prolongation_validity *	Число (+10.0)	Число дней действия продлевающей подписки	3
extension_validity *	Число (+10.0)	Число дней действия расширяющей подписки	3
prolongation_during *	Число (+10.0)	Число дней для создания продлевающей подписки после завершения основной	7
is_extension	Булево	Это расширение тарифа	false
type	Строка (перечисление)	Тип тарифа: basic (Основной) extension (Расширение) upgrade (Апгрейд)	basic
is_payable	Булево	Это платный тариф	true
is_trial	Булево	Это тестовый тариф	false
has_condition	Булево	Есть условие	true
validity_periods	Список (0..*)	Периоды действия тарифа
- id	Строка переменная (10)	Код периода	1YR
- name	Строка переменная (50)	Наименование периода	1 год
- quantity	Число (+10.0)	Количество периодов	1
- cost *	Число (+10.2)	Стоимость	1500
- comment *	Строка переменная (1024)	Комментарий	Комментарий периода действия
- period	Строка (перечисление)	Тип периода действия: day (День) decade (Декада) half_year (Полугодие) month (Месяц) quarter (Квартал) week (Неделя) year (Год)	year
services	Список (0..*)	Предоставляемые услуги
- id	Строка переменная (9)	Код услуги	000000001
- name	Строка переменная (100)	Наименование услуги	Количество прав пользователей на запуск приложений
- service_id	Строка переменная (50)	Идентификатор услуги	КоличествоПравПользователейНаЗапускПриложений
- provider_name	Строка переменная (150)	Наименование поставщика услуги	Менеджер сервиса
- provider_id	Строка переменная (50)	Идентификатор поставщика услуги	sm
- description *	Строка неограниченной длины	Описание
- type	Строка (перечисление)	Тип услуги: limited (Лимитированная) unique (Уникальная) unlimited (Безлимитная)	limited
- amount *	Число (+10.0)	Количество предоставляемых лицензий	10
- extend_amount *	Число (+10.0)	Количество лицензий, которое может быть предоставлено расширяющей подпиской	5

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

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

{
  "auth": {
    "account": 1010
  }
}

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

{
  "tariff": [
    {
      "id": "000000001",
      "name": "Основной тариф",
      "updated": "0001-01-01T00:00:00",
      "start": "0001-01-01T00:00:00",
      "expiration": "0001-01-01T00:00:00",
      "description": "",
      "prolongation_validity": 3,
      "extension_validity": 3,
      "prolongation_during": 7,
      "is_extension": false,
      "type": "basic",
      "is_payable": true,
      "is_trial": false,
      "has_condition": true,
      "validity_periods": [
        {
          "id": "1YR",
          "name": "1 год",
          "quantity": 1,
          "cost": 1500,
          "comment": "Комментарий периода действия",
          "period": "year"
        }
      ],
      "services": [
        {
          "id": "000000001",
          "name": "Количество прав пользователей на запуск приложений",
          "service_id": "КоличествоПравПользователейНаЗапускПриложений",
          "provider_name": "Менеджер сервиса",
          "provider_id": "sm",
          "description": "",
          "type": "limited",
          "amount": 10,
          "extend_amount": 5
        }
      ]
    }
  ],
  "general": {
    "response": 10200,
    "error": false,
    "message": "",
    "version": 37,
    "sm_version": "1.1.48.6",
    "sm_timezone": "Europe/Moscow"
  }
}

Вверх