Pobieranie potwierdzenia otrzymania faktury

Pobiera oświadczenie potwierdzenia faktury przy użyciu identyfikatora faktury i identyfikatora paragonu.

Ważne

Ta funkcja ma zastosowanie tylko do paragonów podatkowych na Tajwanie.

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 i odpowiadający mu identyfikator paragonu.

C#

Aby uzyskać instrukcję potwierdzenia faktury według identyfikatora, począwszy od zestawu SDK Centrum partnerskiego w wersji 1.12.0, użyj kolekcji IPartner.Invoices i wywołaj metodę ById() przy użyciu identyfikatora faktury, a następnie wywołaj kolekcję Paragony i wywołaj metodę ById(), a następnie wywołaj metody Documents() i Statement(), aby uzyskać dostęp do instrukcji potwierdzenia faktury. Na koniec wywołaj metody Get() lub GetAsync().

// IPartner scopedPartnerOperations;
// string selectedInvoiceId;

var invoiceStatement = scopedPartnerOperations.Invoices.ById(selectedInvoiceId).Receipts.ById(selectedReceipt).Documents.Statement.Get();

Przykład: aplikacja testowa konsoli. Projekt: PartnerSDK.FeatureSample Class: GetInvoiceReceiptStatement.cs

Żądanie REST

Składnia żądania

Metoda	Identyfikator URI żądania
GET	{baseURL}/v1/invoices/{invoice-id}/receipts/{receipt-id}/documents/statement HTTP/1.1

Parametr identyfikatora URI

Użyj następującego parametru zapytania, aby pobrać instrukcję potwierdzenia 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.
identyfikator paragonu	ciąg	Tak	Wartość jest identyfikatorem paragonu, który umożliwia odsprzedawcy filtrowanie paragonó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>/receipts/<receipt-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 strumień pdf 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: 195556
Content-Type: application/pdf
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-RequestId: cc1ba6db-ab26-404a-9196-712b6395f518
Date: Tue, 05 Feb 2019 04:08:23 GMT

{
    _content    {System.Net.Http.ByteArrayContent}    System.Net.Http.HttpContent {System.Net.Http.ByteArrayContent}
    _content    {byte[195556]}    byte[]
    _headers    {Content-Type: application/pdf Content-Disposition: attachment; filename=E-Tax-8602768.pdf}
}