Создание будущих тарифных планов

Вы просматриваете документацию Apigee Edge .
Перейдите в документацию Apigee
X.info

Введение

После публикации существующего тарифного плана единственное свойство, которое вы можете изменить, — это дата его окончания. Однако вы можете создать новую версию плана, которая будет включать измененные свойства, такие как измененные тарифы. Вы можете настроить вступление изменений в силу в будущем. Первоначальный тарифный план прекращает свое действие после вступления изменений в силу.

Например, предположим, вы создали стандартный тарифный план, срок действия которого истекает 31 декабря 2019 года, и хотите заменить его другим планом, который вступит в силу 1 января 2020 года. Для этого вы создаете будущий тарифный план и настраиваете его вступление в силу с 1 января 2020 года.

Если для текущего тарифного плана не указана дата окончания, вы можете заменить существующий тарифный план будущим, который начнет действовать уже сегодня. Вам потребуется аннулировать текущий тарифный план, как описано в разделе «Аннулирование опубликованного тарифного плана» .

Разработчики получают уведомление о пересмотренном тарифном плане. Те разработчики, которые принимают первоначальный тарифный план, автоматически регистрируются для участия в пересмотренном проекте (но имеют возможность отклонить его).

Вы можете создать тарифный план на будущее, используя пользовательский интерфейс управления или API монетизации, как описано в следующих разделах.

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

Создайте тарифный план на будущее, как описано ниже.

Край

Чтобы создать будущую версию тарифного плана, которая начнет действовать после сегодняшнего дня, используя пользовательский интерфейс Edge, выполните следующие действия.

  1. На странице «Тарифные планы» установите курсор в строку, соответствующую тарифному плану, для которого вы хотите создать будущий тарифный план.
    Тарифный план должен иметь дату окончания действия.
  2. Нажмите +Будущее .
  3. В разделе «Будущие тарифные планы» выберите один из следующих вариантов:
    • Возобновление действия всего договора с новой датой вступления в силу : новый тарифный план вступает в силу с указанной даты. Срок продления нового тарифного плана совпадает со сроком действия текущего тарифного плана.
    • Время, затраченное на предыдущий договор, вычитается из нового периода с даты вступления в силу : новый тарифный план вступает в силу с даты вступления в силу. Время, затраченное на использование текущего тарифного плана, вычитается из срока продления нового тарифного плана. Это означает, что если застройщик использует текущий план в течение 3 месяцев, то срок продления сокращается на 3 месяца.
  4. Настройте следующие поля на верхней панели:
    Примечание : остальные поля доступны только для чтения.
    Поле Описание По умолчанию Необходимый
    Название тарифного плана

    Название вашего тарифного плана.

    Примечание : Название не обязательно должно совпадать с первоначальным названием тарифного плана.

    Название существующего плана Да
    Дата начала Дата вступления тарифного плана в силу. Введите дату начала действия или выберите дату с помощью календаря. Сегодня Нет
    Дата окончания Укажите дату окончания действия тарифного плана. Чтобы указать дату окончания, включите переключатель « Есть дата окончания» и введите дату окончания или выберите дату с помощью календаря.

    Примечание : Тарифный план будет действовать до конца дня указанной даты. Например, если вы хотите, чтобы действие тарифного плана истекло 1 декабря 2018 года, вам следует установить значение endDate равным 2018-11-30. В этом случае действие тарифного плана истечет в конце дня 30 ноября 2018 года; все запросы, поданные 1 декабря 2018 года, будут заблокированы.

    Никто Нет
    Видно порталам Укажите, является ли тарифный план государственным или частным. См. Государственные и частные тарифные планы . Включено Нет
  5. Настройте тарифный план. См. раздел «Настройка тарифов» .
    Примечание : Не применимо к настраиваемым планам уведомлений.
  6. Если вы выбираете пакет продуктов, содержащий более одного API-продукта, установите следующие параметры в разделе «Конкретный или общий тарифный план» :
    Примечание : Этот шаг не применим к настраиваемым планам уведомлений.
    Поле Описание По умолчанию
    Настройте каждый продукт по отдельности. Флаг, указывающий, следует ли настраивать индивидуальный тарифный план для каждого продукта API. Неполноценный
    Настройте бесплатное предложение для каждого продукта индивидуально. Флаг, указывающий, следует ли настраивать бесплатный тарифный план для каждого API-продукта. Неполноценный
    Выберите товар Если вы включите один или оба флага, вам необходимо будет выбрать каждый продукт по отдельности из выпадающего списка и настроить параметры его тарифного плана.

    Примечание : Убедитесь, что вы настроили все продукты в комплекте.

    Н/Д
  7. Настройте параметры тарифного плана в зависимости от выбранного типа тарифа:
  8. Выберите один из следующих вариантов:
    Кнопка Описание
    Обновить черновик Сохраните тарифный план как черновик.

    Тарифный план не будет виден разработчикам приложений до тех пор, пока вы его не опубликуете. В черновике тарифного плана можно редактировать любое поле.

    Опубликовать черновик Опубликуйте план.

    Примечание : После публикации тарифного плана изменить дату окончания можно только в том случае, если она еще не установлена. Удалить тарифный план после его публикации нельзя, но можно аннулировать его и заменить будущим тарифным планом, как описано в разделе «Аннулирование опубликованного тарифного плана» .

