बिलिंग अडजस्टमेंट करें

यहां Apigee Edge के दस्तावेज़ देखे जा रहे हैं.
पर जाएं Apigee X दस्तावेज़. info

परिचय

Monetization की मदद से, बिलिंग की जानकारी में बदलाव किए जा सकते हैं. उदाहरण के लिए, हो सकता है कि आपको अपने रिकॉर्ड में गड़बड़ी की वजह से, किसी महीने के लिए रेवेन्यू शेयर या शुल्क बढ़ाना या घटाना पड़े.

बिलिंग अडजस्टमेंट पेज के बारे में जानकारी

बिलिंग अडजस्टमेंट पेज को ऐक्सेस करने का तरीका यहां बताया गया है.

बिलिंग अडजस्टमेंट जोड़ना

बिलिंग अडजस्टमेंट जोड़ने के लिए:

1. बिलिंग अडजस्टमेंट पेज को ऐक्सेस करें.
2. + अडजस्टमेंट पर क्लिक करें.
3. यह जानकारी डालें:

   फ़ील्ड	ब्यौरा
   नाम	कोई ऐसा नाम जो बिलिंग से जुड़े दस्तावेज़ पर दिखेगा.
   अडजस्टमेंट का प्रतिशत	अडजस्टमेंट की रकम, जिसे पॉज़िटिव या नेगेटिव प्रतिशत के तौर पर दिखाया जाता है. पॉज़िटिव प्रतिशत से, लेन-देन में रेवेन्यू शेयर या शुल्क में बढ़ोतरी होती है. नेगेटिव प्रतिशत से, लेन-देन में रेवेन्यू शेयर या शुल्क में कमी होती है. पॉज़िटिव या नेगेटिव डेसिमल नंबर डालें. इसमें दो डेसिमल प्लेस तक हो सकते हैं.
   बिलिंग का महीना	अडजस्टमेंट के लिए बिलिंग का महीना. ड्रॉप-डाउन सूची से कोई महीना चुनें.
   ट्रांजै़क्शन का टाइप	उस लेन-देन का टाइप जिसके लिए आपको अडजस्टमेंट लागू करना है. ड्रॉप-डाउन से कोई वैल्यू चुनें: सभी लेन-देन शुल्क (चार्जिंग मॉडल के लेन-देन) खरीदारी (रेवेन्यू के बंटवारे के मॉडल के लेन-देन) रिफ़ंड (रेवेन्यू के बंटवारे के मॉडल के लेन-देन)
   प्रॉडक्ट	वह एपीआई प्रॉडक्ट जिसके लिए आपको अडजस्टमेंट लागू करना है. एक से ज़्यादा एपीआई प्रॉडक्ट पर एक ही अडजस्टमेंट लागू नहीं किया जा सकता. अगर आपको एक से ज़्यादा एपीआई प्रॉडक्ट पर अडजस्टमेंट लागू करना है, तो हर प्रॉडक्ट के लिए एक अडजस्टमेंट बनाएं. ड्रॉप-डाउन मेन्यू से कोई एपीआई प्रॉडक्ट चुनें.
   डेवलपर	वह डेवलपर जिसके लिए आपको अडजस्टमेंट लागू करना है. अडजस्टमेंट को सभी डेवलपर (डिफ़ॉल्ट रूप से) या किसी खास डेवलपर पर लागू किया जा सकता है. ड्रॉप-डाउन मेन्यू से, "सभी डेवलपर" या कोई खास डेवलपर चुनें.

4. अडजस्टमेंट बनाएं पर क्लिक करें.

बिलिंग अडजस्टमेंट में बदलाव करना

बिलिंग अडजस्टमेंट में बदलाव करने के लिए:

1. बिलिंग अडजस्टमेंट पेज को ऐक्सेस करें.
2. कर्सर को उस बिलिंग अडजस्टमेंट पर ले जाएं जिसमें आपको बदलाव करना है. इसके बाद, कार्रवाइयों के मेन्यू में पर क्लिक करें.
3. ज़रूरत के मुताबिक, बिलिंग अडजस्टमेंट को अपडेट करें.
4. अडजस्टमेंट अपडेट करें पर क्लिक करें.

एपीआई का इस्तेमाल करके, बिलिंग अडजस्टमेंट करना

इन सेक्शन में, एपीआई का इस्तेमाल करके बिलिंग अडजस्टमेंट करने का तरीका बताया गया है.

एपीआई का इस्तेमाल करके, बिलिंग अडजस्टमेंट करना

/organizations/{org_name}/billing-adjustments पर POST अनुरोध भेजकर, बिलिंग की जानकारी में बदलाव किया जा सकता है. अनुरोध करते समय, अनुरोध के मुख्य हिस्से में यह जानकारी दें:

• बिलिंग अडजस्टमेंट का नाम.
• अडजस्टमेंट का प्रतिशत. यह पॉज़िटिव या नेगेटिव प्रतिशत वैल्यू होती है. इससे बिल में क्रमशः बढ़ोतरी या कमी होती है.
• बिलिंग का महीना.
• बिलिंग का साल.
• वह संगठन जिस पर बिलिंग अडजस्टमेंट लागू किया गया है.

इसके अलावा, अन्य प्रॉपर्टी भी तय की जा सकती हैं. जैसे:

