Pobieranie zestawienia faktur
Dotyczy: Centrum partnerskie | Centrum partnerskie obsługiwane przez firmę 21Vianet | Centrum partnerskie dla Microsoft Cloud for US Government
Wymagania wstępne
Poświadczenia zgodnie z opisem w temacie Uwierzytelnianie w Centrum partnerskim. Ten scenariusz obsługuje uwierzytelnianie tylko przy użyciu poświadczeń użytkownika i aplikacji.
Prawidłowy identyfikator faktury.
C#
Aby uzyskać zestawienie faktury według identyfikatora, użyj kolekcji IPartner.Invoices i wywołaj metodę ById() przy użyciu identyfikatora faktury, a następnie wywołaj metody Documents() i Statement(), aby uzyskać dostęp do instrukcji faktury. Na koniec wywołaj metody Get() lub GetAsync().
// IPartner scopedPartnerOperations;
// string selectedInvoiceId;
var invoiceStatement = scopedPartnerOperations.Invoices.ById(selectedInvoiceId).Documents.Statement.Get();
Przykład: aplikacja testowa konsoli. Projekt: PartnerSDK.FeatureSample Class: GetInvoiceStatement.cs
Żądanie REST
Składnia żądania
Metoda | Identyfikator URI żądania |
---|---|
GET | {baseURL}/v1/invoices/{invoice-id}/documents/statement HTTP/1.1 |
Parametr identyfikatora URI
Użyj następującego parametru zapytania, aby uzyskać instrukcję faktury.
Nazwa | Typ | Wymagane | Opis |
---|---|---|---|
identyfikator faktury | ciąg | Tak | Wartość to identyfikator faktury, który umożliwia odsprzedawcy filtrowanie wyników dla danej faktury. |
Nagłówki żądań
Aby uzyskać więcej informacji, zobacz Nagłówki REST Centrum partnerskiego.
Treść żądania
Brak
Przykład żądania
GET https://api.partnercenter.microsoft.com/v1/invoices/<invoice-id>/documents/statement HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 8ac25aa5-9537-4b6d-b782-aa0c8e979e99
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
Odpowiedź REST
W przypadku powodzenia ta metoda zwraca zasób InvoiceStatement w treści odpowiedzi.
Kody powodzenia i błędów odpowiedzi
Każda odpowiedź zawiera kod stanu HTTP, który wskazuje powodzenie lub niepowodzenie oraz dodatkowe informacje o debugowaniu. Użyj narzędzia do śledzenia sieci, aby odczytać ten kod, typ błędu i dodatkowe parametry. Aby uzyskać pełną listę, zobacz Kody błędów.
Przykład odpowiedzi
HTTP/1.1 200 OK
Content-Length: 219753
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: a45e6643-1caf-4429-8f90-07c03d85bc2b
Date: Thu, 24 Mar 2016 05:21:01 GMT
{
_content {System.Net.Http.ByteArrayContent} System.Net.Http.HttpContent {System.Net.Http.ByteArrayContent}
_content {byte[219753]} byte[]
_headers {Content-Type: application/pdf Content-Disposition: attachment; filename=Invoice_G000024132.pdf}
}