Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Gilt für: Partner Center betrieben von 21Vianet | Partner Center für Microsoft Cloud für die US-Regierung
Hinweis
Bei modernen kommerziellen Einkäufen gilt diese API nur für Rechnungen, die vor dem 15. Mai 2025 generiert wurden.
Ruft eine bestimmte Rechnung mithilfe der Rechnungs-ID ab.
Voraussetzungen
Anmeldeinformationen wie unter Partner Center-Authentifizierung beschrieben. Dieses Szenario unterstützt nur die Authentifizierung mit App+Benutzeranmeldeinformationen.
Eine gültige Rechnungs-ID.
C#
So rufen Sie eine Rechnung über die ID ab:
Verwenden Sie Ihre IPartner.Invoices-Sammlung , und rufen Sie die ById()- Methode auf.
Rufen Sie die Methoden Get() oder GetAsync() auf.
// IPartner scopedPartnerOperations;
// string selectedInvoiceId;
var invoice = scopedPartnerOperations.Invoices.ById(selectedInvoiceId).Get();
Beispiel: Konsolentest-App. Projekt: PartnerSDK.FeatureSample-Klasse: GetInvoice.cs
REST-Anforderung
Anforderungssyntax
| Methode | Anforderungs-URI |
|---|---|
| GET | {baseURL}/v1/invoices/{invoice-id} HTTP/1.1 |
URI-Parameter
Verwenden Sie den folgenden Abfrageparameter, um die Rechnung abzurufen.
| Name | Typ | Erforderlich | Description |
|---|---|---|---|
| Rechnungs-ID | String | Yes | Der Wert ist eine Rechnungs-ID , mit der der Händler die Ergebnisse für eine bestimmte Rechnung filtern kann. |
Anforderungsheader
Weitere Informationen finden Sie unter Partner Center REST-Header.
Anfragekörper
Nichts
Beispielanfrage
GET https://api.partnercenter.microsoft.com/v1/invoices/<invoice-id> 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 die Methode eine Rechnungsressource im Antworttext zurück.
Antworterfolgs- und Fehlercodes
Jede Antwort enthält einen HTTP-Statuscode, der Erfolg oder Fehler sowie zusätzliche Debuginformationen angibt. 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 Fehlercodes.
Antwortbeispiel
HTTP/1.1 200 OK
Content-Length: 676
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 8ac25aa5-9537-4b6d-b782-aa0c8e979e99
Date: Thu, 24 Mar 2016 05:22:14 GMT
{
"id": "G000024135",
"invoiceDate": "2018-02-08T22:40:37.5897767Z",
"billingPeriodStartDate": "2018-02-01T22:40:37.5897767Z",
"billingPeriodEndDate": "2018-02-28T22:40:37.5897767Z",
"totalCharges": 2076.63,
"paidAmount": 0,
"currencyCode": "USD",
"currencySymbol": "$",
"pdfDownloadLink": "/invoices/G000024135/documents/statement",
"taxReceipts": [
{
"id": "123456",
"taxReceiptPdfDownloadLink": "/invoices/G000024135/receipts/123456/documents/statement"
}
],
"invoiceDetails": [
{
"invoiceLineItemType": "billing_line_items",
"billingProvider": "one_time",
"links": {
"self": {
"uri": "/invoices/OneTime-G000024135/lineitems/OneTime/BillingLineItems",
"method": "GET",
"headers": []
}
},
"attributes": {
"objectType": "InvoiceDetail"
}
}
],
"documentType": "invoice",
"invoiceType": "OneTime",
"links": {
"self": {
"uri": "/invoices/OneTime-G000024135",
"method": "GET",
"headers": []
}
},
"attributes": {
"objectType": "Invoice"
}
}