Köszönjük visszajelzését.
Visszajelzés?Számlázási jelentések
A partnerek a következő nagykereskedelmi számlázási API-kat használhatják számlázási jelentések létrehozásához, amelyek segítenek nekik a használat és a kiépítés pontosságának ellenőrzésében. A nagykereskedelmi számlázási API-k a developer.webex.com oldalon érhetők el.
-
Egyeztetés – Megjeleníti a felhasználást partnerenként, ügyfelenként vagy felhasználónként. A partnerek ezt az egyéni számlázási jelentésinformációt használhatják havi számláik egyeztetésére, hogy ügyfeleiket és felhasználóikat a fogyasztásuk alapján számlázhassák.
-
Időpont – Megjeleníti az aktuális csomagelosztásokat ügyfelenként vagy felhasználónként. Az időpontbeli jelentés valós idejű adatokat szolgáltat a csomagok kiosztásáról. A partnerek ezeket az információkat felhasználhatják a kiépítés pontosságának ellenőrzésére és az ügyfélrendelésekkel való összhang biztosítására.
A partnerek egyéni számlázási jelentéseket is generálhatnak az alpartnerek számára a subPartnerOrgId paraméter használatával.
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 |
Partner adminisztrátori hozzáférési követelmény |
|---|---|---|
|
Nagykereskedelmi számlázási jelentés létrehozása |
Számlázási jelentés készítésére szolgál. |
Read/write |
|
Nagykereskedelmi számlázási jelentés igénylése |
Letölthető számlázási jelentés lekérésére szolgál. |
Olvasás |
|
Nagykereskedelmi számlázási jelentések listázása |
Az adott partnerhez tartozó számlázási jelentések listázására szolgál. |
Olvasás |
|
Nagykereskedelmi számlázási jelentés törlése |
Meglévő számlázási jelentés törlésére szolgál. |
Read/write |
Adatforrás
A számlázási jelentésekhez tartozó adatokat a Webex által az egyes partnerek esetében nyomon követett csomag-hozzárendelésekből és használati adatokból nyerik ki. A Webex naponta összesíti az ügyfél- és felhasználói csomagadatokat a partner havi számlájának elkészítéséhez. A számlázási API-k ezeket az adatokat használják, lehetővé téve a partner adminisztrátorok számára egyéni jelentések létrehozását. Ezek a jelentések segítenek a partnereknek egyeztetni a havi számlájukon szereplő felhasználási adatokat partner-, ügyfél- és felhasználói szinten.
A Webex partnerszámlázási módszereivel kapcsolatos részletesebb információkért lásd: Szolgáltatói számlázás.
Nagykereskedelmi számlázási jelentés létrehozása
| 1 |
A developer.webex.comwebhelyről lépjen a Nagykereskedelmi számlázási jelentés API létrehozásarészhez. |
| 2 |
Válasszon az alábbi jelentéskategóriák közül:
Ha egyeztetési jelentést szeretne létrehozni, akkor nem kell semmit módosítania, mivel az egyeztetés alapértelmezés szerint ki van választva, így folytathatja a következő lépéssel. Ha időpont szerinti jelentést szeretne létrehozni, módosítsa a kijelölést időpont szerintire. |
| 3 |
Adja meg a billingStartDate és a billingEndDate értékeket az API által meghatározott formátumban. Bármely dátumot megadhat az elmúlt öt évből, de a mai napot nem. Az időpont szerinti jelentés esetében a billingStartDate és billingEndDate mezők kitöltése nem kötelező, és ha ki vannak írva, a rendszer figyelmen kívül hagyja őket. A jelentés mindig az aktuális csomagelosztást tükrözi. |
| 4 |
Adja meg a jelentés típusát :
|
| 5 |
A Tartalmaz mezőben adja meg a jelentésekben megjeleníteni kívánt további vagy opcionális oszlopokat. Minden jelentéstípushoz tartozik egy kötelező és egy opcionális attribútum. Eldöntheti, hogy az egyes jelentésekhez mely opcionális attribútumok jelenjenek meg. 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ó jelentésbe való felvételre:
A COUTER_CSOPORT_AZONOSÍTÓJÁT és a COUTER_CSOPORT_NEVE attribútumokat együtt kell megadni, ha ezeket az attribútumokat látni szeretné a jelentésében. Amikor opcionális oszlopokat választ ki, az oszlopok sorrendje megváltozik az Ügyfél- és Felhasználói egyeztetési jelentésekben. A partnereknek frissíteniük kell API-integrációjukat, hogy elfogadják az új CSV-formátumot. Az időpontbeli jelentések oszlopsorrendje változatlan marad. Jelenleg a meglévő funkcióbeállítások elsőbbséget élveznek az Include paraméterrel szemben az oszlopok sorrendjének meghatározásakor. Például, ha egy adott funkcióbeállítás engedélyezve van egy ügyfél számára, akkor az adott funkcióoszlop a régi jelentésformátum szerint jelenik meg, még akkor is, ha hozzáadja azokat az Include paraméterhez. Hamarosan eltávolítjuk ezeket a beállításokat. Miután eltávolította őket, az opcionális oszlopokat csak az Include paraméteren keresztül kérheti le. |
| 6 |
Kattintson a Futtatás gombra a jelentés létrehozásához. |
| 7 |
Másolja ki a azonosítót az API kimenetből. Ezt az értéket a Get API-val használhatja a létrehozott számlázási jelentés lekéréséhez. |
Mi a következő teendő
A jelentés egy példányának letöltéséhez látogasson el a Nagykereskedelmi számlázási jelentés beszerzése részre.
Nagykereskedelmi számlázási jelentés igénylé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-címre kerül kimenetként, ahol a GET kérés befejezését követő 30 percig letölthető.
| 1 |
A developer.webex.comwebhelyről lépjen a Nagykereskedelmi számlázási jelentés API beszerzéseoldalra. |
| 2 |
Adja meg a jelentés egyedi azonosítóját, majd kattintson a Futtatásgombra. Az API kimenete jelentést készít az állapotról. A kimenet tartalmazza a tempDownloadURL paramétert, amely egy URL-címet biztosít, ahonnan letöltheti a jelentést. |
| 3 |
Másolja a tempDownloadURL címet 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ázása
Ezzel az API-val lekérheti a partnerszervezet számára létrehozott számlázási jelentések listáját. Listázhatja 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. Például, ha megad egy számlázási időszakot, akkor csak azok a jelentések jelennek meg, amelyek az adott számlázási időszakot használják. Az időszakon belüli, de a dátumokkal nem pontosan megegyező jelentéseket nem adja vissza a rendszer.
| 1 |
A developer.webex.comwebhelyről lépjen a List Wholesale Billing Report APIrészhez. |
| 2 |
A Lekérdezési paraméterekalatt adja meg a használni kívánt keresési paramétereket (például a kezdődátumot, a befejezési dátumot, a típust, a rendezési módot). |
| 3 |
Kattintson a Futtatás gombra . Az API kimenetként megjeleníti a jelentések listáját, az egyedi jelentésazonosítóval és állapottal (BEFEJEZETT, FOLYAMATOS_) együtt.
|
Mi a következő teendő
Jegyezze fel a letölteni kívánt jelentések azonosítóját. A jelentés letöltéséhez kattintson a Nagykereskedelmi számlázási jelentés beszerzése lehetőségre.
Nagykereskedelmi számlázási jelentés törlése
Ezzel az eljárással törölhet egy jelentésazonosító alapján létrehozott számlázási jelentést. Néhány példa arra, amikor törölni szeretnél egy jelentést:
-
Ha egy meglévő egyeztetési számlázási jelentést szeretne újra létrehozni, először törölnie kell a meglévő jelentést. A meglévő jelentés törlése után létrehozhat egy új jelentést az adott időszakra. Nem törölhet egy jelentést, ha a létrehozása sikertelen volt, vagy még folyamatban van.
Időpont-jelentés esetén nem kell törölni a meglévő jelentést, mivel a rendszer nem generálja újra ezeket a jelentéseket. Minden jelentés mindig az aktuális időbélyeg szerinti adatokat tükrözi.
-
Ha egy generált jelentés URL-címét rossz személynek küldi el, törölheti a jelentést, így az illető nem férhet hozzá.
| 1 |
A developer.webex.comwebhelyről lépjen a Nagykereskedelmi számlázási jelentés API törlésemenüpontra. |
| 2 |
Adja meg a jelentés azonosítóját, majd kattintson a Futtatásgombra. |
Számlázási jelentés mezői
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éskategória |
Kötelező vagy opcionális attribútum |
|---|---|---|---|---|
|
PARTNER_NEVE |
Partner neve |
PARTNER, ÜGYFÉL, FELHASZNÁLÓ |
Egyeztetés, időpont |
Kötelező |
|
PARTNER_SZERV_AZONOSÍTÓ |
Egyedi partnerazonosító |
PARTNER, ÜGYFÉL, FELHASZNÁLÓ |
Egyeztetés, időpont |
Kötelező |
|
ELŐFIZETÉS_AZONOSÍTÓ |
Egyedi előfizetés-azonosító |
PARTNER, ÜGYFÉL, FELHASZNÁLÓ |
Egyeztetés, időpont |
Kötelező |
|
ÜGYFÉL_CSOPORT_AZONOSÍTÓ | Annak a csoportnak az egyedi azonosítója, amelyhez az ügyfél tartozik. Ha az ügyfelet a számlázási időszak alatt csoportok között helyezik át, a használat az adott időszakban az ügyfél által használt csoportok alapján kerül felosztásra. |
ÜGYFÉL, FELHASZNÁLÓ |
Egyeztetés, időpont |
Opcionális |
|
ÜGYFÉL_CSOPORT_NEVE | Az ügyfélcsoport megjelenített neve. Ha a csoport neve a számlázási időszak alatt megváltozott, a legújabb név kerül felhasználásra. |
ÜGYFÉL, FELHASZNÁLÓ |
Egyeztetés, időpont |
Opcionális |
|
ÜGYFÉL_SZERVEZET_AZONOSÍTÓ |
Belső ügyfél egyedi azonosítója |
ÜGYFÉL, FELHASZNÁLÓ |
Egyeztetés, időpont |
Kötelező |
|
ÜGYFÉL_KÜLSŐ_AZONOSÍTÓ |
Egy partner által megadott egyedi ügyfélazonosító |
ÜGYFÉL, FELHASZNÁLÓ |
Egyeztetés, időpont |
Kötelező |
|
TÍPUS |
Felhasználó vagy munkaterület típusa |
ÜGYFÉL, FELHASZNÁLÓ |
Időpont |
Kötelező |
|
ELŐFIZETŐ_AZONOSÍTÓ |
Az előfizető egyedi azonosítója |
FELHASZNÁLÓ |
Egyeztetés, időpont |
Kötelező |
|
FELHASZNÁLÓI AZONOSÍTÓ_ |
Az előfizető Webex felhasználói azonosítója |
FELHASZNÁLÓ |
Egyeztetés, időpont |
Kötelező |
|
MUNKATÉR_AZONOSÍTÓ |
Egyedi munkaterület-azonosító |
FELHASZNÁLÓ |
Egyeztetés, időpont |
Kötelező |
|
SZOLGÁLTATÁS_NEVE |
Szolgáltatás neve (pl. KÖZÖS_TERÜLET_HÍVÁS, WEBEX_HÍVÁS, WEBEX_LAKOSZTÁLY, WEBEX_MÉTELEKÖNNYEK) |
PARTNER, ÜGYFÉL, FELHASZNÁLÓ |
Egyeztetés, időpont |
Kötelező |
|
SKU |
A szolgáltatáshoz tartozó SKU |
PARTNER, ÜGYFÉL, FELHASZNÁLÓ |
Egyeztetés, időpont |
Kötelező |
|
LEÍRÁS |
A szolgáltatás leírása |
PARTNER, ÜGYFÉL, FELHASZNÁLÓ |
Egyeztetés, időpont |
Kötelező |
|
FOGYASZTÁS_KEZDÉS_DÁTUM |
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, ÜGYFÉL, FELHASZNÁLÓ |
Egyeztetés |
Kötelező |
|
FOGYASZTÁS_VÉGE_DÁTUM |
A szolgáltatásfogyasztás vége. Az előző mezővel együtt ez az érték határozza meg a használati időszakot. |
PARTNER, ÜGYFÉL, FELHASZNÁLÓ |
Egyeztetés |
Kötelező |
|
JELENTÉS_DÁTUM |
A jelentés létrehozásának dátuma és időpontja. |
ÜGYFÉL, FELHASZNÁLÓ |
Időpont |
Kötelező |
|
MENNYISÉG |
Az összesített felhasználói fogyasztást jelöli partnerenként, ügyfélenként vagy felhasználónként (attól függően, hogy melyik jelentést és milyen szinten tekinti meg az adatokat). Számítás: A rendszer az adott napra arányosan kiszámítja az egyes felhasználók napi mennyiségét. Használat egy egész napra = 1 Fél napos használat = 0,5 Ezután összegzi a számlázási időszak összes napjára vonatkozó napi összegeket, hogy kiszámítsa az adott felhasználó teljes mennyiségét az adott számlázási időszakban. Ügyfél- és partnerszintű jelentések esetén az összes felhasználó összesített adatait összesítjük, hogy megkapjuk az adott ügyfél vagy partner teljes mennyiségét. Időpont: Az ügyféljelentés listázza az ügyfélenkénti csomagelosztásokat. Minden sor egy adott csomag teljes mennyiségét jelöli, amely egy adott ügyfélszervezeten belüli felhasználókhoz vagy munkaterületekhez van hozzárendelve. A Mennyiség „0” értéket mutat, ha nincsenek kiosztott csomagok. A felhasználói jelentés felsorolja a felhasználókhoz vagy munkaterületekhez rendelt csomagokat. Minden sor 1-es mennyiséget mutat, amely egy felhasználót vagy munkaterületet és az ahhoz tartozó egyedi csomagot vagy bővítményt jelöl. Ha egy felhasználóhoz vagy munkaterülethez több csomag vagy bővítmény van hozzárendelve, akkor a jelentés több bejegyzést jelenít meg, mindegyik mennyisége 1. |
PARTNER, ÜGYFÉL, FELHASZNÁLÓ |
Egyeztetés, időpont |
Kötelező |
|
HELYSZÍN_AZONOSÍTÓ |
Egyedi helyazonosító |
ÜGYFÉL, FELHASZNÁLÓ |
Egyeztetés, időpont Az Ügyfél Időpontjelentése nem tartalmazza a Helyszínazonosítót |
Opcionális |
|
LICENC_AZONOSÍTÓ |
Licencazonosító Ez a mező csak nagykereskedelmi csomagok esetén látható. Egyeztetési jelentés esetén az License_azonosító üres azoknál a licenceknél, amelyeket a mező bevezetése előtt rendeltek hozzá. A számlázási jelentés több sort jelenít meg ugyanahhoz a nagykereskedelmi csomaghoz, ha az a LOCATION_ID és a LICENSE_ID különböző kombinációihoz van társítva. |
ÜGYFÉL, FELHASZNÁLÓ |
Egyeztetés, időpont |
Opcionális |
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 azokra a partnerekre vonatkozik, akiknek az előfizetésében csak nagykereskedelmi SKU-k szerepelnek:
Felhasználói szintű jelentés—PARTNER_NEVE, PARTNER_SZERVEZET_AZONOSÍTÓ, ELŐFIZETÉS_AZONOSÍTÓ, ÜGYFÉL_CSOPORT_AZONOSÍTÓ, ÜGYFÉL_CSOPORT_NEVE, ÜGYFÉL_SZERVEZET_AZONOSÍTÓ, ÜGYFÉL_KÜLSŐ_AZONOSÍTÓ, HELYSZÍN_AZONOSÍTÓ, LICENSZ_AZONOSÍTÓ, ELŐFIZETŐ_AZONOSÍTÓ, FELHASZNÁLÓ_AZONOSÍTÓ, MUNKATÉR_AZONOSÍTÓ, SZOLGÁLTATÁS_NEVE, SKU, LEÍRÁS, FOGYASZTÁS_KEZDÉS_DÁTUM, FOGYASZTÁS_VÉGE_DÁTUM, MENNYISÉG
Ügyfél szintű jelentés—PARTNER_NEVE, PARTNER_SZERVEZET_AZONOSÍTÓ, ELŐFIZETÉS_AZONOSÍTÓ, ÜGYFÉL_CSOPORT_AZONOSÍTÓ, ÜGYFÉL_CSOPORT_NEVE, ÜGYFÉL_SZERVEZET_AZONOSÍTÓ, ÜGYFÉL_KÜLSŐ_AZONOSÍTÓ, HELYSZÍN_AZONOSÍTÓ, LICENSZ_AZONOSÍTÓ, SZOLGÁLTATÁS_NEVE, SKU, LEÍRÁS, FOGYASZTÁS_KEZDÉS_DÁTUM, FOGYASZTÁS_VÉGE_DÁTUM, MENNYISÉG
Egy csomag felhasználóhoz való kiépítése elindítja a Webex Wholesale számlázást, míg a csomag-hozzárendelés eltávolítása leállítja azt.
Egy ügyfélszervezet egyszerre csak egy ügyfélcsoporthoz tartozhat. Jelenleg nem érhető el több ügyfélcsoport támogatása szervezetenként.
