הגדרת עמלות לתוכנית תעריפים

אתם צופים במסמכי התיעוד של Apigee Edge.
כדאי לעיין במסמכי התיעוד של Apigee X. מידע

מבוא

מפתחי אפליקציות נדרשים לשלם עמלות כשהם נרשמים לתוכנית התמחור. אפשר להגדיר עמלות לכל סוג של תוכנית תמחור, למעט התראות על שינויים. העמלות הן אופציונליות, ולא חייבים לציין עמלות בתוכנית מחירים.

הגדרת עמלות לתוכנית מחירים באמצעות ממשק המשתמש

מגדירים עמלות לתוכנית תמחור, כמו שמתואר בהמשך.

Edge

כדי להגדיר עמלות, כשיוצרים או עורכים תוכנית תמחור, בוחרים סוג כלשהו של תוכנית תמחור (חוץ מ'התראה על שינוי מחיר') ומגדירים:

הגדרת פרטי החוזה

כשיוצרים או עורכים תוכנית תמחור, מגדירים את פרטי החוזה בקטע פרטי החוזה.

שדה תיאור ברירת מחדל
מטבע המטבע שבו מוצגות כל העמלות. בוחרים ערך מהתפריט הנפתח. USD
עמלת הגדרה עמלה חד-פעמית שמוחייבת כל מפתח בתאריך ההתחלה של המינוי. מזינים ערך כספי בשדה או משתמשים במקשי החיצים למעלה ולמטה כדי לבחור ערך. 0
עמלת ביטול מוקדם עמלה חד-פעמית שמוחייבת אם המפתח מסיים את התוכנית לפני תקופת החידוש. 0
משך החוזה מרווח הזמן שבו התוכנית מתחדשת אוטומטית (אלא אם המפתח מסיים את ההסכם לפני תאריך החידוש). מציינים את המספר ואת היחידה (יום, שבוע או חודש). אם מגדירים את הערך הזה ל-0, התוכנית נשארת בתוקף עד שהמפתח בוחר לסיים אותה. חודש אחד
המועד לתשלום חל תוך מספר הימים שעד אליהם צריך לבצע את התשלום. 30

הגדרת העלות של תוכנית התמחור

כשיוצרים או עורכים תוכנית תמחור, מגדירים את העלות שלה בקטע Cost (עלות).

שדה תיאור ברירת מחדל
עמלה בסיסית עמלה שהמפתח מחויב בה באופן שוטף עד שהוא מסיים את התוכנית. אם מציינים דמי בסיס, צריך לציין גם את תקופת החיוב (או משך הזמן), כלומר לציין את פרק הזמן בין חיובים של דמי בסיס (למשל, 30 ימים). 0
תקופת חיוב משך הזמן או פרק הזמן בין חיובים של עמלת בסיס. לדוגמה, 30 ימים. מציינים את המספר ואת היחידה (יום, שבוע או חודש). חודש אחד
בתשלום מראש צריך לציין אם אתם גובים את עמלת הבסיס מראש.

אם העמלה הבסיסית נגבית מראש (true):

אם דמי הבסיס לא נגבים מראש (false):

  • למפתחים שמשלמים מראש, העמלה הבסיסית מנוכה בסוף תקופת החיוב (לדוגמה, בסוף חודש החיוב). אם אין מספיק כסף בחשבון בתשלום מראש, המפתח ייחסם עד שהוא יטען מחדש את החשבון. מידע נוסף זמין במאמר בנושא ניהול היתרות בחשבון בתשלום מראש.
  • מפתחים שמשלמים בסוף תקופת החיוב מחויבים בחשבונית ביום האחרון של תקופת החיוב (לדוגמה, בסוף חודש החיוב).
 מופעל
עמלה יחסית מציינים אם העמלה מחושבת באופן יחסי. הדבר רלוונטי למפתחים שמתחילים או מסיימים את התוכנית באמצע החודש. אם העמלה מחושבת באופן יחסי, העמלה הראשונית מבוססת על מספר הימים עד סוף התקופה (או מספר הימים שבהם נעשה שימוש בתקופה). אם העמלה לא מחושבת באופן יחסי, המפתחים מחויבים בעמלה הראשונית המלאה בלי קשר למועד שבו הם מתחילים (או מסיימים) את התוכנית. מופעל

‫Classic Edge (ענן פרטי)

