Számla lekérése azonosító alapján
A következőre vonatkozik: Partnerközpont | A 21Vianet által üzemeltetett Partnerközpont | Partnerközpont Microsoft Cloud for US Government
Egy adott számlát kér le a számlaazonosító használatával.
Előfeltételek
Hitelesítő adatok a Partnerközpont hitelesítésében leírtak szerint. Ez a forgatókönyv csak az App+User hitelesítő adatokkal való hitelesítést támogatja.
Érvényes számlaazonosító.
C#
Számla lekérése azonosító alapján:
Használja az IPartner.Invoices gyűjteményt , és hívja meg a ById() metódust.
Hívja meg a Get() vagy a GetAsync() metódust.
// IPartner scopedPartnerOperations;
// string selectedInvoiceId;
var invoice = scopedPartnerOperations.Invoices.ById(selectedInvoiceId).Get();
Minta: Konzolteszt alkalmazás. Projekt: PartnerSDK.FeatureSample Osztály: GetInvoice.cs
REST-kérelem
Kérés szintaxisa
Metódus | Kérés URI-ja |
---|---|
GET | {baseURL}/v1/invoices/{invoice-id} HTTP/1.1 |
URI-paraméter
A számla lekéréséhez használja a következő lekérdezési paramétert.
Név | Típus | Kötelező | Leírás |
---|---|---|---|
számlaazonosító | sztring | Yes | Az érték egy számlaazonosító , amely lehetővé teszi, hogy a viszonteladó szűrje egy adott számla eredményeit. |
Kérésfejlécek
További információ: Partnerközpont REST-fejlécei.
A kérés törzse
None
Példa kérésre
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-válasz
Ha sikerült, ez a metódus egy számla típusú erőforrást ad vissza a válasz törzsében.
Sikeres válasz és hibakódok
Minden válaszhoz tartozik egy HTTP-állapotkód, amely jelzi a sikert vagy a hibát, valamint további hibakeresési információkat. Használja a hálózati nyomkövetési eszközt a kód, a hibatípus és a további paraméterek olvasásához. A teljes listát lásd: Hibakódok.
Példa válaszra
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"
}
}