Ottenere le voci di utilizzo commerciale fatturate

Articolo
03/15/2024

Nota

Questa API non smetterà di funzionare dopo il 30 settembre 2024. Sarà comunque disponibile e funzionale per le voci di utilizzo fatturate giornaliere precedenti. Fare riferimento ai dettagli seguenti per decidere quale versione usare e quando.

A meno che non si sia passati alla versione 2 a livello generale, usare questa API fino al 30 settembre 2024 per ricevere le voci di utilizzo giornaliere fatturate per le fatture create per periodi di fatturazione compresi tra settembre 2022 e settembre 2024.
Usare solo questa API per ottenere le voci di utilizzo valutate giornaliere fatturate per le fatture create per i periodi di fatturazione precedenti a settembre 2022.
Usare solo l'API v2 GA per ottenere le voci di utilizzo valutate giornaliere giornaliere per le fatture create per i periodi di fatturazione a partire da settembre 2022.

Per iniziare a preparare la migrazione alle nuove API, vedere il collegamento seguente:

API di riconciliazione dell'utilizzo con fatturazione e non fatturata giornaliera v2 (GA)

È possibile utilizzare i metodi seguenti per ottenere una raccolta di dettagli per le voci della fattura a consumo commerciale (note anche come voci di utilizzo giornaliero chiuse) per una fattura specificata.

Importante

I dati di utilizzo valutati giornalieri non includono gli addebiti per questi prodotti:

Prenotazione di Azure
Piano di risparmio di Azure
Office
Dynamics
Microsoft Power Apps
Software perpetuo
Sottoscrizione software
Prodotto SaaS di terze parti

Prerequisiti

Credenziali descritte in Autenticazione del Centro per i partner. Questo scenario supporta l'autenticazione con le credenziali app autonome e App+Utente.
Identificatore di fattura. Identifica la fattura per cui recuperare le voci.

C#

Per ottenere le voci commerciali per la fattura specificata, è necessario recuperare l'oggetto fattura:

Chiamare il metodo ById per ottenere un'interfaccia alle operazioni della fattura per la fattura specificata.
Chiamare il metodo Get o GetAsync per recuperare l'oggetto fattura. L'oggetto fattura contiene tutte le informazioni per la fattura specificata.

Il provider identifica l'origine delle informazioni dettagliate fatturate, ad esempio una volta. InvoiceLineItemType specifica il tipo , ad esempio UsageLineItem.

Il codice di esempio seguente usa un ciclo foreach per elaborare la raccolta di elementi di riga. Viene recuperata una raccolta separata di elementi riga per ogni InvoiceLineItemType.

Per ottenere una raccolta di voci che corrispondono a un'istanza invoiceDetail :

Passare l'oggetto BillingProvider e InvoiceLineItemType dell'istanza al metodo By.
Chiamare il metodo Get o GetAsync per recuperare gli elementi di riga associati.
Creare un enumeratore per attraversare la raccolta, come illustrato nell'esempio seguente.

// IAggregatePartner partnerOperations;
// string invoiceId;
// string curencyCode;
// string period;
// int pageMaxSizeReconLineItems = 2000;

// all the operations executed on this partner operation instance will share the same correlation Id but will differ in request Id
IPartner scopedPartnerOperations = partnerOperations.With(RequestContextFactory.Instance.Create(Guid.NewGuid()));

var seekBasedResourceCollection = scopedPartnerOperations.Invoices.ById(invoiceId).By("onetime", "usagelineitems", curencyCode, period, pageMaxSizeReconLineItems).Get();

var fetchNext = true;

ConsoleKeyInfo keyInfo;

