Faturalandırma ayarlamaları yapma

Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin. bilgi

Giriş

Para kazanma özelliği, fatura ayrıntılarında düzenleme yapmanıza olanak tanır. Örneğin, kayıtlarınızdaki bir tutarsızlık nedeniyle belirli bir faturalandırma ayında gelir payını veya ücretleri artırmanız ya da azaltmanız gerekebilir.

Faturalandırma Düzenlemeleri sayfasını keşfetme

Aşağıda açıklandığı gibi Faturalandırma Düzenlemeleri sayfasına gidin.

Fatura ayarlaması ekleme

Fatura ayarlaması eklemek için:

1. Fatura Düzenlemeleri sayfasına erişin.
2. + Düzenleme'yi tıklayın.
3. Aşağıdaki bilgileri girin:

   Alan	Açıklama
   Ad	Faturalandırma belgesinde görünecek açıklayıcı bir ad.
   Düzenleme %	Ayarlama tutarı, pozitif veya negatif yüzde olarak. Pozitif bir yüzde, işlemdeki gelir paylaşımını veya ücretleri bu yüzde kadar artırır. Negatif bir düzenleme, işlemdeki gelir paylaşımını veya ücretleri bu yüzde oranında düşürür. Pozitif veya negatif bir ondalık sayı girin (en fazla iki ondalık basamaklı).
   Faturalandırma Ayı	Düzenlemenin yapıldığı fatura ayı. Açılır listeden bir ay seçin.
   İşlem Türü	Düzeltmeyi uygulamak istediğiniz işlem türü. Açılır listeden bir değer seçin: Tüm İşlemler Ödeme (şarj modeli işlemleri) Satın alma (gelir paylaşımı modeli işlemleri) Geri ödeme (gelir paylaşımı modeli işlemleri)
   Ürün	Ayarlamayı uygulamak istediğiniz API ürünü. Tek bir ayarlamayı birden fazla API ürününe uygulayamazsınız. Birden fazla API ürününe ayarlama uygulamanız gerekiyorsa her ürün için bir ayarlama oluşturun. Açılır menüden bir API ürünü seçin.
   Geliştirici	Ayarlamayı uygulamak istediğiniz geliştirici. Ayarlamayı tüm geliştiricilere (varsayılan olarak) veya belirli bir geliştiriciye uygulayabilirsiniz. Açılır menüden "Tüm Geliştiriciler"i veya belirli bir geliştiriciyi seçin.

4. Ayarlama oluştur'u tıklayın.

Fatura ayarlamasını düzenleme

Fatura ayarlamasını düzenlemek için:

1. Fatura Düzenlemeleri sayfasına erişin.
2. İmleci düzenlemek istediğiniz fatura ayarlamasının üzerine getirin ve işlemler menüsünde simgesini tıklayın.
3. Gerekirse fatura ayarlamasını güncelleyin.
4. Düzenlemeyi Güncelle'yi tıklayın.

API'yi kullanarak faturalandırma ayarlamaları yapma

Aşağıdaki bölümlerde, API'yi kullanarak faturalandırma ayarlamalarının nasıl yapılacağı açıklanmaktadır.

API'yi kullanarak fatura ayarlaması yapma

/organizations/{org_name}/billing-adjustments adresine bir POST isteği göndererek faturalandırma ayrıntılarını düzenleyebilirsiniz. İsteği gönderirken istek gövdesinde şunları belirtirsiniz:

• Faturalandırma düzenlemesinin adı.
• Bir düzenleme yüzdesi (yani faturayı sırasıyla artıran veya azaltan pozitif ya da negatif bir yüzde değeri).
• Faturalandırma ayı.
• Fatura yılı.
• Fatura ayarlamasının uygulandığı kuruluş.

Ayrıca, aşağıdakiler gibi diğer özellikleri de belirtebilirsiniz:

• Ayarlamayı uygulamak istediğiniz işlem türü (ör. satın alma işlemi).
• Ayarlamayı uygulamak istediğiniz geliştirici.
• Ayarlamayı ön ödemeli geliştiricilere, sonradan ödemeli geliştiricilere veya her ikisine de uygulamak isteyip istemediğiniz.
• Ayarlamayı uygulamak istediğiniz API paketi.
• Ayarlamayı uygulamak istediğiniz API ürünü.

