התאמת חיוב

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

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

ישנם ארבעה ממשקי API הזמינים למנהלי שותפים העומדים בדרישות הגישה המינימליות.

ממשק API לחיוב

מטרת ה-API

דרישת גישת מנהל שותף

צור דוח חיוב סיטונאי

משמש להפקת דוח חיוב.

לִקְרוֹא / לִכתוֹב

קבל דוח חיוב סיטונאי

משמש לקבלת דוח חיוב שנוצר להורדה.

קרא

רשימת דוחות חיוב סיטונאיים

משמש לרישום דוחות החיוב הקיימים עבור שותף זה.

קרא

מחיקת דוח חיוב סיטונאי

משמש למחיקת דוח חיוב קיים.

לִקְרוֹא / לִכתוֹב

מקור נתונים

הנתונים עבור דוחות החיוב נמשכים מנתוני צריכת השימוש ש-Webex עוקב אחריהם עבור כל שותף. בכל יום, Webex עוקב אחר צריכת השימוש של היום הקודם עבור כל השותפים, הלקוחות והמשתמשים ואוסף את הנתונים כך שניתן יהיה להשתמש בהם ליצירת החשבונית החודשית של השותף. ממשקי API לחיוב ממנפים נתונים אלה, ומאפשרים למנהלי שותפים ליצור דוחות מותאמים אישית כך שהשותף יוכל להתאים את צריכת השימוש לחשבונית החודשית שלו ברמת השותף, הלקוח והמשתמש.

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

צור דוח חיוב סיטונאי

השתמש בהליך זה כדי ליצור דוח חיוב מותאם אישית שבו תוכל להשתמש כדי ליישב את החיוב שלך.
1

עבור אל ממשק ה-API של יצירת דוח חיוב סיטונאי.

2

הזן את תקופת החיוב על ידי הזנת ערכים עבור billingStartDate ו- billingEndDate בפורמט שמציין ה-API. ניתן להזין כל תאריך מחמש השנים האחרונות, אך לא את היום הנוכחי.

3

הזן את סוג הדוח :

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

לחץ על הפעל כדי ליצור את הדוח.

5

העתק את מזהה הדוח מפלט ה-API. ניתן להשתמש בערך זה עם Get API כדי לקבל את דוח החיוב שנוצר.

מה הלאה?

עבור אל קבל דוח חיוב סיטונאי כדי להוריד עותק של הדוח.

קבל דוח חיוב סיטונאי

לאחר יצירת דוח חיוב, השתמשו בממשק API זה כדי לקבל דוח חיוב ספציפי. הדוח מופץ לכתובת URL שבה הוא זמין להורדה למשך 30 דקות לאחר השלמת בקשת ה-GET.
1

עבור אל ממשק ה-API של קבל דוח חיוב סיטונאי.

2

בשורה GET, לחץ על כפתור id והזן את ערך ה-id הייחודי עבור הדוח.

3

לחץ על הפעלה.

4

פלט ה-API מדווח על סטטוס. הפלט כולל את הפרמטר tempDownloadURL, המספק כתובת URL שממנה ניתן להוריד את הדוח.

5

העתיקו את ה- tempDownloadURL לדפדפן כדי לגשת לדוח ולהוריד אותו.

רשימת דוחות חיוב סיטונאיים

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

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

עבור אל ממשק ה-API של דוח החיוב הסיטונאי של הרשימה

2

תחת פרמטרי שאילתה, הזן את כל פרמטרי החיפוש שברצונך להשתמש בהם (לדוגמה, startDate, endDate, Type, sortBy on). לפרטים נוספים על פרמטרים אלה, עיין בעזרה למפתחים ב-API.

3

לחץ על הפעלה.

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

מה הלאה?

רשום את ה- id עבור כל דוח שברצונך להוריד. עבור אל קבל דוח חיוב סיטונאי כדי להוריד את הדוח.

מחיקת דוח חיוב סיטונאי

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

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

  • אם נוצר דוח ושלחת את כתובת ה-URL לאדם הלא נכון, תוכל למחוק את הדוח והוא לא יוכל לגשת אליו.

1

עבור אל ממשק ה-API של מחיקת דוח חיוב סיטונאי.

2

הזן את מזהה הדוח .

3

לחץ על הפעלה.

שדות דוח חיוב

דוחות חיוב מכילים את השדות הבאים:

שדה

מידע נוסף

מופיע בדוחות מהסוג

שם השותף_

שם השותף

שותף, לקוח, משתמש

מזהה ארגון_של שותף_

מזהה שותף ייחודי

שותף, לקוח, משתמש

מזהה מנוי_

מזהה מנוי ייחודי

שותף, לקוח, משתמש

שם השירות_

שם השירות

(לדוגמה, שיחות אזור משותף__, שיחות WEBEX_, סוויטת WEBEX_, פגישות WEBEX_)

שותף, לקוח, משתמש

מק"ט

סקו עבור השירות

שותף, לקוח, משתמש

תֵאוּר

תיאור השירות

שותף, לקוח, משתמש

תאריך התחלה של צריכה__

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

שותף, לקוח, משתמש

תאריך סיום צריכה__

סוף צריכת השירות. יחד עם השדה הקודם, ערך זה מגדיר את תקופת צריכת השימוש.

שותף, לקוח, משתמש

כַּמוּת

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

תַחשִׁיב:

הם מחשבים את הכמות היומית עבור כל משתמש על בסיס יחסי עבור אותו יום.

שימוש למשך יום שלם = 1

שימוש למשך חצי יום = 0.5

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

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

שותף, לקוח, משתמש

מזהה לקוח_ארגון_

מזהה ייחודי של לקוח פנימי

לקוח, משתמש

מזהה חיצוני של לקוח__

מזהה ייחודי של לקוח כפי שסופק על ידי שותף

לקוח, משתמש

מזהה מנוי_

מזהה ייחודי עבור המנוי

מִשׁתַמֵשׁ

מזהה משתמש_

מזהה המשתמש של המנוי ב-Webex

מִשׁתַמֵשׁ

מזהה סביבת עבודה_

מזהה ייחודי של סביבת עבודה

מִשׁתַמֵשׁ

מזהה מיקום_

מזהה מיקום ייחודי

לקוח, משתמש

מזהה רישיון_

מזהה רישיון

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

דוח חיוב עשוי להציג מספר שורות עבור אותה חבילה סיטונאית, כאשר כל שורה מייצגת חבילה ייחודית package/license שילוב תעודת זהות.

אם השדה LICENSE_ID קיים, כל שורה מייצגת מזהה ייחודי package/location/license שילוב תעודת זהות.

לקוח, משתמש

הקצאת חבילה למשתמש מפעילה חיוב של Webex Wholesale, בעוד שהסרת הקצאת החבילה עוצרת אותו.