Udostępnij za pośrednictwem

Manage billing - Get invoice line items

  • Odwołanie
Usługa:
Partner Center Rest
Wersja interfejsu API:
v1

Pobiera elementy wiersza dla scenariuszy GTM. Pierwsze i inne firmy nienaliczone dzienne użycie dla bieżących i poprzednich miesięcy. Opłaty za dzienne użycie w pierwszej i innej firmy są naliczane za wywołanie. Pierwsze i inne firmy niezbilone recon dla bieżących i poprzednich miesięcy.

GET https://api.partnercenter.microsoft.com/v1/invoices/{invoice_id}/lineitems
Z parametrami opcjonalnymi: 
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}

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
invoice_id
 path True

string

Identyfikator faktury. W przypadku niezaliczonych elementów wierszy invoiceId jest ustawiona wartość "unbilled".
currencyCode
 query

string

Kod waluty.
hasPartnerEarnedCredit
 query

boolean

Wartość wskazująca, czy zwrócić elementy wiersza z zastosowanymi środki uzyskane przez partnera.
invoiceLineItemType
 query

string

Element wiersza faktury. przykład: BillingLineItems, UsageLineItems.
offset
 query

integer

int32

Przesunięcie strony.
period
 query

string

Okres nierozliczonego reconu. przykład: bieżący, poprzedni.
provider
 query

string

Typ dostawcy. przykład: Wszystkie, Marketplace.
seekOperation
 query

string

Operacja wyszukiwania do wykonania. Obsługiwane są tylko następne.
size
 query

integer

int32

Rozmiar strony.

Nagłówek żądania

Nazwa Wymagane Typ Opis
Authorization True

string

Token elementu nośnego autoryzacji
ms-correlationid

string

Służy do śledzenia żądań wewnętrznie. Jeśli nie podano identyfikatora ms-correlationid, serwer wygeneruje nowy dla każdego żądania
ms-cv

string

Służy do śledzenia żądań wewnętrznie. Jeśli nie podano ms-cv, serwer wygeneruje nowy dla każdego żądania
ms-requestid

string

Służy do idempotentności żądań. Jeśli nie podano identyfikatora ms-requestid, serwer wygeneruje nowy dla każdego żądania

Odpowiedzi

Nazwa Typ Opis
200 OK

Collections.PagedResourceCollection[InvoiceLineItem]

Żądanie zakończyło się pomyślnie. Treść odpowiedzi zawiera żądane elementy wiersza recon.

Media Types: "application/json", "text/json"
400 Bad Request

Brak danych wejściowych lub nieprawidłowy. Treść odpowiedzi udostępni szczegóły błędu.

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

Żądanie nie zostało uwierzytelnione. Klient musi najpierw uwierzytelnić się za pomocą usługi interfejsu API partnera.

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

Żądanie zostało uwierzytelnione, ale zostało odrzucone, ponieważ obiekt wywołujący nie ma praw do jego wywołania.

Media Types: "application/json", "text/json"
404 Not Found

Zasób nie został znaleziony lub niedostępny z podanymi parametrami wejściowymi.

Media Types: "application/json", "text/json"
500 Internal Server Error

Usługa interfejsu API partnera lub jedna z jego zależności nie spełniła żądania. Osoby wywołujące mogą ponowić próbę.

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

Definicje

Nazwa Opis
Collections.PagedResourceCollection[InvoiceLineItem]
InvoiceLineItem
Link
ResourceAttributes
ResourceLinks
System.Collections.Generic.KeyValuePair[System.String,System.String]

Collections.PagedResourceCollection[InvoiceLineItem]

Nazwa Typ Opis
attributes

ResourceAttributes

continuationToken

string

items

InvoiceLineItem[]

links

ResourceLinks

totalCount

integer

InvoiceLineItem

Nazwa Typ Opis
attributes

ResourceAttributes

billingProvider enum:
  • all
  • azure
  • marketplace
  • none
  • office
  • oneTime
invoiceLineItemType enum:
  • billingLineItems
  • none
  • usageLineItems
Nazwa Typ Opis
headers

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

method

string

uri

string

ResourceAttributes

Nazwa Typ Opis
etag

string

objectType

string

Nazwa Typ Opis
next

Link

previous

Link

self

Link

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

Nazwa Typ Opis
key

string

value

string