Riconciliazione fatturazione

Gli amministratori dei partner possono utilizzare le API di fatturazione Wholesale per generare report di fatturazione personalizzati che visualizzano il consumo di utilizzo a livello di partner, cliente o utente. I partner possono utilizzare queste informazioni per riconciliare la fattura mensile in modo da poter fatturare i propri clienti e utenti in base al consumo di utilizzo.

I partner possono anche generare report di fatturazione personalizzati per i partner secondari utilizzando il parametro subPartnerOrgId.

Esistono quattro API disponibili per gli amministratori dei partner che soddisfano i requisiti minimi di accesso.

API di fatturazione

Scopo dell'API

Requisito di accesso amministratore partner

Crea un report di fatturazione Wholesale

Utilizzato per generare un report di fatturazione.

Lettura/Scrittura

Come ottenere un report di fatturazione Wholesale

Utilizzato per generare un report di fatturazione per il download.

Letto

Elenca report di fatturazione Wholesale

Utilizzato per elencare i report di fatturazione esistenti per tale partner.

Letto

Eliminazione di un report di fatturazione Wholesale

Utilizzato per eliminare un report di fatturazione esistente.

Lettura/Scrittura

Origine dati

I dati dei report di fatturazione vengono estratti dai dati sul consumo di utilizzo tracciati da Webex per ciascun partner. Ogni giorno, Webex tiene traccia del consumo di utilizzo del giorno precedente per tutti i partner, i clienti e gli utenti e aggrega i dati in modo che possano essere utilizzati per generare la fattura mensile del partner. Le API di fatturazione sfruttano questi dati, consentendo agli amministratori dei partner di generare report personalizzati in modo che il partner possa conciliare il consumo di utilizzo dalla fattura mensile a livello di partner, cliente e utente.

Per informazioni più dettagliate sulle modalità di fatturazione da parte di Webex ai partner, vedere Fatturazione provider di servizi.

Crea un report di fatturazione Wholesale

Utilizzare questa procedura per generare un report di fatturazione personalizzato che è possibile utilizzare per riconciliare la fatturazione.
1

Vai all'API di creazione di un report di fatturazione Wholesale.

2

Immettere il periodo di fatturazione inserendo i valori per billingStartDate e billingEndDate nel formato specificato dall'API. È possibile immettere qualsiasi data degli ultimi cinque anni, ma non il giorno corrente.

3

Immettere il Tipo di report:

  • PARTNER (impostazione predefinita): mostra il consumo di utilizzo a livello di partner.
  • CLIENTE: mostra il consumo totale di utilizzo suddiviso in base al livello di organizzazioni dei clienti sotto il partner.
  • UTENTE: mostra il consumo totale di utilizzo suddiviso in base al livello di organizzazioni e sottotitoli dei clienti sotto il partner.
4

Fare clic su Esegui per generare il report.

5

Copiare l'id del report dall'output dell'API. Puoi utilizzare questo valore con l'API Get per ottenere il report di fatturazione generato.

Operazioni successive

Vai a Richiedi un report di fatturazione Wholesale per scaricare una copia del report.

Come ottenere un report di fatturazione Wholesale

Una volta generato un report di fatturazione, utilizzare questa API per ottenere un report di fatturazione specifico. Il report viene visualizzato a un URL in cui è disponibile per il download per 30 minuti dopo il completamento della richiesta GET.
1

Vai all'API Ottieni un report di fatturazione Wholesale.

2

Nella linea GET , fare clic sul pulsante id e immettere il valore ID univoco per il report.

3

Fare clic su Correre.

4

L'API genera lo stato del report. L'output include il parametro tempDownloadURL , che fornisce un URL da cui è possibile scaricare il report.

5

Copiare tempDownloadURL in un browser per accedere e scaricare il report.

Elenca report di fatturazione Wholesale

Utilizzare questa API per ottenere un elenco dei report di fatturazione generati per l'organizzazione partner. È possibile elencare tutti i report esistenti o limitare l'elenco a quei report che soddisfano i parametri specificati, come il periodo di fatturazione e il tipo di fatturazione (partner, cliente, utente).

