API di conciliazione dell'utilizzo a tariffa giornaliera fatturato e non fatturato v2 (GA)

si applica a: Centro per i partner (non disponibile in Azure per enti pubblici o Azure Cina 21Vianet)

Comprendere l'architettura

La nuova API asincrona offre miglioramenti significativi nella gestione dell'accesso ai dati di fatturazione e riconciliazione. Questo approccio risolve i problemi associati ai metodi sincroni tradizionali, ad esempio la gestione di connessioni di lunga durata e l'elaborazione di batch di dati di grandi dimensioni. Ecco i principali vantaggi e meccanismi di questa API:

Componenti fondamentali

Proteggere l'accesso con lo schema di chiave del valet

Il modello di chiave di servizio fornisce un accesso sicuro e limitato ai dati di fatturazione. Analogamente al modo in cui una chiave di controllo consente a qualcuno di guidare la tua auto senza accedere al bagagliaio, questo modello garantisce un controllo di accesso granulare. Invece di condividere le credenziali, un token di firma di accesso condiviso concede un accesso limitato e associato a tempo a risorse specifiche. Questo modello riduce il rischio di accesso non autorizzato configurando precise scadenze e autorizzazioni di accesso.

Miglioramento dell'efficienza tramite un modello asincrono di richiesta-risposta

Pensaci come ordinare in un ristorante affollato. Invece di aspettare al banco, ricevi un ronzio e puoi fare altre cose mentre il tuo ordine è preparato. Quando i dati sono pronti, il sistema invia una notifica.

La natura asincrona dell'API significa effettuare una richiesta e il sistema lo elabora in background. Questo richiesta-risposta asincrona usa in modo efficiente le risorse, riduce il carico del server e riduce al minimo i timeout e i fallimenti comuni con il recupero sincrono dei dati.

Flessibilità nelle autorizzazioni di accesso ai dati

I token SAS offrono flessibilità nella gestione dei permessi di accesso ai dati. È possibile generare token che concedono l'accesso a tutti gli attributi dei dati di riconciliazione fatturati o limitare l'accesso a subset specifici. Questa granularità consente alle organizzazioni di personalizzare l'accesso ai dati in base ai criteri interni e ai requisiti normativi, migliorando la sicurezza e la conformità.

Flusso di lavoro semplificato e tempi di elaborazione dei dati migliorati

Il modello richiesta-risposta asincrono semplifica l'elaborazione dei dati consentendo un accesso dinamico anziché attraverso lotti fissi di 2.000 elementi. Questo approccio porta a risultati più rapidi e tempi di elaborazione migliorati, semplificando l'integrazione dei dati di fatturazione e riconciliazione in sistemi e flussi di lavoro esistenti.

Vantaggi

1. Vantaggi delle prestazioni

   Anziché mantenere connessioni di lunga durata ed elaborare batch fissi, il nuovo sistema consente di:

   • Effettuare una rapida richiesta iniziale.
   • Ricevere un token di accesso sicuro.
   • Elaborare i dati in base al proprio ritmo.
   • Accedere esattamente a ciò di cui hai bisogno quando ti serve.

2. miglioramenti della sicurezza

   Il modello di chiave valet, implementato tramite token SAS, fornisce:

   • Accesso limitato al tempo.
   • Autorizzazioni limitate.
   • Eliminazione della condivisione o dell'archiviazione di credenziali permanenti.
   • Controllo di accesso con granularità fine.

3. Vantaggi Architettonici

   Il modello di richiesta-risposta asincrona funziona come un assistente personale che:

   • Accetta la richiesta.
   • Gestisce l'attività sullo sfondo.
   • Notifica quando tutto è pronto.

Adottare API ottimizzate per migliorare le prestazioni

L'adozione di queste API ottimizzate semplifica il flusso di lavoro e migliora le prestazioni complessive nella gestione dei dati. Usando il controllo degli accessi sicuro e meccanismi di recupero efficienti, si ottengono risultati migliori con meno sforzo, con conseguente miglioramento dell'efficienza operativa.

