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

आपको Apigee Edge दस्तावेज़ दिख रहा है.
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है इस पेज पर जाएं Apigee X दस्तावेज़.
जानकारी

परिचय

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

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

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

Edge

Edge यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके, बिलिंग अडजस्टमेंट के पेज को ऐक्सेस करने के लिए:

  1. apigee.com/edge में साइन इन करें.
  2. पब्लिश करें > को चुनें कमाई करना > बिलिंग समायोजन पर क्लिक करें.

इसके बाद, बिलिंग अडजस्टमेंट पेज दिखेगा.

जैसा कि इमेज में दिखाया गया है, बिलिंग अडजस्टमेंट पेज की मदद से ये काम किए जा सकते हैं:

क्लासिक Edge (प्राइवेट क्लाउड)

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

  1. http://ms-ip:9000 में साइन इन करें, जहां ms-ip मैनेजमेंट सर्वर नोड का आईपी पता या डीएनएस नाम.
  2. कमाई करना > सबसे ऊपर मौजूद नेविगेशन बार में, अडजस्टमेंट पर क्लिक करें.

बिलिंग अडजस्टमेंट पेज की मदद से, ये काम किए जा सकते हैं:

  • बिलिंग अडजस्टमेंट की मौजूदा सूची देखना
  • बिलिंग समायोजन जोड़ें
  • बिलिंग समायोजन में बदलाव करें
  • बिलिंग समायोजन की सूची खोजें

बिलिंग समायोजन जोड़ें

बिलिंग समायोजन जोड़ने के लिए:

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

    जानकारी देने वाला नाम, जो बिलिंग दस्तावेज़ पर दिखेगा.

    बदलाव का प्रतिशत

    पॉज़िटिव या नेगेटिव प्रतिशत के तौर पर अडजस्टमेंट की रकम. ए पॉज़िटिव प्रतिशत कितनी राशि के आधार पर लेन-देन में आय का हिस्सा या शुल्क समायोजित करता है प्रतिशत. नेगेटिव अडजस्टमेंट से, आपके रेवेन्यू के बंटवारे या शुल्क को कितना प्रतिशत पेमेंट करना है. धनात्मक या ऋणात्मक दशमलव संख्या डालें (ऊपर के साथ) दो दशमलव स्थानों तक).

    बिलिंग महीना

    अडजस्टमेंट के लिए बिलिंग महीना. ड्रॉप-डाउन सूची से कोई महीना चुनें.

    लेन-देन का टाइप

    जिस तरह के लेन-देन के लिए अडजस्टमेंट लागू करना है. अपने कैंपेन के मकसद के आधार पर, ड्रॉप-डाउन से मान:

    • सभी लेन-देन
    • चार्ज करना (मॉडल लेन-देन चार्ज करना)
    • खरीदारी (रेवेन्यू के बंटवारे वाले मॉडल के लेन-देन)
    • रिफ़ंड (रेवेन्यू के बंटवारे वाले मॉडल के लेन-देन)
    प्रॉडक्ट

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

    डेवलपर

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

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

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

बिलिंग समायोजन में बदलाव करने के लिए:

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

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

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

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

पोस्ट का अनुरोध जारी करके, बिलिंग की जानकारी में बदलाव किया जा सकता है /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
}

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

आप के लिए एक PUT अनुरोध जारी करके बिलिंग समायोजन को अपडेट कर सकते हैं /organizations/{org_name}/billing-adjustments/{billing_adjustment_id}, जहां {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

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

इसके लिए, DELETE अनुरोध जारी करके, बिलिंग अडजस्टमेंट को मिटाया जा सकता है /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

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

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

नाम ब्यौरा डिफ़ॉल्ट ज़रूरी है?
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

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

लागू नहीं नहीं

अगले चरण

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