Reconcilierea facturării

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

Partenerii pot genera, de asemenea, rapoarte de facturare personalizate pentru subparteneri, utilizând parametrul subPartnerOrgId.

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

API facturare

Scopul API-ului

Cerință de acces administrator partener

Crearea unui raport de facturare angro

Utilizat pentru a genera un raport de facturare.

Citire/scriere

Obțineți un raport de facturare angro

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

Citire

Listați rapoarte de facturare angro

Se utilizează pentru a enumera rapoartele de facturare existente pentru partenerul respectiv.

Citire

Ștergerea unui raport de facturare angro

Se utilizează pentru a șterge un raport de facturare existent.

Citire/scriere

Sursa datelor

Datele pentru rapoartele de facturare sunt extrase din datele privind consumul de utilizare pe care Webex le urmărește pentru fiecare partener. În fiecare zi, Webex urmărește consumul din ziua anterioară 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țându-le administratorilor partenerilor să genereze rapoarte personalizate, astfel încât partenerul să poată reconcilia consumul de utilizare din factura lor lunară la nivel de partener, client și utilizator.

Pentru informații mai detaliate despre modul în care partenerii fac facturi Webex, consultați Facturarea furnizorului de servicii.

Crearea unui raport de facturare angro

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

Accesați API-ul Creare raport de 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 și ziua curentă.

3

Introduceți Tipul raportului:

  • PARTENER (aceasta este setarea implicită) — afișează consumul de utilizare la nivel de partener.
  • CLIENT — afișează consumul total de utilizare, defalcat la nivelul organizațiilor client din cadrul partenerului.
  • UTILIZATOR — afișează consumul total de utilizare, defalcat la nivelul organizațiilor client și al abonaților din cadrul partenerului.
4

Faceți clic pe Rulați pentru a genera raportul.

5

Copiați ID-ul raportului din ieșirea API. Puteți utiliza această valoare cu API-ul Obțineți 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ă generarea unui raport de facturare, utilizați acest API pentru a obține un anumit raport de facturare. Raportul ajunge la un URL unde este disponibil pentru descărcare timp de 30 de minute de la finalizarea solicitării GET.
1

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

2

În linia OBȚINEȚI , faceți clic pe butonul id și introduceți valoarea unică de id pentru raport.

3

Faceți clic pe Executare.

4

Starea raportului de ieșire API. Rezultatul include parametrul tempDownloadURL , care furnizează un 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 rapoarte de facturare angro

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

Dacă introduceți parametri opționali, API returnează numai acele rapoarte care corespund exact parametrilor pe care îi introduceți. De exemplu, dacă introduceți o perioadă de facturare, se returnează numai rapoartele care utilizează perioada respectivă de facturare - rapoartele care se încadrează în perioadă, dar care nu corespund exact datelor nu sunt returnate.
1

Accesați API-ul raportului de facturare angro

2

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

3

Faceți clic pe Executare.

API emite lista de rapoarte, împreună cu ID-ul unic de raport și starea (FINALIZAT, ÎN_CURS).

Ce este de făcut în continuare

Faceți o înregistrare a id-ului pentru toate rapoartele pe care doriți să le 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ă generați din nou un raport de facturare existent, trebuie mai întâi să ștergeți raportul existent. După ce ștergeți raportul existent, puteți crea un nou raport pentru perioada respectivă. Rețineți că cerința de ștergere nu există dacă raportul este eșuat sau este în curs.

  • Dacă se generează un raport și trimiteți URL-ul persoanei greșite, puteți șterge raportul, iar aceasta nu îl va putea accesa.

1

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

2

Introduceți Id-ul raportului.

3

Faceți clic pe Executare.

Câmpuri raport de facturare

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

Câmp

Informații suplimentare

Apare în rapoartele de acest tip

NUMELE_PARTENERULUI

Numele partenerului

partener, client, utilizator

ID_ORGANIZAȚIE_PARTENER

Identificator unic de partener

partener, client, utilizator

ID_ABONAMENT

Identificator unic de abonament

partener, client, utilizator

NUME_SERVICIU

Numele serviciului

(de exemplu, FRECVENTE)_zonă_apelare, webex_apelare, webex_suită, webex_întâlniri)

partener, client, utilizator

SKU

Sku pentru serviciu

partener, client, utilizator

descriere

Descrierea serviciului

partener, client, utilizator

DATA_DE ÎNCEPUT_A CONSUMULUI

Începutul consumului de servicii. Împreună cu câmpul de mai jos, această valoare definește perioada de utilizare.

partener, client, utilizator

DATA_DE ÎNCHEIERE_A CONSUMULUI

Încetarea consumului de servicii. Împreună cu câmpul de mai sus, această valoare definește perioada de consum de utilizare.

partener, client, utilizator

cantitate

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

Calcul:

Pentru fiecare utilizator, cantitatea pe zi se calculează proporțional pentru ziua respectivă. De exemplu:

Utilizare pentru o zi întreagă = 1

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

Totalurile zilnice pentru toate zilele din perioada de facturare sunt însumate pentru a furniza o cantitate 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 furniza o cantitate totală pentru clientul sau partenerul respectiv.

partener, client, utilizator

ID_ORGANIZAȚIE_CLIENT

Identificator unic intern al clientului

client, utilizator

ID_EXTERN_AL CLIENTULUI

Identificator unic al clientului, furnizat de un partener

client, utilizator

ID_ABONAT

Identificator unic pentru abonat

UTILIZATOR

ID UTILIZATOR_

ID-ul de utilizator Webex al abonatului

UTILIZATOR

ID_SPAȚIU DE LUCRU

Identificator unic al spațiului de lucru

UTILIZATOR

ID_LOCAȚIE

Identificator unic de locație

client, utilizator

Facturarea Webex Wholesale este declanșată de furnizarea unui pachet unui utilizator sau este oprită prin eliminarea atribuirii pachetului.