Reconcilierea facturării

Administratorii partenerilor pot utiliza API-urile Wholesale Billing pentru a genera rapoarte de facturare personalizate care afișează consumul de utilizare la nivel de partener, client sau utilizator. Partenerii pot folosi aceste informații pentru a reconcilia factura lunară, astfel încât să își poată factura clienții și utilizatorii în funcție de consumul lor.

Partenerii pot genera, de asemenea, rapoarte de facturare personalizate pentru sub-parteneri folosind parametrul subPartnerOrgId.

Există patru API-uri disponibile pentru administratorii parteneri care îndeplinesc cerințele minime de acces.

API-ul de facturare

Scopul API-ului

Cerință de acces pentru administratorii partenerilor

Creați un raport de facturare angro

Folosit pentru a genera un raport de facturare.

Citire / Scrie

Obțineți un raport de facturare angro

Folosit pentru a obține un raport de facturare generat pentru descărcare.

Citire

Listați rapoartele de facturare angro

Folosit pentru a lista rapoartele de facturare existente pentru partenerul respectiv.

Citire

Ștergerea unui raport de facturare angro

Folosit pentru a șterge un raport de facturare existent.

Citire / Scrie

Sursa datelor

Datele pentru rapoartele de facturare sunt extrase din datele de consum de utilizare pe care Webex le urmărește pentru fiecare partener. În fiecare zi, Webex urmărește consumul de utilizare din ziua precedentă pentru toți partenerii, clienții și utilizatorii și agregă datele astfel încât acestea să poată fi utilizate pentru a genera factura lunară a partenerului. API-urile de facturare utilizează aceste date, permițând administratorilor partenerilor să genereze rapoarte personalizate, astfel încât partenerul să poată reconcilia consumul de utilizare din factura lunară la nivel de partener, client și utilizator.

Pentru informații mai detaliate despre modul în care Webex facturează partenerii, consultați Facturarea furnizorilor de servicii.

Creați un raport de facturare angro

Utilizați această procedură pentru a genera un raport de facturare personalizat pe care îl puteți utiliza pentru a reconcilia facturile.
1

Accesați API-ul Creare raport facturare angro.

2

Introduceți perioada de facturare introducând valori pentru billingStartDate și billingEndDate în formatul specificat de API. Puteți introduce orice dată din ultimii cinci ani, dar nu ziua curentă.

3

Introduceți Tipul raportului:

  • PARTNER (aceasta este valoarea implicită) - Afișează consumul de utilizare la nivel de partener.
  • CLIENT — Afișează consumul total de utilizare defalcat la nivelul organizațiilor cliente din cadrul partenerului.
  • UTILIZATOR - Afișează consumul total de utilizare defalcat la nivelul organizațiilor clienți și al abonaților din cadrul partenerului.
4

Faceți clic pe Executare pentru a genera raportul.

5

Copiați ID-ul raportului din ieșirea API. Puteți utiliza această valoare cu API-ul Get pentru a obține raportul de facturare generat.

Ce este de făcut în continuare

Accesați Obțineți un raport de facturare angro pentru a descărca o copie a raportului.

Obțineți un raport de facturare angro

După ce este generat un raport de facturare, utilizați această API pentru a obține un raport de facturare specific. Raportul este trimis către o adresă URL unde este disponibil pentru descărcare timp de 30 de minute după finalizarea solicitării GET.
1

Accesați API-ul Obțineți un raport de facturare angro.

2

În linia GET, faceți clic pe butonul id și introduceți valoarea ID-ului unic pentru raport.

3

Faceți clic pe Executare.

4

Rezultatele API raportează starea. Rezultatul include parametrul tempDownloadURL, care furnizează o adresă URL de la care puteți descărca raportul.

5

Copiați tempDownloadURL într-un browser pentru a accesa și descărca raportul.

Listați rapoartele de facturare angro

Folosește această API pentru a obține o listă de rapoarte de facturare generate pentru organizația parteneră. Puteți lista toate rapoartele existente sau puteți limita lista la acele rapoarte care îndeplinesc parametrii specificați, cum ar fi perioada de facturare și tipul de facturare (Partener, client, utilizator).

Dacă introduceți parametri opționali, API-ul returnează doar acele rapoarte care corespund exact parametrilor introduși. De exemplu, dacă introduceți o perioadă de facturare, vor fi returnate doar rapoartele care utilizează acea perioadă de facturare specifică; rapoartele care se încadrează în perioada respectivă, dar care nu corespund exact datelor, nu vor fi returnate.
1

Accesați API-ul List Wholesale Billing Report

2

Sub Parametri de interogare, introduceți orice parametri de căutare pe care doriți să îi utilizați (de exemplu, startDate, endDate, Type, sortBy activat). Pentru detalii suplimentare despre acești parametri, consultați ajutorul pentru dezvoltatori despre API.

