Izveštaji o naplati
Partneri mogu da koriste sledeće API-je za naplatu na veliko da generišu izveštaje o naplati koji im pomažu da potvrde tačnost upotrebe i obezbeđenja. API-ji za naplatu na veliko dostup ni su preko developer.vebek.com.
-
Usaglašavanje — Prikazuje potrošnju upotrebe po partneru, kupcu ili nivou po korisniku. Partneri mogu da koriste ove prilagođene informacije o izveštaju o naplati kako bi uskladili svoju mesečnu fakturu kako bi mogli naplatiti svojim kupcima i korisnicima u skladu sa potrošnjom upotrebe.
-
Point-in-Time-Prikazuje trenutne alokacije paketa po klijentu ili nivou po korisniku. Izveštaj Point-In-Time pruža broj dodeljivanja paketa u realnom vremenu. Partneri mogu da koriste ove informacije da potvrde tačnost obezbeđenja i osiguraju usklađivanje sa narudžbama kupaca.
Partneri takođe mogu da generišu prilagođene izveštaje o naplati za podpartnere koristeći parametar SubPartnerOrgID.
Postoje četiri API-ja koji su dostupni partnerskim administratorima koji ispunjavaju minimalne zahteve za pristup.
|
API za naplatu |
Svrha API-ja |
Zahtev za pristup administratora partnera |
|---|---|---|
|
Napravite izveštaj o naplatama na veliko |
Koristi se za generisanje izveštaja o naplati. |
Čitanje/pisanje |
|
Nabavite izveštaj o naplatama na veliko |
Koristi se za dobijanje generisanog izveštaja o naplati za preuzimanje. |
Pročitajte |
|
Lista izveštaja o naplatama na veliko |
Koristi se za spisak izveštaja o naplati koji postoje za tog partnera. |
Pročitajte |
|
Brisanje izveštaja o naplatama na veliko |
Koristi se za brisanje postojećeg izveštaja o naplati. |
Čitanje/pisanje |
Izvor podataka
Podaci za izveštaje o naplati izvlače se iz dodeljivanja paketa i podataka o upotrebi koje Vebek prati za svakog partnera. Vebek svakodnevno objedinjuje podatke o kupcima i korisničkim paketima kako bi generisao mesečnu fakturu partnera. API-ji za naplatu koriste ove podatke, omogućavajući partnerskim administratorima da generišu prilagođene izveštaje. Ovi izveštaji pomažu partner ima da usklade potrošnju upotrebe sa svoje mesečne fakture na nivou partnera, kup ca i korisnika.
Detaljnije informacije o tome kako Vebek fakturira partnere potražite u odeljku Obračun dobavl jača usluga.
Napravite izveštaj o naplatama na veliko
| 1 |
Sa developer.vebek.com idite na Kreirajte API iz veštaja o naplatama na veliko. |
| 2 |
Izaberite bilo koju od sledećih kategorija izveštaja:
Ako želite da generišete izveštaj o pomirenju, nema potrebe da ništa menjate jer je Pomirenje podrazumevano izabrano, tako da možete da pređete na sledeći korak. Ako želite da generišete izveštaj o tački u vremenu, promenite izbor u tačka u vreme. |
| 3 |
Unesite BillingStartDate i BillingEndDate u formatu koji API navodi. Možete da unesete bilo koji datum iz poslednjih pet godina, ali ne i trenutni dan. Za izveštaj Point-In-Time polja BillingStartDate i BillingEndDate nisu obavezna i ignorišu se ako se unesu. Izveštaj uvek odražava trenutne alokacije paketa. |
| 4 |
Unesite vrstu izveštaja:
|
| 5 |
U polje U klju či unesite dodatne ili opcione kolone koje želite da vidite u izveštajima. Svaki tip izveštaja ima skup obaveznih atributa i skup opcionalnih atributa. Možete da odlučite koji od opcionalnih atributa ćete prikazati za svaki izveštaj. Ako ne uključite opcione atribute, izveštaj prikazuje samo obavezne atribute. Sledeće kolone su opcioni atributi koje možete zatražiti da uključite u izveštaj o kupcu i korisniku:
Morate uključiti CUSTOMER_GROUP_ID i CUSTOMER_GROUP_NAME zajedno ako želite da vidite ove atribute u svom izveštaju. Kada izaberete opcionalne kolone, redosled kolona u izveštajima o usaglašavanju korisnika i korisnika se menja. Partneri moraju ažurirati svoju API integraciju da bi prihvatili novi csv format. Redosled kolona izveštaja u trenutku ostaje nepromenjen. Trenutno postojeća podešavanja funkcija imaju prednost nad parametrom Uključi prilikom određivanja redosleda kolona. Na primer, ako je određena postavka funkcije omogućena za korisnika, tada se ta kolona funkcija pojavljuje prema starom formatu izveštaja čak i ako ih dodate u parametar Uključi. Uskoro ćemo ukloniti ova podešavanja. Kada se uklone, opcione kolone možete zatražiti samo preko parametra Uključi. |
| 6 |
Kliknite Pok reni da biste generisali izveštaj. |
| 7 |
Kopirajte id izveštaja iz API-ja izlaza. Ovu vrednost možete koristiti pomoću API-ja Get da biste dobili generisani izveštaj o naplati. |
Šta dalje raditi
Idite na odeljak Preuzimanje izveštaja o na platama na veliko da biste preuzeli kopiju iz veštaja.
Nabavite izveštaj o naplatama na veliko
Jednom kada se generiše izveštaj o naplati, koristite ovaj API da biste dobili određeni izveštaj o naplati. Izveštaj dobija izlaz na URL gde je dostupan za preuzimanje 30 minuta nakon završetka GET zahteva.
| 1 |
Sa developer.vebek.com idite na Nabavite API iz veštaja o naplatama na veliko. |
| 2 |
Unesite jedinstvenu vrednost id za izveštaj i kliknite na Pokreni. API daje status izveštaja. Izlaz uključuje parametar tempDovnloadURL, koji pruža URL sa kojeg možete preuzeti izveštaj. |
| 3 |
Kopirajte T empDovnloadURL u pregledač da biste pristupili izveštaju i preuzeli ga. |
Lista izveštaja o naplatama na veliko
Koristite ovaj API da biste dobili listu generisanih izveštaja o naplati za partnersku organizaciju. Možete da navedete sve postojeće izveštaje ili ograničite listu na one izveštaje koji ispunjavaju navedene parametre kao što su period naplate i vrsta naplate (partner, kupac, korisnik).
Ako unesete opcionalne parametre, API vraća samo one izveštaje koji tačno odgovaraju parametrima koje ste naveli. Na primer, ako odredite period naplate, vraćaju se samo izveštaji koji koriste taj određeni period naplate. Izveš taji koji spadaju u period, ali koji se ne podudaraju tačno sa datumima, ne vraćaju se.
| 1 |
Sa developer.vebek.com idite na API izveštaja o naplatama na veliko. |
| 2 |
U od eljku Parametri up ita unesite sve parametre pretrage koje želite da koristite (na primer, StartDate, EndDate, Tip, SortBy). |
| 3 |
Kliknite Pokreni. API daje listu izveštaja zajedno sa jedinstvenim ID- om izveštaja i statusom (ZAVRŠENO,IN_PROGRESS).
|
Šta dalje raditi
Zapišite ID za sve izveštaje koje želite da preuzmete. Idite na D obijanje izveštaja o naplatama na veliko da biste preuzeli izveštaj.
Brisanje izveštaja o naplatama na veliko
Koristite ovu proceduru za brisanje generisanog izveštaja o naplati na osnovu id-a izveštaja. Nekoliko primera gde biste možda želeli da izbrišete izveštaj uključuju:
-
Ako želite da regenerišete postojeći izveštaj o obračunu usklađivanja, prvo morate izbrisati postojeći izveštaj. Nakon što izbrišete postojeći izveštaj, možete kreirati novi izveštaj za taj period. Ne možete izbrisati izveštaj ako njegovo generisanje nije uspelo ili je još uvek u toku.
Za izveštaj u trenutku ne morate da brišete postojeći izveštaj, jer sistem ne regeneriše ove izveštaje. Svaki izveštaj uvek odražava podatke od trenutne vremenske oznake.
-
Ako pošaljete generisani URL izveštaja pogrešnoj osobi, možete da izbrišete iz veštaj tako da mu ne mogu pristupiti.
| 1 |
Sa developer.vebek.com idite na Izbriši API izveš taja o naplatama na veliko. |
| 2 |
Unesite ID izveštaja i kliknite Pokreni. |
Polja izveštaja o naplati
Izveštaji o naplati sadrže sledeća polja:
|
Polje |
Opis |
Podržani tip izveštaja |
Podržana kategorija izveštaja |
Obavezni ili Opcioni atribut |
|---|---|---|---|---|
|
PARTNER_NAME |
Ime partnera |
PARTNER, CUSTOMER, USER |
Pomirenje, tačka-u-vreme |
Obavezno |
|
PARTNER_ORG_ID |
Jedinstveni identifikator partnera |
PARTNER, CUSTOMER, USER |
Pomirenje, tačka-u-vreme |
Obavezno |
|
SUBSCRIPTION_ID |
Jedinstveni identifikator pretplate |
PARTNER, CUSTOMER, USER |
Pomirenje, tačka-u-vreme |
Obavezno |
|
CUSTOMER_GROUP_ID | Jedinstveni identifikator grupe kojoj kupac pripada. Ako se kupac premješta između grupa tokom obračunskog perioda, upotreba se deli na osnovu grupa kojima je kupac pripadao tokom tog perioda. |
CUSTOMER, USER |
Pomirenje, tačka-u-vreme |
Opcionalno |
|
CUSTOMER_GROUP_NAME | Prikaz imena grupe kupaca. Ako se ime grupe promenilo tokom obračunskog perioda, koristi se najnovije ime. |
CUSTOMER, USER |
Pomirenje, tačka-u-vreme |
Opcionalno |
|
CUSTOMER_ORG_ID |
Interni jedinstveni identifikator kupca |
CUSTOMER, USER |
Pomirenje, tačka-u-vreme |
Obavezno |
|
CUSTOMER_EXTERNAL_ID |
Jedinstveni identifikator kupca koji je obezbedio partner |
CUSTOMER, USER |
Pomirenje, tačka-u-vreme |
Obavezno |
|
TYPE |
Tip korisnika ili radnog prostora |
CUSTOMER, USER |
Tačka u vremenu |
Obavezno |
|
SUBSCRIBER_ID |
Jedinstveni identifikator za pretplatnika |
USER |
Pomirenje, tačka-u-vreme |
Obavezno |
|
USER_ID |
Korisnički ID pretplatnika Vebek |
USER |
Pomirenje, tačka-u-vreme |
Obavezno |
|
WORKSPACE_ID |
Jedinstveni identifikator radnog prostora |
USER |
Pomirenje, tačka-u-vreme |
Obavezno |
|
SERVICE_NAME |
Naziv usluge (npr.COMMON_AREA_CALLING,WEBEX_CALLING,WEBEX_SUITE,WEBEX_MEETINGS) |
PARTNER, CUSTOMER, USER |
Pomirenje, tačka-u-vreme |
Obavezno |
|
SKU |
SKU za uslugu |
PARTNER, CUSTOMER, USER |
Pomirenje, tačka-u-vreme |
Obavezno |
|
DESCRIPTION |
Opis usluge |
PARTNER, CUSTOMER, USER |
Pomirenje, tačka-u-vreme |
Obavezno |
|
CONSUMPTION_START_DATE |
Početak potrošnje usluge. Zajedno sa sledećim poljem, ova vrednost definiše period upotrebe. |
PARTNER, CUSTOMER, USER |
Pomirenje |
Obavezno |
|
CONSUMPTION_END_DATE |
Kraj potrošnje usluge. Zajedno sa prethodnim poljem, ova vrednost definiše period potrošnje upotrebe. |
PARTNER, CUSTOMER, USER |
Pomirenje |
Obavezno |
|
REPORT_DATE |
Datum i vreme generisanja izveštaja. |
CUSTOMER, USER |
Tačka u vremenu |
Obavezno |
|
QUANTITY |
Predstavlja agregiranu potrošnju upotrebe korisnika po partneru, po kupcu ili po korisniku (u zavisnosti od izveštaja i nivoa na kojem pregledavate podatke). Proračun: Sistem izračunava dnevnu količinu za svakog korisnika na proporcionalnoj osnovi za taj dan. Upotreba za ceo dan = 1 Upotreba za pola dana = 0,5 Zatim sumira dnevne ukupne iznose za sve dane u obračunskom periodu kako bi se izračunala ukupna količina za tog korisnika u tom obračunskom periodu. Za izveštaje na nivou kupaca i partnera, ukupni iznos za sve korisnike se agregira kako bi se obezbedila ukupna količina za tog kupca ili partnera. Point-in-Time: Izveštaj o kupcu navodi alokacije paketa po kupcu. Svaki red predstavlja ukupnu količinu određenog paketa dodeljenog korisnicima ili radnim prostorima unutar određene organizacije kupaca. Količina prikazuje „0“ ako nema dodeljenih paketa. Korisnički izveštaj navodi pakete dodeljene korisnicima ili radnim prostorima. Svaki red prikazuje količinu od 1, koja predstavlja korisnika ili radni prostor i njihov pojedinačni paket ili dodatak. Ako je korisniku ili radnom prostoru dodeljeno više paketa ili dodataka, izveštaj prikazuje više unosa, svaki sa količinom od 1. |
PARTNER, CUSTOMER, USER |
Pomirenje, tačka-u-vreme |
Obavezno |
|
LOCATION_ID |
Jedinstveni identifikator lokacije |
CUSTOMER, USER |
Pomirenje, tačka-u-vreme Izveštaj klijenta o mestu u vremenu ne uključuje ID lokacije |
Opcionalno |
|
LICENSE_ID |
Identifikator licence Ovo polje je vidljivo samo za veleprodajne pakete Za izveštaj o usklađ License_ID ivanju, prazan je za licence dodeljene pre uvođenja ovog polja. Izveštaj o naplati prikazuje više redova za isti veleprodajni paket ako je povezan sa različitim kombinacijama LOCATION_ID iLICENSE_ID. |
CUSTOMER, USER |
Pomirenje, tačka-u-vreme |
Opcionalno |
Odabirom opcionalnih kolona menja se redosled kolona izveštaja o usaglašavanju kupaca i korisnika. Sledeći redosled važi za partnere sa samo veleprodajnim SKU-ovima u njihovoj pretplati:
Izveštaj o nivou korisnika— 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_ID,SERVICE_NAME,, SKU, OPIS, CONSUMPTION_START_DATECONSUMPTION_END_DATE, KOLIČINA
Izveštaj o nivou 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
Obezbeđivanje paketa korisniku pokreće Vebek veleprodajnu naplatu, dok uklanjanje dodeljivanja paketa zaustavlja ga.
Organizacija kupaca može pripadati samo jednoj grupi kupaca u bilo kom trenutku. Podrška za više grupa kupaca po organizaciji trenutno nije dostupna.