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 tutarsızlık nedeniyle belirli bir faturalandırma ayı için gelir paylaşımını veya ücretleri artırmanız ya da azaltmanız gerekebilir.

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

Aşağıda açıklandığı şekilde Faturalandırma Ayarlamaları sayfasına erişin.

Fatura ayarlaması ekleyin

Fatura ayarlaması eklemek için:

1. Faturalandırma Ayarlamaları 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ı ad.
   Düzenleme yüzdesi	Pozitif veya negatif yüzde olarak düzenleme tutarı. Pozitif yüzde, işlemdeki gelir paylaşımını veya ücretleri bu yüzdeye göre ayarlar. Negatif düzenleme, işlemdeki gelir paylaşımını veya ücretleri bu yüzdeye göre düşürür. Pozitif veya negatif bir ondalık sayı girin (en fazla iki ondalık basamakla).
   Faturalandırma Ayı	Düzenlemenin faturalandırma ayı. Açılır listeden bir ay seçin.
   İşlem Türü	Ayarlamayı uygulamak istediğiniz işlemin türü. Açılır menüden bir değer seçin: Tüm İşlemler Ücretlendir (model işlemlerini ücretlendirme) Satın alma (gelir paylaşımı modeli işlemleri) Geri ödeme (gelir paylaşımı modeli işlemleri)
   Ürün	Düzenlemeyi uygulamak istediğiniz API ürünü. Birden fazla API ürününe tek bir ayarlama uygulayamazsınız. Birden fazla API ürününe bir ayarlama uygulamanız gerekiyorsa her ürün için bir düzenleme oluşturun. Açılır menüden bir API ürünü seçin.
   Geliştirici	Düzenlemeyi uygulamak istediğiniz geliştirici. Düzenlemeyi 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. Düzenleme oluştur'u tıklayın.

Fatura ayarlamasını düzenleme

Bir fatura ayarlamasını düzenlemek için:

1. Faturalandırma Ayarlamaları sayfasına erişin.
2. İmleci, düzenlemek istediğiniz faturalandırma ayarlamasının üzerine getirin ve işlemler menüsünde simgesini tıklayın.
3. Fatura ayarlamasını gerektiği şekilde güncelleyin.
4. Ayarlamayı Güncelle'yi tıklayın.

API'yi kullanarak fatura ayarlamaları yapma

Aşağıdaki bölümlerde, API'yi kullanarak fatura 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ı ayarlayabilirsiniz. İsteği yaptığınızda, istek gövdesinde bunu belirtirsiniz:

• Faturalandırma düzenlemesinin adı.
• Düzenleme yüzdesi, yani faturayı sırasıyla yükselten veya düşüren pozitif veya negatif bir yüzde değeridir.
• Faturalandırma ayı.
• Fatura yılı.
• Faturalandırma düzenlemesinin uygulandığı kuruluş.

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

• Düzenlemeyi uygulamak istediğiniz işlemin türü (satın alma işlemi gibi).
• Düzenlemeyi uygulamak istediğiniz geliştirici.
• Düzenlemeyi ön ödemeli geliştiricilere, faturalı geliştiricilere veya her ikisine birden uygulamak isteyip istemediğiniz.
• Ayarlamayı uygulamak istediğiniz API paketi.
• Düzenlemeyi uygulamak istediğiniz API ürünü.

Bir ayarlama isteğinde belirtebileceğiniz faturalandırma ayarı özelliklerinin tam listesi için Faturalandırma ayarı yapılandırma ayarları bölümüne bakın.

İsteğe bağlı bir özellik belirtilmezse bu mülk için faturalandırma dokümanı ayarlaması her şey dahil olur. Örneğin, bir işlem türü belirtilmezse faturalandırma ayarlaması tüm işlem türleri için geçerli olur.

Aşağıdaki örnekte açık faturalandırma ayı olan Haziran 2013 için bir faturalandırma ayarlaması gösterilmektedir. %3'lük bir azalmaya neden olan düzenleme; satın alma işlemlerine, ödeme ürününe ve faturalı geliştiricilere uygulanır. Belirli bir geliştiriciyi veya API paketini tanımlamaya ilişkin özellikler belirtilmediğinden düzenleme, tüm geliştiricilere (sonradan ödemeli 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österilir):

{
  "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 ayarlamalarını görüntüleme

Bir kuruluşa ait belirli bir fatura ayarlamasını veya tüm fatura ayarlamalarını görüntüleyebilirsiniz. Belirli bir faturalandırma 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}, ilgili faturalandırma ayarlamasının kimliğidir (kimlik, faturalandırma ayarlamasını oluşturduğunuzda yanıtta 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şun tüm fatura ayarlamalarını görüntülemek için /organizations/{org_name}/billing-adjustments adresine 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österilir):

