Rapoarte de facturare cu ridicata pentru rutele către piață

Rapoarte de facturare

Partenerii pot utiliza următoarele API-uri de facturare cu ridicata pentru a genera rapoarte de facturare care îi ajută să valideze utilizarea și acuratețea furnizării. API-urile de facturare cu ridicata sunt accesibile prin developer.webex.com.

Reconciliere — Afișează consumul de utilizare la nivel de partener, client sau utilizator. Partenerii pot utiliza aceste informații personalizate ale raportului de facturare pentru a-și reconcilia factura lunară, astfel încât să își poată factura clienții și utilizatorii în funcție de consumul lor de utilizare.
Punct în timp — Afișează alocările curente ale pachetelor la nivel de client sau per utilizator. Raportul Punct-In-Time oferă un număr în timp real al alocărilor de pachete. Partenerii pot utiliza aceste informații pentru a valida acuratețea furnizării și pentru a asigura alinierea la comenzile clienților.

Partenerii pot genera, de asemenea, rapoarte de facturare personalizate pentru subparteneri folosind parametrul SubpartnerOrgID.

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

API de facturare	Scopul API	Cerință de acces la administratorul partenerului
Crearea unui raport de facturare cu ridicata	Folosit pentru a genera un raport de facturare.	Citește/scrieți
Obțineți un raport de facturare cu ridicata	Folosit pentru a obține un raport de facturare generat pentru descărcare.	Citește
Lista rapoartelor de facturare cu ridicata	Folosit pentru a lista rapoartele de facturare care există pentru acel partener.	Citește
Ștergerea unui raport de facturare cu ridicata	Folosit pentru a șterge un raport de facturare existent.	Citește/scrieți

Sursa de date

Datele pentru rapoartele de facturare sunt extrase din alocările de pachete și datele de utilizare pe care Webex le urmărește pentru fiecare partener. Webex agregă zilnic datele despre pachetul clientului și al utilizatorului pentru a genera factura lunară a partenerului. API-urile de facturare utilizează aceste date, permițând administratorilor parteneri să genereze rapoarte personalizate. Aceste rapoarte ajută partenerii să reconcilieze consumul de utilizare cu factura lunară la nivel de partener, client și utilizator.

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

Crearea unui raport de facturare cu ridicata

1	Din developer.webex.com, accesați Crearea unui API pentru raportul de facturare cu ridicata.
2	Selectați oricare dintre următoarele categorii de rapoarte: Reconciliere (implicit) Punct în timp Dacă doriți să generați un raport de reconciliere, nu este nevoie să modificați nimic, deoarece Reconcilierea este selectată în mod implicit, astfel încât să puteți trece la pasul următor. Dacă doriți să generați un raport Punct în timp, modificaț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 și ziua curentă. Pentru raportul Punct în timp, câmpurile BillingStartDate și BillingEndDate nu sunt obligatorii și sunt ignorate dacă sunt introduse. Raportul reflectă întotdeauna alocările actuale ale pach etelor.
4	Introduceți tipul raportului: PARTENER (implicit) —Afișează consumurile de utilizare sau alocările de pachete la nivel de partener. Acest tip nu este acceptat pentru raportul Punct în timp. Client - afișează consumurile de utilizare sau alocările de pachete defalcate la nivelul organizațiilor clienților din cadrul partenerului. Utilizator — afișează consumurile de utilizare sau alocările de pachete defalcate la nivelul organizațiilor clienților și al abonaților din cadrul partenerului.
5	În câmpul Inclu de, 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ă numai atributele obligatorii. Următoarele coloane sunt atributele opționale pe care le puteți solicita să le includeți în raportul Client și Utilizator: CUSTOMER_GROUP_ID CUSTOMER_GROUP_NAME LOCATION_ID LICENSE_ID Trebuie să inclu CUSTOMER_GROUP_ID deți și CUSTOMER_GROUP_NAME împreună dacă doriți să vedeți aceste atribute în raport. Când selectați coloane opționale, ordinea coloanelor din rapoartele Reconciliere client și utilizator se modifică. Partenerii trebuie să își actualizeze integrarea API pentru a accepta noul format csv. Ordinea coloanelor rapoartelor Point-In-Time rămâne neschimbată. În prezent, setările de caracteristici existente au prioritate față de parametrul Include atunci când se determină ordinea coloanei. De exemplu, dacă o anumită setare de caracteristică este activată pentru un client, atunci coloana caracteristică respectivă apare conform formatului vechi de raport, chiar dacă le adăugați în parametrul Include. Vom elimina aceste setări în curând. După ce sunt eliminate, puteți solicita coloanele opționale numai prin parametrul Include.
6	Faceți clic pe Exec utare pentru a genera raportul.
7	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 să faci în continuare

