Számlázási jelentések
A partnerek a következő nagykereskedelmi számlázási API-k segítségével készíthetik a számlázási jelentéseket, amelyek segítenek a használat és a rendelkezésre bocsátás pontosságának érvényesítésében. A nagykereskedelmi számlázási API-k a developer .webex.com webhelyen érhetők el.
-
Megegyezés — Partnerenként, ügyfélenként vagy felhasználónként megjeleníti a felhasználási fogyasztást. A partnerek felhasználhatják ezeket az egyéni számlázási jelentési információkat a havi számlájuk összeegyeztetésére, így ügyfeleiknek és felhasználóiknak a felhasználási felhasználásuk szerint számlázhatnak.
-
Pont-in-Time — Megjeleníti az aktuális csomagkiosztásokat ügyfélenként vagy felhasználónként. A pont-in-time jelentés valós idejű csomagok elosztásainak számlálását tartalmazza. A partnerek felhasználhatják ezeket az információkat az ellátás pontosságának ellenőrzésére és az ügyfelek megrendeléseivel való összehangolásának biztosítására.
A partnerek egyéni számlázási jelentéseket is készíthetnek az alpartnerek számára a SubPartnerOrgID paraméter segítségével.
Négy API áll rendelkezésre a minimális hozzáférési követelményeknek megfelelő partnerrendszergazdák számára.
|
Számlázási API |
Az API célja |
Partneradminisztrátor-hozzáférési követelmény |
|---|---|---|
|
Nagykereskedelmi számlázási jelentés létrehozása |
Számlázási jelentés létrehozására szolgál. |
Olvasás/írás |
|
Nagykereskedelmi számlázási jelentés beszerzése |
Egy generált számlázási jelentés letöltésére szolgál. |
Olvassa el |
|
Nagykereskedelmi számlázási jelentések listája |
Az adott partner számára létező számlázási jelentések felsorolására szolgál. |
Olvassa el |
|
Nagykereskedelmi számlázási jelentés törlése |
Egy meglévő számlázási jelentés törlésére szolgál. |
Olvasás/írás |
Adatforrás
A számlázási jelentések adatai csomaghozzárendelésekből és használati adatokból származnak, amelyeket a Webex minden partner számára nyomon követ. A Webex naponta összesíti az ügyfél- és felhasználói csomag adatait, hogy generálja a partner havi számláját. A számlázási API-k ezeket az adatokat használják, lehetővé téve a partneradminisztrátorok számára, hogy egyéni jelentéseket hozzanak létre. Ezek a jelentések segítenek a partnere knek összeegyeztetni a felhasználási fogyasztást a havi számlájuk alapján a partner-, ügyfél- és felhasználói szinten.
A Webex partnereinek számlázásának módjáról részletesebb információt a Sz olgáltató számlázása című témakörben talál.
Nagykereskedelmi számlázási jelentés létrehozása
| 1 |
A developer.webex.com webhelyről lépjen a Nagykereskedelmi szám lázási jelentés API létrehozása menüpontra. |
| 2 |
Válassza ki az alábbi jelentési kategóriák egyikét:
Ha összeegyeztetési jelentést szeretne létrehozni, semmit sem kell módosítania, mivel alapértelmezés szerint az Egyeztetés be van jelölve, így folytathatja a következő lépést. Ha pont-in-Time jelentést szeretne létrehozni, módosítsa a kijelölést Pont-in-Time értékre. |
| 3 |
Írja be a BillingStartDate és BillingEndDate beállításokat az API által megadott formátumban. Az elmúlt öt év bármely dátumát megadhatja, de nem az aktuális napot. A Pont-in-Time jelentés esetében a BillingStartDate és a BillingEndDate mezők nem kötelez őek, és a beírás esetén figyelmen kívül hagyják őket. A jelentés mindig tükrözi az aktuális csomagjut tatásokat. |
| 4 |
Adja meg a jelentés típus át:
|
| 5 |
A Tartal om mezőbe írja be a jelentésekben megjeleníteni kívánt további vagy opcionális oszlopokat. Minden jelentéstípus kötelező attribútumkészlettel és opcionális attribútumokkal rendelkezik. Eldöntheti, hogy az opcionális attribútumok közül melyiket jelenítse meg az egyes jelentésekhez. Ha nem adja meg az opcionális attribútumokat, a jelentés csak a kötelező attribútumokat jeleníti meg. A következő oszlopok azok az opcionális attribútumok, amelyeket kérhet az Ügyfél- és Felhasználói jelentésbe való felvételre:
Ha ezeket az attribú CUSTOMER_GROUP_ID tu CUSTOMER_GROUP_NAME mokat szeretné látni a jelentésben, be kell vonnia és együtt kell tartalmaznia. Ha kiválasztja az opcionális oszlopokat, az Ügyfél- és Felhasználói egyeztetési jelentések oszlopsorrendje megváltozik. A partnereknek frissíteniük kell API-integrációjukat az új csv formátum elfogadásához. A pont-in-time jelentések oszlopsorrendje változatlan marad. Jelenleg a meglévő jellemzőbeállítások elsőbbséget élveznek az Include paraméterrel szemben az oszlopsorrend meghatározásakor. Ha például egy adott funkcióbeállítás engedélyezve van egy ügyfél számára, akkor az adott jellemzőoszlop a régi jelentésformátum szerint jelenik meg, még akkor is, ha hozzáadja azt az Include paraméterhez. Hamarosan eltávolítjuk ezeket a beállításokat. Miután eltávolították őket, csak az Include paraméteren keresztül kérheti az opcionális oszlopokat. |
| 6 |
Kattintson a Fut tatás gombra a jelentés létrehozásához. |
| 7 |
Másolja a jelentés azonosító ját az API kimenetéből. Ezt az értéket a Get API-val használhatja a generált számlázási jelentés megszerzéséhez. |
Mi a teendő ezután
A jelentés másolatának letöltéséhez lépjen a Nagykereskedelmi számlázási jelent és beszerzése részre.
Nagykereskedelmi számlázási jelentés beszerzése
Miután létrejött egy számlázási jelentés, használja ezt az API-t egy adott számlázási jelentés beszerzéséhez. A jelentés egy URL-re jelenik meg, ahol letölthető 30 percig a GET kérés teljesítését követően.
| 1 |
A developer.webex.com webhelyről lépjen a Nagykereskedelmi számlá zási jelentés API beszerzése men üpontra. |
| 2 |
Adja meg a jelentés egyedi azonosító értékét, majd kattintson a Futtatás gombra. Az API kiadja a jelentés állapotát. A kimenet tartalmazza a tempDownloadURL paramétert, amely URL-t ad, ahonnan letöltheti a jelentést. |
| 3 |
Másolja a tempDownloadURL-t egy böngészőbe a jelentés eléréséhez és letöltéséhez. |
Nagykereskedelmi számlázási jelentések listája
Ezzel az API-val szerezheti be a partnerszervezet számára létrehozott számlázási jelentések listáját. Felsorolhatja az összes meglévő jelentést, vagy korlátozhatja a listát azokra a jelentésekre, amelyek megfelelnek a megadott paramétereknek, például a számlázási időszaknak és a számlázási típusnak (Partner, ügyfél, felhasználó).
Ha opcionális paramétereket ad meg, az API csak azokat a jelentéseket adja vissza, amelyek pontosan megfelelnek a megadott paramétereknek. Ha például számlázási időszakot ad meg, csak az adott számlázási időszakot használó jelentések kerülnek visszaküldésre. Azok a jelent ések, amelyek az időszakba tartoznak, de amelyek nem pontosan egyeznek meg a dátumokkal, nem kerül nek vissza.
| 1 |
A developer.webex.com webhelyről lépjen a L ist Wholes ale Billing Report API oldalra. |
| 2 |
A Lek érdezési paraméterek területen írja be a használni kívánt keresési paramétereket (például a StartDate, EndD ate, Type, SortBy). |
| 3 |
Kattintson a Futtatás gombra Az API kiadja a jelentések listáját az egyedi jelentés azonos ítóval és állapotával együtt (BEFEJEZVE,IN_PROGRESS).
|
Mi a teendő ezután
Jegyezze fel a letölteni kívánt jelentések azonos ítóját. A jelentés letöltéséhez lépjen a Nagykereskedelmi számlázási jelent és beszerzése menüpontra.
Nagykereskedelmi számlázási jelentés törlése
Ezzel az eljárással törölhet egy generált számlázási jelentést a jelentésazonosító alapján. Néhány példa arra, hogy esetleg törölni szeretné egy jelentést, a következők:
-
Ha egy meglévő egyeztetési számlázási jelentést szeretne újragenerálni, először törölnie kell a meglévő jelentést. A meglévő jelentés törlése után létrehoz hat egy új jelentést az adott időszakra vonatkozóan. Nem törölheti a jelentést, ha a jelent és létrehozása sikertelen vagy még folyamatban van.
Pont-in-Time jelentés esetén nem kell törölnie egy meglévő jelentést, mivel a rendszer nem regenerálja ezeket a jelentéseket. Minden jelentés mindig az aktuális időbélyegző adatait tükrözi.
-
Ha egy generált jelentés URL-címét rossz személynek küld, törölheti a jelentést, így nem férhet hozzá.
| 1 |
A developer.webex.com webhelyről lépjen a Nagykereskedelmi számlázási jelentés API törlése menüpontra. |
| 2 |
Írja be a jelentés azonosítóját, majd kattintson a Futtat ás gom bra. |
Számlázási jelentés mezők
A számlázási jelentések a következő mezőket tartalmazzák:
|
Mező |
Leírás |
Támogatott jelentéstípus |
Támogatott jelentési kategória |
Kötelező vagy opcionális attribútum |
|---|---|---|---|---|
|
PARTNER_NAME |
Partner neve |
PARTNER, CUSTOMER, USER |
Megbékélés, pont-in-time |
Kötelező |
|
PARTNER_ORG_ID |
Egyedi partnerazonosító |
PARTNER, CUSTOMER, USER |
Megbékélés, pont-in-time |
Kötelező |
|
SUBSCRIPTION_ID |
Egyedi előfizetési azonosító |
PARTNER, CUSTOMER, USER |
Megbékélés, pont-in-time |
Kötelező |
|
CUSTOMER_GROUP_ID | Annak a csoportnak az egyedi azonosítója, amelyhez az ügyfél tartozik. Ha a vásárlót csoportok között mozgatják a számlázási időszak alatt, a használat megoszlik azon csoportok alapján, amelyekhez az ügyfél az adott időszakban tartozott. |
CUSTOMER, USER |
Megbékélés, pont-in-time |
Választható |
|
CUSTOMER_GROUP_NAME | Az ügyfélcsoport megjelenített neve. Ha a csoport neve megváltozott a számlázási időszak alatt, akkor a legújabb név kerül felhasználásra. |
CUSTOMER, USER |
Megbékélés, pont-in-time |
Választható |
|
CUSTOMER_ORG_ID |
Belső ügyfél egyedi azonosítója |
CUSTOMER, USER |
Megbékélés, pont-in-time |
Kötelező |
|
CUSTOMER_EXTERNAL_ID |
A partner által megadott egyedi ügyfél azonosítója |
CUSTOMER, USER |
Megbékélés, pont-in-time |
Kötelező |
|
TYPE |
Felhasználó vagy munkaterület típusa |
CUSTOMER, USER |
Pont-in-Time |
Kötelező |
|
SUBSCRIBER_ID |
Egyedi azonosító az előfizető számára |
USER |
Megbékélés, pont-in-time |
Kötelező |
|
USER_ID |
Az előfizető Webex felhasználói azonosítója |
USER |
Megbékélés, pont-in-time |
Kötelező |
|
WORKSPACE_ID |
Egyedi munkaterület-azonosító |
USER |
Megbékélés, pont-in-time |
Kötelező |
|
SERVICE_NAME |
Szolgáltatás neve (pl.COMMON_AREA_CALLING,WEBEX_CALLING,WEBEX_SUITE,WEBEX_MEETINGS) |
PARTNER, CUSTOMER, USER |
Megbékélés, pont-in-time |
Kötelező |
|
SKU |
Szolgáltatás SKU |
PARTNER, CUSTOMER, USER |
Megbékélés, pont-in-time |
Kötelező |
|
DESCRIPTION |
A szolgáltatás leírása |
PARTNER, CUSTOMER, USER |
Megbékélés, pont-in-time |
Kötelező |
|
CONSUMPTION_START_DATE |
A szolgáltatásfogyasztás kezdete. A következő mezővel együtt ez az érték határozza meg a használati időszakot. |
PARTNER, CUSTOMER, USER |
Megbékélés |
Kötelező |
|
CONSUMPTION_END_DATE |
A szolgáltatásfogyasztás vége. Az előző mezővel együtt ez az érték meghatározza a felhasználási időszakot. |
PARTNER, CUSTOMER, USER |
Megbékélés |
Kötelező |
|
REPORT_DATE |
A jelentés létrehozásának dátuma és időpontja. |
CUSTOMER, USER |
Pont-in-Time |
Kötelező |
|
QUANTITY |
Az összesített felhasználói felhasználási fogyasztást képviseli partnerenként, ügyfélenként vagy felhasználónként (az adatok megtekintésének jelentésétől és szintjétől függően). Számítás: A rendszer az egyes felhasználók napi mennyiségét arányosan kiszámítja az adott napra. Teljes napi használat = 1 Fél napos használat = 0,5 Ezután összegzi a számlázási időszakon belüli összes nap napi összegét, hogy kiszámítsa az adott felhasználó teljes mennyiségét az adott számlázási időszakon belül. Ügyfél- és partnerszintű jelentések esetében az összes felhasználó összegét összesítjük, hogy az adott ügyfél vagy partner teljes mennyiségét biztosítsák. Pont-in-Time: Az ügyféljelentés felsorolja a csomagok ügyfélenkénti elosztását. Minden sor egy adott ügyfélszervezeten belüli felhasználókhoz vagy munkaterületekhez hozzárendelt adott csomag teljes mennyiségét jelöli. A Mennyiség a „0” értéket jeleníti meg, ha nincs kiosztott csomag. A felhasználói jelentés felsorolja a felhasználókhoz vagy munkaterületekhez rendelt csomagokat. Minden sor 1-es mennyiséget jelenít meg, amely egy felhasználót vagy munkaterületet, valamint az egyedi csomagot vagy bővítményt jelöli. Ha több csomag vagy bővítmény van hozzárendelve egy felhasználóhoz vagy munkaterülethez, akkor a jelentés több bejegyzést jelenít meg, amelyek mindegyikének mennyisége 1. |
PARTNER, CUSTOMER, USER |
Megbékélés, pont-in-time |
Kötelező |
|
LOCATION_ID |
Egyedi helyazonosító |
CUSTOMER, USER |
Megbékélés, pont-in-time Az ügyfél-pont-in-time jelentés nem tartalmazza a helyazonosítót |
Választható |
|
LICENSE_ID |
Licencazonosító Ez a mező csak nagykereskedelmi csomagoknál látható Az egyeztetési jelent License_ID és esetében a mező bevezetése előtt hozzárendelt licencek üres. A számlázási jelentés több sort jelenít meg ugyanazon nagykereskedelmi csomag esetében, ha az és különböző kombinációihoz van tár LOCATION_ID sítvaLICENSE_ID. |
CUSTOMER, USER |
Megbékélés, pont-in-time |
Választható |
Az opcionális oszlopok kiválasztása módosítja az Ügyfél- és Felhasználói egyeztetési jelentések oszlopsorrendjét. A következő sorrend vonatkozik azokra a partnerekre, akiknek előfizetésükben csak Nagykereskedelmi SKU-k vannak:
Felhasználói szintű jelent PARTNER_NAME és—PARTNER_ORG_ID,SUBSCRIPTION_ID,CUSTOMER_GROUP_ID,CUSTOMER_GROUP_NAME,,CUSTOMER_ORG_ID,CUSTOMER_EXTERNAL_ID,LOCATION_ID,,LICENSE_ID,SUBSCRIBER_ID, SKU USER_ID WORKSPACE_IDSERVICE_NAME, LEÍRÁS,, CONSUMPTION_START_DATECONSUMPTION_END_DATE, MENNYISÉG
Ügyfélszintű jelentés—PARTNER_NAME,PARTNER_ORG_ID,SUBSCRIPTION_ID,CUSTOMER_GROUP_ID,,CUSTOMER_GROUP_NAME,CUSTOMER_ORG_ID,,CUSTOMER_EXTERNAL_ID,LOCATION_ID, SKU LICENSE_IDSERVICE_NAME, LEÍRÁS,, CONSUMPTION_START_DATECONSUMPTION_END_DATE, MENNYISÉG
A csomag felhasználónak történő biztosítása a Webex nagykereskedelmi számlázását indítja el, míg a csomaghozzárendelés eltávolítása leállítja azt.
Egy ügyfélszervezet egy adott időpontban csak egy ügyfélcsoporthoz tartozhat. Szervezetenként több ügyfélcsoport támogatása jelenleg nem érhető el.