شكرًا على ملاحظاتك.
تسوية الفواتير لطريق البيع بالجملة إلى السوق
هل لديك ملاحظات؟تسوية الفواتير
يمكن لمسؤولي الشركاء استخدام واجهات برمجة تطبيقات الفواتير بالجملة لإنشاء تقارير فواتير مخصصة تعرض استهلاك الاستخدام على مستوى كل شريك أو كل عميل أو كل مستخدم. يمكن للشركاء استخدام هذه المعلومات لمطابقة فواتيرهم الشهرية حتى يتمكنوا من إرسال فواتير إلى عملائهم ومستخدميهم وفقًا لاستهلاكهم.
يمكن للشركاء أيضًا إنشاء تقارير فواتير مخصصة للشركاء الفرعيين باستخدام معلمة subPartnerOrgId.
هناك أربع واجهات برمجة تطبيقات متاحة لمسؤولي الشركاء الذين يستوفون الحد الأدنى من متطلبات الوصول.
|
واجهة برمجة تطبيقات الفوترة |
غرض واجهة برمجة التطبيقات (API) |
متطلبات وصول مسؤول الشريك |
|---|---|---|
|
إنشاء تقرير الفواتير بالجملة |
يستخدم لإنشاء تقرير الفوترة. |
يقرأ / يكتب |
|
احصل على تقرير الفواتير بالجملة |
يتم استخدامه للحصول على تقرير الفواتير المُنشأ للتنزيل. |
اقرأ |
|
قائمة تقارير الفواتير بالجملة |
يتم استخدامه لإدراج تقارير الفواتير الموجودة لهذا الشريك. |
اقرأ |
|
حذف تقرير الفواتير بالجملة |
يتم استخدامه لحذف تقرير الفواتير الحالي. |
يقرأ / يكتب |
مصدر البيانات
تتم استخراج البيانات الخاصة بتقارير الفوترة من بيانات استهلاك الاستخدام التي يتتبعها Webex لكل شريك. يقوم Webex يوميًا بتتبع استهلاك الاستخدام في اليوم السابق لجميع الشركاء والعملاء والمستخدمين ويجمع البيانات حتى يمكن استخدامها لإنشاء الفاتورة الشهرية للشريك. تستفيد واجهات برمجة تطبيقات الفوترة من هذه البيانات، مما يسمح لمسؤولي الشركاء بإنشاء تقارير مخصصة حتى يتمكن الشريك من التوفيق بين استهلاك الاستخدام من فاتورته الشهرية على مستويات الشريك والعميل والمستخدم.
لمزيد من المعلومات التفصيلية حول كيفية إرسال الفواتير إلى الشركاء عبر Webex، راجع فاتورة مزود الخدمة.
إنشاء تقرير الفواتير بالجملة
| 1 |
انتقل إلى واجهة برمجة التطبيقات لإنشاء تقرير الفواتير بالجملة. |
| 2 |
أدخل فترة الفوترة عن طريق إدخال القيم لـ billingStartDate و billingEndDate بالتنسيق الذي تحدده واجهة برمجة التطبيقات. يمكنك إدخال أي تاريخ من السنوات الخمس الماضية، ولكن ليس اليوم الحالي. |
| 3 |
أدخل نوع التقرير:
|
| 4 |
انقر فوق تشغيل لإنشاء التقرير. |
| 5 |
انسخ معرف التقرير من مخرجات واجهة برمجة التطبيقات. بإمكانك استخدام هذه القيمة مع واجهة برمجة التطبيقات (API) للحصول على تقرير الفوترة الناتج. |
التصرف التالي
احصل على تقرير الفواتير بالجملة
| 1 |
انتقل إلى واجهة برمجة التطبيقات للحصول على تقرير الفواتير بالجملة. |
| 2 |
في السطر GET ، انقر فوق الزر id وأدخل قيمة المعرف الفريدة للتقرير. |
| 3 |
انقر فوق تشغيل. |
| 4 |
يُخرج API تقرير الحالة. يتضمن الإخراج المعلمة tempDownloadURL ، والتي توفر عنوان URL الذي يمكنك من خلاله تنزيل التقرير. |
| 5 |
انسخ tempDownloadURL في المتصفح حتى تتمكن من الوصول إلى التقرير وتنزيله. |
قائمة تقارير الفواتير بالجملة
استخدم واجهة برمجة التطبيقات هذه للحصول على قائمة بتقارير الفواتير المُنشأة للمؤسسة الشريكة. يمكنك إدراج جميع التقارير الموجودة، أو تقييد القائمة بتلك التقارير التي تلبي المعلمات المحددة مثل فترة الفوترة ونوع الفوترة (شريك، عميل، مستخدم).
| 1 |
انتقل إلى قائمة تقارير الفواتير بالجملة API |
| 2 |
تحت معلمات الاستعلام، أدخل أي معلمات بحث تريد استخدامها (على سبيل المثال، startDate، endDate، Type، sortBy on). لمزيد من التفاصيل حول هذه المعلمات، راجع تعليمات المطور حول واجهة برمجة التطبيقات. |
| 3 |
انقر فوق تشغيل. يقوم واجهة برمجة التطبيقات بإخراج قائمة التقارير مع معرف التقرير الفريد والحالة (مكتمل، قيد التقدم_).
|
التصرف التالي
حذف تقرير الفواتير بالجملة
استخدم هذا الإجراء لحذف تقرير الفواتير الذي تم إنشاؤه استنادًا إلى معرف التقرير. تتضمن بعض الأمثلة التي قد ترغب في حذف تقرير فيها ما يلي:
-
إذا كنت تريد إعادة إنشاء تقرير الفوترة الحالي، فيجب عليك أولاً حذف التقرير الحالي. بعد حذف التقرير الحالي، يمكنك إنشاء تقرير جديد لتلك الفترة. لاحظ أن متطلب الحذف غير موجود إذا فشل التقرير أو كان قيد التقدم.
-
إذا تم إنشاء تقرير وأرسلت عنوان URL إلى الشخص الخطأ، فيمكنك حذف التقرير ولن يتمكن هذا الشخص من الوصول إليه.
| 1 |
انتقل إلى واجهة برمجة تطبيقات حذف تقرير الفواتير بالجملة. |
| 2 |
أدخل التقرير معرف. |
| 3 |
انقر فوق تشغيل. |
حقول تقرير الفواتير
تحتوي تقارير الفواتير على الحقول التالية:
|
الحقل |
معلومات إضافية |
يظهر في التقارير من النوع |
|---|---|---|
|
اسم الشريك_ |
اسم الشريك |
الشريك، العميل، المستخدم |
|
الشريك_المنظمة_المعرف |
معرف الشريك الفريد |
الشريك، العميل، المستخدم |
|
معرف الاشتراك_ |
معرف اشتراك فريد |
الشريك، العميل، المستخدم |
|
اسم الخدمة_ |
اسم الخدمة (على سبيل المثال، منطقة مشتركة_مكالمة_، مكالمة WEBEX_، مجموعة WEBEX_، اجتماعات WEBEX_) |
الشريك، العميل، المستخدم |
|
SKU |
رمز SKU للخدمة |
الشريك، العميل، المستخدم |
|
وصف |
وصف الخدمة |
الشريك، العميل، المستخدم |
|
الاستهلاك_تاريخ البدء_ |
بداية استهلاك الخدمة. إلى جانب الحقل التالي، تحدد هذه القيمة فترة الاستخدام. |
الشريك، العميل، المستخدم |
|
تاريخ انتهاء الاستهلاك__ |
نهاية استهلاك الخدمة. إلى جانب الحقل السابق، تحدد هذه القيمة فترة استهلاك الاستخدام. |
الشريك، العميل، المستخدم |
|
كمية |
يمثل إجمالي استهلاك الاستخدام للمستخدم لكل شريك أو لكل عميل أو لكل مستخدم (اعتمادًا على التقرير والمستوى الذي تعرض فيه البيانات). حساب: يقومون بحساب الكمية اليومية لكل مستخدم على أساس نسبي لذلك اليوم. الاستخدام لمدة يوم كامل = 1 الاستخدام لمدة نصف يوم = 0.5 إنهم يجمعون إجماليات اليوم لجميع الأيام ضمن فترة الفوترة لحساب الكمية الإجمالية لهذا المستخدم ضمن فترة الفوترة تلك. بالنسبة لتقارير مستوى العميل والشريك، يتم تجميع الإجماليات لجميع المستخدمين لتوفير الكمية الإجمالية لذلك العميل أو الشريك. |
الشريك، العميل، المستخدم |
|
معرف العميل_المنظمة_ |
معرف فريد للعميل الداخلي |
العميل، المستخدم |
|
معرف العميل_الخارجي_ |
معرف العميل الفريد كما قدمه الشريك |
العميل، المستخدم |
|
معرف المشترك_ |
معرف فريد للمشترك |
مستخدم |
|
معرف المستخدم_ |
معرف مستخدم Webex الخاص بالمشترك |
مستخدم |
|
معرف مساحة العمل_ |
معرف مساحة العمل الفريد |
مستخدم |
|
الموقع_معرف |
معرف الموقع الفريد |
العميل، المستخدم |
|
رقم الترخيص_ |
معرف الترخيص هذا الحقل مرئي فقط للطرود بالجملة. معرف License_فارغ للتراخيص المخصصة قبل تقديم هذا الحقل. قد يعرض تقرير الفواتير صفوفًا متعددة لنفس الحزمة بالجملة، حيث يمثل كل صف مجموعة فريدة package/license مجموعة الهوية. إذا كان حقل معرف الترخيص_موجودًا، فإن كل صف يمثل رقمًا فريدًا package/location/license مجموعة الهوية. |
العميل، المستخدم |
يؤدي توفير حزمة لمستخدم إلى تشغيل فواتير Webex Wholesale، بينما يؤدي إزالة تعيين الحزمة إلى إيقافها.
