Configurar plano de divisão da receita

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

Introdução

Em um plano de participação na receita, o provedor de API compartilha com o desenvolvedor uma porcentagem da receita gerada por cada transação (com base no preço bruto ou líquido de uma transação). Ao criar um plano de participação na receita, é necessário indicar um modelo de compartilhamento, que pode ser fixo ou flexível, e uma base de preços (por exemplo, se a participação na receita é baseada no preço bruto ou líquido de uma transação). Você define o preço bruto ou líquido da transação ao criar a política de registro de transações.

No modelo de compartilhamento fixo, você compartilha com o desenvolvedor uma porcentagem fixa da receita gerada por cada transação (com base no preço bruto ou líquido de uma transação). No modelo de compartilhamento flexível, você compartilha com o desenvolvedor uma porcentagem variável da receita. A participação na receita depende da receita gerada durante um período. A porcentagem usada no cálculo da participação na receita pode variar com base no valor da receita gerada pelas transações.

Como especificar detalhes do plano de participação na receita usando a interface

Configure planos de participação na receita, conforme descrito abaixo.

Como especificar detalhes do plano de participação na receita usando a API

Você especifica os detalhes do plano de participação na receita ao criar o plano de tarifas. Você especifica os detalhes na propriedade ratePlanDetails no corpo da solicitação em uma chamada para /organizations/{org_name}/monetization-packages/{package_id}/rate-plans. O que você especifica na propriedade ratePlanDetails depende do modelo de compartilhamento escolhido: fixo ou flexível.

Como especificar detalhes do plano de participação na receita para um modelo de compartilhamento fixo

Para implementar o modelo de compartilhamento fixo, especifique o seguinte nos detalhes do plano de tarifas:

• Um parâmetro de classificação que indica que o plano de tarifas é baseado em transações (VOLUME). VOLUME é o padrão.
• Um tipo de medição (UNIT) que indica que a participação na receita é fixa por unidade (ou seja, não é baseada no volume de transações, como é o caso do modelo de compartilhamento flexível ).
• O tipo de receita (GROSS ou NET). Isso indica se a participação na receita é baseada no preço bruto ou líquido de uma transação.
• O período de vencimento do pagamento (por exemplo, 30 dias).
• O ID da sua organização.
• A moeda "base" ou contábil que sua empresa usa.
• Uma taxa de plano de tarifas que fornece detalhes sobre como a participação na receita é calculada. Como o modelo de compartilhamento é baseado em uma taxa fixa, você só especifica uma taxa de plano de tarifas.

Consulte Propriedades de configuração para detalhes do plano de tarifas para uma lista completa de propriedades de detalhes do plano de tarifas.

Na taxa do plano de tarifas, especifique:

• O tipo de taxa do plano de tarifas (REVSHARE).
• A porcentagem usada para calcular a participação na receita. Por exemplo, se você especificar 80,5555, a participação na receita será de 80,5555%, ou seja, como provedor de API, você paga ao desenvolvedor 80,5555% do preço cobrado por cada transação (ou, se baseado em um atributo personalizado, como o número de bytes transmitidos em uma transação, você paga ao desenvolvedor 80,5555% do preço cobrado pela transmissão do número especificado de bytes).
• A unidade inicial da aplicação da taxa (0). Isso significa que a taxa é aplicada a cada transação, começando pela primeira.

Consulte Propriedades de configuração para planos de tarifas para uma lista completa de propriedades de planos de tarifas.

Por exemplo, o seguinte cria um plano de participação na receita com um modelo de compartilhamento fixo. A porcentagem de participação na receita é de 80,5555%. A participação na receita é baseada no preço líquido de uma transação. O contrato é válido a partir de 15 de setembro de 2013, e o pagamento vence em 30 dias. (Os detalhes relacionados à participação na receita são destacados.)

$ curl -H "Content-Type:application/json" -X POST -d \
'{
    "name": "Fixed share plan",
    "developer":null,
    "developerCategory":null,
    "advance": false,
    "currency": {
      "id": "usd"
    },
    "description": "Fixed share plan",
    "displayName": "Fixed share plan",
    "earlyTerminationFee": 10,    
    "monetizationPackage": {
      "id": "location"
    },    
    "organization": {
      "id": "{org_name}"
    },
    "paymentDueDays": "30",
    "prorate": false,
    "published": true,
    "ratePlanDetails": [
      {
        "aggregateStandardCounters": true,
        "currency": {
         "id": "usd"
        },
        "duration": 1,
        "durationType": "MONTH",
        "meteringType": "UNIT",
        "organization": {
         "id": "{org_name}"
        },
        "paymentDueDays": "30",
        "ratePlanRates": [
         {
          "revshare": 80.8555,
          "startUnit": 0,
          "type": "REVSHARE"
         }
        ],
        "ratingParameter": "VOLUME",
        "revenueType": "NET",
        "type": "REVSHARE"
      }
    ],
    "recurringStartUnit": 1,
    "recurringType": "CALENDAR",
    "setUpFee": 10,
    "startDate": "2013-09-15 00:00:00",
    "type": "STANDARD"
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/location/rate-plans" \
-u email:password

