Konfigurasikan rencana bagi hasil

Anda sedang melihat dokumentasi Apigee Edge.
Buka dokumentasi Apigee X. info

Pengantar

Dalam paket pembagian keuntungan, penyedia API berbagi persentase pendapatan yang dihasilkan dari setiap transaksi dengan developer (berdasarkan harga kotor atau bersih transaksi). Saat membuat paket pembagian keuntungan, Anda perlu menentukan model pembagian, yang dapat bersifat tetap atau fleksibel, dan berbasis penetapan harga (seperti apakah pembagian keuntungan didasarkan pada harga kotor atau bersih transaksi). Anda menetapkan harga kotor atau bersih untuk transaksi saat membuat kebijakan pencatatan transaksi.

Dalam model berbagi tetap, Anda berbagi persentase tetap dari pendapatan yang dihasilkan dari setiap transaksi dengan developer (berdasarkan harga kotor atau bersih transaksi). Dalam model berbagi fleksibel, Anda berbagi persentase variabel dari pendapatan dengan developer. Pembagian keuntungan bergantung pada pendapatan yang dihasilkan selama jangka waktu tertentu. Persentase yang digunakan dalam penghitungan pembagian keuntungan dapat bervariasi berdasarkan jumlah pendapatan yang dihasilkan oleh transaksi.

Menentukan detail paket pembagian keuntungan menggunakan UI

Konfigurasikan paket pembagian keuntungan, seperti yang dijelaskan di bawah.

Menentukan detail paket pembagian keuntungan menggunakan API

Anda menentukan detail paket pembagian keuntungan saat membuat paket tarif. Anda menentukan detailnya di properti ratePlanDetails dalam isi permintaan dalam panggilan ke /organizations/{org_name}/monetization-packages/{package_id}/rate-plans. Apa yang Anda tentukan di properti ratePlanDetails, bergantung pada model berbagi yang Anda pilih: tetap atau fleksibel.

Menentukan detail paket pembagian keuntungan untuk model pembagian tetap

Untuk menerapkan model berbagi tetap, Anda harus menentukan hal berikut dalam detail paket tarif:

• Parameter rating yang menunjukkan bahwa paket tarif didasarkan pada transaksi (VOLUME). VOLUME adalah defaultnya.
• Jenis pengukuran (UNIT) yang menunjukkan bahwa pembagian keuntungan bersifat tetap per unit (yaitu, tidak didasarkan pada volume transaksi, seperti yang berlaku untuk model berbagi fleksibel).
• Jenis pendapatan (GROSS atau NET). Jenis pendapatan ini menunjukkan apakah bagi hasil didasarkan pada harga kotor atau bersih transaksi.
• Batas waktu pembayaran (misalnya, 30 hari).
• ID organisasi Anda.
• "Dasar" atau mata uang akuntansi yang digunakan perusahaan Anda.
• Tarif paket tarif yang memberikan detail tentang cara penghitungan pembagian keuntungan. Karena model berbagi didasarkan pada tarif tetap, Anda hanya menentukan satu tarif paket tarif.

Lihat Properti konfigurasi untuk detail paket tarif guna melihat daftar lengkap properti detail paket tarif.

Dalam tarif paket tarif, Anda menentukan:

• Jenis tarif paket tarif (REVSHARE).
• Persentase yang digunakan untuk menghitung pembagian keuntungan. Misalnya, jika Anda menetapkan 80,5555, pembagian keuntungannya adalah 80,5555%. Artinya, sebagai penyedia API, Anda membayar 80,5555% kepada developer dari harga yang dikenakan untuk setiap transaksi (atau jika berdasarkan atribut khusus seperti jumlah byte yang ditransmisikan dalam suatu transaksi, Anda membayar 80,5555% byte yang dikenakan kepada developer).
• Unit awal aplikasi tarif (0). Hal ini berarti tarif diterapkan ke setiap transaksi, yang dimulai dengan transaksi pertama.

Lihat Properti konfigurasi untuk paket tarif guna mengetahui daftar lengkap properti paket tarif.

Misalnya, gambar berikut akan membuat rencana pembagian keuntungan dengan model pembagian tetap. Persentase pembagian keuntungannya adalah 80,5555%. Pembagian keuntungan didasarkan pada harga bersih transaksi. Kontrak ini berlaku mulai 15 September 2013, dan pembayaran akan jatuh tempo dalam 30 hari. (Detail terkait pembagian keuntungan disorot.)

$ 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

Respons seharusnya terlihat seperti ini (hanya sebagian respons yang ditampilkan):

{
  "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"
}

Menentukan detail paket pembagian keuntungan untuk model berbagi yang fleksibel

