Kuruluş profilini yönetme

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

Aşağıdaki bölümlerde kuruluş profili tanıtılmakta ve kullanıcı arayüzü ile API kullanılarak nasıl yönetilebileceği açıklanmaktadır.

Kuruluş profili hakkında

Para kazanma özelliğinin ilk kurulumu kapsamında, Apigee Edge yapılandırma ekibi kuruluş profilinizi oluşturur.

Kuruluşunuzla ilgili bilgileri eklemek veya güncellemek için kuruluş profilini düzenlemeniz gerekir. Örneğin, faturalandırma türünü, para birimi ayarlarını veya vergi modelini güncellemeniz gerekebilir.

Aşağıdakiler dahil olmak üzere kuruluşunuzla ilgili temel bilgileri yapılandırın:

• Kuruluşun adı, adresi ve faaliyet gösterdiği ülke
• Faturalandırma türünü anlama başlıklı makalede açıklandığı gibi faturalandırma türü (ön ödemeli, sonradan ödemeli veya her ikisi)
• Faturalandırma dönemi (kullanım süresine göre hesaplanan veya takvim ayı)
• Temel para birimi
• Kuruluşunuzun kullandığı vergi modeli

Kuruluş profilinizi aşağıdaki bölümlerde açıklandığı şekilde kullanıcı arayüzünü ve API'yi kullanarak yönetebilirsiniz.

Kuruluş Profili sayfasını keşfetme

Aşağıda açıklandığı şekilde kuruluş profili sayfasına erişin.

Kullanıcı arayüzünü kullanarak kuruluş profilini düzenleme

Kullanıcı arayüzünü kullanarak kuruluş profilini düzenlemek için:

1. Kuruluş profili sayfasına gidin.
2. Düzenle'yi tıklayın.
3. Ad ve bilgiler bölümünde kuruluş adını ve faaliyet gösterilen ülkeyi düzenleyin.
4. Vergiler ve para birimi bölümünde aşağıdaki alanları düzenleyin:

   Alan	Açıklama
   Vergi Modeli	Not: Yalnızca gelir paylaşımı oran planları ayarladıysanız ve faturalandırma belgeleri oluşturmak istiyorsanız geçerlidir. Gerekli faturalandırma belgelerinin türünü belirleyen, gelir paylaşımı ücret planları için vergi modeli. Geçerli değerler şunlardır: Açıklanmış: API sağlayıcı, geliştiricinin açıklanmış aracısı olarak hareket eder. Son kullanıcıdan alınan brüt gelir (satış vergileri dahil) geliştiriciye aktarılır. API sağlayıcının komisyonu, geliştiriciden komisyon faturası şeklinde alınır. API sağlayıcı, son kullanıcıdan alınan satış vergisini ele almaz ve satış vergisini bildirmek geliştiricinin sorumluluğundadır. Açıklanmayan: API sağlayıcı, geliştiricinin açıklanmayan temsilcisi olarak hareket eder ve son kullanıcılardan toplanan vergiyi kesip yerel vergi dairelerine öder. Geliştirici, API sağlayıcıya geliştiriciye ödenmesi gereken net gelir payı (satış vergileri ve API sağlayıcının komisyonu hariç) için fatura keser. Karma: API sağlayıcı, geliştiricinin açıklanmış aracısı olarak hareket eder. Ancak API sağlayıcı, abonelerinden alınan satış vergisini geliştirici adına yerel vergi dairelerine öder. API sağlayıcı, kalan geliri geliştiriciye aktarır ve ardından komisyon ücretleri için fatura düzenler.
   Para Birimi	Kuruluşunuzun desteklediği para birimleri Gelir paylaşımı, fiyat listesi ve yalnızca ücret planları için ücret planınızda varsayılan para birimi kullanılır. Ücret tablosu veya yalnızca ücret planı oluşturduğunuzda, desteklenen para birimleri listesinden seçim yaparak hangi para biriminin kullanılacağını değiştirebilirsiniz. İsteğe bağlı olarak, uygulama geliştiricilerin her para birimi için ön ödemeli hesap bakiyelerine ekleyebileceği minimum yükleme tutarını belirleyebilirsiniz. Para birimi eklemek için: Para birimi ekle'yi tıklayın. Para birimi alanındaki açılır menüden bir para birimi seçin. İsteğe bağlı olarak, uygulama geliştiricilerin ön ödemeli hesap bakiyelerine ekleyebilecekleri minimum tutarı Minimum yükleme alanında belirleyin. Ekle'yi tıklayın. İsterseniz ilişkili radyo düğmesini tıklayarak varsayılan para birimi olarak ayarlayın. Başka para birimleri eklemek için adımları tekrarlayın. Bir para birimini silmek için imlecinizi silmek istediğiniz para biriminin üzerine getirip simgesini tıklayın.

5. Kullanıcı arayüzünü kullanarak hüküm ve koşulları yönetme başlıklı makalede açıklandığı şekilde hüküm ve koşulları yönetin.
6. Kaydet'i tıklayın.