In conclusione, la nuova API asincrona per l'accesso ai dati di fatturazione e riconciliazione tramite BLOB di Azure è uno strumento potente. Offre accesso sicuro ed efficiente ai dati finanziari, semplificando i flussi di lavoro, riducendo i carichi del server e migliorando i tempi di elaborazione, tutto con sicurezza e conformità elevate.

Nota

Le nuove API non sono ospitate nell'host API del Centro per i partner. Al contrario, è possibile trovarli in MS Graph in Usare l'API Microsoft Graph per esportare i dati di fatturazione dei partner. Per accedere a queste API, fare riferimento ai dettagli seguenti.

È possibile usare queste API solo per il cloud globale pubblico ms Graph per il momento. Non sono ancora disponibili per Azure per enti pubblici o Azure Cina.

Consentire all'app di accedere ai dati di fatturazione dei partner

Per consentire all'app di accedere ai dati di fatturazione dei partner, seguire questo collegamento e acquisire familiarità con le nozioni di base sull'autenticazione e sull'autorizzazione per Microsoft Graph. Questo passaggio è fondamentale perché garantisce che l'app possa accedere in modo sicuro ai dati necessari.

Assegnare l'autorizzazione PartnerBilling.Read.All

Assegnare l'autorizzazione "PartnerBilling.Read.All" usando il portale di Azure o l'interfaccia di amministrazione di Microsoft Entra. Questi passaggi assicurano che l'app abbia l'accesso necessario ai dati di fatturazione dei partner.

1. Registrare l'app nella home page di Microsoft Entra nella sezione Registrazioni app.
2. Concedere l'autorizzazione necessaria passando alla pagina dell'app Microsoft Entra. Nella sezione Autorizzazioni API selezionare Aggiungi un'autorizzazione e scegliere l'ambito PartnerBilling.Read.All.

Comprendere le differenze tra le versioni beta e ga

Se hai utilizzato la nostra versione beta, probabilmente troverai la transizione alla versione ufficiale (GA) senza problemi e intuitiva. Per comprendere gli aggiornamenti e i miglioramenti, è consigliabile confrontare le versioni beta e ga. La comprensione di questi aggiornamenti consente di ottimizzare le nuove funzionalità e i miglioramenti disponibili nella versione disponibile a livello generale.

Importante

Il nuova tariffazione giornaliera del commercio non include gli addebiti per questi prodotti:

• Prenotazione di Azure
• Piano di risparmio di Azure
• Ufficio
• Dynamics
• Microsoft Power Apps
• Software con licenza perpetua
• Sottoscrizione software
• Prodotto SaaS di terze parti o di marketplace

Comprendere e usare gli endpoint API

Per aiutarti a recuperare in modo asincrono gli elementi di utilizzo fatturati per il nuovo commercio valutati giornalmente, offriamo due endpoint API chiave. Seguire questa guida semplificata per iniziare rapidamente.

Usare l'endpoint dell'elemento di riga

Prima di tutto, usare questa API per recuperare le voci di utilizzo giornaliero con valutazione per new commerce. Quando si effettua una richiesta, si riceve uno stato HTTP 202 e un'intestazione di posizione con un URL. Eseguire regolarmente il polling di questo URL fino a ottenere lo stato di esito positivo e l'URL del manifesto.

Usare l'endpoint di stato dell'operazione

Seguendo questa procedura, è possibile gestire in modo efficiente il processo di riconciliazione della fattura.

Continuare a controllare lo stato dell'operazione chiamando questa API a intervalli regolari. Se i dati non sono pronti, la risposta include un'intestazione Retry-After che indica quanto tempo attendere prima di riprovare. Al termine dell'operazione, si riceve una risorsa manifesto con un collegamento alla cartella di archiviazione per scaricare i dati di utilizzo. La risposta segmenta i file per migliorare la velocità effettiva e consentire il parallelismo di I/O.

Esaminare il diagramma della sequenza di dati di riconciliazione

Ecco un diagramma di sequenza che mostra i passaggi per scaricare i dati di riconciliazione.

Seguire la sequenza di azioni dell'utente

Ecco i passaggi della sequenza di azioni utente per recuperare le voci di riconciliazione dell'uso giornaliero calcolato di nuovo commercio:

• Inviare una richiesta
• Controllare lo stato della richiesta
• Scarica gli elementi della riga di riconciliazione da Azure Blob Storage