3

Faceți clic pe Executare.

API-ul afișează lista de rapoarte împreună cu ID-ul unic al raportului și starea (FINALIZAT, ÎN_CURS).

Ce este de făcut în continuare

Înregistrați ID-ul pentru orice raport pe care doriți să îl descărcați. Accesați Obțineți un raport de facturare angro pentru a descărca raportul.

Ștergerea unui raport de facturare angro

Utilizați această procedură pentru a șterge un raport de facturare generat pe baza ID-ului raportului. Câteva exemple în care ați putea dori să ștergeți un raport includ:

  • Dacă doriți să regenerați un raport de facturare existent, trebuie mai întâi să ștergeți raportul existent. După ce ștergeți raportul existent, puteți crea un raport nou pentru perioada respectivă. Rețineți că cerința de ștergere nu există dacă raportul a eșuat sau este în curs de procesare.

  • Dacă se generează un raport și trimiteți adresa URL persoanei greșite, puteți șterge raportul și aceasta nu va putea să îl acceseze.

1

Accesați API-ul Ștergere raport facturare angro.

2

Introduceți ID-ul raportului .

3

Faceți clic pe Executare.

Câmpuri din raportul de facturare

Rapoartele de facturare conțin următoarele câmpuri:

Câmp

Informații suplimentare

Apare în rapoarte de tipul

NUMELE PARTENERULUI_

Numele partenerului

PARTENER, CLIENT, UTILIZATOR

ID-ul PARTENERULUI_ORGANIZAȚIEI_

Identificator unic de partener

PARTENER, CLIENT, UTILIZATOR

ID ABONAMENT_

Identificator unic de abonament

PARTENER, CLIENT, UTILIZATOR

NUME SERVICIU_

Numele serviciului

(de exemplu, APELARE ZONĂ COMUNĂ__, APELARE WEBEX_, SUITĂ WEBEX_, ÎNTÂLNIRI WEBEX_)

PARTENER, CLIENT, UTILIZATOR

SKU

SKU pentru serviciu

PARTENER, CLIENT, UTILIZATOR

DESCRIERE

Descrierea serviciului

PARTENER, CLIENT, UTILIZATOR

CONSUM_DATA DE ÎNCEPERE_

Începutul consumului de servicii. Împreună cu următorul câmp, această valoare definește perioada de utilizare.

PARTENER, CLIENT, UTILIZATOR

CONSUM_DATA DE SFÂRȘIT_

Sfârșitul consumului de servicii. Împreună cu câmpul precedent, această valoare definește perioada de consum.

PARTENER, CLIENT, UTILIZATOR

CANTITATE

Reprezintă consumul agregat de utilizare al utilizatorilor per partener, per client sau per utilizator (în funcție de raport și de nivelul la care vizualizați datele).

Calcul:

Aceștia calculează cantitatea pe zi pentru fiecare utilizator proporțional pentru ziua respectivă.

Utilizare pentru o zi întreagă = 1

Utilizare timp de jumătate de zi = 0,5

Aceștia însumează totalurile pe zi pentru toate zilele din perioada de facturare pentru a calcula cantitatea totală pentru utilizatorul respectiv în perioada de facturare respectivă.

Pentru rapoartele la nivel de client și partener, totalurile pentru toți utilizatorii sunt agregate pentru a oferi o cantitate totală pentru clientul sau partenerul respectiv.

PARTENER, CLIENT, UTILIZATOR

ID CLIENT_ORG_

Identificator unic al clientului intern

CLIENT, UTILIZATOR

ID CLIENT_EXTERN_

Identificatorul unic al clientului, așa cum este furnizat de un partener

CLIENT, UTILIZATOR

ID-UL ABONATULUI_

Identificator unic pentru abonat

UTILIZATOR

ID UTILIZATOR_

ID-ul de utilizator Webex al abonatului

UTILIZATOR

ID-ul SPAȚIULUI DE LUCRU_

Identificator unic al spațiului de lucru

UTILIZATOR

ID-UL LOCAȚIEI_

Identificator unic de locație

CLIENT, UTILIZATOR

ID LICENȚĂ_

Identificator de licență

Acest câmp este vizibil doar pentru pachetele Wholesale. ID-ul License_este gol pentru licențele atribuite înainte de introducerea acestui câmp.

Un raport de facturare poate afișa mai multe rânduri pentru același pachet Wholesale, fiecare rând reprezentând un anumit număr de rânduri. package/license Combinație de ID.

Dacă este prezent câmpul LICENSE_ID, fiecare rând reprezintă un cod unic package/location/license Combinație de ID.

CLIENT, UTILIZATOR

Alocarea unui pachet către un utilizator declanșează facturarea Webex Wholesale, în timp ce eliminarea atribuirii pachetului o oprește.