API'yi kullanarak kuruluş profilini yönetme

Kuruluş profilini aşağıdaki bölümlerde açıklandığı şekilde API'yi kullanarak yönetin.

API'yi kullanarak kuruluş profilini görüntüleme

/mint/organizations/{org_name} adresine bir GET isteği göndererek kuruluş profilinizi görüntüleyin. Örneğin:

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

Aşağıda, yanıta dair bir örnek verilmiştir. Gösterilen seçenekler hakkında daha fazla bilgi için API için kuruluş profili yapılandırma özellikleri başlıklı makaleyi inceleyin.

{
    "address" : [ {
      "address1" : "Test address”,
      "city" : "Test City",
      "country" : "US",
      "id" : "test-address",
      "isPrimary" : true,
      "state" : "CA",
      "zip" : "54321"
    } ],
    "approveTrusted" : false,
    "approveUntrusted" : false,
    "billingCycle" : "CALENDAR_MONTH",
    "country" : "US",
    "currency" : "USD",
    "description" : "Test organization",
    "hasBillingAdjustment" : true,
    "hasBroker" : false,
    "hasSelfBilling" : false,
    "hasSeparateInvoiceForProduct" : false,
    "id" : "{org_name}"
    "issueNettingStmt" : false,
    "logoUrl" : " https://dl.dropboxusercontent.com/u/48279818/LOGOS/testorg.jpeg",
    "name" : "myorg",
    "nettingStmtPerCurrency" : false,
    "regNo" : "RegNo-1234-myorg",
    "selfBillingAsExchOrg" : false,
    "selfBillingForAllDev" : false,
    "separateInvoiceForFees" : true,
    "status" : "ACTIVE",
    "supportedBillingType" : "PREPAID",
    "taxModel" : "UNDISCLOSED",
    "taxRegNo" : "TaxRegNo-1234-myorg",
    "timezone" : "UTC"
}

API'yi kullanarak kuruluş profilini düzenleme

/mint/organizations/{org_name} adresine bir PUT isteği göndererek kuruluş profilini düzenleyin. Kuruluş profilini düzenlerken yalnızca düzenlediğiniz özellikleri değil, tüm kuruluş profili özelliklerini belirtmeniz gerekir.

Kuruluşun varsayılan para birimini düzenlemek için currency değerini, varsayılan olarak ayarlamak istediğiniz desteklenen para biriminin ISO 4217 para birimi kodu olarak ayarlayın.

Örneğin, aşağıdaki API çağrısı currency değerini ABD doları olarak, vergi modeli ayarını ise HYBRID olarak günceller (örnekte güncellenen alanlar vurgulanmıştır). Gösterilen seçenekler hakkında daha fazla bilgi için API için kuruluş profili yapılandırma özellikleri başlıklı makaleyi inceleyin.

curl -X PUT "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}" \
  -H "Content-Type: application/json" \
  -d '{
  "address" : [ { 
    "address1" : "Test address”,
    "city" : "Test City",
    "country" : "US",
    "id" : "corp-address",
    "isPrimary" : true,
    "state" : "CA",
    "zip" : "54321"
  } ], 
  "approveTrusted" : false, 
  "approveUntrusted" : false, 
  "billingCycle" : "CALENDAR_MONTH", 
  "country" : "US", 
  "currency" : "USD", 
  "description" : "Test organization", 
  "hasBillingAdjustment" : true, 
  "hasBroker" : false, 
  "hasSelfBilling" : false, 
  "hasSeparateInvoiceForProduct" : false,
  "id" : "myorg", 
  "issueNettingStmt" : false, 
  "logoUrl" : "https://dl.dropboxusercontent.com/u/48279818/LOGOS/testorg.jpeg",
  "name" : "{org_name}", 
  "nettingStmtPerCurrency" : false, 
  "regNo" : "RegNo-1234-myorg", 
  "selfBillingAsExchOrg" : false, 
  "selfBillingForAllDev" : false, 
  "separateInvoiceForFees" : false, 
  "status" : "ACTIVE", 
  "supportedBillingType" : "POSTPAID",
  "taxModel" : "HYBRID", 
  "taxRegNo" : "TaxRegNo-1234-myorg", 
  "timezone" : "UTC" 
}' \

-u email:password

API'yi kullanarak ön ödemeli ve sonradan ödemeli faturalandırma türlerini yapılandırma

Geliştirici hesapları, ön ödemeli, sonradan ödemeli veya her ikisi de dahil olmak üzere aşağıdaki faturalandırma türlerini kullanacak şekilde yapılandırılabilir.

Ön ödemeli hesaplarda geliştiriciler, API'lerinizin kullanımı için önceden ödeme yapar. Fonlar, entegre bir ödeme sağlayıcı aracılığıyla tutulan geliştiricinin ön ödemeli bakiyesinden düşülür. Geliştirici, API'leri satın almak için yeterli ön ödemeli bakiyeye sahip olmalıdır.