Inviare una richiesta

Inviare una richiesta POST all'endpoint API.

Ottenere voci di utilizzo giornaliero non fatturate

Ottieni new commerce voci di utilizzo giornaliere non fatturate per il mese di calendario corrente o l'ultimo mese o periodo di fatturazione.

Nota

È possibile accedere alle voci di utilizzo giornaliere non fatturate tramite l'API o il portale del Centro per i partner. Per garantire l'accuratezza dei dati, attendere fino a 24 ore affinché siano disponibili. A seconda della posizione e quando i contatori segnalano l'utilizzo, potrebbero verificarsi ulteriori ritardi.

Viene data la priorità alla consegna puntuale dei dati di utilizzo fatturati con tariffa giornaliera. In alcuni casi, i dati di utilizzo valutati giornalieri più recenti non fatturati potrebbero non essere visualizzati finché i dati fatturati del mese precedente non sono disponibili. Dopo aver ricevuto i dati fatturati, è possibile accedere a tutti i dati di utilizzo non fatturati aggiornati dall'inizio del mese.

punti chiave:

• Attendere fino a 24 ore per la disponibilità dei dati.
• Potrebbero verificarsi ulteriori ritardi a seconda dei tempi di segnalazione della posizione e del contatore.
• I dati di utilizzo giornalieri fatturati vengono classificati in ordine di priorità rispetto ai dati non fatturati.

La comprensione e la pazienza sono apprezzate come ci sforziamo di fornire le informazioni più accurate e tempestive possibili.

Richiesta API

POST https://graph.microsoft.com/v1.0/reports/partners/billing/usage/unbilled/export

Accept: application/json

Content-Type: application/json

{

"currencyCode": "USD",

"billingPeriod": "current",

"attributeSet": "basic"

}

Testo della richiesta