A resposta deve ser semelhante a esta (apenas parte da resposta é mostrada):

{
  "advance" : false,
  "currency" : {
    "id" : "usd",
    "name" : "USD",
    ...
    "organization" : {
      ...
    },
   ...
  },
  "description" : "Fixed share plan",
  "displayName" : "Fixed share plan",
  "earlyTerminationFee" : 10,
  "id" : "location_fixed_share_plan",
  "monetizationPackage" : {
    "description" : "Location",
    "displayName" : "Location",
    "id" : "location",
    "name" : "Location",
    "organization" : {
     ...
    },
    "product" : [ {
      "customAtt1Name" : "user",
      "description" : "Location",
      "displayName" : "Location",
      "id" : "location",
      "name" : "location",
      "organization" : {
        ...
      },
      "status" : "CREATED"
    } ],
    "status" : "CREATED"
  },
  "name" : "Fixed share plan",
  "organization" : {
    ...
  },
  "paymentDueDays" : "30",
  "prorate" : false,
  "published" : true,
  "ratePlanDetails" : [ {
    "aggregateFreemiumCounters" : true,
    "aggregateStandardCounters" : true,
    "currency" : {
      "id" : "usd",
      "name" : "USD",
      ...
      "organization" : {
        ...
      },
      ...
    },
    "duration" : 1,
    "durationType" : "MONTH",
    "id" : "c1720153-c60f-4f7f-b4e5-cdc7bc7bec5b",
    "meteringType" : "UNIT",
    "organization" : {
      ...
    },
    "paymentDueDays" : "30",
    "ratePlanRates" : [ {
      "id" : "01c4d544-d907-423b-964e-4e2aed2816a3",
      "revshare" : 80.8555,
      "startUnit" : 0,
      "type" : "REVSHARE"
    } ],
    "ratingParameter" : "VOLUME",
    "revenueType" : "NET",
    "type" : "REVSHARE"
  } ],
  "recurringStartUnit" : 1,
  "recurringType" : "CALENDAR",
  "setUpFee" : 10,
  "startDate" : "2013-09-15 00:00:00",
  "type" : "STANDARD"
}

Como especificar detalhes do plano de participação na receita para um modelo de compartilhamento flexível

Em um modelo de compartilhamento flexível, você especifica detalhes do plano de tarifas que incluem uma ou mais taxas de plano de tarifas. Cada taxa de plano de tarifas abrange um intervalo de receita de transação (cada intervalo é chamado de "faixa de receita"). Você atribui uma porcentagem de participação na receita para cada faixa de receita.

Além das taxas do plano de tarifas, especifique o seguinte nos detalhes do plano de tarifas:

• Um parâmetro de classificação que indica que o plano de tarifas é baseado em transações (VOLUME). VOLUME é o padrão.
• Um tipo de medição (VOLUME) que indica que a participação na receita não é baseada no volume de transações (ou seja, não é fixa, como é o caso do modelo de compartilhamento fixo ).
• O tipo de receita (GROSS ou NET). Isso indica se a participação na receita é baseada no preço bruto ou líquido de uma transação.
• O período de vencimento do pagamento (por exemplo, 30 dias).
• O ID da sua organização.
• A moeda "base" ou contábil que sua empresa usa.
• Uma duração e um tipo de duração que, juntos, especificam o período em que a receita é agregada (isso também é chamado de "base de agregação"). As transações são agregadas com base na agregação (por exemplo, 1 mês) para calcular a receita total e a faixa de receita aplicável. A porcentagem de participação na receita aplicada a cada transação depende da faixa de receita.
• Contadores de agregação usados para determinar a faixa de receita aplicável.

Consulte Propriedades de configuração para detalhes do plano de tarifas para uma lista completa de propriedades de detalhes do plano de tarifas.

Para cada taxa de plano de tarifas, especifique:

• O tipo de taxa do plano de tarifas para a faixa de receita (REVSHARE).
• A porcentagem usada para calcular a participação na receita da faixa de receita. Por exemplo, se você especificar 80,5555, a participação na receita da faixa de receita será de 80,5555%, ou seja, como provedor de API você paga ao desenvolvedor 80,5555% do preço cobrado por cada transação nessa faixa de receita.
• A unidade inicial e final da faixa de receita. A unidade inicial especifica o limite inferior de uma faixa de receita, e a unidade final especifica o limite superior da faixa de receita. Por exemplo, se você especificar uma unidade inicial de 0 e uma unidade final de 1.000, a faixa de receita vai cobrir a receita de transação maior que 0 e até 1.000 na moeda especificada. Se a moeda for dólares americanos, a base de agregação for de 1 mês e a porcentagem da faixa de receita for de 80,5555%, então, para transações que geram até US $1.000 em receita em um mês, a participação na receita será de 80,5555% do preço da transação.

  Se você não especificar uma unidade final para a faixa de receita final, a porcentagem de participação para essa faixa será aplicada a todas as transações depois que a receita agregada ultrapassar a unidade inicial para essa faixa. Por exemplo, se a unidade inicial da última faixa for 1.000 (suponha dólares americanos) e você não especificar uma unidade final para essa faixa, a porcentagem de receita da faixa será aplicada a todas as transações acima de US $1. 000 de receita durante o período agregado.

