Como configurar taxas para um plano de tarifas

Você está lendo a documentação do Apigee Edge.
Acesse a documentação da Apigee X.
info

Introdução

As taxas são aplicadas aos desenvolvedores de apps quando eles se inscrevem no plano de taxas. É possível configurar taxas para qualquer tipo de plano de taxas, exceto a notificação ajustável. As taxas são opcionais. Não é necessário especificar nenhuma taxa em um plano de taxas .

Como configurar taxas para um plano de taxas usando a interface

Configure as taxas de um plano de taxas, conforme descrito abaixo.

Edge

Para configurar taxas, ao criar ou editar um plano de taxas selecione qualquer tipo de plano de taxas (exceto a notificação ajustável) e configure:

Como configurar detalhes do contrato

Configure os detalhes do contrato na seção Detalhes do contrato ao criar ou editar um plano de taxas.

Campo Descrição Padrão
Moeda Moeda para todas as taxas. Selecione um valor no menu suspenso. USD
Taxa de configuração Taxa única cobrada de cada desenvolvedor na data de início do plano. Insira um valor monetário no campo ou use as teclas de seta para cima/para baixo para selecionar um valor. 0
Taxa de rescisão antecipada Taxa única cobrada se o desenvolvedor encerrar o plano antes do prazo de renovação. 0
Duração do contrato Intervalo de tempo em que o plano é renovado automaticamente (a menos que o desenvolvedor rescinda o contrato antes da data de renovação). Especifique o número e a unidade (dia, semana ou mês). Se você definir esse valor como 0, o plano permanecerá em vigor até que o desenvolvedor opte por encerrá-lo. 1 mês
Pagamento devido em Número de dias em que o pagamento é devido. 30

Como configurar o custo do plano de taxas

Configure o custo do plano de taxas na seção Custo ao criar ou editar um plano de taxas.

Campo Descrição Padrão
Taxa básica Taxa cobrada do desenvolvedor de forma contínua até que ele encerre o plano. Se você especificar uma taxa básica, também precisará especificar o período de faturamento (ou duração), ou seja, indicar o período de tempo entre as cobranças de taxa básica (como 30 dias). 0
Período de faturamento Duração ou tempo entre as cobranças de taxa básica. Por exemplo, 30 dias. Especifique o número e a unidade (dia, semana ou mês). 1 mês
Assinatura pré-paga Especifique se a taxa básica é cobrada antecipadamente.

Se a taxa básica for cobrada antecipadamente (true):

  • Para desenvolvedores pré-pagos, a taxa básica é deduzida no momento da compra do plano de taxas. Se não houver fundos suficientes na conta pré-paga, a compra vai falhar. Consulte Como calcular o saldo restante da conta pré-paga?
  • Os desenvolvedores pós-pagos são cobrados na fatura na data em que o plano de taxas é comprado.

Se a taxa básica não for cobrada antecipadamente (false):

  • Para desenvolvedores pré-pagos, a taxa básica é deduzida no final do período de faturamento (por exemplo, no final do mês de faturamento). Se não houver fundos suficientes na conta pré-paga, o desenvolvedor será bloqueado até recarregar a conta. Consulte Gerenciar saldos de contas pré-pagas.
  • Os desenvolvedores pós-pagos são cobrados na fatura no último dia do período de faturamento (por exemplo, no final do mês de faturamento).
Ativado
Taxa proporcional Especifique se a taxa é proporcional. Isso se aplica a desenvolvedores que iniciam ou encerram o plano durante um mês. Se a taxa for proporcional, a taxa inicial será baseada no número de dias até o final do período (ou no número de dias usados no período). Se a taxa não for proporcional, os desenvolvedores receberão a cobrança da taxa inicial completa, independentemente de quando iniciarem (ou encerrarem) o plano. Ativado

Classic Edge (nuvem privada)