Bir düzenleme isteğinde belirtebileceğiniz fatura düzenleme özelliklerinin tam listesi için Fatura düzenleme yapılandırma ayarları başlıklı makaleyi inceleyin.

İsteğe bağlı bir özellik belirtilmezse fatura belgesi düzenlemesi söz konusu özellik için her şeyi kapsar. Örneğin, işlem türü belirtilmemişse faturalandırma düzenlemesi tüm işlem türleri için geçerli olur.

Aşağıdaki örnekte, açık faturalandırma ayında (Haziran 2013) fatura ayarlaması yapılmaktadır. Düzenleme, %3 oranında bir indirim yapar ve satın alma işlemlerine, ödeme ürününe ve faturalı ödeme seçeneğini kullanan geliştiricilere uygulanır. Belirli bir geliştiriciyi veya API paketini tanımlamaya yönelik özellikler belirtilmediğinden, düzenleme tüm geliştiricilere (faturalı geliştiriciler) ve tüm API paketlerindeki ödeme ürününe uygulanır.

$ curl -H "Content-Type:application/json" -X POST -d \
'{
  "name": "Purchase Adjustment Negative3",
  "adjustmentPercentageFactor": -3,
  "billingMonth": 6,
  "billingYear": 2017,
  "isPublished": false,
  "transactionType": "PURCHASE",
  "developerBillingType": "POSTPAID",
  "organization": {
      "id": "{org_name}" 
  },
  "product": { "id": "payment" }
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/billing-adjustments" \
-u email:password

Yanıt aşağıdaki gibi görünmelidir (yanıtın yalnızca bir kısmı gösterilmektedir):

{
  "adjustmentPercentageFactor" : -3,
  "billingMonth" : 6,
  "billingYear" : 2017,
  "developerBillingType" : "POSTPAID",
  "id" : "511144db-7fb1-4c74-bafb-5bc7a6380c9c",
  "isPublished" : false,
  "name" : "Purchase Adjustment Negative3",
  "organization" : {
   ...
  },
  "product" : {
    "customAtt1Name" : "user",
    "description" : "Payment",
    "displayName" : "Payment",
    "id" : "payment",
    "name" : "payment",
    "organization" : {
      ...
    },
    "status" : "CREATED",
    "transactionSuccessCriteria" : "Status=='200 OK'"
  },
  "transactionType" : "PURCHASE"
}

API'yi kullanarak fatura düzenlemelerini görüntüleme

Belirli bir fatura ayarlamasını veya bir kuruluşa ait tüm fatura ayarlamalarını görüntüleyebilirsiniz. Belirli bir fatura ayarlamasını görüntülemek için /organizations/{org_name}/billing-adjustments/{billing_adjustment_id} adresine bir GET isteği gönderin. Burada {billing_adjustment_id}, belirli fatura ayarlamasının kimliğidir (Fatura ayarlamasını oluşturduğunuzda yanıtta kimlik döndürülür). Örneğin:

$ curl -H "Accept:application/json" -X GET \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/billing-adjustments/511144db-7fb1-4c74-bafb-5bc7a6380c9c" \
-u email:password

Bir kuruluşa ait tüm faturalandırma düzenlemelerini görüntülemek için /organizations/{org_name}/billing-adjustments adresine bir GET isteği gönderin. Örneğin:

$ curl -H "Accept:application/json" -X GET \ 
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/billing-adjustments" \ 
-u email:password

Yanıt aşağıdaki gibi görünmelidir (yanıtın yalnızca bir kısmı gösterilmektedir):

