Hvala na povratnim informacijama.
Želite li poslati povratne informacije?Izvješća o naplati
Partneri mogu koristiti sljedeće API-je za naplatu na veliko kako bi generirali izvješća o naplati koja im pomažu u potvrđivanju točnosti korištenja i pružanja usluga. API-ji za naplatu na veliko dostup ni su putem developer.webex.com.
-
Usklađivanje — prikazuje potrošnju korištenja po partneru, kupcu ili razini po korisniku. Partneri mogu koristiti ove prilagođene podatke o izvještaju o naplatu kako bi uskladili svoj mjesečni račun kako bi mogli naplatiti svojim kupcima i korisnicima u skladu s potrošnjom korištenja.
-
Točka u vremenu — prikazuje trenutne dodjele paketa po klijentu ili razini po korisniku. Izvješće Point-In-Time pruža broj dodjele paketa u stvarnom vremenu. Partneri mogu koristiti ove podatke kako bi potvrdili točnost pružanja usluga i osigurali usklađivanje s narudžbama kupaca.
Partneri također mogu generirati prilagođena izvješća o naplati za podpartnere pomoću parametra SubPartnerOrgid.
Postoje četiri API-ja koja su dostupna partnerskim administratorima koji ispunjavaju minimalne zaht jeve pristupa.
|
API za naplatu |
Svrha API-ja |
Zahtjev za pristup administratoru partnera |
|---|---|---|
|
Napravite izvješće o naplatama na veliko |
Koristi se za generiranje izvješća o naplati. |
Čitanje/pisanje |
|
Nabavite izvješće o naplatama na veliko |
Koristi se za dobivanje generiranog izvješća o naplati za preuzimanje. |
Pročitaj |
|
Popis veleprodajnih izvještaja o naplati |
Koristi se za popis izvješća o naplati koja postoje za tog partnera. |
Pročitaj |
|
Brisanje izvješća o naplatama na veliko |
Koristi se za brisanje postojećeg izvješća o naplati. |
Čitanje/pisanje |
Izvor podataka
Podaci za izvješća o naplati izvlače se iz dodjele paketa i podataka o upotrebi koje Webex prati za svakog partnera. Webex svakodnevno objedinjuje podatke o kupcima i korisničkim paketima kako bi generirao mjesečnu fakturu partnera. API-ji za naplatu koriste te podatke, omogućujući partnerskim administratorima generiranje prilagođenih izvješća. Ova izvješća pomažu partnerima da usklade potrošnju korištenja sa svoje mjesečne fakture na razini partnera, kup ca i korisnika.
Detaljnije informacije o tome kako Webex izdaje računa partnerima potražite u odjeljku Naplata davatel ja usluga.
Izrada izvješća o naplatama na veliko
| 1 |
S developer.webex.com idite na Izrada API-ja izvješća o naplatama na veliko. |
| 2 |
Odaberite bilo koju od sljedećih kategorija izvješća:
Ako želite generirati izvješće o pomirenju, nema potrebe ništa mijenjati jer je pomirenje odabrano prema zadanim postavkama, tako da možete prijeći na sljedeći korak. Ako želite generirati izvješće o točki u vremenu, promijenite odabir u Point-In-Time. |
| 3 |
Unesite billingStartDate i BillingEndDate u formatu koji API navodi. Možete unijeti bilo koji datum iz posljednjih pet godina, ali ne i trenutni dan. Za izvješće Point-In-Time polja BillingStartDate i BillingEndDate nisu obavezna i zanemaruju se ako se unesu. Izvješće uvijek odražava trenutne dodjele paketa. |
| 4 |
Unesite vrstu izvješća:
|
| 5 |
U polje U klju či unesite dodatne ili neobavezne stupce koje želite vidjeti u izvješćima. Svaka vrsta izvješća ima skup obveznih atributa i skup neobaveznih atributa. Možete odlučiti koji će se od opcionalnih atributa prikazati za svako izvješće. Ako ne uključite dodatne atribute, izvješće prikazuje samo obvezne atribute. Sljedeći stupci su izborni atributi za koje možete zatražiti uključivanje u izvješće o kupcu i korisniku:
Morate uključiti CUSTOMER_GROUP_ID i CUSTOMER_GROUP_NAME zajedno ako želite vidjeti ove atribute u svom izvješću. Kada odaberete neobavezne stupce, redoslijed stupaca u izvješćima o usklađivanju korisnika i korisnika se mijenja. Partneri moraju ažurirati svoju API integraciju kako bi prihvatili novi csv format. Redoslijed stupaca izvještaja Point-In-Time ostaje nepromijenjen. Trenutno postojeće postavke značajki imaju prednost nad parametrom Uključi prilikom određivanja redoslijeda stupaca. Na primjer, ako je određena postavka značajke omogućena za kupca, tada se taj stupac značajki pojavljuje prema starom formatu izvješća čak i ako ih dodate u parametar Uključi. Uskoro ćemo ukloniti ove postavke. Nakon što se uklone, možete zatražiti dodatne stupce samo putem parametra Uključi. |
| 6 |
Kliknite Pok reni da biste generirali izvješće. |
| 7 |
Kopirajte id izvješća iz API-ja izlaza. Ovu vrijednost možete upotrijebiti pomoću API-ja Get da biste dobili generirano izvješće o naplati. |
Što učiniti sljedeće
Idite na odjeljak Nabavite izvješće o na platama na veliko da biste preuzeli kopiju izvješća.
Nabavite izvješće o naplatama na veliko
Nakon što se generira izvješće o naplati, upotrijebite ovaj API za dobivanje određenog izvješća o naplatu. Izvješće dobiva izlaz na URL gdje je dostupan za preuzimanje 30 minuta nakon završetka GET zahtjeva.
| 1 |
S developer.webex.com idite na Nabavite API izvješća o naplatama na veliko. |
| 2 |
Unesite jedinstvenu vrijednost id za izvješće i kliknite Pok reni. API daje status izvješća. Izlaz uključuje parametar tempDownloadURL koji pruža URL s kojeg možete preuzeti izvješće. |
| 3 |
Kopirajte T empDownloadURL u preglednik da biste pristupili izvješću i preuzeli ga. |
Popis izvještaja o naplatama na veliko
Upotrijebite ovaj API za dobivanje popisa generiranih izvješća o naplati za partnersku organizaciju. Možete navesti sva postojeća izvješća ili ograničiti popis na ona izvješća koja zadovoljavaju navedene parametre kao što su razdoblje naplate i vrsta naplate (partner, kupac, korisnik).
Ako unesete opcionalne parametre, API vraća samo ona izvješća koja točno odgovaraju parametrima koje ste naveli. Na primjer, ako odredite razdoblje naplate, vraćaju se samo izvješća koja koriste to određeno razdoblje naplate. Izv ješća koja spadaju u razdoblje, ali koja se ne podudaraju točno s datumima, ne vraćaju se.
| 1 |
S developer.webex.com idite na API popisa veleprodajnih izvještaja o naplat ama. |
| 2 |
U od jeljku Parametri up ita unesite sve parametre pretraživanja koje želite koristiti (na primjer, startDate, EndDate, Type, SortBy). |
| 3 |
Kliknite Pokreni. API daje popis izvješća zajedno s jedinstvenim ID- om izvješća i statusom (ZAVRŠENO,IN_PROGRESS).
|
Što učiniti sljedeće
Zabilježite ID za sva izvješća koja želite preuzeti. Idite na D obivanje izvješća o naplatama na veliko da biste preuzeli izvješće.
Brisanje izvješća o naplatama na veliko
Koristite ovaj postupak za brisanje generiranog izvješća o naplati na temelju ID izvješća. Nekoliko primjera u kojima biste možda htjeli izbrisati izvješće uključuju:
-
Ako želite obnoviti postojeće izvješće o naplaćivanju usklađivanja, prvo morate izbrisati postojeće izvješće. Nakon što izbrišete postojeće izvješće, možete stvoriti novo izvješće za to razdoblje. Ne možete izbrisati izvješće ako njegovo generiranje nije uspjelo ili je još u tijeku.
Za izvješće u trenutku ne morate brisati postojeće izvješće jer sustav ne obnavlja ta izvješća. Svako izvješće uvijek odražava podatke trenutne vremenske oznake.
-
Ako generirani URL izvješća pošaljete pogrešnoj osobi, možete izbrisati izvješće tako da mu ne može pristupiti.
| 1 |
S developer.webex.com idite na Izbriši API izvješ ća o naplatama na veliko. |
| 2 |
Unesite ID izvješća i kliknite Pokreni. |
Polja izvješća o naplati
Izvješća o naplati sadrže sljedeća polja:
|
Polje |
Opis |
Podržana vrsta izvješća |
Podržana kategorija izvještaja |
Obvezni ili neobavezni atribut |
|---|---|---|---|---|
|
PARTNER_NAME |
Ime partnera |
PARTNER, CUSTOMER, USER |
Pomirenje, točkasto |
Obavezno |
|
PARTNER_ORG_ID |
Jedinstveni identifikator partnera |
PARTNER, CUSTOMER, USER |
Pomirenje, točkasto |
Obavezno |
|
SUBSCRIPTION_ID |
Jedinstveni identifikator pretplate |
PARTNER, CUSTOMER, USER |
Pomirenje, točkasto |
Obavezno |
|
CUSTOMER_GROUP_ID | Jedinstveni identifikator grupe kojoj kupac pripada. Ako se kupac premješta između grupa tijekom razdoblja naplate, korištenje se dijeli na temelju grupa kojima je kupac pripadao tijekom tog razdoblja. |
CUSTOMER, USER |
Pomirenje, točkasto |
Opcionalno |
|
CUSTOMER_GROUP_NAME | Prikazani naziv grupe kupaca. Ako se naziv grupe promijenio tijekom razdoblja naplate, koristi se najnoviji naziv. |
CUSTOMER, USER |
Pomirenje, točkasto |
Opcionalno |
|
CUSTOMER_ORG_ID |
Interni jedinstveni identifikator kupca |
CUSTOMER, USER |
Pomirenje, točkasto |
Obavezno |
|
CUSTOMER_EXTERNAL_ID |
Jedinstveni identifikator kupca koji je dao partner |
CUSTOMER, USER |
Pomirenje, točkasto |
Obavezno |
|
TYPE |
Vrsta korisnika ili radnog prostora |
CUSTOMER, USER |
Točka u vrijeme |
Obavezno |
|
SUBSCRIBER_ID |
Jedinstveni identifikator za pretplatnika |
USER |
Pomirenje, točkasto |
Obavezno |
|
USER_ID |
Korisnički ID Webex pretplatnika |
USER |
Pomirenje, točkasto |
Obavezno |
|
WORKSPACE_ID |
Jedinstveni identifikator radnog prostora |
USER |
Pomirenje, točkasto |
Obavezno |
|
SERVICE_NAME |
Naziv usluge (npr.COMMON_AREA_CALLING,WEBEX_CALLING,WEBEX_SUITE,WEBEX_MEETINGS) |
PARTNER, CUSTOMER, USER |
Pomirenje, točkasto |
Obavezno |
|
SKU |
SKU za uslugu |
PARTNER, CUSTOMER, USER |
Pomirenje, točkasto |
Obavezno |
|
DESCRIPTION |
Opis usluge |
PARTNER, CUSTOMER, USER |
Pomirenje, točkasto |
Obavezno |
|
CONSUMPTION_START_DATE |
Početak potrošnje usluge. Zajedno sa sljedećim poljem, ova vrijednost definira razdoblje korištenja. |
PARTNER, CUSTOMER, USER |
Pomirenje |
Obavezno |
|
CONSUMPTION_END_DATE |
Kraj potrošnje usluge. Zajedno s prethodnim poljem, ova vrijednost definira razdoblje potrošnje upotrebe. |
PARTNER, CUSTOMER, USER |
Pomirenje |
Obavezno |
|
REPORT_DATE |
Datum i vrijeme generiranja izvješća. |
CUSTOMER, USER |
Točka u vrijeme |
Obavezno |
|
QUANTITY |
Predstavlja ukupnu potrošnju korištenja korisnika po partneru, po kupcu ili po korisniku (ovisno o izvješću i razini na kojoj pregledavate podatke). Proračun: Sustav izračunava dnevnu količinu za svakog korisnika na proporcionalnoj osnovi za taj dan. Upotreba za cijeli dan = 1 Korištenje pola dana = 0,5 Zatim zbraja dnevne ukupne iznose za sve dane unutar obračunskog razdoblja kako bi se izračunala ukupna količina za tog korisnika unutar tog obračunskog razdoblja. Za izvješća na razini kupaca i partnera, ukupni iznos za sve korisnike se objedinjuje kako bi se osigurala ukupna količina za tog kupca ili partnera. Point-in-Time: Izvješće korisnika navodi dodjele paketa po kupcu. Svaki redak predstavlja ukupnu količinu određenog paketa dodijeljenog korisnicima ili radnim prostorima unutar određene organizacije korisnika. Količina prikazuje "0" ako nema dodijeljenih paketa. Korisničko izvješće navodi pakete dodijeljene korisnicima ili radnim prostorima. Svaki redak prikazuje količinu od 1, koja predstavlja korisnika ili radni prostor i njihov pojedinačni paket ili dodatak. Ako je korisniku ili radnom prostoru dodijeljeno više paketa ili dodataka, izvješće prikazuje više unosa, svaki s količinom od 1. |
PARTNER, CUSTOMER, USER |
Pomirenje, točkasto |
Obavezno |
|
LOCATION_ID |
Jedinstveni identifikator lokacije |
CUSTOMER, USER |
Pomirenje, točkasto Izvješće klijenta o točki u vremenu ne uključuje ID lokacije |
Opcionalno |
|
LICENSE_ID |
Identifikator licence Ovo polje je vidljivo samo za veleprodajne pakete Za izvješće o usklađivanju, prazna License_ID je za licence dodijeljene prije uvođenja ovog polja. Izvješće o naplati prikazuje više redaka za isti veleprodajni paket ako je povezan s različitim kombinacijama LOCATION_ID iLICENSE_ID. |
CUSTOMER, USER |
Pomirenje, točkasto |
Opcionalno |
Odabirom opcionalnih stupaca mijenja se redoslijed stupaca izvješća o usklađivanju korisnika i korisnika. Sljedeći redoslijed odnosi se na partnere koji imaju samo veleprodajne SKU u svojoj pretplati:
Izvješće o razini korisnika— PARTNER_NAME PARTNER_ORG_ID SUBSCRIPTION_ID CUSTOMER_GROUP_IDCUSTOMER_GROUP_NAME,CUSTOMER_ORG_ID,CUSTOMER_EXTERNAL_ID,LOCATION_ID,,LICENSE_ID,SUBSCRIBER_ID,USER_ID,WORKSPACE_ID,SERVICE_NAME, SKU, OPIS, CONSUMPTION_START_DATECONSUMPTION_END_DATE, KOLIČINA
Izvješće o razini kupca— PARTNER_NAME PARTNER_ORG_ID SUBSCRIPTION_IDCUSTOMER_GROUP_ID,CUSTOMER_GROUP_NAME,CUSTOMER_ORG_ID,CUSTOMER_EXTERNAL_ID,LOCATION_ID,LICENSE_ID,,SERVICE_NAME,, SKU, OPIS, CONSUMPTION_START_DATECONSUMPTION_END_DATE, KOLIČINA
Dodjeljivanje paketa korisniku pokreće Webex Wholesale naplatu, dok uklanjanje dodjele paketa zaustavlja ga.
Organizacija kupaca može pripadati samo jednoj grupi kupaca u bilo kojem trenutku. Podrška za više grupa kupaca po organizaciji trenutno nije dostupna.
