Nagykereskedelmi útvonal-piac számlázási jelentések
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 |
Kattintson a Futtatás gombra a jelentés létrehozásához. |
| 6 |
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 |
|---|---|---|---|
|
PARTNER_NEVE |
Partner neve |
PARTNER, ÜGYFÉL, FELHASZNÁLÓ |
Egyeztetés, időpont |
|
PARTNER_SZERV_AZONOSÍTÓ |
Egyedi partnerazonosító |
PARTNER, ÜGYFÉL, FELHASZNÁLÓ |
Egyeztetés, időpont |
|
ELŐFIZETÉS_AZONOSÍTÓ |
Egyedi előfizetés-azonosító |
PARTNER, ÜGYFÉL, FELHASZNÁLÓ |
Egyeztetés, időpont |
|
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 |
|
SKU |
A szolgáltatáshoz tartozó SKU |
PARTNER, ÜGYFÉL, FELHASZNÁLÓ |
Egyeztetés, időpont |
|
LEÍRÁS |
A szolgáltatás leírása |
PARTNER, ÜGYFÉL, FELHASZNÁLÓ |
Egyeztetés, időpont |
|
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 |
|
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 fogyasztási időszakot. |
PARTNER, ÜGYFÉL, FELHASZNÁLÓ |
Egyeztetés |
|
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, mindegyikben egy mennyiséggel 1. |
PARTNER, ÜGYFÉL, FELHASZNÁLÓ |
Egyeztetés, időpont |
|
ÜGYFÉL_SZERVEZET_AZONOSÍTÓ |
Belső ügyfél egyedi azonosítója |
ÜGYFÉL, FELHASZNÁLÓ |
Egyeztetés, időpont |
|
ÜGYFÉL_KÜLSŐ_AZONOSÍTÓ |
Egy partner által megadott egyedi ügyfélazonosító |
ÜGYFÉL, FELHASZNÁLÓ |
Egyeztetés, időpont |
|
ELŐFIZETŐ_AZONOSÍTÓ |
Az előfizető egyedi azonosítója |
FELHASZNÁLÓ |
Egyeztetés, időpont |
|
FELHASZNÁLÓI AZONOSÍTÓ_ |
Az előfizető Webex felhasználói azonosítója |
FELHASZNÁLÓ |
Egyeztetés, időpont |
|
MUNKATÉR_AZONOSÍTÓ |
Egyedi munkaterület-azonosító |
FELHASZNÁLÓ |
Egyeztetés, időpont |
|
HELYSZÍN_AZONOSÍTÓ |
Egyedi helyazonosító |
ÜGYFÉL, FELHASZNÁLÓ |
Egyeztetés, időpont |
|
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őpontban |
|
JELENTÉS_DÁTUM |
A jelentés létrehozásának dátuma és időpontja. |
ÜGYFÉL, FELHASZNÁLÓ |
Időpont |
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.