Freigeben über


Abrufen der Anweisung zum Rechnungsempfang

Ruft eine Rechnungsbelegabrechnung mithilfe der Rechnungs-ID und der Beleg-ID ab.

Wichtig

Dieses Feature gilt nur für Taiwan-Steuerbelege.

Voraussetzungen

  • Anmeldeinformationen, wie unter Partner Center-Authentifizierung beschrieben. In diesem Szenario wird Authentifizierung nur mit App- und Benutzeranmeldeinformationen unterstützt.

  • Eine gültige Rechnungs-ID und eine entsprechende Beleg-ID.

C#

Um eine Rechnungsbelegabrechnung nach ID abzurufen, verwenden Sie ab Partner Center SDK v1.12.0 Ihre IPartner.Invoices-Sammlung , und rufen Sie die ById() -Methode mithilfe der Rechnungs-ID auf, rufen Sie dann die Receipts-Auflistung auf, und rufen Sie ById() auf, und rufen Sie dann die Methoden Documents() und Statement() auf, um auf die Rechnungsbestätigungsabrechnung zuzugreifen. Rufen Sie schließlich die Methoden Get() oder GetAsync() auf.

// IPartner scopedPartnerOperations;
// string selectedInvoiceId;

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

Beispiel: Konsolentest-App. Projekt: PartnerSDK.FeatureSample-Klasse: GetInvoiceReceiptStatement.cs

REST-Anforderung

Anforderungssyntax

Methode Anforderungs-URI
GET {baseURL}/v1/invoices/{invoice-id}/receipts/{receipt-id}/documents/statement HTTP/1.1

URI-Parameter

Verwenden Sie den folgenden Abfrageparameter, um die Rechnungsbelegabrechnung abzurufen.

Name Typ Erforderlich BESCHREIBUNG
Rechnungs-ID Zeichenfolge Ja Der Wert ist eine Rechnungs-ID, die es dem Wiederverkäufer ermöglicht, die Ergebnisse für eine bestimmte Rechnung zu filtern.
Beleg-ID Zeichenfolge Ja Der Wert ist eine Beleg-ID, die es dem Wiederverkäufer ermöglicht, die Belege für eine bestimmte Rechnung zu filtern.

Anforderungsheader

Weitere Informationen finden Sie unter Partner Center-REST-Header.

Anforderungstext

Keine

Anforderungsbeispiel

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

REST-Antwort

Bei erfolgreicher Ausführung gibt diese Methode einen PDF-Stream im Antworttext zurück.

Erfolgs- und Fehlercodes der Antwort

Jede Antwort enthält einen HTTP-Statuscode, der Aufschluss darüber gibt, ob der Vorgang erfolgreich war, sowie ggf. zusätzliche Debuginformationen. Verwende ein Tool für die Netzwerkablaufverfolgung, um diesen Code, den Fehlertyp und zusätzliche Parameter zu lesen. Die vollständige Liste findest du unter Partner-API: REST-Fehlercodes.

Antwortbeispiel

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}
}