Para configurar taxas em um plano de taxas usando a interface do Classic Edge:

  1. Selecione a guia "Taxas" na janela "Plano de taxas".

  2. Digite as seguintes informações:
    Campo Descrição
    Moeda

    A moeda em que você quer que as taxas sejam cobradas. Selecione uma moeda na lista de moedas aceitas no menu suspenso.

    Valor da taxa de configuração

    Uma taxa única cobrada de cada desenvolvedor na data de início do plano (ou seja, a data em que o desenvolvedor compra o plano). Insira o valor a ser cobrado.

    Rescisão antecipada

    Uma taxa única cobrada se o desenvolvedor encerrar o plano antes do prazo de renovação termo. Insira o valor a ser cobrado.

    Recorrente

    Uma taxa cobrada do desenvolvedor de forma contínua até que ele encerre o plano. Especifique o valor a ser cobrado.

    Período

    O período de tempo entre as cobranças de taxas recorrentes. Insira um número (entre 1 e 12) e selecione "Semana" ou "Mês". Por exemplo, insira 1 e selecione "Mês" para especificar que o desenvolvedor recebe a cobrança da taxa recorrente uma vez por mês.

    Proporcional?

    Indica se a taxa recorrente é proporcional ou não. Esse campo se refere ao desenvolvedor que inicia ou encerra o plano durante um mês. Selecione um dos os seguintes botões de opção:

    • Sim, proporcional. A monetização calcula a taxa inicial com base no número de dias até o final do período (ou no número de dias usados no período).
    • Não, taxa completa. A monetização cobra a taxa inicial completa, independentemente de quando o desenvolvedor inicia (ou encerra) o plano. Essa é a opção padrão.
    Antecipado?

    Indica se a taxa recorrente é cobrada antecipadamente ou não. Selecione um dos os seguintes botões de opção:

    • Sim, cobrado antecipadamente. A monetização cobra a taxa recorrente antecipadamente. Por exemplo, se o período for de um mês, a taxa recorrente será cobrada na fatura gerada quando o mês de faturamento anterior terminar.
    • Não, atrasado. A monetização cobra a taxa no final do período. Por exemplo, se o período for de um mês, a taxa recorrente será cobrada na fatura quando o mês de faturamento atual terminar. Essa é a opção padrão.
    Taxas devidas

    Indica quando as taxas são devidas. Selecione 30, 45, 60 ou 90 dias. Ou escolha Personalizado para especificar outro período de taxas devidas.

Como configurar taxas para um plano de taxas usando a API

É possível adicionar taxas a um plano de taxas ao criar ou atualizar o plano. Especifique as taxas em no corpo da solicitação da chamada.

Por exemplo, a solicitação a seguir cria um plano de taxas padrão com uma taxa de rescisão antecipada, uma taxa de configuração e uma taxa recorrente (cada uma definida em 10 dólares americanos). A duração da taxa é de 30 dias, as taxas são devidas em 30 dias e a taxa recorrente é proporcional. (As especificações relacionadas à taxa são destacadas.)

$ curl -H "Content-Type:application/json" -X POST -d \
'{
     "advance": false,
     "name": "Simple rate plan",
     "currency": {
      "id" : "usd"
     },
     "earlyTerminationFee": "10",
     "frequencyDuration": "30",
     "description": "Simple rate plan",
     "displayName" : "Simple rate plan",
     "frequencyDurationType": "DAY",
     "monetizationPackage": {
      "id": "location_package"
     },
     "organization": {
      "id": "myorg"
     },
     "prorate": "true",
     "paymentDueDays": "30",
     "published": "true",
     "ratePlanDetails": [
     {
      …
      }
      ],
     "recurringFee": "10",
     "setUpFee": "10",
     "startDate": "2013-09-15",
     "type": "STANDARD"
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/location_package/rate-plans" \
-u email:password

Consulte Propriedades de configuração para planos de taxas para uma lista completa de opções de planos de taxas.