Udostępnij za pośrednictwem

Pobieranie potwierdzenia otrzymania faktury

  • Artykuł

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: 57eb2ca7-755f-450f-9187-eae1e75a0114

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: a1d6ab41-5a30-4643-898b-b30d65d3a0a1
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}
}