Laskutusraportit
Kumppanit voivat käyttää seuraavia tukkumyyntilaskutusohjelmointirajapintoja luodakseen laskutusraportteja , jotka auttavat heitä vahvistamaan käytön ja valmistelun tarkkuuden. Tukkulaskutuksen sovellusliittymiin pääsee osoitteesta developer.webex.com.
-
Täsmäytys — Näyttää käyttökulutuksen kumppani-, asiakas- tai käyttäjätasolla. Kumppanit voivat käyttää näitä mukautettuja laskutusraportti tietoja kuukausilaskunsa täsmäyttämiseen, jotta he voivat laskuttaa asiakka itaan ja käyttäjiä käyttökulutuksensa mukaan.
-
Point-In-Time — Näyttää nykyiset pakettivaraukset asiakas- tai käyttäjätasolla. Point-In-Time -raportti tarjoaa reaaliaikaisen pakettien allokoinnin laskennan. Kumppanit voivat käyttää näitä tietoja varmistaakseen toimituksen tarkkuuden ja varmistaakseen yhdenmukaisuuden asiakkaiden tilausten kanssa.
Kumppanit voivat myös luoda mukautettuja laskutusraportteja alikumppaneille käyttämällä SubpartnerOrgID-parametria.
Yhteistyökumppaneiden järjestelmänvalvojien käytettävissä on neljä sovellusliittymää, jotka täyttävät vähimmäis käyttövaatimukset.
|
Laskutussovellusliittymä |
API:n tarkoitus |
Kumppanin järjestelmänvalvojan käyttöoikeusvaatimus |
|---|---|---|
|
Tukkulaskutusraportin luominen |
Käytetään laskutusraportin luomiseen. |
Luku/kirjoita |
|
Hanki tukkumyyntiraportti |
Käytetään luodun laskutusraportin saamiseen ladattavaksi. |
Lukea |
|
Luettelo tukkukaupan laskutusraporteista |
Käytetään kyseiselle kumppanille olemassa olevien laskutusraporttien luettelointiin. |
Lukea |
|
Tukkulaskutusraportin poistaminen |
Käytetään olemassa olevan laskutusraportin poistamiseen. |
Luku/kirjoita |
Tietolähde
Laskutusraporttien tiedot kerätään pakettien määrityksistä ja käyttötiedoista, joita Webex seuraa kullekin kumppanille. Webex kokoaa asiakas- ja käyttäjäpakettitiedot päivittäin kumppanin kuukausilaskun luomiseksi. Laskutussovellusliittymät käyttävät näitä tietoja, jolloin kumppanin järjestelmänvalvojat voivat luoda mukautettuja raportteja. Nämä raportit auttavat kumppan eita yhdistämään kulutuksen kuukausilaskustaan kumppani-, asiakas- ja käyttäjätasolla.
Lisätietoja siitä, miten Webex las kuttaa kumppaneita, on kohdassa Palveluntarjoajan laskutus.
Luo tukkumyyntilaskutusraportti
| 1 |
Siirry developer.webex.com-sivustolta kohtaan Luo tukkumy yntiraportin sovellus liittymä. |
| 2 |
Valitse jokin seuraavista raporttiluokista:
Jos haluat luoda täsmäytysraportin, mitään ei tarvitse muuttaa, koska Sovittelu on oletusarvoisesti valittu, joten voit siirtyä seuraavaan vaiheeseen. Jos haluat luoda Point-In-Time -raportin, muuta valinta kohtaan Point-In-Time. |
| 3 |
Kirjoita BillingStartDate ja BillingEndDate sovellusliittymän määrittämään muotoon. Voit syöttää minkä tahansa päivämäärän viimeisten viiden vuoden ajalta, mutta et nykyistä päivää. Point-In-Time -raportissa BillingStartDate- ja Billing EndDate -kentät eivät ole pakollisia, ja ne jätetään huomiotta, jos ne syötetään. Raportti heijastaa aina nykyisiä pakettien määrä rahoja. |
| 4 |
Syötä raportin tyyppi:
|
| 5 |
Kirjoita Sisäl lytä-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ä valinnaiset määritteet näytetään kullekin raportille. Jos et sisällytä valinnaisia määritteitä, raportti näyttää vain pakolliset määritteet. Seuraavat sarakkeet ovat valinnaisia määritteitä, jotka voit pyytää sisällyttämään Asiakas- ja Käyttäjä-raporttiin:
Jos haluat nähdä nämä CUSTOMER_GROUP_ID määritteet raportissasi, sinun on sisällytettävä ne CUSTOMER_GROUP_NAME yhdessä. Kun valitset valinnaisia sarakkeita, Asiakkaan ja käyttäjän täsmäytys -raporttien sarakejärjestys muuttuu. Kumppaneiden on päivitettävä API-integraatio hyväksyäkseen uuden csv-muodon. Point-In-Time -raporttien sarakejärjestys pysyy muuttumattomana. Tällä hetkellä olemassa olevat ominaisuusasetukset ovat ensisijaisia Sisällytä-parametriin nähden sarakejärjestystä määritettäessä. Jos esimerkiksi tietty ominaisuusasetus on käytössä asiakkaalle, kyseinen ominaisuussarake näkyy vanhan raporttimuodon mukaisesti, vaikka lisäisit ne Sisällytä-parametriin. Poistamme nämä asetukset pian. Kun ne on poistettu, voit pyytää valinnaisia sarakkeita vain Sisällytä -parametrin kautta. |
| 6 |
Luo raportti valitsemalla Suorita. |
| 7 |
Kopioi raportin tunnus API-tulosteesta. Voit käyttää tätä arvoa Get-sovellusliittymän kanssa luodun laskutusraportin saamiseksi. |
Mitä tehdä seuraavaksi
Siirry Hanki tukkumyyntiraportti -osioon ladataksesi kopion raportista.
Hanki tukkumyyntilaskutusraportti
Kun laskutusraportti on luotu, käytä tätä sovellusliittymää tietyn laskutusraportin hankkimiseen. Raportti lähetetään URL-osoitteeseen, josta se on ladattavissa 30 minuutin ajan GET-pyynnön valmistumisen jälkeen.
| 1 |
Siirry developer.webex.com-sivustolta kohtaan Hanki tukkumy yntiraportti -sovell usliittymä. |
| 2 |
Anna raportin yksilöllinen tunn usarvo ja napsauta Suorita. API tulostaa raportin tilan. Tulos sisältää tempDownloadUrl- parametrin, joka tarjoaa URL-osoitteen, josta voit ladata raportin. |
| 3 |
Kopioi TempDownloadURL selaimeen päästäksesi raporttiin ja lataamiseksi. |
Luettelo tukkukaupan laskutusraportit
Tämän sovellusliittymän avulla voit hankkia luettelon kumppaniorganisaatiolle luoduista laskutusraporteista. Voit luetella kaikki olemassa olevat raportit tai rajoittaa luettelon raportteihin, jotka täyttävät määritetyt parametrit, kuten laskutuskausi ja laskutustyyppi (kumppani, asiakas, käyttäjä).
Jos annat valinnaisia parametreja, sovellusliittymä palauttaa vain ne raportit, jotka vastaavat täsmälleen määrittämiäsi parametreja. Jos esimerkiksi määrität laskutus kauden, vain kyseistä laskutuskautta käyttävät raportit palautetaan. Rap ortteja, jotka kuuluvat ajanjaksoon, mutta jotka eivät täsmää päivämääriä, ei palauteta.
| 1 |
Siirry developer.webex.com- sivustolta kohtaan List Wholesale Billing Report -sovellusliitty mä. |
| 2 |
Kirjoita Kyselyn parametrit -kohtaan haluamasi haku parametrit (esimerkiksi aloituspäivämäärä, päättymispäivämäärä, tyyppi, lajittelu käytössä). |
| 3 |
Valitse Suorita. API tuottaa raporttiluettelon sekä yksilöllisen raportin tunn uksen ja tilan (VALMIS,IN_PROGRESS).
|
Mitä tehdä seuraavaksi
Tallenna kaikkien ladattavien raporttien tunnus. Lataa raportti siirtymällä Hanki tukkumy yntiraportti -kohtaan.
Tukkumyyntilaskutusraportin poistaminen
Tämän toimenpiteen avulla voit poistaa raportin tunnuksen perusteella luodun laskutusraportin. Muutamia esimerkkejä raportin poistamisesta ovat seuraavat:
-
Jos haluat luoda uudelleen olemassa olevan täsmäytyslaskutusraportin, sinun on ensin poistettava olemassa oleva raportti. Kun olet poistanut aiemmin luodun raportin, voit luoda uuden raportin kyseiselle ajanjaksolle. Et voi poistaa raporttia, jos sen luom inen on epäonnistunut tai se on vielä kesken.
Point-In-Time -raporttia varten sinun ei tarvitse poistaa olemassa olevaa raporttia, koska järjestelmä ei luo näitä raportteja uudelleen. Jokainen raportti heijastaa aina tietoja nykyisestä aikaleimasta lähtien.
-
Jos lähetät luodun raportin URL-osoitteen väärälle henkilölle, voit poistaa raportin, jotta he eivät pääse siihen.
| 1 |
Siirry developer.webex.com-sivustolta kohtaan Poista tukkumyyn tiraportin sovellusliittymä. |
| 2 |
Anna raportin tunnus ja napsauta Suorita. |
Laskutusraportin kentät
Laskutusraportit sisältävät seuraavat kentät:
|
Kenttä |
Kuvaus |
Tuettu raporttityyppi |
Tuettu raporttiluokka |
Pakollinen tai Valinnainen määrite |
|---|---|---|---|---|
|
PARTNER_NAME |
Kumppanin nimi |
PARTNER, CUSTOMER, USER |
Sovittelu, aikapisteet |
Pakollinen |
|
PARTNER_ORG_ID |
Yksilöllinen kumppanitunnus |
PARTNER, CUSTOMER, USER |
Sovittelu, aikapisteet |
Pakollinen |
|
SUBSCRIPTION_ID |
Yksilöllinen tilaustunnus |
PARTNER, CUSTOMER, USER |
Sovittelu, aikapisteet |
Pakollinen |
|
CUSTOMER_GROUP_ID | Asiakkaan ryhmän yksilöllinen tunniste. Jos asiakas siirretään ryhmien välillä laskutuskauden aikana, käyttö jaetaan niiden ryhmien mukaan, joihin asiakas kuului kyseisenä ajanjaksona. |
CUSTOMER, USER |
Sovittelu, aikapisteet |
Valinnainen |
|
CUSTOMER_GROUP_NAME | Asiakasryhmän näyttönimi. Jos ryhmän nimi muuttui laskutuskauden aikana, käytetään viimeisintä nimeä. |
CUSTOMER, USER |
Sovittelu, aikapisteet |
Valinnainen |
|
CUSTOMER_ORG_ID |
Sisäinen asiakkaan yksilöllinen tunniste |
CUSTOMER, USER |
Sovittelu, aikapisteet |
Pakollinen |
|
CUSTOMER_EXTERNAL_ID |
Asiakkaan yksilöllinen tunniste kumppanin antama |
CUSTOMER, USER |
Sovittelu, aikapisteet |
Pakollinen |
|
TYPE |
Käyttäjä- tai työtilatyyppi |
CUSTOMER, USER |
Point-in-Time |
Pakollinen |
|
SUBSCRIBER_ID |
Tilaajan yksilöllinen tunniste |
USER |
Sovittelu, aikapisteet |
Pakollinen |
|
USER_ID |
Tilaajan Webex-käyttäjätunnus |
USER |
Sovittelu, aikapisteet |
Pakollinen |
|
WORKSPACE_ID |
Yksilöllinen työtilan tunniste |
USER |
Sovittelu, aikapisteet |
Pakollinen |
|
SERVICE_NAME |
Palvelun nimi (esim.,COMMON_AREA_CALLING,WEBEX_CALLING,WEBEX_SUITE,WEBEX_MEETINGS) |
PARTNER, CUSTOMER, USER |
Sovittelu, aikapisteet |
Pakollinen |
|
SKU |
Sku palvelulle |
PARTNER, CUSTOMER, USER |
Sovittelu, aikapisteet |
Pakollinen |
|
DESCRIPTION |
Palvelun kuvaus |
PARTNER, CUSTOMER, USER |
Sovittelu, aikapisteet |
Pakollinen |
|
CONSUMPTION_START_DATE |
Palvelun kulutuksen alkaminen. Seuraavan kentän ohella tämä arvo määrittää käyttöajan. |
PARTNER, CUSTOMER, USER |
Sovittelu |
Pakollinen |
|
CONSUMPTION_END_DATE |
Palvelun kulutuksen loppu. Edellisen kentän ohella tämä arvo määrittää käyttökulutusjakson. |
PARTNER, CUSTOMER, USER |
Sovittelu |
Pakollinen |
|
REPORT_DATE |
Päivämäärä ja kellonaika, jolloin raportti luodaan. |
CUSTOMER, USER |
Point-in-Time |
Pakollinen |
|
QUANTITY |
Edustaa käyttäjien yhteenlaskettua kulutusta kumppania, asiakasta tai käyttäjää kohden (riippuen raportista ja tasosta, jolla tietoja tarkastellaan). Laskenta: Järjestelmä laskee kunkin käyttäjän päiväkohtaisen määrän suhteellisesti kyseiselle päivälle. Koko päivän käyttö = 1 Käyttö puolen päivän ajan = 0,5 Sitten se summaa kaikkien laskutuskauden päivien päiväkohtaiset kokonaissummat laskuttaakseen kyseisen käyttäjän kokonaismäärän kyseisellä laskutuskaudella. Asiakas- ja kumppanitason raporteissa kaikkien käyttäjien kokonaissummat kootaan yhteen, jotta saadaan kyseisen asiakkaan tai kumppanin kokonaismäärä. Point-In-Time: Asiakasraportissa luetellaan pakettien allokaatiot asiakasta kohden. Jokainen rivi edustaa tietyn asiakasorganisaation käyttäjille tai työtiloille määritetyn paketin kokonaismäärää. Määrä näyttää ”0", jos paketteja ei ole varattu. Käyttäjäraportissa luetellaan 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ä pakettia tai lisäosaa. Jos käyttäjälle tai työtilalle on osoitettu useita paketteja tai lisäosia, raportti näyttää useita merkintöjä, joista jokaisella on määrä 1. |
PARTNER, CUSTOMER, USER |
Sovittelu, aikapisteet |
Pakollinen |
|
LOCATION_ID |
Yksilöllinen sijaintitunniste |
CUSTOMER, USER |
Sovittelu, aikapisteet Asiakkaan aikapiste-raportti ei sisällä sijaintitunnusta |
Valinnainen |
|
LICENSE_ID |
Lisenssin tunniste Tämä kenttä näkyy vain tukkumyyntipaketeissa Täsmäytysraportissa merkintä License_ID on tyhjä ennen tämän kentän käyttöönottoa määritetyille käyttöoikeuksille. Laskutusraportti näyttää useita rivejä samalle tukkumyyntipaketille, jos se on liitetty eri yhdistel LOCATION_ID miin jaLICENSE_ID. |
CUSTOMER, USER |
Sovittelu, aikapisteet |
Valinnainen |
Valinnaisten sarakkeiden valitseminen muuttaa Asiakas- ja Käyttäjien täsmäytysraporttien sarakejärjestystä. Seuraava tilaus koskee kumppaneita, joiden tilauksessa on vain tukkukaupan SKU:t:
Käyttäjätason raportti— 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_IDSERVICE_NAME, SKU, KUVAUS,CONSUMPTION_START_DATE,CONSUMPTION_END_DATE, MÄÄRÄ
Asiakastason raportti— PARTNER_NAMEPARTNER_ORG_ID,SUBSCRIPTION_ID,CUSTOMER_GROUP_ID,CUSTOMER_GROUP_NAME,CUSTOMER_ORG_ID,CUSTOMER_EXTERNAL_ID,LOCATION_ID,LICENSE_ID,SERVICE_NAME, SKU, KUVAUS,CONSUMPTION_START_DATE,CONSUMPTION_END_DATE, MÄÄRÄ
Paketin tarjoaminen käyttäjälle käynnistää Webex Wholesale -laskutuksen, kun taas pakettimäärityksen poistaminen pysäyttää sen.
Asiakasorganisaatio voi kuulua vain yhteen asiakasryhmään kerrallaan. Useiden asiakasryhmien tuki organisaatiota kohti ei ole tällä hetkellä käytettävissä.