Faturalı hesaplarda geliştiricilere ay sonunda aylık olarak fatura gönderilir. Geliştirici, API ürünlerinin kullanımı için faturada yer alan planlarda belirtilen ödeme koşullarına göre ödeme yapar.

Kuruluşunuz için ön ödemeli ve faturalı faturalandırma türlerini yapılandırmak üzere geçerli faturalandırma türlerini belirtmek için supportedBillingType özelliğini aşağıdaki değerlerden birine ayarlayın: PREPAID, POSTPAID veya BOTH. Değeri BOTH olarak ayarlarsanız uygulama geliştirici veya şirket eklediğinizde varsayılan değer PREPAID olur. Bu durumda, Şirketleri ve uygulama geliştiricileri yönetme başlıklı makalede açıklandığı gibi, API'yi kullanarak bir şirket veya uygulama geliştirici için faturalandırma türünü açıkça ayarlayabilirsiniz.

Örneğin:

curl -X PUT "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}" \
  -H "Content-Type: application/json" \
  -d '{
  "address" : [ {
    "address1" : "Test address",
    "city" : "Test City",
    "country" : "US",
    "id" : "corp-address",
    "isPrimary" : true,
    "state" : "CA",
    "zip" : "54321"
  } ],
  "approveTrusted" : false,
  "approveUntrusted" : false,
  "billingCycle" : "CALENDAR_MONTH",
  "country" : "US",
  "currency" : "USD",
  "description" : "Test organization",
  "hasBillingAdjustment" : true,
  "hasBroker" : false,
  "hasSelfBilling" : false,
  "hasSeparateInvoiceForProduct" : false,
  "id" : "myorg",
  "issueNettingStmt" : false,
  "logoUrl" : "https://dl.dropboxusercontent.com/u/48279818/LOGOS/testorg.jpeg",
  "name" : "{org_name}",
  "nettingStmtPerCurrency" : false,
  "regNo" : "RegNo-1234-myorg",
  "selfBillingAsExchOrg" : false,
  "selfBillingForAllDev" : false,
  "separateInvoiceForFees" : false,
  "status" : "ACTIVE",
  "supportedBillingType" : "POSTPAID",
  "taxModel" : "HYBRID",
  "taxRegNo" : "TaxRegNo-1234-myorg",
  "timezone" : "UTC"
  }' \
  -u email:password

API'yi kullanarak faturalandırma döngüsünü yapılandırma

Kuruluşunuzun faturalandırma döngüsünü yapılandırmak için billingCycle özelliğini aşağıdaki değerlerden birine ayarlayın:

• PRORATED: Faturalandırma, bir API ürününün takvim ayında kullanıldığı gün sayısına göre yapılır.
• CALENDAR_MONTH: Faturalandırma aylık olarak yapılır.

Örneğin:

curl -X PUT "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}" \
  -H "Content-Type: application/json" \
  -d '{
    "address" : [ {
      "address1" : "Test address",
      "city" : "Test City",
      "country" : "US",
      "id" : "corp-address",
      "isPrimary" : true,
      "state" : "CA",
      "zip" : "54321"
    } ],
    "approveTrusted" : false,
    "approveUntrusted" : false,
    "billingCycle" : "CALENDAR_MONTH",
    "country" : "US",
    "currency" : "USD",
    "description" : "Test organization",
    "hasBillingAdjustment" : true,
    "hasBroker" : false,
    "hasSelfBilling" : false,
    "hasSeparateInvoiceForProduct" : false,
    "id" : "myorg",
    "issueNettingStmt" : false,
    "logoUrl" : "https://dl.dropboxusercontent.com/u/48279818/LOGOS/testorg.jpeg",
    "name" : "{org_name}",
    "nettingStmtPerCurrency" : false,
    "regNo" : "RegNo-1234-myorg",
    "selfBillingAsExchOrg" : false,
    "selfBillingForAllDev" : false,
    "separateInvoiceForFees" : false,
    "status" : "ACTIVE",
    "supportedBillingType" : "POSTPAID",
    "taxModel" : "HYBRID",
    "taxRegNo" : "TaxRegNo-1234-myorg",
    "timezone" : "UTC"
  }' \
  -u email:password

API için kuruluş profili yapılandırma özellikleri

Kuruluş profili, API'yi kullanarak aşağıdaki yapılandırma özelliklerini ayarlamanıza olanak tanır.

Bir şirket veya uygulama geliştiricinin para kazanma profili ayarlarını geçersiz kılma

Aşağıdaki bölümlerde açıklandığı gibi, kullanıcı arayüzünü veya API'yi kullanarak bir şirket ya da uygulama geliştiricinin para kazanma profili ayarlarını geçersiz kılın:

• Uygulama geliştiriciler için özel özellikleri yönetme
• Şirketleri ve uygulama geliştiricileri yönetme
• Uygulama geliştiricileri yönetme