Rapoarte de facturare angro pentru ruta către piață
Rapoarte de facturare
Partenerii pot utiliza următoarele API-uri de facturare angro pentru a genera rapoarte de facturare care îi ajută să valideze utilizarea și acuratețea aprovizionării. API-urile de facturare angro sunt accesibile prin developer.webex.com.
-
Reconciliere — Afișează consumul de utilizare la nivel de partener, client sau utilizator. Partenerii pot folosi aceste informații personalizate din raportul de facturare pentru a reconcilia factura lunară, astfel încât să își poată factura clienții și utilizatorii în funcție de consumul lor.
-
Moment în timp — Afișează alocările curente de pachete la nivel de client sau de utilizator. Raportul Point-In-Time oferă o numărătoare în timp real a alocărilor de pachete. Partenerii pot folosi aceste informații pentru a valida acuratețea aprovizionării și pentru a asigura alinierea cu comenzile clienților.
Partenerii pot genera, de asemenea, rapoarte de facturare personalizate pentru subparteneri 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ța de acces administrator pentru parteneri |
|---|---|---|
|
Creați un raport de facturare angro |
Folosit pentru a genera un raport de facturare. |
Read/write |
|
Obțineți un raport de facturare angro |
Folosit pentru a obține un raport de facturare generat pentru descărcare. |
Citite |
|
Listați rapoartele de facturare angro |
Folosit pentru a lista rapoartele de facturare existente pentru partenerul respectiv. |
Citite |
|
Ștergerea unui raport de facturare angro |
Folosit pentru a șterge un raport de facturare existent. |
Read/write |
Sursă de date
Datele pentru rapoartele de facturare sunt extrase din atribuirile de pachete și din datele de utilizare pe care Webex le urmărește pentru fiecare partener. Webex agregă zilnic datele pachetelor clienților și utilizatorilor pentru a genera factura lunară a partenerului. API-urile de facturare folosesc aceste date, permițând administratorilor parteneri să genereze rapoarte personalizate. Aceste rapoarte îi ajută pe parteneri să reconcilieze 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 furnizorului de servicii.
Creați un raport de facturare angro
| 1 |
Din developer.webex.com, accesați Creați o API pentru raportul de facturare angro. |
| 2 |
Selectați oricare dintre următoarele categorii de rapoarte:
Dacă doriți să generați un raport de reconciliere, nu este nevoie să modificați nimic, deoarece opțiunea Reconciliere este selectată în mod implicit, așa că puteți trece la pasul următor. Dacă doriți să generați un raport la un moment dat, schimbați selecția la Punct în timp. |
| 3 |
Introduceți billingStartDate și billingEndDate în formatul specificat de API. Puteți introduce orice dată din ultimii cinci ani, dar nu ziua curentă. Pentru raportul Point-In-Time, câmpurile billingStartDate și billingEndDate nu sunt obligatorii și sunt ignorate dacă sunt introduse. Raportul reflectă întotdeauna alocările curente ale pachetelor. |
| 4 |
Introduceți tipul de raport:
|
| 5 |
Faceți clic pe Executare pentru a genera raportul. |
| 6 |
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 secțiunea 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 |
De pe developer.webex.com, accesați Obțineți un API pentru raportul de facturare Wholesale. |
| 2 |
Introduceți valoarea unică id pentru raport și faceți clic pe Run. Rezultatele API raportează starea. Rezultatul include parametrul tempDownloadURL, care furnizează o adresă URL de la care puteți descărca raportul. |
| 3 |
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 specificați. De exemplu, dacă specificaț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 sunt returnate.
| 1 |
Din developer.webex.com, accesați List Wholesale Billing Report API. |
| 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). |
| 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.
Ștergeți un 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 Reconciliere 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ă. Nu puteți șterge un raport dacă generarea acestuia a eșuat sau este încă în curs.
Pentru un raport la un moment dat, nu trebuie să ștergeți un raport existent, deoarece sistemul nu regenerează aceste rapoarte. Fiecare raport reflectă întotdeauna datele la momentul actual.
-
Dacă trimiteți adresa URL a unui raport generat persoanei greșite, puteți șterge raportul, astfel încât aceasta să nu îl poată accesa.
| 1 |
Din developer.webex.com, accesați Ștergere API raport facturare angro. |
| 2 |
Introduceți ID-ul raportului și faceți clic pe Executare. |
Câmpuri din raportul de facturare
Rapoartele de facturare conțin următoarele câmpuri:
|
Câmp |
Descriere |
Tip de raport acceptat |
Categorie de raport acceptată |
|---|---|---|---|
|
NUMELE PARTENERULUI_ |
Numele partenerului |
PARTENER, CLIENT, UTILIZATOR |
Reconciliere, punct în timp |
|
ID-ul PARTENERULUI_ORGANIZAȚIEI_ |
Identificator unic de partener |
PARTENER, CLIENT, UTILIZATOR |
Reconciliere, punct în timp |
|
ID ABONAMENT_ |
Identificator unic de abonament |
PARTENER, CLIENT, UTILIZATOR |
Reconciliere, punct în timp |
|
NUME SERVICIU_ |
Numele serviciului (de exemplu, APELARE ZONĂ COMUNĂ__, APELARE WEBEX_, SUITĂ WEBEX_, ÎNTÂLNIRI WEBEX_) |
PARTENER, CLIENT, UTILIZATOR |
Reconciliere, punct în timp |
|
SKU |
SKU pentru serviciu |
PARTENER, CLIENT, UTILIZATOR |
Reconciliere, punct în timp |
|
DESCRIERE |
Descrierea serviciului |
PARTENER, CLIENT, UTILIZATOR |
Reconciliere, punct în timp |
|
CONSUM_DATA DE ÎNCEPERE_ |
Începutul consumului de servicii. Împreună cu următorul câmp, această valoare definește perioada de utilizare. |
PARTENER, CLIENT, UTILIZATOR |
Reconciliere |
|
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 |
Reconciliere |
|
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: Sistemul calculează cantitatea pe zi pentru fiecare utilizator, proporțional cu ziua respectivă. Utilizare pentru o zi întreagă = 1 Utilizare timp de jumătate de zi = 0,5 Apoi, î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. Moment în timp: Raportul clientului listează alocările de pachete per client. Fiecare rând reprezintă cantitatea totală a unui anumit pachet atribuit utilizatorilor sau spațiilor de lucru din cadrul unei anumite organizații client. Cantitatea arată „0” dacă nu există colete alocate. Raportul utilizatorului listează pachetele atribuite utilizatorilor sau spațiilor de lucru. Fiecare rând afișează o cantitate de 1, reprezentând un utilizator sau spațiu de lucru și pachetul sau extensia sa individuală. Dacă unui utilizator sau unui spațiu de lucru i se alocă mai multe pachete sau suplimente, atunci raportul afișează mai multe intrări, fiecare cu o cantitate de 1. |
PARTENER, CLIENT, UTILIZATOR |
Reconciliere, punct în timp |
|
ID CLIENT_ORG_ |
Identificator unic al clientului intern |
CLIENT, UTILIZATOR |
Reconciliere, punct în timp |
|
ID CLIENT_EXTERN_ |
Identificatorul unic al clientului, așa cum este furnizat de un partener |
CLIENT, UTILIZATOR |
Reconciliere, punct în timp |
|
ID-UL ABONATULUI_ |
Identificator unic pentru abonat |
UTILIZATOR |
Reconciliere, punct în timp |
|
ID UTILIZATOR_ |
ID-ul de utilizator Webex al abonatului |
UTILIZATOR |
Reconciliere, punct în timp |
|
ID-ul SPAȚIULUI DE LUCRU_ |
Identificator unic al spațiului de lucru |
UTILIZATOR |
Reconciliere, punct în timp |
|
ID-UL LOCAȚIEI_ |
Identificator unic de locație |
CLIENT, UTILIZATOR |
Reconciliere, punct în timp |
|
ID LICENȚĂ_ |
Identificator de licență Acest câmp este vizibil doar pentru pachetele Wholesale Pentru raportul de reconciliere, ID-ul License_este gol pentru licențele atribuite înainte de introducerea acestui câmp. Raportul de facturare afișează mai multe rânduri pentru același pachet Wholesale dacă acesta este asociat cu combinații diferite de ID LOCAȚIE_și ID LICENȚĂ_. |
CLIENT, UTILIZATOR |
Reconciliere, punct în timp |
|
RAPORT_DATA |
Data și ora la care este generat raportul. |
CLIENT, UTILIZATOR |
Punct în timp |
Alocarea unui pachet către un utilizator declanșează facturarea Webex Wholesale, în timp ce eliminarea atribuirii pachetului o oprește.