Report di fatturazione all'ingrosso Route-to-Market
Rapporti di fatturazione
I partner possono utilizzare le seguenti API di fatturazione all'ingrosso per generare report di fatturazione che li aiutano a convalidare l'utilizzo e l'accuratezza del provisioning. Le API di fatturazione all'ingrosso sono accessibili tramite developer.webex.com.
-
Riconciliazione: visualizza il consumo di utilizzo a livello di partner, cliente o utente. I partner possono utilizzare queste informazioni di report di fatturazione personalizzati per riconciliare la propria fattura mensile, in modo da poter fatturare ai propri clienti e utenti in base al consumo.
-
Punto nel tempo: visualizza le attuali allocazioni dei pacchetti a livello di cliente o di utente. Il report Point-In-Time fornisce un conteggio in tempo reale delle allocazioni dei pacchetti. I partner possono utilizzare queste informazioni per convalidare l'accuratezza dell'approvvigionamento e garantire l'allineamento con gli ordini dei clienti.
I partner possono anche generare report di fatturazione personalizzati per i subpartner utilizzando il parametro subPartnerOrgId.
Sono disponibili quattro API per gli amministratori partner che soddisfano i requisiti minimi di accesso.
|
API di fatturazione |
Scopo dell'API |
Requisito di accesso amministratore partner |
|---|---|---|
|
Creare un report di fatturazione all'ingrosso |
Utilizzato per generare un report di fatturazione. |
Read/write |
|
Ottieni un report di fatturazione all'ingrosso |
Utilizzato per ottenere un report di fatturazione generato da scaricare. |
Leggi |
|
Elenco dei report di fatturazione all'ingrosso |
Utilizzato per elencare i report di fatturazione esistenti per quel partner. |
Leggi |
|
Elimina un report di fatturazione all'ingrosso |
Utilizzato per eliminare un report di fatturazione esistente. |
Read/write |
Fonte dei dati
I dati per i report di fatturazione vengono estratti dalle assegnazioni dei pacchetti e dai dati di utilizzo monitorati da Webex per ciascun partner. Webex aggrega quotidianamente i dati dei pacchetti dei clienti e degli utenti per generare la fattura mensile del partner. Le API di fatturazione utilizzano questi dati, consentendo agli amministratori partner di generare report personalizzati. Questi report aiutano i partner a riconciliare i consumi di utilizzo dalla loro fattura mensile a livello di partner, cliente e utente.
Per informazioni più dettagliate su come Webex fattura ai partner, vedere Fatturazione del fornitore di servizi.
Creare un report di fatturazione all'ingrosso
| 1 |
Da developer.webex.com, vai a Crea un'API per i report di fatturazione all'ingrosso. |
| 2 |
Seleziona una delle seguenti categorie di report:
Se si desidera generare un report di riconciliazione, non è necessario apportare modifiche perché la riconciliazione è selezionata per impostazione predefinita, quindi è possibile procedere al passaggio successivo. Se si desidera generare un report Point-In-Time, modificare la selezione in Point-In-Time. |
| 3 |
Immettere billingStartDate e billingEndDate nel formato specificato dall'API. È possibile inserire qualsiasi data degli ultimi cinque anni, ma non quella corrente. Per il report Point-In-Time, i campi billingStartDate e billingEndDate non sono obbligatori e vengono ignorati se inseriti. Il rapporto riflette sempre le attuali assegnazioni dei pacchetti. |
| 4 |
Inserisci il tipo del report:
|
| 5 |
Fare clic su Esegui per generare il report. |
| 6 |
Copiare il report id dall'output API. È possibile utilizzare questo valore con l'API Get per ottenere il report di fatturazione generato. |
Operazioni successive
Vai alla sezione Ottieni un report di fatturazione all'ingrosso per scaricare una copia del report.
Ottieni un report di fatturazione all'ingrosso
Una volta generato un report di fatturazione, utilizzare questa API per ottenere un report di fatturazione specifico. Il report viene inviato a un URL, dove è disponibile per il download per 30 minuti dopo il completamento della richiesta GET.
| 1 |
Da developer.webex.com, vai a Ottieni un'API per il report di fatturazione all'ingrosso. |
| 2 |
Immettere il valore univoco id per il report e fare clic su Esegui. L'API emette un report sullo stato. L'output include il parametro tempDownloadURL, che fornisce un URL da cui è possibile scaricare il report. |
| 3 |
Copiare tempDownloadURL in un browser per accedere e scaricare il report. |
Elenca i report di fatturazione all'ingrosso
Utilizzare questa API per ottenere un elenco dei report di fatturazione generati per l'organizzazione partner. È possibile elencare tutti i report esistenti oppure limitare l'elenco ai report che soddisfano i parametri specificati, quali il periodo di fatturazione e il tipo di fatturazione (partner, cliente, utente).
Se si immettono parametri facoltativi, l'API restituisce solo i report che corrispondono esattamente ai parametri specificati. Ad esempio, se si specifica un periodo di fatturazione, verranno restituiti solo i report che utilizzano quel periodo di fatturazione specifico. I report che rientrano nel periodo ma che non corrispondono esattamente alle date non vengono restituiti.
| 1 |
Da developer.webex.com, vai a Elenco API report fatturazione all'ingrosso. |
| 2 |
In Parametri di query, immettere i parametri di ricerca che si desidera utilizzare (ad esempio, startDate, endDate, Type, sortBy on). |
| 3 |
Fare clic su Correre. L'API restituisce l'elenco dei report insieme all'ID univoco del report e allo stato (COMPLETO, IN_CORSO).
|
Operazioni successive
Prendi nota dell'ID per tutti i report che vuoi scaricare. Vai a Ottieni un report di fatturazione all'ingrosso per scaricare il report.
Elimina un report di fatturazione all'ingrosso
Utilizzare questa procedura per eliminare un report di fatturazione generato in base all'ID del report. Ecco alcuni esempi in cui potresti voler eliminare un report:
-
Se si desidera rigenerare un report di fatturazione di riconciliazione esistente, è necessario prima eliminare il report esistente. Dopo aver eliminato il report esistente, puoi crearne uno nuovo per quel periodo. Non è possibile eliminare un report se la sua generazione non è riuscita o è ancora in corso.
Per un report Point-In-Time, non è necessario eliminare un report esistente, poiché il sistema non rigenera questi report. Ogni report riflette sempre i dati aggiornati alla data e all'ora correnti.
-
Se invii l'URL di un report generato alla persona sbagliata, puoi eliminare il report in modo che non possa accedervi.
| 1 |
Da developer.webex.com, vai a Elimina API report fatturazione all'ingrosso. |
| 2 |
Immettere il report Id e fare clic su Esegui. |
Campi del report di fatturazione
I report di fatturazione contengono i seguenti campi:
|
Campo |
Descrizione |
Tipo di report supportato |
Categoria di report supportata |
|---|---|---|---|
|
NOME DEL PARTNER_ |
Nome del partner |
PARTNER, CLIENTE, UTENTE |
Riconciliazione, punto nel tempo |
|
PARTNER_ORG_ID |
Identificatore univoco del partner |
PARTNER, CLIENTE, UTENTE |
Riconciliazione, punto nel tempo |
|
ID ABBONAMENTO_ |
Identificatore univoco dell'abbonamento |
PARTNER, CLIENTE, UTENTE |
Riconciliazione, punto nel tempo |
|
NOME DEL SERVIZIO_ |
Nome del servizio (ad esempio, CHIAMATE AREA COMUNE__, CHIAMATE WEBEX_, SUITE WEBEX_, RIUNIONI WEBEX_) |
PARTNER, CLIENTE, UTENTE |
Riconciliazione, punto nel tempo |
|
SKU |
SKU per il servizio |
PARTNER, CLIENTE, UTENTE |
Riconciliazione, punto nel tempo |
|
DESCRIZIONE |
Descrizione del servizio |
PARTNER, CLIENTE, UTENTE |
Riconciliazione, punto nel tempo |
|
DATA DI INIZIO__DATA DI CONSUMO |
Inizio del consumo del servizio. Insieme al campo seguente, questo valore definisce il periodo di utilizzo. |
PARTNER, CLIENTE, UTENTE |
Riconciliazione |
|
DATA DI CONSUMO_FINE_ |
Fine del consumo del servizio. Insieme al campo precedente, questo valore definisce il periodo di consumo dell'utilizzo. |
PARTNER, CLIENTE, UTENTE |
Riconciliazione |
|
QUANTITÀ |
Rappresenta il consumo aggregato degli utenti per partner, per cliente o per utente (a seconda del report e del livello a cui si visualizzano i dati). Calcolo: Il sistema calcola la quantità giornaliera per ciascun utente in base a una ripartizione proporzionale per quel giorno. Utilizzo per un giorno intero = 1 Utilizzo per mezza giornata = 0,5 Quindi, somma i totali giornalieri di tutti i giorni del periodo di fatturazione per calcolare la quantità totale per quell'utente entro quel periodo di fatturazione. Per i report a livello di cliente e partner, i totali di tutti gli utenti vengono aggregati per fornire una quantità totale per quel cliente o partner. Punto nel tempo: Il report clienti elenca le allocazioni dei pacchetti per cliente. Ogni riga rappresenta la quantità totale di un pacchetto specifico assegnato agli utenti o agli spazi di lavoro all'interno di una particolare organizzazione cliente. La quantità mostra "0" se non ci sono pacchetti assegnati. Il report utente elenca i pacchetti assegnati agli utenti o alle aree di lavoro. Ogni riga mostra una quantità pari a 1, che rappresenta un utente o uno spazio di lavoro e il relativo pacchetto o componente aggiuntivo. Se più pacchetti o componenti aggiuntivi sono assegnati a un utente o a un'area di lavoro, il report mostra più voci, ciascuna con una quantità di 1. |
PARTNER, CLIENTE, UTENTE |
Riconciliazione, punto nel tempo |
|
CLIENTE_ORG_ID |
Identificatore univoco del cliente interno |
CLIENTE, UTENTE |
Riconciliazione, punto nel tempo |
|
CLIENTE_ESTERNO_ID |
Identificatore univoco del cliente fornito da un partner |
CLIENTE, UTENTE |
Riconciliazione, punto nel tempo |
|
ID ABBONATO_ |
Identificatore univoco per l'abbonato |
UTENTE |
Riconciliazione, punto nel tempo |
|
USERID_ |
ID utente Webex dell'abbonato |
UTENTE |
Riconciliazione, punto nel tempo |
|
AREA DI LAVORO_ID |
Identificatore univoco dell'area di lavoro |
UTENTE |
Riconciliazione, punto nel tempo |
|
ID POSIZIONE_ |
Identificatore di posizione univoco |
CLIENTE, UTENTE |
Riconciliazione, punto nel tempo |
|
LICENZA_ID |
Identificatore di licenza Questo campo è visibile solo per i pacchetti all'ingrosso Per il report di riconciliazione, l'ID License_è vuoto per le licenze assegnate prima dell'introduzione di questo campo. Il report di fatturazione mostra più righe per lo stesso pacchetto all'ingrosso se è associato a diverse combinazioni di LOCATION_ID e LICENSE_ID. |
CLIENTE, UTENTE |
Riconciliazione, punto nel tempo |
|
RAPPORTO_DATA |
Data e ora in cui viene generato il report. |
CLIENTE, UTENTE |
Punto nel tempo |
L'assegnazione di un pacchetto a un utente attiva la fatturazione Webex Wholesale, mentre la rimozione dell'assegnazione del pacchetto la interrompe.