Accesați secțiunea Obțineți un raport de facturare cu ridicata pentru a descărca o copie a raportului.

Obțineți un raport de facturare cu ridicata

Odată generat un raport de facturare, utilizați acest API pentru a obține un raport de facturare specific. Raportul primește ieșirea la o adresă URL unde este disponibil pentru descărcare timp de 30 de minute după finalizarea solicitării GET.

1	Din developer.webex.com, accesați API-ul Obțineți un raport de facturare cu ridicata.
2	Introduceți valoarea identific atorului unic pentru raport și faceți clic pe Executare. Ieșirile API raportează starea. Ieșirea include parametrul TempDownloadURL, care oferă 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 rapoartelor de facturare cu ridicata

Utilizați acest 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ă numai acele rapoarte care se potrivesc exact cu parametrii specificați. De exemplu, dacă specificați o perioadă de facturare, sunt returnate numai rapoartele care utilizează perioada de facturare specifică. Rapoartele care se încadrează în perioada respectivă, dar care nu se potrivesc exact cu datele nu sunt returnate.

1	Din developer.webex.com, accesați API-ul Listează raportul de facturare cu ridic ata.
2	Sub Parametri de interog are, 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 Execut are. API-ul afișează lista de rapoarte împreună cu ID- ul și starea raportului unic (COMPLETAT,IN_PROGRESS).

Ce să faci în continuare

Faceți o înregistrare a ID- ului pentru orice rapoarte pe care doriți să le descărcați. Accesați Ob țineți un raport de facturare cu ridicata pentru a descărca raportul.

Ștergerea unui raport de facturare cu ridicata

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

Dacă doriți să regenerați un raport de facturare existent pentru Reconciliere, 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 de desfășurare.

Pentru un raport Punct-In-Time, nu este necesar să ștergeți un raport existent, deoarece sistemul nu regenerează aceste rapoarte. Fiecare raport reflectă întotdeauna datele începând cu marcajul de timp curent.
Dacă trimiteți o adresă URL a raportului generată unei persoane greșite, puteți șterge raportul, astfel încât aceasta să nu-l poată accesa.

1	Din developer.webex.com, accesați Ș tergerea API-ului Raport de facturare cu ridicata.
2	Introduceți ID- ul raportului și faceți clic pe Executare.