• उस लेन-देन का टाइप जिसके लिए आपको अडजस्टमेंट लागू करना है. जैसे, खरीदारी का लेन-देन.
• वह डेवलपर जिसके लिए आपको अडजस्टमेंट लागू करना है.
• क्या आपको अडजस्टमेंट, प्रीपेड डेवलपर, पोस्टपेड डेवलपर या दोनों पर लागू करना है.
• वह एपीआई पैकेज जिसके लिए आपको अडजस्टमेंट लागू करना है.
• वह एपीआई प्रॉडक्ट जिसके लिए आपको अडजस्टमेंट लागू करना है.

अडजस्टमेंट के अनुरोध में तय की जा सकने वाली, बिलिंग अडजस्टमेंट की सभी प्रॉपर्टी की सूची देखने के लिए, बिलिंग अडजस्टमेंट कॉन्फ़िगरेशन सेटिंग देखें.

अगर कोई ज़रूरी नहीं है वाली प्रॉपर्टी तय नहीं की जाती है, तो बिलिंग से जुड़े दस्तावेज़ में उस प्रॉपर्टी के लिए सभी अडजस्टमेंट शामिल होंगे. उदाहरण के लिए, अगर लेन-देन का कोई टाइप तय नहीं किया जाता है, तो बिलिंग अडजस्टमेंट सभी तरह के लेन-देन पर लागू होगा.

यहां दिए गए उदाहरण में, बिलिंग के चालू महीने, यानी कि जून 2013 के लिए बिलिंग अडजस्टमेंट किया गया है. अडजस्टमेंट से 3% की कमी होती है. यह खरीदारी के लेन-देन, पेमेंट प्रॉडक्ट, और पोस्टपेड डेवलपर पर लागू होता है. किसी खास डेवलपर या एपीआई पैकेज की पहचान करने वाली प्रॉपर्टी तय नहीं की गई हैं. इसलिए, अडजस्टमेंट सभी डेवलपर (जो पोस्टपेड डेवलपर हैं) और सभी एपीआई पैकेज में पेमेंट प्रॉडक्ट पर लागू होगा.

$ 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

जवाब कुछ इस तरह दिखना चाहिए. यहां जवाब का सिर्फ़ एक हिस्सा दिखाया गया है:

{
  "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"
}

एपीआई का इस्तेमाल करके, बिलिंग अडजस्टमेंट देखना

किसी संगठन के लिए, कोई खास बिलिंग अडजस्टमेंट या सभी बिलिंग अडजस्टमेंट देखे जा सकते हैं. कोई खास बिलिंग अडजस्टमेंट देखने के लिए, /organizations/{org_name}/billing-adjustments/{billing_adjustment_id} पर GET अनुरोध भेजें. यहां {billing_adjustment_id} , खास बिलिंग अडजस्टमेंट की पहचान है. बिलिंग अडजस्टमेंट बनाते समय, आईडी जवाब में दिखता है. उदाहरण के लिए:

$ 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

किसी संगठन के सभी बिलिंग अडजस्टमेंट देखने के लिए, /organizations/{org_name}/billing-adjustments पर GET अनुरोध भेजें. उदाहरण के लिए:

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

जवाब कुछ इस तरह दिखना चाहिए. यहां जवाब का सिर्फ़ एक हिस्सा दिखाया गया है:

{
  "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
}

एपीआई का इस्तेमाल करके, बिलिंग अडजस्टमेंट अपडेट करना

बिलिंग अडजस्टमेंट को अपडेट करने के लिए, /organizations/{org_name}/billing-adjustments/{billing_adjustment_id} पर PUT अनुरोध भेजें. यहां {billing_adjustment_id} , खास बिलिंग अडजस्टमेंट की पहचान है. अपडेट करते समय, अनुरोध के मुख्य हिस्से में अपडेट की गई प्रॉपर्टी और अपडेट किए जाने वाले बिलिंग अडजस्टमेंट की पहचान तय करनी होगी. आपको बिलिंग अडजस्टमेंट के लिए ज़रूरी प्रॉपर्टी भी तय करनी होंगी. जैसे, नाम, अडजस्टमेंट का प्रतिशत, बिलिंग का महीना, बिलिंग का साल, और संगठन.

उदाहरण के लिए, यहां दिए गए एपीआई कॉल से, अडजस्टमेंट के प्रतिशत फ़ैक्टर और नाम को अपडेट किया जाता है. उदाहरण में, अपडेट की गई प्रॉपर्टी को हाइलाइट किया गया है:

$ 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

एपीआई का इस्तेमाल करके, बिलिंग अडजस्टमेंट मिटाना

बिलिंग अडजस्टमेंट को मिटाने के लिए, /organizations/{org_name}/billing-adjustments/{billing_adjustment_id} पर DELETE अनुरोध भेजें. यहां {billing_adjustment_id} , मिटाए जाने वाले बिलिंग अडजस्टमेंट की पहचान है. उदाहरण के लिए:

$ 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

एपीआई के लिए, बिलिंग अडजस्टमेंट कॉन्फ़िगरेशन सेटिंग

बिलिंग अडजस्टमेंट के लिए, ये कॉन्फ़िगरेशन विकल्प उपलब्ध हैं:

अगले चरण

Monetization की मदद से, किसी डेवलपर को क्रेडिट जारी किए जा सकते हैं. ऐसा तब करना पड़ सकता है, जब कोई डेवलपर किसी सेवा से संतुष्ट न हो और किसी अवधि के लिए, इस्तेमाल के आधार पर आंशिक या पूरा रिफ़ंड मांगे. क्रेडिट जारी करने का तरीका जानने के लिए, क्रेडिट जारी करना लेख पढ़ें.