Dalam model berbagi fleksibel, Anda menentukan detail paket tarif yang mencakup satu atau beberapa tarif paket tarif. Setiap tarif paket tarif mencakup rentang pendapatan transaksi (setiap rentang disebut "band pendapatan"). Anda menetapkan persentase pembagian keuntungan untuk setiap band pendapatan.

Selain tarif paket tarif, Anda dapat menentukan hal berikut dalam detail paket tarif:

• Parameter rating yang menunjukkan bahwa paket tarif didasarkan pada transaksi (VOLUME). VOLUME adalah defaultnya.
• Jenis pengukuran (VOLUME) yang menunjukkan bahwa pembagian keuntungan tidak didasarkan pada volume transaksi (artinya, pembagian keuntungan tidak tetap, seperti halnya untuk model berbagi tetap).
• Jenis pendapatan (GROSS atau NET). Jenis pendapatan ini menunjukkan apakah bagi hasil didasarkan pada harga kotor atau bersih transaksi.
• Batas waktu pembayaran (misalnya, 30 hari).
• ID organisasi Anda.
• "Dasar" atau mata uang akuntansi yang digunakan perusahaan Anda.
• Jenis durasi dan durasi yang secara bersama-sama menentukan jangka waktu agregasi pendapatan (ini juga disebut sebagai "dasar agregasi"). Transaksi digabungkan berdasarkan agregasi (misalnya, 1 bulan) untuk menghitung total pendapatan dan band pendapatan yang berlaku. Persentase pembagian keuntungan yang diterapkan pada setiap transaksi bergantung pada band pendapatannya.
• Penghitung agregasi yang digunakan untuk menentukan band pendapatan yang berlaku.

Lihat Properti konfigurasi untuk detail paket tarif guna melihat daftar lengkap properti detail paket tarif.

Untuk setiap tarif paket tarif, Anda menentukan:

• Jenis tarif paket tarif untuk band pendapatan (REVSHARE).
• Persentase yang digunakan untuk menghitung pembagian keuntungan untuk band pendapatan. Misalnya, jika Anda menetapkan 80,5555, pembagian keuntungan untuk band pendapatan adalah 80,5555%, yaitu, sebagai penyedia API, Anda membayar developer sebesar 80,5555% dari harga yang dikenakan untuk setiap transaksi dalam band pendapatan tersebut.
• Unit awal dan akhir dari band pendapatan. Unit awal menentukan batas bawah band pendapatan, dan unit akhir menentukan batas atas band pendapatan. Misalnya, jika Anda menentukan unit awal 0 dan unit akhir 1.000, band pendapatan mencakup pendapatan transaksi yang lebih besar dari 0 dan hingga 1.000 dalam mata uang yang ditentukan. Jika mata uangnya adalah dolar AS, basis agregasinya adalah 1 bulan, dan persentase untuk band pendapatan adalah 80,5555%, maka untuk transaksi yang menghasilkan pendapatan hingga $1.000 dalam sebulan, pembagian keuntungan adalah 80,5555% dari harga transaksi.

  Jika Anda tidak menentukan unit akhir untuk band pendapatan akhir, persentase pembagian untuk band tersebut akan diterapkan ke semua transaksi setelah pendapatan agregat berada di atas unit awal untuk band tersebut. Misalnya, jika unit awal untuk band terakhir adalah 1.000 (asumsikan dolar AS), dan Anda tidak menentukan unit akhir untuk band tersebut, persentase pendapatan untuk band tersebut akan diterapkan pada semua transaksi dengan pendapatan di atas $1. 000 selama periode agregat.

Lihat Properti konfigurasi untuk paket tarif guna mengetahui daftar lengkap properti paket tarif.

Misalnya, gambar berikut akan membuat rencana pembagian keuntungan dengan model berbagi yang fleksibel. Parameter ini menentukan dua band pendapatan. Band pertama mencakup pendapatan transaksi yang lebih besar dari hingga 1.000 dolar AS. Pita kedua mencakup pendapatan transaksi lebih dari 1.000 dolar AS. Persentase pembagian keuntungan adalah 80,5555% untuk band pendapatan pertama, dan 90,5% untuk band pendapatan kedua. Pembagian keuntungan didasarkan pada harga bersih transaksi. Dasar agregasi adalah 1 bulan. Periode kontrak ini berlaku mulai 15 September 2013, dan pembayaran akan jatuh tempo dalam 30 hari. (Detail terkait pembagian keuntungan disorot.)

$ 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

Respons seharusnya terlihat seperti ini (hanya sebagian respons yang ditampilkan):

{
  "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"
}