請求書を ID で取得する
適用対象: パートナー センター | 21Vianet が運営するパートナー センター | Microsoft Cloud for US Government のパートナー センター
請求書 ID を使用して、特定の請求書を取得します。
前提条件
パートナー センターの認証に関するページで説明している資格情報。 このシナリオでは、アプリとユーザーの資格情報を使用した認証のみがサポートされます。
有効な請求書 ID。
C#
ID で請求書を取得するには:
IPartner.Invoices コレクションを使用し、ById() メソッドを呼び出します。
Get() メソッドまたは GetAsync() メソッドを呼び出します。
// IPartner scopedPartnerOperations;
// string selectedInvoiceId;
var invoice = scopedPartnerOperations.Invoices.ById(selectedInvoiceId).Get();
サンプル: コンソール テスト アプリ。 プロジェクト: PartnerSDK.FeatureSample クラス: GetInvoice.cs
REST 要求
要求の構文
認証方法 | 要求 URI |
---|---|
GET | {baseURL}/v1/invoices/{invoice-id} HTTP/1.1 |
URI パラメーター
請求書を取得するには、次のクエリ パラメーターを使用します。
名前 | Type | 必須 | 説明 |
---|---|---|---|
invoice-id | string | はい | この値は、リセラーが特定の請求書の結果をフィルター処理できるようにする invoice-id です 。 |
要求ヘッダー
詳細については、「パートナー センター REST ヘッダー」を参照してください。
[要求本文]
なし
要求の例
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: 57eb2ca7-755f-450f-9187-eae1e75a0114
REST 応答
成功した場合、このメソッドは応答本文で Invoice リソースを返します。
応答の成功とエラーのコード
各応答には、成功または失敗を示す HTTP ステータス コードと、追加のデバッグ情報が付属しています。 このコード、エラーの種類、追加のパラメーターを読み取るには、ネットワーク トレース ツールを使用します。 完全な一覧については、エラー コードに関するページを参照してください。
応答の例
HTTP/1.1 200 OK
Content-Length: 676
Content-Type: application/json; charset=utf-8
MS-CorrelationId: 57eb2ca7-755f-450f-9187-eae1e75a0114
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"
}
}