تسوية الفوترة

يستطيع مسؤولو الشركاء استخدام واجهات API الخاصة بالفوترة الشاملة لإنشاء تقارير فوترة مخصصة تعرض استهلاك الاستخدام على مستويات كل شريك أو عميل أو مستخدم. يمكن للشركاء استخدام هذه المعلومات لتسوية فواتيرهم الشهرية حتى يتمكنوا من إصدار فواتير لعملائهم والمستخدمين وفقًا لاستهلاك استخدامهم.

يمكن للشركاء أيضًا إنشاء تقارير فوترة مخصصة للشركاء الفرعيين باستخدام المعلمة subPartnerOrgId.

هناك أربع واجهات API متاحة للمسؤولين الشركاء الذين يستوفون الحد الأدنى من متطلبات الوصول.

واجهة برمجة تطبيقات الفوترة

الغرض من API

متطلبات وصول مسؤول الشريك

إنشاء تقرير الفوترة الشاملة

يستخدم لإنشاء تقرير الفوترة.

قراءة / كتابة

الحصول على تقرير فوترة الخدمات الشاملة

يُستخدم للحصول على تقرير فوترة تم إنشاؤه لتنزيله.

مقروء

إدراج تقارير الفوترة الشاملة

يُستخدم لإدراج تقارير الفوترة الموجودة لهذا الشريك.

مقروء

حذف تقرير الفوترة الشاملة

يُستخدم لحذف تقرير حالي للفوترة.

قراءة / كتابة

مصدر البيانات

يتم سحب بيانات تقارير الفوترة من بيانات استهلاك الاستخدام التي يتبعها Webex لكل شريك. في كل يوم، يتتبع Webex استهلاك جميع الشركاء والعملاء والمستخدمين في اليوم السابق ويقوم بتجميع البيانات حتى يمكن استخدامها في إنشاء الفاتورة الشهرية للشريك. تستفيد واجهات API الخاصة بالفوترة من هذه البيانات، وتتيح لمسؤولي الشريك إنشاء تقارير مخصصة حتى يتمكن الشريك من التوفيق بين استهلاك الاستخدام من فاتورتهم الشهرية على مستويات الشريك والعميل والمستخدم.

لمعرفة مزيد من المعلومات التفصيلية عن كيفية شركاء فواتير Webex، ارجع إلى فوترة موفر الخدمة.

إنشاء تقرير الفوترة الشاملة

استخدم هذا الإجراء لإنشاء تقرير فوترة مخصص يمكنك استخدامه للتوفيق بين الفوترة الخاصة بك.
1

انتقل إلى واجهة API لإنشاء تقرير الفوترة الشاملة.

2

أدخل فترة الفوترة عن طريق إدخال قيم billingStartDate وbillingEndDate بالتنسيق الذي تحدده واجهة برمجة التطبيقات. يمكنك إدخال أي تاريخ من السنوات الخمس الماضية، ولكن ليس اليوم الحالي.

3

أدخل نوع التقرير:

  • شريك (هذا هو الإعداد الافتراضي) - يعرض استهلاك الاستخدام على مستوى الشريك.
  • العميل — يعرض إجمالي استهلاك الاستخدام مقسم إلى مستوى مؤسسات العميل الموجودة تحت الشريك.
  • المستخدم — يعرض إجمالي استهلاك الاستخدام مقسم إلى مستوى مؤسسات العميل والمشاركين ضمن الشريك.
4

انقر على تشغيل لإنشاء التقرير.

5

انسخ معرف التقرير من مخرجات API. يمكنك استخدام هذه القيمة مع Get API من أجل الحصول على تقرير الفوترة الذي تم إنشاؤه.

التصرف التالي

انتقل إلى الحصول على تقرير الفوترة الشاملة لتنزيل نسخة من التقرير.

الحصول على تقرير فوترة الخدمات الشاملة

بمجرد إنشاء تقرير فوترة، استخدم واجهة API هذه للحصول على تقرير فوترة محدد. يحصل التقرير على مخرجاته إلى عنوان URL حيث يكون متاحًا للتنزيل لمدة 30 دقيقة بعد إكمال طلب GET.
1

انتقل إلى واجهة API الخاصة بتقرير الفوترة الشاملة.

2

في سطر الحصول على ، انقر على الزر المعرف وأدخل قيمة المعرف الفريدة للتقرير.

3

انقر على تشغيل.

4

حالة تقرير مخرجات API. يتضمن المخرجات المعلمة tempDownloadURL ، التي توفر عنوان URL يمكنك من خلاله تنزيل التقرير.

5

انسخ tempDownloadURL إلى متصفح للوصول إلى التقرير وتنزيله.

إدراج تقارير الفوترة الشاملة

استخدم واجهة API هذه للحصول على قائمة بتقارير الفوترة التي تم إنشاؤها للمؤسسة الشريكة. يمكنك إدراج كل التقارير الحالية، أو قصر القائمة على تلك التقارير التي تستوفي المعلمات المحددة مثل فترة الفوترة ونوع الفوترة (الشريك والعميل والمستخدم).

