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 paket yang menyertakan properti yang diubah, seperti tarif paket tarif yang diubah. Anda dapat menyiapkan revisi untuk diterapkan pada masa mendatang. Paket tarif asli berakhir saat revisi berlaku.

Misalnya, Anda membuat paket tarif standar yang berakhir pada 31 Desember 2019 dan Anda ingin menggantinya dengan paket lain yang berlaku pada 1 Januari 2020. Untuk melakukannya, buat paket tarif mendatang dan siapkan agar berlaku 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 paket tarif saat ini, seperti yang dijelaskan di Mengakhiri paket tarif yang dipublikasikan.

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

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

Membuat paket tarif mendatang menggunakan UI

Buat paket tarif mendatang, seperti yang dijelaskan di bawah.

Edge

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

  1. Di halaman Paket Tarif, posisikan kursor di dalam baris yang terkait dengan paket tarif yang ingin Anda buatkan paket tarif di masa mendatang.
    Paket tarif harus memiliki tanggal akhir.
  2. Klik +Future.
  3. Di bagian Paket tarif mendatang, pilih salah satu dari opsi berikut:
    • Mulai ulang periode kontrak penuh pada tanggal mulai berlaku baru: Paket tarif mendatang mulai berlaku pada tanggal mulai berlaku. Jangka waktu perpanjangan paket tarif mendatang sama dengan paket tarif saat ini.
    • Kurangi waktu yang dihabiskan untuk kontrak sebelumnya dari periode baru, pada tanggal mulai berlaku: Paket tarif di masa mendatang berlaku pada tanggal mulai berlaku. Waktu yang dihabiskan untuk menggunakan paket tarif saat ini dipotong dari masa perpanjangan paket tarif mendatang. Artinya, jika developer menggunakan paket saat ini selama 3 bulan, dan periode perpanjangan akan dikurangi 3 bulan.
  4. Konfigurasikan kolom berikut di panel atas:
    Catatan: Kolom lainnya 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 paket yang sudah ada Ya
    Tanggal mulai Tanggal paket tarif mulai berlaku. Masukkan tanggal mulai atau pilih tanggal menggunakan kalender. Hari ini Tidak
    Tanggal akhir Tanggal akhir paket tarif. 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. Jika Anda ingin mengakhiri paket tarif pada tanggal 1 Desember 2018, misalnya, Anda harus menetapkan nilai endDate ke 30-11-2018. Dalam hal ini, paket tarif akan habis masa berlakunya pada penghujung hari pada tanggal 30 November 2018; semua permintaan pada tanggal 1 Desember 2018 akan diblokir.

    		Tidak ada Tidak
    Dapat dilihat oleh portal Tetapkan apakah paket tarif disetel ke Publik atau Pribadi. Lihat Paket tarif publik versus pribadi. Diaktifkan 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 khusus atau umum:
    Catatan: Langkah ini tidak berlaku untuk paket notifikasi yang dapat disesuaikan.
    Kolom Deskripsi Default
    Konfigurasi setiap produk satu per satu Tanda yang menentukan apakah akan mengonfigurasi setiap paket tarif 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. Konfigurasikan 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 apa pun dalam draf paket 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 paket tarif tersebut 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 waktu 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 Anda ganti.

    Tindakan ini akan membuka jendela Paket Tarif mendatang.

    Perbedaan utama antara periode paket tarif mendatang dan periode paket tarif saat ini adalah penambahan bagian Pelanggan Lama.

  2. Seperti yang biasa Anda lakukan untuk paket tarif:
    • Masukkan nama untuk paket tersebut di kolom Nama Paket Tarif. Nama ini tidak harus sama dengan nama paket tarif asli.
    • Mengonfigurasi biaya untuk paket tarif (opsional).
    • Konfigurasikan detail paket tarif, berdasarkan jenis paket tarif yang dipilih:
    • Tentukan tanggal saat paket mendatang mulai berlaku (lihat Paket tarif publikasi), dan tanggal akhir (Anda juga dapat memilih "Tidak ada tanggal akhir" jika tidak ingin paket tarif mendatang berakhir pada tanggal tertentu). Jika tanggal akhir ditetapkan untuk rencana saat ini, maka tanggal mulai berlaku rencana mendatang harus setelah tanggal akhir rencana saat ini.
  3. Di bagian Pelanggan yang Ada, pilih salah satu opsi berikut:
    • Mulai ulang periode kontrak penuh pada tanggal mulai berlaku yang baru. Paket tarif mendatang akan berlaku pada tanggal mulai berlaku. Jangka waktu perpanjangan paket tarif mendatang sama dengan paket tarif saat ini.
    • Kurangi waktu yang dihabiskan untuk kontrak sebelumnya dari periode baru, pada tanggal mulai berlaku. Paket tarif mendatang akan berlaku pada tanggal mulai berlaku. Waktu yang dihabiskan untuk menggunakan paket tarif saat ini dipotong dari masa perpanjangan paket tarif mendatang. Artinya, jika developer menggunakan paket saat ini selama 3 bulan, dan periode perpanjangan akan dikurangi 3 bulan.
  4. Di kolom Tanggal Mulai Berlaku, masukkan tanggal mulai yang terjadi setelah tanggal akhir paket tarif yang ada.

Membuat paket tarif mendatang menggunakan API

Anda dapat membuat paket tarif mendatang menggunakan API dengan mengajukan permintaan POST ke /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 penerapan rencana baru.

Nama paket tarif mendatang tidak harus sama dengan nama paket awal. Jika Anda ingin menyimpan tanggal mulai asli yang dicatat untuk developer, tetapkan tanda keepOriginalStartDate ke true. Secara default, flag ini adalah false.

Untuk informasi setelan konfigurasi selengkapnya, 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