פיוס חיוב

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

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

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

ממשק API לחיוב

מטרת API

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

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

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

קריאה/כתיבה

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

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

קרא

פרט דוחות חיוב סיטונאי

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

קרא

מחיקת דוח חיוב של Wholesale

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

קריאה/כתיבה

מקור נתונים

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

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

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

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

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

2

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

3

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

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

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

5

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

מה הלאה?

עבור אל קבל דוח חיוב של Wholesale כדי להוריד עותק של הדוח.

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

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

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

2

בקו GET , לחץ על לחצן מזהה והזן את ערך המזהה הייחודי עבור הדוח.

3

לחץ על הפעל.

4

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

5

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

פרט דוחות חיוב סיטונאי

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

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

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

2

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

3

לחץ על הפעל.

ה-API מפיץ את רשימת הדוחות יחד עם מזהה ומצב הדוח הייחודיים (הושלם, _בביצוע).

מה הלאה?

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

מחיקת דוח חיוב של Wholesale

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

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

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

1

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

2

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

3

לחץ על הפעל.

שדות דוח חיוב

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

שדה

מידע נוסף

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

שם_שותף

שם השותף

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

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

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

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

מזהה_מינוי

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

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

שם_שירות

שם השירות

(לדוגמה, COMMON_AREA_CALLING, WEBEX_CALLING, WEBEX_SUITE, WEBEX_Meetings)

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

מק"ט

מק"ט עבור השירות

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

ערך FALSE (הסתכל בסוג boolean).

תיאור השירות

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

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

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

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

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

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

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

כמות

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

חישוב:

עבור כל משתמש, הכמות ליום מחושבת על בסיס מתוזמן ליום זה. לדוגמה:

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

שימוש בחצי יום = 0.5

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

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

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

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

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

לקוח, משתמש

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

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

לקוח, משתמש

מזהה_מנוי

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

משתמש

מזהה_משתמש

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

משתמש

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

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

משתמש

מזהה_מיקום

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

לקוח, משתמש

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