{
  "billingAdjustment" : [ {
    "adjustmentPercentageFactor" : -3,
    "billingMonth" : 6,
    "billingYear" : 2017,
    "developerBillingType" : "POSTPAID",
    "id" : "511144db-7fb1-4c74-bafb-5bc7a6380c9c",
    "isPublished" : false,
    "name" : "Purchase Adjustment Negative3",
    "organization" : {
      ...
    },
    "product" : {
      "customAtt1Name" : "user",
      "description" : "Payment",
      "displayName" : "Payment",
      "id" : "payment",
      "name" : "payment",
      "organization" : {
        ...
      },
      "status" : "CREATED",
      "transactionSuccessCriteria" : "Status=='200 OK'"
    },
    "transactionType" : "PURCHASE"
  }, {
    "adjustmentPercentageFactor" : 5.0000,
    "billingMonth" : 5,
    "billingYear" : 2017,
    "id" : "53c363c0-7e1d-4dc1-9392-cf86656225f2",
    "isPublished" : false,
    "monetizationPackage" : {
      "description" : "Communications",
      "displayName" : "Communications",
      "id" : "communications",
      "name" : "Communications",
      "organization" : {
       ...
      },
      "product" : [ {
        "customAtt1Name" : "user",
        "description" : "Messaging",
        "displayName" : "Messaging",
        "id" : "messaging",
        "name" : "messaging",
        "organization" : {
          ...
        },
        "status" : "CREATED"
      }, {
        ...
        },
        "status" : "CREATED",
        "transactionSuccessCriteria" : "Status=='200 OK'"
      } ],
      "status" : "CREATED"
    },
    "name" : "Test Package Adjustment",
    "organization" : {
     ...
    },
    "product" : {
      "customAtt1Name" : "user",
      "description" : "Location",
      "displayName" : "Location",
      "id" : "location",
      "name" : "location",
      "organization" : {
        ...
      },
      "status" : "CREATED",
      "transactionSuccessCriteria" : "Status=='200 OK'"
    }
  } ],
  "totalRecords" : 2
}

API'yi kullanarak fatura ayarlaması güncelleme

/organizations/{org_name}/billing-adjustments/{billing_adjustment_id} adresine bir PUT isteği göndererek fatura ayarlamasını güncelleyebilirsiniz. Burada {billing_adjustment_id}, belirli fatura ayarlamasının kimliğidir. Güncelleme yaptığınızda, istek gövdesinde güncellenen özellikleri ve güncellenecek fatura ayarlamasının kimliğini belirtmeniz gerekir. Ayrıca faturalandırma ayarlaması için zorunlu özellikleri (ör. ad, ayarlama yüzdesi, faturalandırma ayı, faturalandırma yılı ve kuruluş özellikleri) de belirtmeniz gerekir.

Örneğin, aşağıdaki API çağrısı ayarlama yüzdesi faktörünü ve adını günceller (güncellenen özellikler örnekte vurgulanmıştır):

$ curl -H "Content-Type: application/json" -X PUT -d \
'{
  "id" : "511144db-7fb1-4c74-bafb-5bc7a6380c9c ",
  "adjustmentPercentageFactor": -5,
  "name" : "Purchase Adjustment Negative5",
  "billingMonth": 6,
  "billingYear": 2017,
  "isPublished": false,
  "transactionType": "PURCHASE",
  "developerBillingType": "POSTPAID",
  "organization": {
      "id": "{org_name}" 
    },
  "product": { "id": "payment" }
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/billing-adjustments/511144db-7fb1-4c74-bafb-5bc7a6380c9c" \
-u email:password

API'yi kullanarak fatura ayarlaması silme

/organizations/{org_name}/billing-adjustments/{billing_adjustment_id} adresine bir DELETE isteği göndererek fatura ayarlamasını silebilirsiniz. Burada {billing_adjustment_id}, silinecek fatura ayarlamasının kimliğidir. Örneğin:

$ curl -H "Accept:application/json" -X GET \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/billing-adjustments/511144db-7fb1-4c74-bafb-5bc7a6380c9c" \
-u email:password

API için fatura ayarlaması yapılandırma ayarları

Fatura düzenlemeleri için aşağıdaki yapılandırma seçenekleri kullanılabilir:

Sonraki adımlar

Para kazanma özelliği, geliştiricilere kredi verme esnekliği sunar. Bir geliştirici hizmetten memnun kalmazsa ve belirli bir dönem için kullanım ücretinin kısmen veya eksiksiz geri ödenmesini isterse bu işlemi yapmanız gerekebilir. Kredi verme başlıklı makalede kredi verme hakkında bilgi edinin.