Классический Edge (частное облако)

Чтобы создать будущую версию тарифного плана, которая начнет действовать после сегодняшнего дня, используя классический интерфейс Edge, выполните следующие действия.

  1. В каталоге пакетов в столбце «Черновик/Будущее» нажмите кнопку «+Будущее» для тарифного плана, который вы хотите заменить.

    Это открывает возможность выбора тарифного плана на будущее.

    Основное отличие между будущим и текущим периодом действия тарифных планов заключается в добавлении раздела для существующих абонентов.

  2. Как и в случае с любым тарифным планом:
  3. В разделе «Существующие подписчики» выберите один из следующих вариантов:
    • Возобновите действие всего договора с новой даты вступления в силу. Новый тарифный план вступает в силу с этой даты. Срок продления действия нового тарифного плана совпадает со сроком действия текущего тарифного плана.
    • Время, затраченное на предыдущий договор, вычитается из нового периода с даты вступления в силу. План тарифов на будущие работы вступает в силу с этой даты. Время, затраченное на использование текущего плана тарифов, вычитается из срока продления плана тарифов на будущие работы. Это означает, что если застройщик использует текущий план в течение 3 месяцев, то срок продления сокращается на 3 месяца.
  4. В поле «Дата вступления в силу» укажите дату начала действия, которая наступает после даты окончания действия существующего тарифного плана.

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

Создать тарифный план на будущее можно с помощью API, отправив POST запрос по адресу /organizations/{org_name}/monetization-packages/{package_id}/rate-plans/{plan_Id}/revision .

Где:

  • {org_id} — это название организации.
  • {package_id} — это идентификатор пакета API.
  • {plan_Id} — это идентификатор тарифного плана.
При создании ревизии необходимо указать следующие свойства в теле запроса:
  • parentRatePlan указывает идентификатор исходного тарифного плана.
  • startDate указывает дату вступления в силу нового плана.

Название будущего тарифного плана не должно совпадать с названием исходного плана. Кроме того, оно должно быть уникальным среди всех ваших тарифных планов. Если вы хотите сохранить исходную дату начала действия тарифа для разработчиков, установите флаг keepOriginalStartDate в true . По умолчанию этот флаг имеет значение false .

Для получения дополнительной информации о параметрах конфигурации см. раздел «Параметры конфигурации для тарифных планов» .

Например, следующий запрос создает тарифный план на будущее:

$ curl -H "Content-Type:application/json" -X POST -d \
'{ 
     "parentRatePlan": {
       "id": "monetization_package_flat_rate_card_plan_1379513833409"
     },
     "name": "Flat rate card plan",
     "developer":null,
     "developerCategory":null,
     "advance": "false",
     "currency": {
      "id" : "usd"
     },     
     "description": "Flat rate card plan",
     "displayName" : "Flat rate card plan",
     "frequencyDuration": "30",
     "frequencyDurationType": "DAY",
     "earlyTerminationFee": "10",     
     "monetizationPackage": {
      "id": "location"
     },
     "organization": {
      "id": "{org_name}"
     },
     "paymentDueDays": "30",
     "prorate": "false",
     "published": "true",
     "ratePlanDetails": [
     {
      "currency": {
       "id" : "usd"
      },
      "paymentDueDays": "30",      
      "meteringType": "UNIT",
      "organization": {
       "id": "myorg"
      },
      "ratePlanRates": [
       {
        "type": "RATECARD",
        "rate": "0.05",
        "startUnit": "0"       
       }      
      ],     
     "ratingParameter": "VOLUME",
     "type": "RATECARD"
     }],
     "recurringStartUnit": 1,
     "recurringType": "CALENDAR",
     "recurringFee": "10",
     "setUpFee": "10",
     "startDate": "2014-01-01 00:00:00",
     "type": "STANDARD"
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/location/rate-plans/monetization_package_flat_rate_card_plan_1379513833409/revision" \
-u email:password