Kiitos palautteestasi.
Onko sinulla palautetta?Laskutusraportit
Kumppanit voivat käyttää seuraavia tukkulaskutusrajapintoja luodakseen laskutusraportteja, jotka auttavat heitä validoimaan käytön ja tarjoamisen tarkkuutta. Tukkulaskutusrajapinnat ovat käytettävissä osoitteessa developer.webex.com.
-
Täsmäytys – Näyttää käytön kumppani-, asiakas- tai käyttäjätasolla. Kumppanit voivat käyttää tätä mukautettua laskutusraporttitietoa kuukausittaisen laskunsa täsmäyttämiseen, jotta he voivat laskuttaa asiakkaitaan ja käyttäjiään heidän käytön mukaan.
-
Ajankohta – Näyttää nykyiset pakettien allokoinnit asiakas- tai käyttäjätasolla. Ajankohtainen raportti näyttää reaaliaikaisen määrän pakettien allokoinneista. Kumppanit voivat käyttää näitä tietoja varmistaakseen valmistelun tarkkuuden ja yhdenmukaisuuden asiakastilausten kanssa.
Kumppanit voivat myös luoda mukautettuja laskutusraportteja alikumppaneille käyttämällä subPartnerOrgId-parametria.
Kumppanijärjestelmänvalvojille, jotka täyttävät vähimmäiskäyttöoikeusvaatimukset, on käytettävissä neljä API:a.
|
Laskutusrajapinta |
API:n tarkoitus |
Kumppanin järjestelmänvalvojan käyttöoikeusvaatimus |
|---|---|---|
|
Luo tukkulaskutusraportti |
Käytetään laskutusraportin luomiseen. |
Read/write |
|
Hanki tukkulaskutusraportti |
Käytetään luodun laskutusraportin lataamiseen. |
Lue |
|
Listaa tukkulaskutusraportit |
Käytetään listaamaan kyseiselle kumppanille olemassa olevat laskutusraportit. |
Lue |
|
Tukkulaskutusraportin poistaminen |
Käytetään olemassa olevan laskutusraportin poistamiseen. |
Read/write |
Tietolähde
Laskutusraporttien tiedot haetaan pakettien määrityksistä ja käyttötiedoista, joita Webex seuraa kullekin kumppanille. Webex kokoaa asiakkaan ja käyttäjän pakettitiedot päivittäin luodakseen kumppanin kuukausittaisen laskun. Laskutus-APIt käyttävät näitä tietoja, joiden avulla kumppanijärjestelmänvalvojat voivat luoda mukautettuja raportteja. Nämä raportit auttavat kumppaneita täsmäyttämään kuukausittaisen laskunsa käytön kumppani-, asiakas- ja käyttäjätasolla.
Tarkempia tietoja Webexin laskutustavoista on kohdassa Palveluntarjoajan laskutus.
Luo tukkulaskutusraportti
| 1 |
Siirry osoitteesta developer.webex.comkohtaan Luo tukkulaskutusraportin API. |
| 2 |
Valitse jokin seuraavista raporttiluokista:
Jos haluat luoda täsmäytysraportin, sinun ei tarvitse muuttaa mitään, koska täsmäytys on valittuna oletusarvoisesti, joten voit siirtyä seuraavaan vaiheeseen. Jos haluat luoda ajankohtaraportin, muuta valinta ajankohtaiseksi. |
| 3 |
Syötä billingStartDate ja billingEndDate API:n määrittämässä muodossa. Voit syöttää minkä tahansa päivämäärän viimeisen viiden vuoden ajalta, mutta et nykyistä päivää. Ajankohtaraportissa kentät billingStartDate ja billingEndDate eivät ole pakollisia, ja ne ohitetaan, jos ne täytetään. Raportti heijastaa aina pakettien nykyistä allokointia. |
| 4 |
Anna raportin tyyppi :
|
| 5 |
Kirjoita Sisällytä -kenttään lisä- tai valinnaiset sarakkeet, jotka haluat nähdä raporteissa. Jokaisella raporttityypillä on joukko pakollisia määritteitä ja joukko valinnaisia määritteitä. Voit päättää, mitkä valinnaisista määritteistä näytetään kussakin raportissa. Jos et sisällytä valinnaisia määritteitä, raportti näyttää vain pakolliset määritteet. Seuraavat sarakkeet ovat valinnaisia määritteitä, jotka voit pyytää sisällytettäväksi asiakas- ja käyttäjäraporttiin:
Sinun on sisällytettävä ASIAKAS_RYHMÄ_ID ja ASIAKAS_RYHMÄ_NIMI yhdessä, jos haluat nähdä nämä määritteet raportissasi. Kun valitset valinnaisia sarakkeita, sarakejärjestys asiakas- ja käyttäjätäsmäytysraporteissa muuttuu. Kumppaneiden on päivitettävä API-integraationsa hyväksyäkseen uuden csv-muodon. Ajankohtaisten raporttien sarakejärjestys pysyy muuttumattomana. Tällä hetkellä olemassa olevat ominaisuusasetukset ovat etusijalla Sisällytä-parametriin nähden sarakejärjestystä määritettäessä. Jos esimerkiksi tietty ominaisuusasetus on otettu käyttöön asiakkaalle, kyseinen ominaisuussarake näkyy vanhan raporttimuodon mukaisesti, vaikka lisäisit sen Sisällytä-parametriin. Poistamme nämä asetukset pian. Kun ne on poistettu, voit pyytää valinnaisia sarakkeita vain Sisällytä-parametrin kautta. |
| 6 |
Luo raportti napsauttamalla Suorita. |
| 7 |
Kopioi raportin id API-tulosteesta. Voit käyttää tätä arvoa Get API:n kanssa saadaksesi luodun laskutusraportin. |
Mitä tehdä seuraavaksi
Lataa raportti siirtymällä osioon Hanki tukkulaskutusraportti.
Hanki tukkulaskutusraportti
Kun laskutusraportti on luotu, voit hankkia tietyn laskutusraportin tämän API:n avulla. Raportti lähetetään URL-osoitteeseen, josta se on ladattavissa 30 minuuttia GET-pyynnön valmistumisen jälkeen.
| 1 |
Siirry osoitteesta developer.webex.comkohtaan Hanki tukkulaskutusraportin API. |
| 2 |
Syötä raportin yksilöllinen id -arvo ja napsauta Suorita. API-rajapinta raportoi tilan. Tuloste sisältää tempDownloadURL -parametrin, joka antaa URL-osoitteen, josta voit ladata raportin. |
| 3 |
Kopioi tempDownloadURL selaimeen käyttääksesi raporttia ja ladataksesi sen. |
Listaa tukkulaskutusraportit
Käytä tätä API:a saadaksesi luettelon kumppaniorganisaation luomista laskutusraporteista. Voit listata kaikki olemassa olevat raportit tai rajata listan raportteihin, jotka täyttävät määritetyt parametrit, kuten laskutusjakson ja laskutustyypin (kumppani, asiakas, käyttäjä).
Jos syötät valinnaisia parametreja, API palauttaa vain ne raportit, jotka vastaavat täsmälleen määrittämiäsi parametreja. Jos esimerkiksi määrität laskutusjakson, palautetaan vain raportit, jotka käyttävät kyseistä laskutusjaksoa. Raportteja, jotka osuvat ajanjaksoon, mutta eivät täsmälleen vastaa päivämääriä, ei palauteta.
| 1 |
Siirry osoitteesta developer.webex.comkohtaan List Wholesale Billing Report API. |
| 2 |
Kirjoita kohtaan Kyselyparametrithaluamasi hakuparametrit (esimerkiksi aloituspäivämäärä, päättymispäivämäärä, tyyppi tai lajitteluperuste). |
| 3 |
Napsauta Suorita. API tuottaa luettelon raporteista sekä yksilöllisen raportin tunnuksen ja tilan (VALMIS, KÄYNNISSÄ_).
|
Mitä tehdä seuraavaksi
Kirjaa muistiin kaikkien ladattavien raporttien id -tunnus. Lataa raportti kohdasta Hanki tukkulaskutusraportti.
Tukkulaskutusraportin poistaminen
Tämän toimenpiteen avulla voit poistaa luodun laskutusraportin raporttitunnuksen perusteella. Joitakin esimerkkejä tilanteista, joissa haluat ehkä poistaa raportin:
-
Jos haluat luoda uudelleen olemassa olevan täsmäytyslaskutusraportin, sinun on ensin poistettava olemassa oleva raportti. Kun olet poistanut olemassa olevan raportin, voit luoda uuden raportin kyseiselle ajanjaksolle. Et voi poistaa raporttia, jos sen luominen on epäonnistunut tai on vielä kesken.
Ajankohtaraportin tapauksessa sinun ei tarvitse poistaa olemassa olevaa raporttia, koska järjestelmä ei luo näitä raportteja uudelleen. Jokainen raportti heijastaa aina tietoja nykyisen aikaleiman mukaisesti.
-
Jos lähetät luodun raportin URL-osoitteen väärälle henkilölle, voit poistaa raportin, jotta he eivät voi käyttää sitä.
| 1 |
Siirry osoitteesta developer.webex.comkohtaan Poista tukkulaskutusraportin API. |
| 2 |
Syötä raportin tunnus ja napsauta Suorita. |
Laskutusraportin kentät
Laskutusraportit sisältävät seuraavat kentät:
|
Kenttä |
Kuvaus |
Tuettu raporttityyppi |
Tuettu raporttikategoria |
Pakollinen tai valinnainen ominaisuus |
|---|---|---|---|---|
|
KUMPPANIN_NIMI |
Kumppanin nimi |
KUMPPANIA, ASIAKAS, KÄYTTÄJÄ |
Täsmäytys, ajankohta |
Pakollinen |
|
KUMPPANIN_ORG_ID |
Yksilöllinen kumppanin tunniste |
KUMPPANIA, ASIAKAS, KÄYTTÄJÄ |
Täsmäytys, ajankohta |
Pakollinen |
|
TILAUKSEN_ID |
Yksilöllinen tilaustunniste |
KUMPPANIA, ASIAKAS, KÄYTTÄJÄ |
Täsmäytys, ajankohta |
Pakollinen |
|
ASIAKAS_RYHMÄ_TUNNUS | Asiakkaan ryhmän yksilöllinen tunniste. Jos asiakasta siirretään ryhmien välillä laskutuskauden aikana, käyttö jaetaan sen mukaan, mihin ryhmiin asiakas kuului kyseisenä aikana. |
ASIAKAS, KÄYTTÄJÄ |
Täsmäytys, ajankohta |
Valinnainen |
|
ASIAKAS_RYHMÄ_NIMI | Asiakasryhmän näyttönimi. Jos ryhmän nimi muuttui laskutuskauden aikana, käytetään viimeisintä nimeä. |
ASIAKAS, KÄYTTÄJÄ |
Täsmäytys, ajankohta |
Valinnainen |
|
ASIAKAS_ORG_ID |
Sisäinen asiakkaan yksilöllinen tunniste |
ASIAKAS, KÄYTTÄJÄ |
Täsmäytys, ajankohta |
Pakollinen |
|
ASIAKAS_ULKOINEN_TUNNUS |
Kumppanin toimittama asiakkaan yksilöllinen tunniste |
ASIAKAS, KÄYTTÄJÄ |
Täsmäytys, ajankohta |
Pakollinen |
|
TYYPPI |
Käyttäjä- tai työtilan tyyppi |
ASIAKAS, KÄYTTÄJÄ |
Ajankohta |
Pakollinen |
|
TILAAJAN_TUNNUS |
Tilaajan yksilöllinen tunniste |
KÄYTTÄJÄ |
Täsmäytys, ajankohta |
Pakollinen |
|
KÄYTTÄJÄN_TUNNUS |
Tilaajan Webex-käyttäjätunnus |
KÄYTTÄJÄ |
Täsmäytys, ajankohta |
Pakollinen |
|
TYÖTILA_ID |
Yksilöllinen työtilan tunniste |
KÄYTTÄJÄ |
Täsmäytys, ajankohta |
Pakollinen |
|
PALVELUN_NIMI |
Palvelun nimi (esim. YHTEINEN_ALUE_SOITTO, WEBEX_SOITTO, WEBEX_HUONEISTO, WEBEX_KOKOUKSET) |
KUMPPANIA, ASIAKAS, KÄYTTÄJÄ |
Täsmäytys, ajankohta |
Pakollinen |
|
Tuotekoodi |
Palvelun SKU |
KUMPPANIA, ASIAKAS, KÄYTTÄJÄ |
Täsmäytys, ajankohta |
Pakollinen |
|
KUVAUS |
Palvelun kuvaus |
KUMPPANIA, ASIAKAS, KÄYTTÄJÄ |
Täsmäytys, ajankohta |
Pakollinen |
|
KULUTUS_ALKAMISAIKA_ |
Palvelun kulutuksen alku. Seuraavan kentän ohella tämä arvo määrittää käyttöjakson. |
KUMPPANIA, ASIAKAS, KÄYTTÄJÄ |
Sovinnon |
Pakollinen |
|
KULUTUS_PÄÄTTYMISPÄIVÄ_ |
Palvelun kulutuksen loppu. Edellisen kentän ohella tämä arvo määrittää käyttökulutusjakson. |
KUMPPANIA, ASIAKAS, KÄYTTÄJÄ |
Sovinnon |
Pakollinen |
|
RAPORTTI_PÄIVÄMÄÄRÄ |
Raportin luontipäivämäärä ja -kellonaika. |
ASIAKAS, KÄYTTÄJÄ |
Ajankohta |
Pakollinen |
|
MÄÄRÄ |
Edustaa käyttäjien yhteenlaskettua kulutusta kumppania, asiakasta tai käyttäjää kohden (riippuen raportista ja tasosta, jolla tietoja tarkastellaan). Laskeminen: Järjestelmä laskee kunkin käyttäjän päiväkohtaisen määrän suhteellisesti kyseiselle päivälle. Käyttö koko päivän ajan = 1 Käyttöaika puoli päivää = 0,5 Sitten se laskee yhteen kaikkien laskutuskauden päivien päiväkohtaiset kokonaismäärät laskeakseen kyseisen käyttäjän kokonaismäärän kyseisellä laskutuskaudella. Asiakas- ja kumppanitason raporteissa kaikkien käyttäjien kokonaissummat yhdistetään, jolloin saadaan kyseisen asiakkaan tai kumppanin kokonaismäärä. Ajankohta: Asiakasraportti listaa pakettien kohdentamisen asiakaskohtaisesti. Jokainen rivi edustaa tietyn asiakasorganisaation käyttäjille tai työtiloille määritetyn tietyn paketin kokonaismäärää. Määränä näkyy ”0”, jos paketteja ei ole allokoitu. Käyttäjäraportti listaa käyttäjille tai työtiloille määritetyt paketit. Jokaisella rivillä näkyy määrä 1, joka edustaa käyttäjää tai työtilaa ja heidän yksittäistä pakettiaan tai lisäosaansa. Jos käyttäjälle tai työtilalle on varattu useita paketteja tai lisäosia, raportissa näkyy useita merkintöjä, joiden määrä on 1. |
KUMPPANIA, ASIAKAS, KÄYTTÄJÄ |
Täsmäytys, ajankohta |
Pakollinen |
|
SIJAINTI_ID |
Yksilöllinen sijaintitunniste |
ASIAKAS, KÄYTTÄJÄ |
Täsmäytys, ajankohta Asiakkaan ajankohtaraportti ei sisällä sijaintitunnusta |
Valinnainen |
|
LISENSSI_TUNNUS |
Lisenssitunniste Tämä kenttä näkyy vain tukkumyyntipaketeille Täsmäytysraportissa License_ID on tyhjä lisensseille, jotka on myönnetty ennen tämän kentän käyttöönottoa. Laskutusraportissa näkyy useita rivejä samalle tukkumyyntipaketille, jos se on liitetty eri LOCATION_ID- ja LICENSE_ID -yhdistelmiin. |
ASIAKAS, KÄYTTÄJÄ |
Täsmäytys, ajankohta |
Valinnainen |
Valinnaisten sarakkeiden valitseminen muuttaa asiakas- ja käyttäjäkohtaisten täsmäytysraporttien sarakejärjestystä. Seuraava järjestys koskee kumppaneita, joiden tilauksessa on vain tukkumyynti-SKU:ita:
Käyttäjätason raportti – KUMPPANIN_NIMI, KUMPPANIN_ORGANISAATION_TUNNUS, TILAUKSEN_TUNNUS, ASIAKAS_RYHMÄ_TUNNUS, ASIAKAS_RYHMÄ_NIMI, ASIAKAS_ORGANISAATION_TUNNUS, ASIAKAS_ULKOINEN_TUNNUS, SIJAINTI_TUNNUS, LISENSSI_TUNNUS, TILAAJAN_TUNNUS, KÄYTTÄJÄN_TUNNUS, TYÖTILAN_TUNNUS, PALVELU_NIMI, SKU, KUVAUS, KULUTUS_ALKUPÄIVÄ_, KULUTUS_PÄÄTTYMISPÄIVÄ_, MÄÄRÄ
Asiakastason raportti – KUMPPANIN_NIMI, KUMPPANIN_ORG_ID, TILAUKSEN_ID, ASIAKAS_RYHMÄ_ID, ASIAKAS_RYHMÄ_NIMI, ASIAKAS_ORG_ID, ASIAKAS_ULKOINEN_ID, SIJAINTI_ID, LISENSSI_ID, PALVELU_NIMI, SKU, KUVAUS, KULUTUS_ALKUPÄIVÄ_, KULUTUS_PÄÄTTYMISPÄIVÄ_, MÄÄRÄ
Paketin toimittaminen käyttäjälle käynnistää Webex Wholesale -laskutuksen, kun taas paketin määrityksen poistaminen pysäyttää sen.
Asiakasorganisaatio voi kuulua vain yhteen asiakasryhmään kerrallaan. Useiden asiakasryhmien tuki organisaatiota kohden ei ole tällä hetkellä saatavilla.
