Buat paket tarif mendatang

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

Pengantar

Setelah paket tarif yang ada dipublikasikan, satu-satunya properti yang dapat Anda ubah adalah tanggal akhirnya. Namun, Anda dapat membuat versi baru rencana yang menyertakan properti yang diubah, seperti perubahan tingkat paket tarif. Anda dapat menyiapkan revisi untuk berlaku di masa mendatang. Tujuan paket tarif asli berakhir saat revisi diberlakukan.

Misalnya, Anda membuat paket tarif standar yang berakhir masa berlakunya pada tanggal 31 Desember 2019 dan Anda ingin menggantinya dengan paket lain yang mulai berlaku pada 1 Januari 2020. Untuk melakukannya, Anda membuat rencana tarif mendatang dan menyiapkannya untuk diterapkan pada 1 Januari 2020.

Jika tidak ada tanggal akhir yang ditetapkan untuk paket tarif saat ini, Anda dapat mengganti paket tarif yang ada dengan paket tarif mendatang yang dimulai paling cepat hari ini. Anda harus mengakhiri masa berlaku paket tarif saat ini, seperti yang dijelaskan di bagian Mengakhiri paket tarif yang dipublikasikan.

Developer akan diberi tahu tentang paket tarif yang direvisi. Developer yang menyetujui paket tarif akan otomatis terdaftar untuk revisi (tetapi memiliki opsi untuk menolak ).

Anda dapat membuat rencana tarif mendatang menggunakan UI pengelolaan atau monetization API, seperti yang dijelaskan di bagian berikut ini.

Membuat rencana tarif mendatang menggunakan UI

Buat paket tarif mendatang, seperti yang dijelaskan di bawah.

Edge

Untuk membuat versi paket tarif mendatang yang dimulai beberapa saat setelah hari ini menggunakan UI Edge, lakukan langkah-langkah berikut.

  1. Di halaman Paket Tarif, posisikan kursor di baris yang terkait dengan paket tarif yang ingin Anda buatkan paket tarif mendatang.
    Paket tarif harus memiliki tanggal akhir.
  2. Klik +Future.
  3. Di bagian Paket tarif mendatang, pilih salah satu opsi berikut:
    • Mulai ulang periode kontrak penuh pada tanggal mulai berlaku yang baru: Rencana tarif di masa mendatang akan masuk sejak tanggal mulai berlaku. Jangka waktu perpanjangan paket tarif yang akan datang sama dengan untuk paket tarif saat ini.
    • Kurangi waktu yang dihabiskan untuk kontrak sebelumnya dari periode baru, pada tanggal mulai berlaku: rencana tarif yang akan datang berlaku pada tanggal mulai berlaku. Waktu yang dihabiskan untuk paket tarif dipotong dari masa perpanjangan paket tarif mendatang. Ini berarti bahwa jika developer menggunakan paket saat ini selama 3 bulan, dan periode perpanjangan dikurangi 3 bulan berikutnya.
  4. Konfigurasikan kolom berikut di panel atas:
    Catatan: Kolom lain bersifat hanya baca.
    Kolom Deskripsi Default Wajib
    Nama paket tarif

    Nama paket tarif Anda.

    Catatan: Nama tidak harus sama dengan nama paket tarif asli.

    		 Nama rencana yang ada Ya
    Tanggal mulai Tanggal paket tarif berlaku. Masukkan tanggal mulai atau pilih tanggal menggunakan kalender. Hari ini Tidak
    Tanggal akhir Tanggal paket tarif berakhir. Untuk menentukan tanggal akhir, aktifkan tombol Memiliki Tanggal Akhir, lalu masukkan tanggal akhir atau pilih tanggal menggunakan kalender.

    Catatan: Paket tarif akan berlaku hingga akhir hari pada tanggal yang ditentukan. Misalnya, jika Anda ingin mengakhiri masa berlaku paket tarif pada 1 Desember 2018, Anda harus menetapkan nilai endDate ke 2018-11-30. Dalam hal ini, paket tarif akan berakhir pada penghujung hari pada 30 November 2018; semua permintaan pada tanggal 1 Desember 2018 akan diblokir.

    		Tidak ada Tidak
    Dapat dilihat oleh portal Tetapkan apakah paket tarif bersifat Publik atau Pribadi. Lihat Paket tarif publik versus pribadi. Aktif Tidak
  5. Konfigurasi biaya untuk paket tarif. Lihat Mengonfigurasi biaya.
    Catatan: Tidak berlaku untuk paket notifikasi yang dapat disesuaikan.
  6. Jika Anda memilih paket produk yang berisi lebih dari satu produk API, tetapkan preferensi berikut di bagian Paket tarif spesifik atau umum:
    Catatan: Langkah ini tidak berlaku untuk paket notifikasi yang dapat disesuaikan.
    Kolom Deskripsi Default
    Mengonfigurasi setiap produk satu per satu Tanda yang menentukan apakah akan mengonfigurasi paket tarif individual untuk setiap produk API. Nonaktif
    Konfigurasi penawaran freemium setiap produk satu per satu Tanda yang menentukan apakah akan mengonfigurasi paket freemium untuk setiap produk API. Nonaktif
    Pilih produk Jika mengaktifkan salah satu atau kedua tanda, Anda harus memilih setiap produk satu per satu dari menu drop-down dan mengonfigurasi detail paket tarifnya.

    Catatan: Pastikan Anda mengonfigurasi semua produk dalam paket produk.

    		T/A
  7. Konfigurasi detail paket tarif, berdasarkan jenis paket tarif yang dipilih:
  8. Klik salah satu opsi berikut:
    Tombol Deskripsi
    Perbarui Draf Simpan paket tarif sebagai draf.

    Paket tarif tidak akan terlihat oleh developer aplikasi hingga Anda memublikasikannya. Anda dapat mengedit kolom mana pun dalam draf rencana tarif.

    Publikasikan Draf Publikasikan rencana.

    Catatan: Setelah memublikasikan paket tarif, Anda hanya dapat mengubah tanggal akhir jika belum ditetapkan. Anda tidak dapat menghapus paket tarif setelah dipublikasikan, tetapi Anda dapat mengakhiri masa berlaku paket tarif dan menggantinya dengan paket tarif mendatang, seperti yang dijelaskan dalam Mengakhiri paket tarif yang dipublikasikan.