{
  "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ını güncelleme

/organizations/{org_name}/billing-adjustments/{billing_adjustment_id} için PUT isteği göndererek faturalandırma ayarlamasını güncelleyebilirsiniz. Burada {billing_adjustment_id}, ilgili faturalandırma ayarlamasının tanımlamasıdır. Güncellemeyi yaparken, istek gövdesinde güncellenen özellikleri ve güncellenecek faturalandırma ayarlamasının tanımını belirtmeniz gerekir. Ayrıca faturalandırma ayarlaması için zorunlu özellikleri (yani ad, ayarlama yüzdesi, fatura ayı, fatura yılı ve kuruluşa ait özellikleri) belirtmeniz gerekir.

Örneğin, aşağıdaki API çağrısı, düzenleme 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 bir fatura ayarlamasını silme

/organizations/{org_name}/billing-adjustments/{billing_adjustment_id} için DELETE isteği göndererek faturalandırma ayarlamasını silebilirsiniz. Burada {billing_adjustment_id}, silinecek faturalandırma ayarlamasının tanımlamasıdı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

API için faturalandırma ayarı yapılandırma ayarları

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

Ad	Açıklama	Varsayılan	Zorunlu mu?
name	Fatura ayarlaması için açıklayıcı bir ad.	Yok	Evet
adjustmentPercentageFactor	Pozitif veya negatif sayısal yüzde olarak, düzenlemenin tutarı. Pozitif yüzde, işlemdeki gelir paylaşımını veya ücretleri bu yüzdeye göre ayarlar. Negatif yüzde, işlemdeki gelir paylaşımını veya ücretleri bu yüzdeye göre düşürür. Değerler -100 ile 999,9999 arasında olabilir.	Yok	Evet
billingMonth	Faturalandırma ayarlaması için fatura ayı; tam sayı olarak belirtilir. Örneğin, Aralık için 11.	Yok	Evet
billingYear	Fatura ayarlaması için fatura yılı. Şu biçim kullanılarak belirtilir: YYYY. Örneğin, 2017.	Yok	Evet
organization	Faturalandırma düzenlemesinin geçerli olduğu kuruluş.	Yok	Evet
isPublished	Düzenlemenin yayınlanıp yayınlanmayacağını belirten bir işaret. Değer şunlardan biri olabilir: true. Fatura ayarlaması yayınlanmalıdır. false. Faturalandırma ayarlaması yayınlanmamalıdır.	Yok	Hayır
transactionType	Fatura düzenlemesinin geçerli olduğu işlemlerin türü. Tür aşağıdakilerden biri olabilir: PURCHASE CHARGE REFUND CREDIT BALANCE SETUPFEES TERMINATIONFEES RECURRINGFEES TRUEUPS. Bunlar, puanlanmış işlemleri yeniden ayarlamak için kullanılan işlemlerdir. Önceki faturalandırma ayında vergi değişiklikleri yapıldığında bu numaradan yararlanılır.	Yok	Hayır
developerBillingType	Faturalandırma düzenlemesinin geçerli olduğu geliştirici faturalandırma türü. Değer şunlardan biri olabilir: PREPAID.. Ön ödemeli geliştiriciler. POSTPAID. Sonradan ödemeli geliştiriciler. BOTH. Ön ödemeli ve faturalı geliştiriciler.	Yok	Hayır
product	Faturalandırma düzenlemesinin geçerli olduğu API ürünü. Bu özelliği belirtmezseniz faturalandırma ayarlaması tüm API ürünleri için geçerli olur.	Yok	Hayır
monetizationPackage	Faturalandırma düzenlemesinin geçerli olduğu API paketi. Bu özelliği belirtmezseniz faturalandırma ayarlaması tüm API paketleri için geçerli olur.	Yok	Hayır
developer	Faturalandırma düzenlemesinin geçerli olduğu geliştirici. Bu özelliği belirtmezseniz fatura ayarlaması tüm geliştiriciler için geçerli olur.	Yok	Hayır

Sonraki adımlar

Para kazanma, bir geliştiriciye kredi verme esnekliği sağlar. Geliştirici bir hizmetten memnun kalmazsa ve bir süreliğine kullanım için kısmi veya tam geri ödeme talep ederse bunu yapmanız gerekebilir. Kredi verme bölümünde nasıl kredi gönderileceğini öğrenin.