Faturalandırma ayarlamaları yapma

Apigee Edge belgelerini görüntülüyorsunuz.
. Git: Apigee X belgeleri. bilgi

Giriş

Para kazanma özelliği, fatura ayrıntılarında düzenlemeler yapmanıza olanak tanır. Örneğin, bir tedarikçinin nedeniyle herhangi bir faturalandırma ayında gelir paylaşımını veya ücretleri artırmak ya da azaltmak için tutarsızlığa neden olabilir.

Faturalandırma Ayarlamaları 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. Fatura 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ı bir ad.
   Düzenleme yüzdesi	Düzenlemenin pozitif veya negatif yüzde miktarı. A pozitif yüzde değeri, buna göre işlemdeki gelir paylaşımını veya ücretleri yüzdelik oranına. Negatif bir düzenleme, yüzdeye göre işlem yapabilirsiniz. Pozitif veya negatif bir ondalık sayı girin ( iki ondalık basamak) ekleyin.
   Faturalandırma Ayı	Düzenlemenin fatura ayı. Açılır listeden bir ay seçin.
   İşlem Türü	Düzenlemeyi uygulamak istediğiniz işlemin türü. Hedeflerinize göre bir değerini 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	Düzenlemeyi uygulamak istediğiniz API ürünü. Bu işlem için Birden fazla API ürününde tek bir düzenleme. Proje bütçesine birden fazla API ürünü varsa her ürün için bir düzenleme oluşturun. API ürünü seçin seçeneğini belirleyin.
   Geliştirici	Ayarlamayı uygulamak istediğiniz geliştirici. URL parametrelerinin Google tarafından nasıl ele alınmasını istediğinizi belirtmek için (varsayılan olarak) tüm geliştiricilere veya belirli bir geliştiriciye yönelik düzenleme. "Tümü"nü seçin Geliştiriciler" veya belirli bir geliştiriciyi seçin.

4. Düzenleme oluştur'u tıklayın.

Fatura ayarlamasını düzenleme

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

1. Fatura Ayarlamaları 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. Fatura ayarlamasını gerektiği gibi güncelleyin.
4. Düzenlemeyi Güncelle'yi tıklayın.

API'yi kullanarak fatura ayarlamaları yapma

Aşağıdaki bölümlerde, API kullanılarak fatura ayarlamalarının nasıl yapılacağı açıklanmaktadır.

API'yi kullanarak fatura ayarlaması yapma

Şuna bir POST isteği göndererek faturalandırma ayrıntılarını ayarlayabilirsiniz: /organizations/{org_name}/billing-adjustments. Talepte bulunduğunuzda istek içeriği:

• Fatura ayarlamasının adı.
• Düzenleme yüzdesi, yani faturayı artırır veya azaltır.
• Faturalandırma ayı.
• Faturalandırma 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ü (ör. satın alma işlemi) işlemi) ekleyebilirsiniz.
• Ayarlamayı uygulamak istediğiniz geliştirici.
• Düzenlemeyi ön ödemeli geliştiricilere, faturalı geliştiricilere veya her ikisini de seçebilirsiniz.
• Düzenlemeyi uygulamak istediğiniz API paketi.
• Düzenlemeyi uygulamak istediğiniz API ürünü.

Aşağıdakilerin tam listesi için Fatura ayarlaması yapılandırma ayarları bölümüne bakın Düzenleme isteğinde belirtebileceğiniz faturalandırma ayarlaması özellikleri.

İsteğe bağlı bir özellik belirtilmezse faturalandırma dokümanı düzenlemesinin tamamı geçerli olur. dahil değildir. Örneğin, işlem türü belirtilmemişse faturalandırma düzenleme tüm işlem türlerine uygulanır.

Aşağıdaki örnekte açık faturalandırma ayı (Haziran 2013) için bir fatura düzenlemesi yapılmaktadır. İlgili içeriği oluşturmak için kullanılan Bu düzenleme %3'lük bir düşüş sağlar ve satın alma işlemlerine uygulanır. ödeme ürünü geliştirenler ve sonradan ödemeli geliştiriciler içerir. Çünkü bir anahtar kelimeyi tanımlamaya yönelik geliştirici veya API paketi belirtilmediyse düzenleme, (Google Play Müzik sonradan ödemeli geliştiriciler) ve tüm API paketlerindeki ödeme ürünüdü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ünecektir (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şla ilgili belirli bir fatura ayarlamasını veya tüm fatura ayarlamalarını görüntüleyebilirsiniz. Belirli bir fatura ayarlamasını görüntülemek için şuna bir GET isteği gönderin: /organizations/{org_name}/billing-adjustments/{billing_adjustment_id}, burada: {billing_adjustment_id} özel fatura düzenlemesinin kimliğidir (kimlik, fatura 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 şuna bir GET isteği gönderin: /organizations/{org_name}/billing-adjustments Ö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ünecektir (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 faturalandırma ayarlamasını güncelleme

Fatura ayarlamasını, /organizations/{org_name}/billing-adjustments/{billing_adjustment_id}, burada: {billing_adjustment_id} özel fatura düzenlemesinin tanımıdır. Güncellemeyi yaptığınızda istek gövdesinde, güncellenen özellikleri ve güncellenecek fatura düzenlemesinin kimliği. Ayrıca faturalandırma düzenlemesi özelliklerini (yani ad, düzenleme yüzdesi ve fatura ayı, fatura yılı ve kuruluş.

Örneğin, aşağıdaki API çağrısı, düzenleme yüzde faktörünü ve adını ( 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ını silme

Faturalandırma ayarlamasını silmek için /organizations/{org_name}/billing-adjustments/{billing_adjustment_id}, burada: {billing_adjustment_id}, yapılacak fatura düzenlemesinin kimliğidir silindi. Ö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 ayarlamaları için aşağıdaki yapılandırma seçenekleri kullanılabilir:

Sonraki adımlar

Para kazanma, bir geliştiriciye kredi verme esnekliği sağlar. Yapmak istediğiniz Geliştirici bir hizmetten memnun kalmazsa ve kullanım karşılığında kısmi ya da tam geri ödeme isterse bu bir süre boyunca geçerli olur. Kredi oluşturma bölümünden nasıl kredi verileceğini öğrenebilirsiniz.