Condividi tramite


Manage billing - Get invoice line items

Ottiene gli elementi di riga per gli scenari GTM. Utilizzo giornaliero di primo e di terze parti non fatturato per i mesi correnti e precedenti. First e Third party hanno fatturato l'utilizzo giornaliero valutato per un invoceid. Ricognizione prima e terza parte non fatturata per i mesi correnti e precedenti.

GET https://api.partnercenter.microsoft.com/v1/invoices/{invoice_id}/lineitems
GET https://api.partnercenter.microsoft.com/v1/invoices/{invoice_id}/lineitems?provider={provider}&invoiceLineItemType={invoiceLineItemType}&hasPartnerEarnedCredit={hasPartnerEarnedCredit}&currencyCode={currencyCode}&period={period}&size={size}&offset={offset}&seekOperation={seekOperation}

Parametri dell'URI

Nome In Necessario Tipo Descrizione
invoice_id
path True

string

ID fattura. Per gli articoli non fatturati invoiceId è impostato su "non fatturato".

currencyCode
query

string

Codice valuta.

hasPartnerEarnedCredit
query

boolean

Valore che indica se restituire le voci con credito ottenuto dal partner applicato.

invoiceLineItemType
query

string

Voce della fattura. esempio: BillingLineItems, UsageLineItems.

offset
query

integer

int32

Offset di pagina.

period
query

string

Periodo per la riconciliazione non fatturata. esempio: corrente, precedente.

provider
query

string

Tipo di provider. esempio: All, Marketplace.

seekOperation
query

string

Operazione di ricerca da eseguire. È supportato solo Next.

size
query

integer

int32

Dimensioni della pagina.

Intestazione della richiesta

Nome Necessario Tipo Descrizione
Authorization True

string

Token di connessione dell'autorizzazione

ms-correlationid

string

Usato per tenere traccia delle richieste internamente. Se non viene specificato un ms-correlationid, il server genererà un nuovo elemento per ogni richiesta

ms-cv

string

Usato per tenere traccia delle richieste internamente. Se non viene specificata una ms-cv, il server genererà un nuovo per ogni richiesta

ms-requestid

string

Usato per l'idempotenza delle richieste. Se non viene specificato un ms-requestid, il server genererà un nuovo per ogni richiesta

Risposte

Nome Tipo Descrizione
200 OK

Collections.PagedResourceCollection[InvoiceLineItem]

La richiesta ha avuto esito positivo. Il corpo della risposta contiene gli elementi di riga di ricognizione richiesti.

Media Types: "application/json", "text/json"

400 Bad Request

Non è presente un input mancante o non valido. Il corpo della risposta fornirà i dettagli dell'errore.

Media Types: "application/json", "text/json"

401 Unauthorized

La richiesta non è stata autenticata. Il client deve prima eseguire l'autenticazione con il servizio API partner.

Media Types: "application/json", "text/json"

403 Forbidden

La richiesta è stata autenticata ma è stata rifiutata perché il chiamante non dispone dei diritti per richiamarlo.

Media Types: "application/json", "text/json"

404 Not Found

La risorsa non viene trovata o non è disponibile con i parametri di input specificati.

Media Types: "application/json", "text/json"

500 Internal Server Error

Il servizio API partner o una delle relative dipendenze non è riuscito a soddisfare la richiesta. I chiamanti possono riprovare.

Media Types: "application/json", "text/json"

Definizioni

Nome Descrizione
Collections.PagedResourceCollection[InvoiceLineItem]
InvoiceLineItem
Link
ResourceAttributes
ResourceLinks
System.Collections.Generic.KeyValuePair[System.String,System.String]

Collections.PagedResourceCollection[InvoiceLineItem]

Nome Tipo Descrizione
attributes

ResourceAttributes

continuationToken

string

items

InvoiceLineItem[]

links

ResourceLinks

totalCount

integer

InvoiceLineItem

Nome Tipo Descrizione
attributes

ResourceAttributes

billingProvider enum:
  • all
  • azure
  • marketplace
  • none
  • office
  • oneTime
invoiceLineItemType enum:
  • billingLineItems
  • none
  • usageLineItems
Nome Tipo Descrizione
headers

System.Collections.Generic.KeyValuePair[System.String,System.String][]

method

string

uri

string

ResourceAttributes

Nome Tipo Descrizione
etag

string

objectType

string

Nome Tipo Descrizione
next

Link

previous

Link

self

Link

System.Collections.Generic.KeyValuePair[System.String,System.String]

Nome Tipo Descrizione
key

string

value

string