כדי להגדיר עמלות לתוכנית תמחור באמצעות ממשק המשתמש הקלאסי של Edge:

  1. לוחצים על הכרטיסייה 'עמלות' בחלון 'תוכנית תמחור'.

  2. הזן את המידע הבא:
    שדה תיאור
    מטבע

    המטבע שבו רוצים לחייב את העמלות. בוחרים מטבע מהרשימה הנפתחת של המטבעות הנתמכים.
    סכום עמלת ההגדרה

    עמלה חד-פעמית שמוחלת על כל מפתח בתאריך ההתחלה של התוכנית (כלומר, התאריך שבו המפתח רוכש את התוכנית). מזינים את הסכום לחיוב.
    סיום מוקדם

    עמלה חד-פעמית שמוחייבת אם המפתח מסיים את התוכנית לפני תקופת החידוש. מזינים את הסכום לחיוב.
    חוזרת

    עמלה שמחויבת למפתח על בסיס שוטף עד שהמפתח מסיים את התוכנית. מציינים את הסכום לחיוב.
    נקודה

    תקופת הזמן בין חיובים חוזרים. מזינים מספר (בין 1 ל-12) ובוחרים באפשרות 'שבוע' או 'חודש'. לדוגמה, מזינים 1 ובוחרים באפשרות 'חודש' כדי לציין שהמפתח יחויב בעמלה הקבועה פעם בחודש.
    Pro Rata?

    מציין אם העמלה החוזרת מחושבת באופן יחסי או לא. השדה הזה מתייחס למצב שבו המפתח מתחיל או מסיים את התוכנית באמצע החודש. בוחרים באחד מלחצני האפשרויות הבאים:

    • כן, באופן יחסי. המונטיזציה מחלקת את העמלה הראשונית באופן יחסי לפי מספר הימים עד לסוף התקופה (או מספר הימים שבהם נעשה שימוש בתקופה).
    • לא, עמלה מלאה. במסגרת המונטיזציה, נגבה תשלום מלא על העמלה הראשונית, ללא קשר למועד שבו המפתח מתחיל (או מסיים) את התוכנית. זוהי אפשרות ברירת המחדל.
    ברכישה מראש?

    מציין אם העמלה החוזרת נגבית מראש או לא. בוחרים באחד מלחצני האפשרויות הבאים:

    • כן, החיוב הוא מראש. במונטיזציה, החיוב החוזר מתבצע מראש. לדוגמה, אם התקופה היא חודש אחד, העמלה הקבועה מחויבת בחשבונית שנוצרת בסיום חודש החיוב הקודם.
    • לא, יש לי חוב. החיוב על המינוי מתבצע בסוף התקופה. לדוגמה, אם התקופה היא חודש אחד, העמלה החוזרת מחויבת בחשבונית בסוף חודש החיוב הנוכחי. זוהי אפשרות ברירת המחדל.
    עמלות לתשלום

    המאפיין הזה מציין מתי צריך לשלם את העמלות. בוחרים 30, 45, 60 או 90 ימים. אפשר גם לבחור באפשרות Custom (התאמה אישית) כדי לציין תקופה אחרת לתשלום העמלות.

הגדרת עמלות לתוכנית תמחור באמצעות ה-API

אפשר להוסיף עמלות לתוכנית מחירים כשיוצרים או מעדכנים את התוכנית. מציינים את העמלות בגוף הבקשה של הקריאה.

לדוגמה, הבקשה הבאה יוצרת תוכנית תמחור רגילה עם דמי ביטול מוקדם, דמי הקמה ודמי מינוי חוזרים (כל אחד מהם מוגדר ל-10 דולר ארה"ב). משך התשלום הוא 30 יום, התשלומים הם ל-30 יום והתשלום החוזר הוא יחסי. (ההדגשה היא על המפרטים שקשורים לעמלות).

$ curl -H "Content-Type:application/json" -X POST -d \
'{
     "advance": false,
     "name": "Simple rate plan",
     "currency": {
      "id" : "usd"
     },
     "earlyTerminationFee": "10",
     "frequencyDuration": "30",
     "description": "Simple rate plan",
     "displayName" : "Simple rate plan",
     "frequencyDurationType": "DAY",
     "monetizationPackage": {
      "id": "location_package"
     },
     "organization": {
      "id": "myorg"
     },
     "prorate": "true",
     "paymentDueDays": "30",
     "published": "true",
     "ratePlanDetails": [
     {
      …
      }
      ],
     "recurringFee": "10",
     "setUpFee": "10",
     "startDate": "2013-09-15",
     "type": "STANDARD"
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/location_package/rate-plans" \
-u email:password

רשימה מלאה של אפשרויות לתוכניות תמחור זמינה במאמר מאפייני הגדרה של תוכניות תמחור.