Criar planos de tarifas futuros

Você está vendo a documentação do Apigee Edge.
Acesse a documentação da Apigee X. informações

Introdução

Depois que um plano de tarifas existente é publicado, a única propriedade que pode ser alterada é a data de término. No entanto, é possível criar uma nova versão do plano que inclua as propriedades alteradas, como taxas de planos de tarifas alteradas. Você pode configurar a revisão para que ela entre em vigor em uma data futura. O plano de tarifas original termina quando a revisão entra em vigor.

Por exemplo, suponha que você criou um plano de tarifas padrão que expira em 31 de dezembro de 2019 e quer substituí-lo por outro que entre em vigor em 1o de janeiro de 2020. Para isso, crie um plano de tarifas futuras e configure-o para entrar em vigor em 1o de janeiro de 2020.

Os desenvolvedores são notificados sobre o plano de tarifas revisado. Os desenvolvedores que aceitam o plano de tarifas original são registrados automaticamente para a revisão, mas têm a opção de rejeitá-la.

É possível criar um plano de tarifas futuro usando a interface de gerenciamento ou a API de monetização, conforme descrito nas seções a seguir.

Como criar um plano de preços futuro usando a interface

Crie um plano de tarifação futuro, conforme descrito abaixo.

Como criar um plano de tarifação futuro usando a API

É possível criar um plano de tarifas futuro usando a API emitindo uma solicitação POST para /organizations/{org_name}/monetization-packages/{package_id}/rate-plans/{plan_Id}/revision.

Em que:

• {org_id} é o nome da organização.
• {package_id} é a identificação do pacote da API.
• {plan_Id} é a identificação do plano de tarifação.

Ao criar a revisão, especifique as seguintes propriedades no corpo da solicitação:

• parentRatePlan especifica o ID do plano de tarifas original.
• startDate especifica a data em que o novo plano entrará em vigor.

O nome do plano de tarifa futuro não pode ser igual ao do plano original. Além disso, ela precisa ser única entre todos os seus planos de tarifas. Se você quiser manter a data de início original registrada para os desenvolvedores, defina a sinalização keepOriginalStartDate como true. O padrão dessa sinalização é false.

Para mais informações sobre as definições de configuração, consulte Definições de configuração para planos de tarifas.

Por exemplo, a solicitação a seguir cria um plano de tarifas futuro:

$ 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