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

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

शुरुआती जानकारी

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

बिलिंग समायोजन पेज के बारे में ज़्यादा जानना

नीचे बताए गए तरीके के मुताबिक, बिलिंग अडजस्टमेंट पेज को ऐक्सेस करें.

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

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

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

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

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

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

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

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

एपीआई का इस्तेमाल करके बिलिंग में बदलाव करना

नीचे दिए सेक्शन में एपीआई का इस्तेमाल करके बिलिंग घटाने या बढ़ाने का तरीका बताया गया है.

API का उपयोग करके बिलिंग समायोजन करना

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

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

आप अन्य प्रॉपर्टी के बारे में भी बता सकते हैं, जैसे:

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

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

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

नीचे दिया गया उदाहरण, मौजूदा बिलिंग महीने, जून 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} पर एक जीईटी अनुरोध जारी करें. इस अनुरोध में, {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 पर जीईटी अनुरोध जारी करें. उदाहरण के लिए:

$ 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

एपीआई के लिए बिलिंग घटाने या बढ़ाने की कॉन्फ़िगरेशन सेटिंग

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

नाम	ब्यौरा	डिफ़ॉल्ट	ज़रूरी है?
name	बिलिंग अडजस्टमेंट की जानकारी देने वाला नाम.	लागू नहीं	हां
adjustmentPercentageFactor	अडजस्टमेंट की रकम, पॉज़िटिव या नेगेटिव संख्या के प्रतिशत के रूप में. पॉज़िटिव प्रतिशत, लेन-देन में आय के हिस्से या शुल्क को उस प्रतिशत से घटाता या बढ़ाता है. नेगेटिव प्रतिशत, लेन-देन में आय के हिस्से या शुल्क को उस प्रतिशत तक घटा देता है. वैल्यू -100 से 999.9999 के बीच हो सकती है.	लागू नहीं	हां
billingMonth	बिलिंग अडजस्टमेंट के लिए बिलिंग महीना, जिसे पूर्णांक के तौर पर दिखाया जाता है. उदाहरण के लिए, दिसंबर के लिए 11.	लागू नहीं	हां
billingYear	बिलिंग में बदलाव के लिए बिलिंग साल, नीचे दिए गए फ़ॉर्मैट का इस्तेमाल करके बताया गया है: YYYY. उदाहरण के लिए, 2017.	लागू नहीं	हां
organization	वह संगठन जिस पर बिलिंग अडजस्टमेंट लागू होता है.	लागू नहीं	हां
isPublished	यह फ़्लैग बताता है कि अडजस्टमेंट को पब्लिश किया जाना चाहिए या नहीं. वैल्यू इनमें से एक हो सकती है: true. बिलिंग अडजस्टमेंट पब्लिश हो जाना चाहिए. false. बिलिंग अडजस्टमेंट को पब्लिश नहीं किया जाना चाहिए.	लागू नहीं	नहीं
transactionType	ऐसे लेन-देन के टाइप जिनके लिए बिलिंग अडजस्टमेंट लागू होता है. टाइप इनमें से कोई एक हो सकता है: PURCHASE CHARGE REFUND CREDIT BALANCE SETUPFEES TERMINATIONFEES RECURRINGFEES TRUEUPS. ये ऐसे लेन-देन हैं जिनका इस्तेमाल, रेट किए गए ट्रांज़ैक्शन में फिर से बदलाव करने के लिए किया जाता है. इन्हें तब लागू किया जाता है, जब पिछले बिलिंग महीने में टैक्स में बदलाव किए जाते हैं.	लागू नहीं	नहीं
developerBillingType	डेवलपर का बिलिंग टाइप, जिसके लिए बिलिंग अडजस्टमेंट लागू होता है. वैल्यू इनमें से कोई एक हो सकती है: PREPAID.. प्रीपेड डेवलपर. POSTPAID. पोस्टपेड डेवलपर. BOTH. प्रीपेड और पोस्टपेड डेवलपर.	लागू नहीं	नहीं
product	वह एपीआई प्रॉडक्ट जिसके लिए बिलिंग अडजस्टमेंट लागू होता है. इस प्रॉपर्टी का इस्तेमाल न करने पर, बिलिंग अडजस्टमेंट, एपीआई के सभी प्रॉडक्ट पर लागू होता है.	लागू नहीं	नहीं
monetizationPackage	वह एपीआई पैकेज जिसके लिए बिलिंग अडजस्टमेंट लागू होता है. अगर इस प्रॉपर्टी का इस्तेमाल नहीं किया जाता है, तो बिलिंग अडजस्टमेंट, एपीआई के सभी पैकेज पर लागू होता है.	लागू नहीं	नहीं
developer	वह डेवलपर जिसके लिए बिलिंग अडजस्टमेंट लागू होता है. इस प्रॉपर्टी को न चुनने पर, बिलिंग अडजस्टमेंट सभी डेवलपर पर लागू होता है.	लागू नहीं	नहीं

अगले चरण

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