var itemNumber = 1;
while (fetchNext)
{
    Console.Out.WriteLine("\tLine line items count: " + seekBasedResourceCollection.Items.Count());

    seekBasedResourceCollection.Items.ToList().ForEach(item =>
    {
        // Instance of type DailyRatedUsageLineItem
        if (item is DailyRatedUsageLineItem)
        {
            Type t = typeof(DailyRatedUsageLineItem);
            PropertyInfo[] properties = t.GetProperties();

            foreach (PropertyInfo property in properties)
            {
                // Insert code here to work with the line item properties
            }
        }
        itemNumber++;
    });

    Console.Out.WriteLine("\tPress any key to fetch next data. Press the Escape (Esc) key to quit: \n");
    keyInfo = Console.ReadKey();

    if (keyInfo.Key == ConsoleKey.Escape)
    {
        break;
    }

    fetchNext = !string.IsNullOrWhiteSpace(seekBasedResourceCollection.ContinuationToken);

    if (fetchNext)
    {
        if (seekBasedResourceCollection.Links.Next.Headers != null && seekBasedResourceCollection.Links.Next.Headers.Any())
        {
            seekBasedResourceCollection = scopedPartnerOperations.Invoices.ById(invoiceId).By("onetime", "usagelineitems", curencyCode, period, pageMaxSizeReconLineItems).Seek(seekBasedResourceCollection.ContinuationToken, SeekOperation.Next);
        }
    }
}

Per un esempio simile, vedere quanto segue:

Esempio: App di test della console
Progetto: Esempi di SDK del Centro per i partner
Classe: GetBilledConsumptionReconLineItemsPaging.cs

Richiesta REST

Sintassi della richiesta

Usare la prima sintassi per restituire un elenco completo di ogni voce per la fattura specificata. Per le fatture di grandi dimensioni, per recuperare un elenco di voci su più pagine usare la seconda sintassi con una dimensione specifica e un offset basato su 0. Usare la terza sintassi per ottenere la pagina successiva di elementi della riga di riconciliazione usando seekOperation = "Next".

metodo	URI della richiesta
GET	{baseURL}/v1/invoices/{invoice-id}/lineitems?provider=onetime&invoicelineitemtype=usagelineitems¤cycode={currencycode} HTTP/1.1
GET	{baseURL}/v1/invoices/{invoice-id}/lineitems?provider=onetime&invoicelineitemtype=usagelineitems¤cycode={currencycode}&size={size} HTTP/1.1
GET	{baseURL}/v1/invoices/{invoice-id}/lineitems?provider=onetime&invoicelineitemtype=usagelineitems¤cycode={currencycode}&size={size}&seekOperation=Next

Parametri URI

Usare gli URI e i parametri di query seguenti durante la creazione della richiesta.

Nome	Digita	Obbligatorio	Descrizione
invoice-id	string	Sì	Stringa che identifica la fattura.
provider	string	Sì	Provider: "OneTime".
invoice-line-item-type	string	Sì	Tipo di dettaglio fattura: "UsageLineItems".
currencyCode	string	Sì	Codice di valuta per le voci fatturate.
period	string	Sì	Periodo per la riconciliazione fatturata. esempio: corrente, precedente.
size	number	No	Numero massimo di elementi da restituire. Le dimensioni predefinite sono 2000
seekOperation	string	No	Impostare seekOperation=Next per ottenere la pagina successiva di elementi di ricognizione.

Intestazioni delle richieste

Per altre informazioni, vedi Intestazioni REST del Centro per i partner.

Corpo della richiesta

Nessuno.

Risposta REST

In caso di esito positivo, la risposta contiene la raccolta di dettagli dell'elemento di riga.

Per l'elemento riga ChargeType, il valore Purchase viene mappato a Nuovo. Il valore Rimborso viene mappato a Annulla.

Codici di errore e di esito della risposta

Ogni risposta viene fornita con un codice di stato HTTP che ne indica l'esito e con informazioni di debug aggiuntive. Usa uno strumento di traccia di rete per leggere il codice, il tipo di errore e parametri aggiuntivi. Per l'elenco completo, vedi Codici di errore REST del Centro per i partner.

Esempi REST

Esempio di richiesta-risposta 1

I dettagli per questo esempio di richiesta REST e risposta sono i seguenti:

Provider: OneTime
InvoiceLineItemType: UsageLineItems
Periodo: Precedente

Esempio di richiesta 1

GET https://api.partnercenter.microsoft.com/v1/invoices/T000001234/lineitems?provider=onetime&invoicelineitemtype=usagelineitems&currencycode=usd&period=previous&size=2000 HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 1234ecb8-37af-45f4-a1a1-358de3ca2b9e
MS-CorrelationId: 5e612512-4345-4bb0-866e-47aeda031234
X-Locale: en-US
MS-PartnerCenter-Application: Partner Center .NET SDK Samples
Host: api.partnercenter.microsoft.com