Edge Klasik (Private Cloud)

Untuk membuat versi paket tarif mendatang yang dimulai beberapa saat setelah hari ini menggunakan UI Edge Klasik, lakukan langkah-langkah berikut.

  1. Dalam katalog paket, klik +Future di kolom Draft/Future untuk paket tarif yang ingin diganti.

    Tindakan ini akan membuka jendela Paket Tarif.

    Perbedaan utama antara periode paket tarif mendatang dan periode paket tarif saat ini adalah tambahan bagian Subscriber yang Ada.

  2. Seperti yang Anda lakukan pada paket tarif apa pun:
    • Masukkan nama untuk paket di kolom Nama Paket Tarif. Nama tidak harus cocok nama paket tarif awal.
    • Mengonfigurasi biaya untuk paket tarif (opsional).
    • Konfigurasi detail paket tarif, berdasarkan jenis paket tarif yang dipilih:
    • Tentukan tanggal saat paket mendatang mulai berlaku (lihat Memublikasikan paket tarif), dan tanggal akhir (Anda juga dapat memilih “Tanpa tanggal akhir” jika tidak ingin rencana tarif mendatang yang berakhir pada tanggal tertentu). Jika tanggal akhir ditetapkan untuk paket saat ini, maka tanggal mulai berlaku rencana yang akan datang harus setelah tanggal akhir rencana Anda sendiri.
  3. Di bagian Subscriber yang Ada, pilih salah satu opsi berikut:
    • Mulai ulang periode kontrak penuh pada tanggal mulai berlaku yang baru. Rencana tarif mendatang akan sejak tanggal mulai berlaku. Jangka waktu perpanjangan paket tarif yang akan datang sama dengan untuk paket tarif saat ini.
    • Kurangi waktu yang dihabiskan untuk kontrak sebelumnya dari periode baru, pada tanggal mulai berlaku. Tujuan rencana tarif yang akan datang berlaku pada tanggal mulai berlaku. Waktu yang dihabiskan untuk paket tarif dipotong dari masa perpanjangan paket tarif mendatang. Ini berarti bahwa jika developer menggunakan paket saat ini selama 3 bulan, dan periode perpanjangan dikurangi 3 bulan berikutnya.
  4. Di bidang Tanggal Mulai Berlaku, masukkan tanggal mulai yang jatuh setelah tanggal akhir paket tarif yang sudah ada.

Membuat rencana tarif mendatang menggunakan API

Anda dapat membuat rencana tarif mendatang menggunakan API dengan mengeluarkan permintaan POST untuk /organizations/{org_name}/monetization-packages/{package_id}/rate-plans/{plan_Id}/revision.

Dengan keterangan:

  • {org_id} adalah nama organisasi.
  • {package_id} adalah identifikasi paket API.
  • {plan_Id} adalah identifikasi paket tarif.
Saat membuat revisi, Anda harus menentukan properti berikut dalam isi permintaan:
  • parentRatePlan menentukan ID paket tarif asli.
  • startDate menentukan tanggal mulai berlaku rencana baru.

Nama paket tarif mendatang tidak boleh sama dengan nama paket asli. Selain itu, harus unik di antara semua paket tarif Anda. Jika Anda ingin menyimpan tanggal mulai asli yang dicatat untuk developer, setel flag keepOriginalStartDate ke true. Tanda ini nilai defaultnya adalah false.

Untuk informasi selengkapnya tentang setelan konfigurasi, lihat Setelan konfigurasi untuk paket tarif.

Misalnya, permintaan berikut akan membuat paket tarif mendatang:

$ 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