Câmpurile raportului 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
PARTNER_NAME	Numele partenerului	PARTNER, CUSTOMER, USER	Reconciliere, Punct-In-Time	Obligatoriu
PARTNER_ORG_ID	Identificator unic al partenerului	PARTNER, CUSTOMER, USER	Reconciliere, Punct-In-Time	Obligatoriu
SUBSCRIPTION_ID	Identificator unic de abonament	PARTNER, CUSTOMER, USER	Reconciliere, Punct-In-Time	Obligatoriu
CUSTOMER_GROUP_ID	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 clientul a aparținut în perioada respectivă.	CUSTOMER, USER	Reconciliere, Punct-In-Time	Opțional
CUSTOMER_GROUP_NAME	Numele afișat al grupului de clienți. Dacă numele grupului s-a schimbat în perioada de facturare, se utilizează cel mai recent nume.	CUSTOMER, USER	Reconciliere, Punct-In-Time	Opțional
CUSTOMER_ORG_ID	Identificator unic intern al clientului	CUSTOMER, USER	Reconciliere, Punct-In-Time	Obligatoriu
CUSTOMER_EXTERNAL_ID	Identificatorul unic al clientului furnizat de un partener	CUSTOMER, USER	Reconciliere, Punct-In-Time	Obligatoriu
TYPE	Tip utilizator sau spațiu de lucru	CUSTOMER, USER	Punct în timp	Obligatoriu
SUBSCRIBER_ID	Identificator unic pentru abonat	USER	Reconciliere, Punct-In-Time	Obligatoriu
USER_ID	ID-ul de utilizator Webex al abonatului	USER	Reconciliere, Punct-In-Time	Obligatoriu
WORKSPACE_ID	Identificator unic al spațiului de lucru	USER	Reconciliere, Punct-In-Time	Obligatoriu
SERVICE_NAME	Denumirea serviciului (de exemplu,COMMON_AREA_CALLING,WEBEX_CALLING,WEBEX_SUITE,WEBEX_MEETINGS)	PARTNER, CUSTOMER, USER	Reconciliere, Punct-In-Time	Obligatoriu
SKU	Sku pentru serviciu	PARTNER, CUSTOMER, USER	Reconciliere, Punct-In-Time	Obligatoriu
DESCRIPTION	Descrierea serviciului	PARTNER, CUSTOMER, USER	Reconciliere, Punct-In-Time	Obligatoriu
CONSUMPTION_START_DATE	Începerea consumului de servicii. Împreună cu câmpul următor, această valoare definește perioada de utilizare.	PARTNER, CUSTOMER, USER	Reconciliere	Obligatoriu
CONSUMPTION_END_DATE	Sfârșitul consumului de servicii. Împreună cu câmpul precedent, această valoare definește perioada de consum de utilizare.	PARTNER, CUSTOMER, USER	Reconciliere	Obligatoriu
REPORT_DATE	Data și ora la care este generat raportul.	CUSTOMER, USER	Punct în timp	Obligatoriu
QUANTITY	Reprezintă consumul agregat de utilizare a utilizatorilor pe partener, pe 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 pe o bază proporțională pentru acea zi. Utilizare pentru o zi întreagă = 1 Utilizare pentru o jumătate de zi = 0,5 Apoi, însumează totalurile pe zi pentru toate zilele din perioada de facturare pentru a calcula cantitatea totală pentru acel utilizator î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 acel client sau partener. Punct-In-Time: Raportul clientului listează alocările de pachete pe client. Fiecare rând reprezintă cantitatea totală a unui pachet specific atribuit utilizatorilor sau spațiilor de lucru dintr-o anumită organizație client. Cantitatea afișează „0” dacă nu există pachete alocate. Raportul utilizator listează pachetele atribuite utilizatorilor sau spațiilor de lucru. Fiecare rând arată o cantitate de 1, reprezentând un utilizator sau spațiu de lucru și pachetul sau suplimentul individual al acestora. Dacă mai multe pachete sau programe de completare sunt alocate unui utilizator sau unui spațiu de lucru, atunci raportul afișează mai multe intrări, fiecare cu o cantitate de 1.	PARTNER, CUSTOMER, USER	Reconciliere, Punct-In-Time	Obligatoriu
LOCATION_ID	Identificator unic de locație	CUSTOMER, USER	Reconciliere, Punct-In-Time Raportul Punct-In-Time al clientului nu include ID-ul locației	Opțional
LICENSE_ID	Identificator de licență Acest câmp este vizibil numai pentru pachetele en-gros Pentru raportul Reconciliere, License_ID este necompletat pentru licențele atribuite înainte de introducerea acestui câmp. Raportul de facturare afișează mai multe rânduri pentru același pachet en-gros dacă este asociat cu combinații diferite de LOCATION_ID șiLICENSE_ID.	CUSTOMER, USER	Reconciliere, Punct-In-Time	Opțional

Selectarea coloanelor opționale modifică ordinea coloanelor din rapoartele Reconciliere client și utilizator. Următoarea comandă se aplică partenerilor care au doar SKU-uri cu ridicata în abonament:

Raport la nivel de utilizator— PARTNER_NAME PARTNER_ORG_IDSUBSCRIPTION_ID,CUSTOMER_GROUP_ID,CUSTOMER_GROUP_NAME,CUSTOMER_ORG_ID,CUSTOMER_EXTERNAL_ID,LOCATION_ID,,LICENSE_ID,SUBSCRIBER_ID,USER_ID,WORKSPACE_ID, SKUSERVICE_NAME, DESCRIERE,, CONSUMPTION_START_DATECONSUMPTION_END_DATE, CANTITATE

Raport la nivel de PARTNER_NAME client— PARTNER_ORG_IDSUBSCRIPTION_ID,CUSTOMER_GROUP_ID,,CUSTOMER_GROUP_NAME,CUSTOMER_ORG_ID,CUSTOMER_EXTERNAL_ID,LOCATION_ID,LICENSE_ID,SERVICE_NAME, SKU, DESCRIERE,, CONSUMPTION_START_DATECONSUMPTION_END_DATE, CANTITATE

Furnizarea unui pachet unui utilizator declanșează facturarea Webex Wholesale, în timp ce eliminarea atribuirii pachetului îl oprește.

O organizație de clienți poate aparține unui singur grup de clienți la un moment dat. Asistența pentru mai multe grupuri de clienți pe organizație nu este disponibilă momentan.

Cisco AI Assistant

Mulțumim pentru feedback.