Grazie per il feedback.
Feedback?Rapporti di fatturazione
I partner possono utilizzare le seguenti API di fatturazione all'ingrosso per generare i 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 personalizzate del rapporto di fatturazione per riconciliare la fattura mensile in modo da poter fatturare ai propri clienti e utenti in base al consumo di utilizzo.
-
Point-In-Time: mostra le allocazioni correnti dei pacchi a livello di cliente o per utente. Il rapporto Point-In-Time fornisce un conteggio in tempo reale delle allocazioni dei pacchi. I partner possono utilizzare queste informazioni per convalidare l' accuratezza del provisioning e garantire l'allineamento con gli ordini dei clienti.
I partner possono anche generare rapporti 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 come amministratore per i partner |
|---|---|---|
|
Creare un rapporto sulla fatturazione all'ingrosso |
Utilizzato per generare un rapporto di fatturazione. |
Lettura/scrittura |
|
Richieda un rapporto sulla fatturazione all'ingrosso |
Usato per ottenere un rapporto di fatturazione generato da scaricare. |
Legga |
|
Elenca i rapporti di fatturazione all'ingrosso |
Utilizzato per elencare i rapporti di fatturazione esistenti per quel partner. |
Legga |
|
Eliminare un rapporto sulla fatturazione all'ingrosso |
Usato per eliminare un rapporto di fatturazione esistente. |
Lettura/scrittura |
Fonte dei dati
I dati per i rapporti di fatturazione sono ricavati dalle assegnazioni dei pacchi e dai dati di utilizzo che Webex traccia per ciascun partner. Webex aggrega quotidianamente i dati dei pacchetti di clienti e utenti per generare la fattura mensile del partner. Le API di fatturazione utilizzano questi dati, consentendo agli amministratori dei partner di generare report personalizzati. Questi rapporti aiutano i partner a riconciliare il consumo di utilizzo rispetto alla fattura mensile a livello di partner, cliente e utente.
Per informazioni più dettagliate su come Webex fattura i partner, vedere Fatturazione con i fornitori di servizi.
Creare un rapporto sulla fatturazione all'ingrosso
| 1 |
Da developer.webex.com, acceda all'API per la creazione di un rapporto di fatturazione all'ingrosso. |
| 2 |
Seleziona una delle seguenti categorie di rapporti:
Se desidera generare un rapporto di riconciliazione, non è necessario modificare nulla perché la riconciliazione è selezionata per impostazione predefinita, quindi può procedere al passaggio successivo. Se desidera generare un rapporto Point-In-Time, modifichi la selezione in Point-In-Time. |
| 3 |
Inserisca BillingStartDate e BillingEndDate nel formato specificato dall'API. Può inserire qualsiasi data degli ultimi cinque anni, ma non il giorno corrente. Per il rapporto Point-In-Time, i campi BillingStartDate e BillingEndDate non sono obbligatori e vengono ignorati se inseriti. Il rapporto riflette sempre le attuali allocazioni dei pacchetti. |
| 4 |
Inserisca il tipo di rapporto:
|
| 5 |
Nel campo Includi, inserisca le colonne aggiuntive o opzionali che desidera vedere nei rapporti. Ogni tipo di rapporto ha una serie di attributi obbligatori e una serie di attributi opzionali. Può decidere quali attributi opzionali visualizzare per ogni rapporto. Se non include gli attributi opzionali, il rapporto mostra solo gli attributi obbligatori. Le seguenti colonne sono gli attributi opzionali che può richiedere di includere nel rapporto Clienti e utenti:
Deve includere CUSTOMER_GROUP_ID e CUSTOMER_GROUP_NAME insieme se vuole vedere questi attributi nel suo rapporto. Quando seleziona colonne opzionali, l'ordine delle colonne nei rapporti di riconciliazione clienti e utenti cambia. I partner devono aggiornare la loro integrazione API per accettare il nuovo formato csv. L'ordine delle colonne dei report Point-In-Time rimane invariato. Attualmente, le impostazioni delle funzionalità esistenti hanno la precedenza sul parametro Include nel determinare l'ordine delle colonne. Ad esempio, se una particolare impostazione di funzionalità è abilitata per un cliente, quella colonna della funzionalità viene visualizzata come nel vecchio formato del rapporto anche se la aggiunge nel parametro Include. Rimuoveremo presto queste impostazioni. Una volta rimosse, può richiedere le colonne opzionali solo tramite il parametro Include. |
| 6 |
Faccia clic su Esegui per generare il rapporto. |
| 7 |
Copia l'ID del rapporto dall'output dell'API. Può utilizzare questo valore con l'API Get per ottenere il rapporto di fatturazione generato. |
Cosa fare dopo
Vai alla sezione Richiedi un rapporto sulla fatturazione all'ingrosso per scaricare una copia del rapporto.
Richieda un rapporto sulla fatturazione all'ingrosso
Una volta generato un rapporto di fatturazione, utilizzi questa API per ottenere un rapporto di fatturazione specifico. Il rapporto viene inviato a un URL in cui è disponibile per il download per 30 minuti dopo il completamento della richiesta GET.
| 1 |
Da developer.webex.com, acceda all'API Get a Wholesale Billing Report. |
| 2 |
Inserisca il valore identificativo univoco per il rapporto e faccia clic su Esegui. L'API restituisce lo stato del rapporto. L'output include il parametro TempDownloadURL, che fornisce un URL da cui è possibile scaricare il rapporto. |
| 3 |
Copia il TempDownloadURL in un browser per accedere e scaricare il rapporto. |
Elenco dei rapporti di fatturazione all'ingrosso
Utilizza questa API per ottenere un elenco dei report di fatturazione generati per l'organizzazione partner. Può elencare tutti i rapporti esistenti o limitare l'elenco a quei rapporti che soddisfano i parametri specificati, come il periodo di fatturazione e il tipo di fatturazione (partner, cliente, utente).
Se inserisce parametri opzionali, l'API restituisce solo i report che corrispondono esattamente ai parametri da Lei specificati. Ad esempio, se specifica 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 |
Da developer.webex.com, vada all'API List Wholesale Billing Report. |
| 2 |
In Parametri di interrogazione, inserisca tutti i parametri di ricerca che desidera utilizzare (ad esempio, StartDate, EndDate, Type, SortBy on). |
| 3 |
Faccia clic su Esegui. L'API genera l'elenco dei report insieme all'ID e allo stato univoci del rapporto (COMPLETATO,IN_PROGRESS).
|
Cosa fare dopo
Registri l'ID di tutti i report che desidera scaricare. Vai a Richiedi un rapporto sulla fatturazione all'ingrosso per scaricare il rapporto.
Eliminare un rapporto sulla fatturazione all'ingrosso
Utilizza questa procedura per eliminare un rapporto di fatturazione generato in base all'ID del rapporto. Alcuni esempi in cui potrebbe voler eliminare un rapporto includono:
-
Se desidera rigenerare un rapporto di fatturazione di riconciliazione esistente, deve prima eliminare il rapporto esistente. Dopo aver eliminato il rapporto esistente, può creare un nuovo rapporto per quel periodo. Non può eliminare un rapporto se la sua generazione non è riuscita o è ancora in corso.
Per un rapporto point-in-time, non è necessario eliminare un rapporto esistente, poiché il sistema non rigenera questi report. Ogni rapporto riflette sempre i dati a partire dal timestamp corrente.
-
Se invia l'URL di un rapporto generato alla persona sbagliata, può eliminare il rapporto in modo che non possa accedervi.
| 1 |
Da developer.webex.com, vada all'API Elimina rapporto di fatturazione all'ingrosso. |
| 2 |
Inserisca l'ID del rapporto e faccia clic su Esegui. |
Campi del rapporto di fatturazione
I rapporti di fatturazione contengono i seguenti campi:
|
Campo |
Descrizione |
Tipo di rapporto supportato |
Categoria di report supportata |
Attributo obbligatorio o facoltativo |
|---|---|---|---|---|
|
PARTNER_NAME |
Nome del partner |
PARTNER, CUSTOMER, USER |
Riconciliazione, point-in-time |
Obbligatorio |
|
PARTNER_ORG_ID |
Identificatore unico del partner |
PARTNER, CUSTOMER, USER |
Riconciliazione, point-in-time |
Obbligatorio |
|
SUBSCRIPTION_ID |
Identificatore univoco dell'abbonamento |
PARTNER, CUSTOMER, USER |
Riconciliazione, point-in-time |
Obbligatorio |
|
CUSTOMER_GROUP_ID | L'identificativo univoco del gruppo a cui appartiene il cliente. Se il cliente viene spostato tra i gruppi durante il periodo di fatturazione, l'utilizzo viene suddiviso in base ai gruppi a cui apparteneva il cliente durante quel periodo. |
CUSTOMER, USER |
Riconciliazione, point-in-time |
Facoltativo |
|
CUSTOMER_GROUP_NAME | Mostra il nome del gruppo di clienti. Se il nome del gruppo è cambiato durante il periodo di fatturazione, viene utilizzato il nome più recente. |
CUSTOMER, USER |
Riconciliazione, point-in-time |
Facoltativo |
|
CUSTOMER_ORG_ID |
Identificatore univoco interno del cliente |
CUSTOMER, USER |
Riconciliazione, point-in-time |
Obbligatorio |
|
CUSTOMER_EXTERNAL_ID |
Identificatore univoco del cliente fornito da un partner |
CUSTOMER, USER |
Riconciliazione, point-in-time |
Obbligatorio |
|
TYPE |
Tipo di utente o area di lavoro |
CUSTOMER, USER |
Punto nel tempo |
Obbligatorio |
|
SUBSCRIBER_ID |
Identificatore univoco per l'abbonato |
USER |
Riconciliazione, point-in-time |
Obbligatorio |
|
USER_ID |
L'ID utente Webex dell'abbonato |
USER |
Riconciliazione, point-in-time |
Obbligatorio |
|
WORKSPACE_ID |
Identificatore univoco dell'area di lavoro |
USER |
Riconciliazione, point-in-time |
Obbligatorio |
|
SERVICE_NAME |
Nome del servizio (ad esempio,COMMON_AREA_CALLING, WEBEX_CALLINGWEBEX_SUITE,WEBEX_MEETINGS) |
PARTNER, CUSTOMER, USER |
Riconciliazione, point-in-time |
Obbligatorio |
|
SKU |
Codice del servizio |
PARTNER, CUSTOMER, USER |
Riconciliazione, point-in-time |
Obbligatorio |
|
DESCRIPTION |
Descrizione del servizio |
PARTNER, CUSTOMER, USER |
Riconciliazione, point-in-time |
Obbligatorio |
|
CONSUMPTION_START_DATE |
Inizio del consumo del servizio. Insieme al campo seguente, questo valore definisce il periodo di utilizzo. |
PARTNER, CUSTOMER, USER |
Riconciliazione |
Obbligatorio |
|
CONSUMPTION_END_DATE |
Fine del consumo del servizio. Insieme al campo precedente, questo valore definisce il periodo di consumo di utilizzo. |
PARTNER, CUSTOMER, USER |
Riconciliazione |
Obbligatorio |
|
REPORT_DATE |
La data e l'ora di generazione del rapporto. |
CUSTOMER, USER |
Punto nel tempo |
Obbligatorio |
|
QUANTITY |
Rappresenta il consumo aggregato di utilizzo degli utenti per partner, per cliente o per utente (a seconda del rapporto e del livello al quale sta visualizzando i dati). Calcolo: Il sistema calcola la quantità giornaliera per ogni utente su base proporzionale per quel giorno. Utilizzo per un giorno intero = 1 Utilizzo per mezza giornata = 0,5 Quindi, somma i totali giornalieri per 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. Point-In-Time: il rapporto sui clienti elenca le allocazioni dei pacchi 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à indica «0" se non ci sono pacchi assegnati. Il rapporto utente elenca i pacchetti assegnati agli utenti o agli spazi di lavoro. Ogni riga mostra una quantità pari a 1, che rappresenta un utente o un'area di lavoro e il relativo pacchetto o componente aggiuntivo individuale. Se più pacchetti o componenti aggiuntivi sono allocati a un utente o a un'area di lavoro, il rapporto mostra più voci, ciascuna con una quantità pari a 1. |
PARTNER, CUSTOMER, USER |
Riconciliazione, point-in-time |
Obbligatorio |
|
LOCATION_ID |
Identificatore di posizione univoco |
CUSTOMER, USER |
Riconciliazione, point-in-time Il rapporto Point-In-Time del cliente non include l'ID della località |
Facoltativo |
|
LICENSE_ID |
Identificatore della licenza Questo campo è visibile solo per i pacchi all'ingrosso Per il rapporto di riconciliazione, License_ID è vuoto per le licenze assegnate prima dell'introduzione di questo campo. Il rapporto di fatturazione mostra più righe per lo stesso pacchetto Wholesale se associato a diverse combinazioni di LOCATION_ID e. LICENSE_ID |
CUSTOMER, USER |
Riconciliazione, point-in-time |
Facoltativo |
La selezione di colonne opzionali modifica l'ordine delle colonne dei rapporti di riconciliazione clienti e utenti. L'ordine seguente si applica ai partner con solo SKU all'ingrosso nel loro abbonamento:
Rapporto a livello utente— PARTNER_NAMEPARTNER_ORG_ID,SUBSCRIPTION_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, DESCRIZIONECONSUMPTION_START_DATE,CONSUMPTION_END_DATE, QUANTITÀ
Rapporto a livello di cliente— PARTNER_NAMEPARTNER_ORG_ID,SUBSCRIPTION_ID,CUSTOMER_GROUP_ID,CUSTOMER_GROUP_NAME,CUSTOMER_ORG_ID,CUSTOMER_EXTERNAL_ID,LOCATION_ID,LICENSE_ID,SERVICE_NAME,, SKU, DESCRIZIONECONSUMPTION_START_DATE,CONSUMPTION_END_DATE, QUANTITÀ
L'assegnazione di un pacchetto a un utente attiva la fatturazione Webex Wholesale, mentre la rimozione dell'assegnazione del pacchetto la interrompe.
Un'organizzazione clienti può appartenere a un solo gruppo di clienti alla volta. Il supporto per più gruppi di clienti per organizzazione non è attualmente disponibile.
