Report di fatturazione all'ingrosso Route-to-Market

list-menuFeedback?
Gli amministratori dei partner possono utilizzare le API di fatturazione all'ingrosso per generare report di fatturazione che li aiutano a convalidare l'utilizzo e l'accuratezza del provisioning.

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:

  • Riconciliazione (predefinita)

  • Punto nel tempo

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:

  • PARTNER (predefinito): mostra i consumi o le allocazioni dei pacchetti a livello di partner. Questo tipo non è supportato per i report Point-In-Time.

  • CLIENTE: mostra i consumi di utilizzo o le allocazioni dei pacchetti suddivisi a livello di organizzazioni clienti del partner.

  • UTENTE: mostra i consumi di utilizzo o le allocazioni dei pacchetti suddivisi a livello di organizzazioni clienti e abbonati del partner.

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.

Questo articolo è stato utile?
Questo articolo è stato utile?