إذا أدخلت معلمات اختيارية، فإن واجهة API ترجع فقط تلك التقارير التي تطابق المعلمات التي تدخلها بدقة. على سبيل المثال، إذا أدخلت فترة الفوترة، يتم إرجاع التقارير التي تستخدم فترة الفوترة المحددة فقط - لا يتم إرجاع التقارير التي تقع خلال الفترة الزمنية، ولكنها لا تتطابق تمامًا مع التواريخ.
1

انتقل إلى واجهة API الخاصة بتقرير الفوترة الشاملة الخاص بالقائمة

2

ضمن معلمات الاستعلام، أدخل أي معلمات بحث تريد استخدامها (على سبيل المثال، startDate وendDate وType وsortBy on). للحصول على تفاصيل إضافية حول هذه المعلمات، راجع تعليمات المطور في واجهة برمجة التطبيقات.

3

انقر على تشغيل.

تُصدر واجهة برمجة التطبيقات قائمة التقارير بالإضافة إلى معرّف التقرير الفريد وحالته (مكتمل، قيد_التقدم).

التصرف التالي

قم بتدوين سجل لمعرّف أي تقارير ترغب في تنزيلها. انتقل إلى الحصول على تقرير الفوترة الشاملة لتنزيل التقرير.

حذف تقرير الفوترة الشاملة

استخدم هذا الإجراء لحذف تقرير فوترة تم إنشاؤه بناءً على معرف التقرير. تتضمن بعض الأمثلة التي قد ترغب في حذف تقرير ما ما يلي:

  • إذا كنت ترغب في إعادة إنشاء تقرير حالي للفوترة، فيجب عليك أولاً حذف التقرير الحالي. بعد حذف التقرير الحالي، يمكنك إنشاء تقرير جديد لتلك الفترة. لاحظ أن متطلبات الحذف لا توجد إذا فشل التقرير أو كان قيد التقدم.

  • إذا تم إنشاء تقرير وإرسال عنوان URL إلى الشخص الخطأ، فيمكنك حذف التقرير ولن يتمكن من الوصول إليه.

1

انتقل إلى واجهة API الخاصة بحذف تقرير الفوترة الشاملة.

2

أدخل معرف التقرير.

3

انقر على تشغيل.

حقول تقرير الفوترة

تحتوي تقارير الفوترة على الحقول التالية:

الحقل

معلومات إضافية

يظهر في تقارير من هذا النوع

اسم_الشريك

اسم الشريك

الشريك، العميل، المستخدم

معرف_مؤسسة_الشريك

معرف الشريك الفريد

الشريك، العميل، المستخدم

معرف_الاشتراك

معرّف الاشتراك الفريد

الشريك، العميل، المستخدم

اسم الخدمة_

اسم الخدمة

(على سبيل المثال، اتصال _المنطقة_ المشتركة، وWEBEX_CALLING، ومجموعة WEBEX_، وWEBEX_MEETINGS)

الشريك، العميل، المستخدم

SKU

Sku للخدمة

الشريك، العميل، المستخدم

الوصف

وصف الخدمة

الشريك، العميل، المستخدم

تاريخ_بدء_الاستهلاك

بدء استهلاك الخدمة. بالإضافة إلى الحقل أدناه، تحدد هذه القيمة فترة الاستخدام.

الشريك، العميل، المستخدم

تاريخ_نهاية_ الاستهلاك

نهاية استهلاك الخدمة. بالإضافة إلى الحقل المذكور أعلاه، تحدد هذه القيمة فترة استهلاك الاستخدام.

الشريك، العميل، المستخدم

الكمية

يمثل الاستهلاك الكلي لاستخدام المستخدم لكل شريك أو عميل أو لكل مستخدم (بناءً على التقرير والمستوى الذي تعرض به البيانات).

الحساب:

لكل مستخدم، يتم حساب الكمية اليومية على أساس تناسبي لذلك اليوم. على سبيل المثال:

الاستخدام ليوم كامل = 1

الاستخدام لمدة نصف يوم = 0.5

يتم إضافة المجاميع الإجمالية في اليوم لجميع الأيام خلال فترة الفوترة لتوفير مبلغ إجمالي لهذا المستخدم خلال فترة الفوترة تلك.

بالنسبة للتقارير على مستوى العملاء والشريك، يتم تجميع إجمالي جميع المستخدمين من أجل توفير الكمية الإجمالية لذلك العميل أو الشريك.

الشريك، العميل، المستخدم

معرف_مؤسسة_العميل

المعرِّف الفريد للعميل الداخلي

العميل، المستخدم

المعرِّف_الخارجي_ للعميل

المعرِّف الفريد للعميل كما هو موفر بواسطة الشريك

العميل، المستخدم

معرف_المشترك

معرّف فريد للمشارك

مستخدم

معرف_المستخدم

معرِّف مستخدم Webex الخاص بالمشترك

مستخدم

معرف_مساحة العمل

معرِّف مساحة العمل الفريد

مستخدم

معرف_الموقع

معرف الموقع الفريد

العميل، المستخدم

يتم تشغيل فوترة Webex Wholesale عن طريق توفير حزمة لمستخدم أو إيقافها عن طريق إزالة تعيين الحزمة.