Mulțumim pentru feedback.
Feedback?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 Wholesale 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 |
În câmpul Include, introduceți coloanele suplimentare sau opționale pe care doriți să le vedeți în rapoarte. Fiecare tip de raport are un set de atribute obligatorii și un set de atribute opționale. Puteți decide care dintre atributele opționale să fie afișate pentru fiecare raport. Dacă nu includeți atributele opționale, raportul afișează doar atributele obligatorii. Următoarele coloane reprezintă atributele opționale pe care le puteți solicita pentru a fi incluse în raportul Client și Utilizator:
Trebuie să includeți împreună ID-ul CLIENTULUI_GRUP_și NUMELE CLIENTULUI_GRUP_dacă doriți să vedeți aceste atribute în raport. Când selectați coloane opționale, ordinea coloanelor din rapoartele de reconciliere a clienților și utilizatorilor se modifică. Partenerii trebuie să își actualizeze integrarea API pentru a accepta noul format CSV. Ordinea coloanelor din rapoartele punctuale rămâne neschimbată. În prezent, setările existente ale funcțiilor au prioritate față de parametrul Include atunci când se stabilește ordinea coloanelor. De exemplu, dacă o anumită setare de funcții este activată pentru un client, atunci coloana de funcții respectivă apare în formatul vechi de raport, chiar dacă o adăugați în parametrul Include. Vom elimina aceste setări în curând. După ce sunt eliminate, puteți solicita coloanele opționale doar prin intermediul parametrului Include. |
| 6 |
Faceți clic pe Executare pentru a genera raportul. |
| 7 |
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ă |
Atribut obligatoriu sau opțional |
|---|---|---|---|---|
|
NUMELE PARTENERULUI_ |
Numele partenerului |
PARTENER, CLIENT, UTILIZATOR |
Reconciliere, punct în timp |
Obligatoriu |
|
ID-ul PARTENERULUI_ORGANIZAȚIEI_ |
Identificator unic de partener |
PARTENER, CLIENT, UTILIZATOR |
Reconciliere, punct în timp |
Obligatoriu |
|
ID ABONAMENT_ |
Identificator unic de abonament |
PARTENER, CLIENT, UTILIZATOR |
Reconciliere, punct în timp |
Obligatoriu |
|
ID CLIENT_GRUP_ | Identificatorul unic al grupului din care face parte clientul. Dacă clientul este mutat între grupuri în timpul perioadei de facturare, utilizarea este împărțită în funcție de grupurile cărora le-a aparținut clientul în perioada respectivă. |
CLIENT, UTILIZATOR |
Reconciliere, punct în timp |
Opțional |
|
CLIENT_GRUP_NUME | Numele afișat al grupului de clienți. Dacă numele grupului s-a schimbat în timpul perioadei de facturare, se folosește cel mai recent nume. |
CLIENT, UTILIZATOR |
Reconciliere, punct în timp |
Opțional |
|
ID CLIENT_ORG_ |
Identificator unic al clientului intern |
CLIENT, UTILIZATOR |
Reconciliere, punct în timp |
Obligatoriu |
|
ID CLIENT_EXTERN_ |
Identificatorul unic al clientului, așa cum este furnizat de un partener |
CLIENT, UTILIZATOR |
Reconciliere, punct în timp |
Obligatoriu |
|
TIP |
Tip de utilizator sau spațiu de lucru |
CLIENT, UTILIZATOR |
Punct în timp |
Obligatoriu |
|
ID-UL ABONATULUI_ |
Identificator unic pentru abonat |
UTILIZATOR |
Reconciliere, punct în timp |
Obligatoriu |
|
ID UTILIZATOR_ |
ID-ul de utilizator Webex al abonatului |
UTILIZATOR |
Reconciliere, punct în timp |
Obligatoriu |
|
ID-ul SPAȚIULUI DE LUCRU_ |
Identificator unic al spațiului de lucru |
UTILIZATOR |
Reconciliere, punct în timp |
Obligatoriu |
|
NUME SERVICIU_ |
Numele serviciului (de exemplu, APELARE ZONĂ COMUNĂ__, APELARE WEBEX_, SUITĂ WEBEX_, ÎNTÂLNIRI WEBEX_) |
PARTENER, CLIENT, UTILIZATOR |
Reconciliere, punct în timp |
Obligatoriu |
|
SKU |
SKU pentru serviciu |
PARTENER, CLIENT, UTILIZATOR |
Reconciliere, punct în timp |
Obligatoriu |
|
DESCRIERE |
Descrierea serviciului |
PARTENER, CLIENT, UTILIZATOR |
Reconciliere, punct în timp |
Obligatoriu |
|
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 |
Obligatoriu |
|
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 |
Obligatoriu |
|
RAPORT_DATA |
Data și ora la care este generat raportul. |
CLIENT, UTILIZATOR |
Punct în timp |
Obligatoriu |
|
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 extensii, atunci raportul afișează mai multe intrări, fiecare cu o cantitate de 1. |
PARTENER, CLIENT, UTILIZATOR |
Reconciliere, punct în timp |
Obligatoriu |
|
ID-UL LOCAȚIEI_ |
Identificator unic de locație |
CLIENT, UTILIZATOR |
Reconciliere, punct în timp Raportul privind momentul în care clientul este în timp real nu include ID-ul locației |
Opțional |
|
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 |
Opțional |
Selectarea coloanelor opționale modifică ordinea coloanelor din rapoartele de reconciliere a clienților și utilizatorilor. Următoarea ordine se aplică partenerilor care au doar SKU-uri Wholesale în abonamentul lor:
Raport la nivel de utilizator—NUME PARTENER_, ID PARTENER_ORG_, ID ABONAMENT_, ID CLIENT_GRUP_, NUME CLIENT_GRUP_, ID CLIENT__ORG [], ID CLIENT_] EXTERN_, ID LOCAȚIE_, ID LICENȚĂ_, ID ABONAT_, ID UTILIZATOR_, ID SPAȚIU DE LUCRU_, NUME SERVICIU_, SKU, DESCRIERE, DATA CONSUMULUI_ÎNCEPERE_, DATA CONSUMULUI_SFÂRȘIT_, CANTITATE
Raport la nivel de client—NUME PARTENER_, ID PARTENER_ORG_, ID ABONAMENT_, ID CLIENT_GRUP_, NUME CLIENT_GRUP_, ID CLIENT_] ORG_, ID CLIENT_EXTERN_, ID LOCAȚIE_, ID LICENȚĂ_, NUME SERVICIU_, SKU, DESCRIERE, DATA CONSUMULUI_ÎNCEPERE_, DATA CONSUMULUI_SFÂRȘIT_, CANTITATE
Alocarea unui pachet către un utilizator declanșează facturarea Webex Wholesale, în timp ce eliminarea atribuirii pachetului o oprește.
O organizație client poate aparține unui singur grup de clienți la un moment dat. Asistența pentru mai multe grupuri de clienți per organizație nu este disponibilă în prezent.
