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 tarif paket tarif yang diubah. Anda dapat menyiapkan revisi untuk berlaku di masa mendatang. Paket tarif asli berakhir saat revisi berlaku.

Misalnya, Anda membuat paket tarif standar yang habis masa berlakunya pada 31 Desember 2019 dan ingin menggantinya dengan paket lain yang berlaku pada 1 Januari 2020. Untuk melakukannya, buat rencana tarif mendatang dan siapkan untuk berlaku pada tanggal 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 dalam Mengakhiri paket tarif yang dipublikasikan.

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

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

Membuat rencana tarif mendatang menggunakan UI

Buat paket tarif mendatang, seperti yang dijelaskan di bawah.

Edge

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

  1. Di halaman Paket Tarif, posisikan kursor pada 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: Paket tarif di masa 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 berlaku pada tanggal mulai berlaku. Waktu yang dihabiskan untuk menggunakan paket tarif saat ini dikurangi dari jangka waktu perpanjangan paket tarif mendatang. Artinya, jika developer menggunakan paket saat ini selama 3 bulan, dan periode perpanjangannya dikurangi 3 bulan.
  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 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. 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 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 mendatang dari paket tarif 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 penambahan bagian Pelanggan Lama.

  2. Seperti yang Anda lakukan pada paket tarif apa pun:
  3. Di bagian Subscriber yang Ada, pilih salah satu opsi berikut:
    • Mulai ulang periode kontrak penuh pada tanggal mulai berlaku yang baru. Paket tarif mendatang 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 berlaku pada tanggal mulai berlaku. Waktu yang dihabiskan untuk menggunakan paket tarif saat ini dikurangi dari jangka waktu perpanjangan paket tarif mendatang. Artinya, jika developer menggunakan paket saat ini selama 3 bulan, dan periode perpanjangannya dikurangi 3 bulan.
  4. Di kolom Tanggal Mulai Berlaku, masukkan tanggal mulai yang jatuh setelah tanggal akhir paket tarif yang ada.

Membuat rencana tarif mendatang menggunakan API

Anda dapat membuat paket tarif mendatang menggunakan API dengan mengeluarkan 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 mulai berlaku rencana baru.

Nama paket tarif mendatang tidak boleh sama dengan nama paket asli. Selain itu, untuk semua paket tarif Anda harus unik. Jika Anda ingin menyimpan tanggal mulai awal yang dicatat untuk developer, tetapkan tanda keepOriginalStartDate ke true. Flag ini ditetapkan secara default ke false.

Untuk mengetahui 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