Riconciliazione della fatturazione

Gli amministratori dei partner possono utilizzare le API di fatturazione all'ingrosso 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 propria fattura mensile, in modo da poter fatturare ai propri clienti e utenti in base al consumo.

I partner possono anche generare report di fatturazione personalizzati per i sub-partner 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.

Leggere / Scrivere

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.

Leggere / Scrivere

Origine dati

I dati per i report di fatturazione vengono estratti dai dati di utilizzo e consumo monitorati da Webex per ciascun partner. Ogni giorno, Webex monitora il consumo del giorno precedente per tutti i partner, clienti e 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 riconciliare il consumo di utilizzo dalla propria 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

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

Vai all'API Crea un report di fatturazione all'ingrosso.

2

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

3

Inserisci il Tipo del report:

  • PARTNER (impostazione predefinita): mostra il consumo di utilizzo a livello di partner.
  • CLIENTE: mostra il consumo totale suddiviso a livello di organizzazioni clienti del partner.
  • UTENTE: mostra il consumo totale suddiviso a livello di organizzazioni clienti e abbonati del partner.
4

Fare clic su Esegui per generare il report.

5

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 a 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

Vai all'API Ottieni un report di fatturazione all'ingrosso.

2

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

3

Fare clic su Correre.

4

L'API emette un report sullo stato. 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.

Elenco dei 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 immessi. Ad esempio, se si immette 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'elenco API del report di fatturazione all'ingrosso

2

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

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 esistente, è necessario prima eliminarlo. Dopo aver eliminato il report esistente, puoi crearne uno nuovo per quel periodo. Si noti che il requisito di eliminazione non esiste se il report non è riuscito o è in corso.

  • Se viene generato un report e invii l'URL alla persona sbagliata, puoi eliminare il report e la persona non potrà più accedervi.

1

Vai all'API Elimina report fatturazione all'ingrosso.

2

Inserisci il report Id.

3

Fare clic su Correre.

Campi del report di fatturazione

I report di fatturazione contengono i seguenti campi:

Campo

Informazioni aggiuntive

Appare nei resoconti del tipo

NOME DEL PARTNER_

Nome del partner

PARTNER, CLIENTE, UTENTE

PARTNER_ORG_ID

Identificatore univoco del partner

PARTNER, CLIENTE, UTENTE

ID ABBONAMENTO_

Identificatore univoco dell'abbonamento

PARTNER, CLIENTE, UTENTE

NOME DEL SERVIZIO_

Nome del servizio

(ad esempio, CHIAMATE AREA COMUNE__, CHIAMATE WEBEX_, SUITE WEBEX_, RIUNIONI WEBEX_)

PARTNER, CLIENTE, UTENTE

SKU

SKU per il servizio

PARTNER, CLIENTE, UTENTE

DESCRIZIONE

Descrizione del servizio

PARTNER, CLIENTE, UTENTE

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

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

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:

Calcolano la quantità giornaliera per ciascun utente in base a una quota proporzionale per quel giorno.

Utilizzo per un giorno intero = 1

Utilizzo per mezza giornata = 0,5

Sommano 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.

PARTNER, CLIENTE, UTENTE

CLIENTE_ORG_ID

Identificatore univoco del cliente interno

CLIENTE, UTENTE

CLIENTE_ESTERNO_ID

Identificatore univoco del cliente fornito da un partner

CLIENTE, UTENTE

ID ABBONATO_

Identificatore univoco per l'abbonato

UTENTE

USERID_

ID utente Webex dell'abbonato

UTENTE

AREA DI LAVORO_ID

Identificatore univoco dell'area di lavoro

UTENTE

POSIZIONE_ID

Identificatore di posizione univoco

CLIENTE, UTENTE

LICENZA_ID

Identificatore di licenza

Questo campo è visibile solo per i pacchetti all'ingrosso. L'ID License_è vuoto per le licenze assegnate prima dell'introduzione di questo campo.

Un report di fatturazione può mostrare più righe per lo stesso pacchetto all'ingrosso, con ogni riga che rappresenta un valore univoco package/license Combinazione ID.

Se è presente il campo ID LICENZA_, ogni riga rappresenta un ID univoco package/location/license Combinazione ID.

CLIENTE, UTENTE

L'assegnazione di un pacchetto a un utente attiva la fatturazione Webex Wholesale, mentre la rimozione dell'assegnazione del pacchetto la interrompe.