Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Van toepassing op: Partnercentrum beheerd door 21Vianet | Partnercentrum voor Microsoft Cloud voor de Amerikaanse overheid
Opmerking
Voor moderne commerciële aankopen is deze API alleen van toepassing op facturen die vóór 15 mei 2025 zijn gegenereerd.
Haalt een bepaalde factuur op met behulp van de factuur-id.
Vereiste voorwaarden
Inloggegevens zoals beschreven in Partner Center-authenticatie. Dit scenario biedt alleen ondersteuning voor verificatie met app+gebruikersreferenties.
Een geldige factuur-id.
C#
Een factuur ophalen met ID:
Gebruik uw verzameling IPartner.Invoices en roep de Methode ById() aan.
Roep de methoden Get() of GetAsync() aan.
// IPartner scopedPartnerOperations;
// string selectedInvoiceId;
var invoice = scopedPartnerOperations.Invoices.ById(selectedInvoiceId).Get();
Voorbeeld van: Console-test-app. Project: PartnerSDK.FeatureSample Klasse: GetInvoice.cs
REST-aanvraag
Aanvraagsyntaxis
| Methode | URI-aanvraag |
|---|---|
| GET | {baseURL}/v1/invoices/{invoice-id} HTTP/1.1 |
URI-parameter
Gebruik de volgende queryparameter om de factuur op te halen.
| Naam | Typologie | Verplicht | Description |
|---|---|---|---|
| factuur-id | string | Yes | De waarde is een factuur-id waarmee de reseller de resultaten voor een bepaalde factuur kan filteren. |
Headers aanvragen
Voor meer informatie, zie Partner Center REST headers.
Inhoud van het verzoek
Geen
Vraag om voorbeeld
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-antwoord
Als dit lukt, retourneert deze methode een factuurresource in de hoofdtekst van het antwoord.
Geslaagde antwoorden en foutcodes
Elk antwoord wordt geleverd met een HTTP-statuscode die aangeeft of er sprake is van succes of mislukking en aanvullende foutopsporingsinformatie. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en aanvullende parameters te lezen. Zie Foutcodes voor de volledige lijst.
Voorbeeld van antwoord
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"
}
}