Se si immettono parametri opzionali, l'API restituisce solo quei report che corrispondono esattamente ai parametri immessi. Ad esempio, se inserisci un periodo di fatturazione, vengono 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

Vai all'API di report di fatturazione Wholesale elenco

2

In Parametri query, immettere eventuali parametri di ricerca che si desidera utilizzare (ad esempio, startDate, endDate, Type, sortBy on). Per ulteriori dettagli su questi parametri, vedere la Guida per gli sviluppatori sull'API.

3

Fare clic su Correre.

L'API genera l'elenco di report insieme all'id e allo stato univoci del report (COMPLETATO, IN_CORSO).

Operazioni successive

Registrare l'ID per tutti i report che si desidera scaricare. Vai a Richiedi un report di fatturazione Wholesale per scaricare il report.

Eliminazione di un report di fatturazione Wholesale

Utilizzare questa procedura per eliminare un report di fatturazione generato in base all'ID del report. Alcuni esempi in cui si potrebbe voler eliminare un report sono:

  • Se si desidera rigenerare un report di fatturazione esistente, è necessario prima eliminare il report esistente. Dopo aver eliminato il report esistente, è possibile creare un nuovo report per tale periodo. Tenere presente che il requisito di eliminazione non esiste se il report è in errore o è in corso.

  • Se viene generato un report e si invia l'URL alla persona errata, è possibile eliminare il report e tale persona non potrà accedervi.

1

Vai all'API di eliminazione report di fatturazione Wholesale.

2

Immettere l'Id report.

3

Fare clic su Correre.

Campi report di fatturazione

I report di fatturazione contengono i seguenti campi:

Campo

Informazioni aggiuntive

Appare in report di questo tipo

NOME_PARTNER

Nome del partner

partner, cliente, utente

ID_ORG_PARTNER

ID partner univoco

partner, cliente, utente

ID_ABBONAMENTO

Identificativo univoco abbonamento

partner, cliente, utente

NOME_SERVIZIO

Nome del servizio

(ad esempio, CHIAMATA_AREA COMUNE_, WEBEX_CALLING, SUITE WEBEX_, WEBEX_MEETINGS)

partner, cliente, utente

SKU

Sku per il servizio

partner, cliente, utente

descrizione

Descrizione del servizio

partner, cliente, utente

DATA_DI INIZIO_CONSUMO

Inizio del consumo di servizio. Insieme al campo seguente, questo valore definisce il periodo di utilizzo.

partner, cliente, utente

DATA_DI FINE_CONSUMO

Fine del consumo di servizio. Insieme al campo precedente, questo valore definisce il periodo di consumo di utilizzo.

partner, cliente, utente

quantità

Rappresenta il consumo di utilizzo aggregato degli utenti per partner, per cliente o per utente (a seconda del report e del livello di visualizzazione dei dati).

Calcolo:

Per ogni utente, la quantità giornaliera viene calcolata su base proporzionale per quel giorno. Ad esempio:

Utilizzo per una giornata intera = 1

Utilizzo per mezza giornata = 0,5

I totali giornalieri per tutti i giorni del periodo di fatturazione vengono sommati in modo da fornire una quantità totale per tale utente entro tale periodo di fatturazione.

Per i report a livello di clienti e partner, i totali per tutti gli utenti vengono aggregati per fornire una quantità totale per tale cliente o partner.

partner, cliente, utente

ID_ORG_CLIENTE

Identificativo univoco cliente interno

cliente, utente

ID_ESTERNO_CLIENTE

Identificativo univoco cliente fornito da un partner

cliente, utente

ID_ABBONATO

Identificativo univoco per l'abbonato

UTENTE

USERID_

ID utente Webex dell'abbonato

UTENTE

ID SPAZIO DI LAVORO_

Identificativo univoco spazio di lavoro

UTENTE

ID POSIZIONE_

ID posizione univoco

cliente, utente

La fatturazione Webex Wholesale viene attivata dal provisioning di un pacchetto a un utente o interrotta dalla rimozione dell'assegnazione del pacchetto.