Attributo	Richiesto	Tipo	Descrizione
insiemeDiAttributi	Falso	Stringa	Scegliere "full" per tutti gli attributi o "basic" per un set limitato. Se non specificato, "full" è il valore predefinito. Controlla l'elenco degli attributi in questa sezione. Facoltativo.
periodo di fatturazione	Vero	String	Per ottenere un utilizzo giornaliero non fatturato, usare "current" per il periodo di fatturazione corrente o "last" per il periodo di fatturazione precedente (uguale a "precedente" nell'API v1). Obbligatorio.
codice valuta	Vero	Stringa	Codice valuta di fatturazione partner. Obbligatorio.

Header di richiesta

Per richiedere intestazioni per l'API, vedere Affidabilità e supporto.

Risposta dell'API

HTTP/1.1 202 Accepted  
Location: https://graph.microsoft.com/v1.0/reports/partners/billing/operations/9ab9cb54-d07f-4f52-9ea6-a09d7de52c14

L'API risponde in genere con uno stato HTTP 202. È anche possibile riscontrare altri stati a seconda delle tue richieste. Questi stati sono elencati nella sezione Stati di risposta API Standard.

Codice	Descrizione
202 - Accettato	La richiesta è stata accettata. Per controllare lo stato della tua richiesta, esegui una query sull'URL fornito nell'intestazione della posizione.

Ottenere le voci fatturate per l'utilizzo giornaliero valutato

Recuperare le voci di utilizzo valutato giornalmente del nuovo commercio per una fattura relativa al periodo di fatturazione chiuso.

Richiesta API

POST https://graph.microsoft.com/v1.0/reports/partners/billing/usage/billed/export

{  
"invoiceId": "G00012345",  
"attributeSet": "full"  
}

Parametri di query

N/D

Testo della richiesta

Attributo	Richiesto	Tipo	Descrizione
ID fattura	Vero	String	Identificatore univoco per ogni fattura. Obbligatorio.
insieme di attributi	Falso	Stringa	Scegliere "full" per tutti gli attributi o "basic" per un set limitato. Se non specificato, "full" è il valore predefinito. Controlla l'elenco degli attributi in questa sezione. Facoltativo.

Intestazione della richiesta

Intestazioni di richiesta per l'API. Per altre informazioni, vedere l'affidabilità e il supporto.

Risposta dell'API

HTTP/1.1 202 Accettato
Posizione: https://graph.microsoft.com/v1.0/reports/partners/billing/operations/9ab9cb54-d07f-4f52-9ea6-a09d7de52c14

Quando si usa l'API, in genere restituisce uno stato HTTP 202. Per altri possibili stati in base alle tue richieste, vedere stati.

Codice	Descrizione
202 - Accettato	La richiesta è stata accettata. Per controllare lo stato della richiesta, interrogare l'URL fornito nell'intestazione 'Location'.

Controllare lo stato della richiesta

Per tenere traccia dello stato di una richiesta, assicurarsi di ricevere una risposta HTTP 200 che è un codice di stato standard che indica "succeeded" o "failed". In caso di esito positivo, l'URL del manifesto viene trovato nell'attributo "resourceLocation". Questo attributo fornisce un endpoint per l'accesso alle informazioni necessarie.

Ottenere lo stato dell'operazione

Recupera lo stato di una richiesta.

Richiesta API

RICEVI https://graph.microsoft.com/v1.0/reports/partners/billing/operations/9ab9cb54-d07f-4f52-9ea6-a09d7de52c14

Parametri della richiesta

Nome	Includi in	Richiesto	Tipo	Descrizione
operationId	URI della richiesta	Vero	Stringa	Identificatore univoco per controllare lo stato della richiesta. Obbligatorio.

Intestazione della richiesta

Per richiedere intestazioni per l'API, vedere Affidabilità e supporto.

Testo della richiesta

N/D.

Stato della risposta

Oltre agli stati HTTP standard elencati negli stati di risposta api standard, l'API può restituire anche lo stato HTTP seguente:

Codice	Descrizione
410 - Non Disponibile	Il collegamento al manifesto scade dopo un periodo di tempo impostato. Per ottenere di nuovo il collegamento al manifesto, inviare una nuova richiesta.

Payload della risposta

Il payload della risposta API include gli attributi seguenti:

Attributo	Richiesto	Descrizione
id	Vero	Identificatore univoco per ogni risposta. Obbligatorio.
stato	Vero	Valori e azioni: obbligatorio: non avviato: attendere il tempo specificato nell'intestazione "Retry-After", quindi effettuare un'altra chiamata per verificare lo stato. in esecuzione: attendere la durata specificata nell'intestazione "Retry-After", quindi effettuare un'altra chiamata per controllare lo stato. succeeded: i dati sono pronti. Recuperare il payload del manifesto usando l'URI specificato in resourceLocation. failed: l'operazione non è riuscita in modo permanente. Riavviarlo.
createdDateTime	Vero	Ora in cui è stata effettuata la richiesta. Obbligatorio.
lastActionDateTime	Vero	L'ultima volta che lo stato è cambiato. Obbligatorio.
resourceLocation	Falso	URI per il payload del manifest. Facoltativo.
Errore	Falso	Informazioni dettagliate su eventuali errori, forniti in formato JSON. Facoltativo. Attributi inclusi: message: Descrizione dell'errore. code: tipo di errore.

Oggetto posizione risorsa

Attributo	Descrizione
id	Identificatore univoco per il manifesto.
schemaVersion	Versione dello schema del manifesto.
dataFormat	Formato del file di dati di fatturazione. compressedJSON: formato di dati in cui ogni BLOB è un file compresso che contiene dati in formato righe JSON . Per recuperare i dati da ogni BLOB, decomprimerli.
createdDateTime	Data e ora di creazione del file manifesto.
eTag	Versione dei dati del manifesto. Una modifica nelle informazioni di fatturazione genera un nuovo valore.
partnerTenantId	ID Microsoft Entra del cliente del partner.
rootDirectory	Cartella radice del file.
sasToken	Token di firma di accesso condiviso (SAS) che consente di leggere tutti i file sotto la directory.
tipoDiPartizione	Divide i dati in più blob in base all'attributo "partitionValue". Il sistema suddivide le partizioni che superano il numero supportato. Per impostazione predefinita, i dati vengono partizionati in base al numero di elementi di riga nel file. Evitare di fissare il numero degli elementi o le dimensioni dei file poiché potrebbero cambiare.
blobCount	Numero totale di file per l'ID tenant di questo partner.
blob	Matrice JSON di oggetti "BLOB" che contengono i dettagli del file per l'ID tenant del partner.
oggetto BLOB	Oggetto contenente i dettagli seguenti: nome e partitionValue
nome	Nome del BLOB.
partitionValue	Partizione che contiene il file. La partizione di grandi dimensioni è suddivisa in più file in base a determinati criteri, ad esempio le dimensioni del file o il numero di record, con ogni file contenente lo stesso "partitionValue".

Richiesta API

GET <https://graph.microsoft.com/v1.0/reports/partners/billing/operations/9ab9cb54-d07f-4f52-9ea6-a09d7de52c14>

Risposta dell'API

La risposta consiglia di attendere 10 secondi prima di riprovare durante l'elaborazione dei dati.

HTTP/1.1 200 OK  
Retry-After: 10  
{  
"id": "9ab9cb54-d07f-4f52-9ea6-a09d7de52c14",  
"createdDateTime": "2022-06-1T10-01-03.4Z",  
"lastActionDateTime": "2022-06-1T10-01-05Z",  
"status": "running"  
}

Richiesta API

(10 secondi dopo la richiesta precedente...)

GET <https://graph.microsoft.com/v1.0/reports/partners/billing/operations/9ab9cb54-d07f-4f52-9ea6-a09d7de52c14>

Risposta dell'API

L'API restituisce lo stato "succeeded" e l'URI per "resourceLocation".

HTTP/1.1 200 OK  
Content-Type: application/json  
{

    "@odata.context": "https://graph.microsoft.com/v1.0/\$metadata#reports/partners/billing/operations/\$entity",

    "@odata.type": "#microsoft.graph.partners.billing.exportSuccessOperation",

    "id": "f2170b13-6a8e-47d6-b481-6988490dc0cb",

    "createdDateTime": "2023-12-05T21:17:29Z",

    "lastActionDateTime": "2023-12-05T21:18:00.8897902Z",

    "status": "succeeded",

    "resourceLocation": {

        "id": "44e8500b-ab92-490e-8ac3-90500a1d3427",

        "createdDateTime": "2023-11-06T19:58:47.513Z",

        "schemaVersion": "2",

        "dataFormat": "compressedJSON",

        "partitionType": "default",

        "eTag": "RwDrn7fbiTXy6UULE",

        "partnerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",

        "rootDirectory": "https://adlsreconbuprodeastus201.blob.core.windows.net/path_id",

        "sasToken": "{token}",

        "blobCount": 1,

        "blobs": \[

            {

                "name": "part-00123-5a93fa5d-749f-48bc-a372-9b021d93c3fa.c000.json.gz",

                "partitionValue": "default"

            }

        \]

    }

}

Scaricare gli elementi della riga di riconciliazione dall'archivio BLOB di Azure

Prima di tutto, è necessario ottenere il token di firma di accesso condiviso (SAS) e il percorso di archiviazione BLOB, combinando la directory principale con il nome del BLOB. Questi dettagli sono disponibili nelle proprietà sasToken, rootDirectorye blobs della risposta dell'API del payload del manifesto.

Per procedere, effettuare i seguenti passaggi:

1. Scaricare il file BLOB usando l'SDK/strumento di archiviazione di Azure .
2. Decomprimere il file, che si trova nel formato JSONLines.

Suggerimento

Controlla il codice di esempio . Illustra come scaricare e decomprimere il file BLOB di Azure nel database locale.

Comprendere gli stati di risposta API standard

È possibile ricevere questi stati HTTP dalla risposta dell'API:

Codice	Descrizione
400 - Richiesta non valida	La richiesta è mancante o contiene dati non corretti. Controllare il corpo della risposta per i dettagli dell'errore.
401 - Non autorizzato	L'autenticazione è necessaria prima di effettuare la prima chiamata. Eseguire l'autenticazione con il servizio API partner.
403 - Vietato	Non si dispone dell'autorizzazione necessaria per effettuare la richiesta.
404 - Non trovato	Le risorse richieste non sono disponibili con i parametri di input forniti.
410 - Non Disponibile	Il collegamento al manifesto non è più valido o attivo. Inviare una nuova richiesta.
500 - Errore interno del server	L'API o le relative dipendenze non possono soddisfare la richiesta al momento. Riprovare.
5000 - Nessun dato disponibile	Il sistema non dispone di dati per i parametri di input forniti.

Confrontare le versioni beta e ga

Vedere la tabella di confronto seguente per vedere le differenze tra le versioni beta e le versioni disponibili a livello generale. Se si usa attualmente la versione beta, è probabile che la transizione alla versione GA sia semplice.

Informazioni importanti	Beta	Generalmente disponibile
Host dell'endpoint API	https://ep-billingreconservice-prod-d5bfczcnfvbqbdhx.z01.azurefd.net/	https://graph.microsoft.com/v1.0/reports/partners/billing/usage/
Metodo HTTP	POST	POST
Endpoint dell'API per utilizzo valutato giornalmente non fatturato	https://ep-billingreconservice-prod-d5bfczcnfvbqbdhx.z01.azurefd.net/v1/unbilledusage	https://graph.microsoft.com/v1.0/reports/partners/billing/usage/unbilled/export
Parametri di input per l'API di utilizzo giornaliero non fatturata	Per specificare i parametri nella richiesta API, includerli nella stringa di query dell'URL della richiesta. Ad esempio, per specificare i parametri period e currencyCode, aggiungere ?period=current&currencyCode=usd all'URL della richiesta.	Per fornire input, includere un oggetto JSON nel corpo della richiesta. Il codice JSON deve avere le proprietà seguenti: * currencyCode: valuta di fatturazione. Ad esempio, USD. * billingPeriod: periodo di fatturazione per la fattura. Ad esempio, corrente. Ecco un oggetto JSON di esempio che include le proprietà currencyCode e billingPeriod:<br>{<br> "currencyCode": "USD",<br> "billingPeriod": "current"<br>}
Endpoint dell'API per gli addebiti dell'utilizzo giornaliero	https://ep-billingreconservice-prod-d5bfczcnfvbqbdhx.z01.azurefd.net/v1/billedusage/invoices/{InvoiceId}	https://graph.microsoft.com/v1.0/reports/partners/billing/usage/billed/export
Parametri di input per l'API di utilizzo valutato giornaliero fatturata	Per specificare i parametri nella richiesta API, includere invoiceId nell'URL della richiesta. Inoltre, è possibile includere un parametro di frammento facoltativo nella stringa di query per recuperare il set completo di attributi. Ad esempio, per recuperare il set completo di attributi, aggiungere ?fragment=full all'URL della richiesta.	Per fornire input, includere un oggetto JSON nel corpo della richiesta. Il codice JSON deve avere le proprietà seguenti: * invoiceId: identificatore univoco della fattura. Ad esempio, G00012345. * attributeSet: attributi che devono trovarsi nella risposta, ad esempio full. Ecco un oggetto JSON di esempio che include le proprietà invoiceId e attributeSet: {<br> "invoiceId": "G00012345",<br> "attributeSet": "full"<br>}
Risorsa manifesto	Usare un metodo GET /manifests/{id} separato per recuperare la risorsa manifest.	Usare il metodo GET /operations/{Id} per accedere alla risorsa manifest in resourceLocation. Questo metodo consente di risparmiare tempo eliminando la necessità di una chiamata separata a GET /manifests/{id}.
Modifiche allo schema del manifesto
	"id": non disponibile	"id": identificatore univoco per la risorsa manifest.
	"version": Disponibile	"versione": è stato modificato in "versione schema".
	"dataFormat": disponibile	"dataFormat": disponibile.
	"utcCretedDateTime": disponibile	"utcCretedDateTime": modificato in "createdDateTime".
	"eTag": disponibile	"eTag": disponibile.
	"partnerTenantId": disponibile	"partnerTenantId": disponibile
	"rootFolder": disponibile	"rootFolder": modificato in "rootDirectory".
	"rootFolderSAS": disponibile	"rootFolderSAS": modificato in "sasToken". Questo aggiornamento fornisce solo il token senza il percorso della directory radice. Per individuare la directory, utilizzare invece la proprietà "rootDirectory".
	"partitionType": Disponibile	"partitionType": Disponibile.
	"blobCount": disponibile	"blobCount": Disponibile.
	"sizeInBytes": disponibile	"sizeInBytes": non disponibile.
	"BLOB": disponibile	"BLOB": disponibile.
	"oggetto BLOB": disponibile	"oggetto BLOB": disponibile.
	"name": Disponibile	"name": Disponibile.
	"partitionValue": disponibile	"partitionValue": disponibile.

Confrontare gli attributi di riconciliazione per l'utilizzo giornaliero, sia di base che completo

Per confrontare gli attributi restituiti dall'API di riconciliazione dell'utilizzo fatturato o non fatturato per i set di attributi "completo" o "base", consultare questa tabella. Per ulteriori informazioni su questi attributi e sui relativi significati, vedere i campi nel file di riconciliazione dell'utilizzo valutato giornalmente.

Attributo	Completo	Di base
PartnerId	sì	sì
PartnerName	sì	sì
CustomerId	sì	sì
NomeCliente	sì	Sì
NomeDominioCliente	sì	no
PaeseCliente	sì	no
MpnId	sì	no
Tier2MpnId	sì	no
Numero Fattura	sì	sì
ProductId	sì	sì
SkuId	sì	sì
IDDisponibilità	sì	no
SkuName	sì	sì
ProductName	sì	no
PublisherName	sì	sì
ID del Pubblicatore	sì	no
Descrizione dell'abbonamento	sì	no
ID di Sottoscrizione	sì	sì
DataInizioAddebito	sì	sì
ChargeEndDate	sì	sì
Data di Utilizzo	sì	sì
Tipo di Misuratore	sì	no
Categoria di Misurazione	sì	no
ID contatore	sì	no
ContatoreSottocategoria	sì	no
MeterName	sì	no
MeterRegion	sì	no
Unità	sì	sì
ResourceLocation	sì	no
ConsumedService	sì	no
ResourceGroup	sì	no
ResourceURI	sì	sì
Tipo di Carica	sì	sì
PrezzoUnitario	sì	sì
Quantità	sì	sì
Tipo di Unità	sì	no
Totale Fatturazione Ante Imposte	sì	sì
BillingCurrency	sì	sì
PricingPreTaxTotal	sì	sì
ValutaPrezzi	sì	sì
ServiceInfo1	sì	no
ServiceInfo2	sì	no
Etichette	sì	no
Informazioni aggiuntive	sì	no
Prezzo Unitario Effettivo	sì	sì
PCToBCExchangeRate	sì	sì
PCToBCExchangeRateDate	sì	no
ID di Autorizzazione	sì	sì
Descrizione dei diritti	sì	no
PercentualeCreditoGuadagnatoPartner	sì	no
Percentuale di credito	sì	sì
Tipo di Credito	sì	sì
BenefitOrderID	sì	sì
BenefitID	sì	no
Tipo di Beneficio	sì	sì

Importante

Prendere nota di queste modifiche quando si passa dall'API v1 alla versione 2.

• Ogni nome di attributo inizia con un lettera maiuscola per mantenere la coerenza con il file e migliorare la leggibilità.
• unitOfMeasure viene aggiornato a Unit. Il significato e il valore rimangono invariati, semplificando il nome dell'attributo.
• resellerMpnId è ora Tier2MpnId. Il significato e il valore sono uguali.
• rateOfPartnerEarnedCredit viene aggiornato a PartnerEarnedCreditPercentage. Il nuovo nome e il nuovo valore riflettono la percentuale anziché la frazione, semplificando la comprensione. Ad esempio, 0,15 è ora del 15%.
• rateOfCredit è ora CreditPercentage. Sia il nome che il valore sono stati modificati per fornire una comprensione più chiara. Ad esempio, 1,00 è ora 100%.

Queste modifiche rendono le API più intuitive e facili da usare.

Codice di esempio

Se è necessaria assistenza per la migrazione a questa API, fare riferimento al collegamento che include il codice di esempio C#.

Esempi di API del Centro per i partner: ottenere i dati di riconciliazione della fatturazione.

Contenuto correlato

• 'API Microsoft Graph per esportare i dati di fatturazione dei partner
• SDK/Strumento di Archiviazione di Azure