Consulte Propriedades de configuração para planos de tarifas para uma lista completa de propriedades de planos de tarifas.

Por exemplo, o seguinte cria um plano de participação na receita com um modelo de compartilhamento flexível. Ele especifica duas faixas de receita. A primeira faixa abrange a receita de transação maior que até US$ 1.000 . A segunda faixa abrange a receita de transação acima de US$ 1.000. A porcentagem de participação na receita é de 80,5555% para a primeira faixa de receita e de 90,5% para a segunda faixa de receita. A participação na receita é baseada no preço líquido de uma transação. A base de agregação é de 1 mês. O período do contrato é válido a partir de 15 de setembro de 2013, e o pagamento vence em 30 dias. (Os detalhes relacionados à participação na receita são destacados.)

$ curl -H "Content-Type:application/json" -X POST -d \
'{
     "name": "Flexible share plan",
     "developer":null,
     "developerCategory":null,
     "advance": "true",
     "currency": {
      "id": "usd"
     },
     "description": "Flexible share plan",
     "displayName": "Flexible share plan",   
     "frequencyDuration": "30",
     "frequencyDurationType": "DAY",
     "earlyTerminationFee": "10",       
     "monetizationPackage": {
      "id": "location"
     },
     "organization": {
      "id": "{org_name}"
     },
     "paymentDueDays": "30",
     "prorate": "false",
     "published": "true",
     "ratePlanDetails": [
     {
      "currency": {
       "id": "usd"
      },
      "duration": "1",
      "durationType": "MONTH",
      "meteringType": "VOLUME",
      "organization": {
       "id": "{org_name}"
      },
      "paymentDueDays": "30",
      "ratePlanRates" : [ {
       "endUnit" : 1000,
       "revshare" : 80.5555,
       "startUnit" : 0,
       "type" : "REVSHARE"
      }, {
       "revshare" : 90.5,
       "startUnit" : 1000,
       "type" : "REVSHARE"
      } ],
     "ratingParameter" : "VOLUME",
     "revenueType" : "NET",
     "type" : "REVSHARE"
    } ],
    "recurringStartUnit": 1,
    "recurringType": "CALENDAR",
    "recurringFee": "10",
    "setUpFee": "10",
    "startDate": "2013-09-15 00:00:00",   
    "type": "STANDARD"
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/location/rate-plans" \
-u email:password

A resposta deve ser semelhante a esta (apenas parte da resposta é mostrada):

{
  "advance" : true,
  "currency" : {
    "id" : "usd",
    "name" : "USD",
    "organization" : {
      ...
    },
    ...
  },
  "description" : "Flexible share plan",
  "displayName" : "Flexible share plan",
  "earlyTerminationFee" : 10,
  "frequencyDuration" : 30,
  "frequencyDurationType" : "DAY",
  "id" : "location_flexible_share_plan",
  "monetizationPackage" : {
    "description" : "Location",
    "displayName" : "Location",
    "id" : "location",
    "name" : "Location",
    "organization" : {
      ...
    },
    "product" : [ {
      "customAtt1Name" : "user",
      "description" : "Location",
      "displayName" : "Location",
      "id" : "location",
      "name" : "location",
      "organization" : {
        ...
      },
      "status" : "CREATED"
    } ],
    "status" : "CREATED"
  },
  "name" : "Flexible share plan",
  "organization" : {
    ...
  },
  "paymentDueDays" : "30",
  "prorate" : false,
  "published" : false,
  "ratePlanDetails" : [ {
    "aggregateFreemiumCounters" : true,
    "aggregateStandardCounters" : true,
    "currency" : {
      "id" : "usd",
      "name" : "USD",
       …
      "organization" : {
        ...
      },
      ...
    },
    "duration" : 1,
    "durationType" : "MONTH",
    "id" : "ba3353e3-14f4-4bc5-a9f1-c723fd34131c",
    "meteringType" : "VOLUME",
    "organization" : {
      ...
    },
    "paymentDueDays" : "30",
    "ratePlanRates" : [ {
      "endUnit" : 1000,
      "id" : "5f13a51e-2250-4383-9aad-35e9a008ab40",
      "revshare" : 80.5555,
      "startUnit" : 0,
      "type" : "REVSHARE"
    }, {
      "id" : "d4196250-4ecc-480e-a7ed-dfab8e1c92ed",
      "revshare" : 90.5,
      "startUnit" : 1000,
      "type" : "REVSHARE"
    } ],
    "ratingParameter" : "VOLUME",
    "revenueType" : "NET",
    "type" : "REVSHARE"
  } ],
  "recurringFee" : 10,
  "recurringStartUnit" : 1,
  "recurringType" : "CALENDAR",
  "setUpFee" : 10,
  "startDate" : "2013-09-15 00:00:00",
  "type" : "STANDARD"
}