次の方法で共有

ID で請求書を取得する

適用対象: 21Vianet が運営するパートナー センター |Microsoft Cloud for US Government のパートナー センター

注

最新の商用購入の場合、この API は 2025 年 5 月 15 日より前に生成された請求書にのみ適用されます。

請求書 ID を使用して、特定の請求書を取得します。

[前提条件]

  • パートナー センター認証で説明されている資格証明。 このシナリオでは、App+User 資格情報のみを使用した認証がサポートされます。

  • 有効な請求書 ID。

C#

ID で請求書を取得するには:

  1. IPartner.Invoices コレクションを使用し、ById() メソッドを呼び出します。

  2. Get() メソッドまたは GetAsync() メソッドを呼び出します。

// IPartner scopedPartnerOperations;
// string selectedInvoiceId;

var invoice = scopedPartnerOperations.Invoices.ById(selectedInvoiceId).Get();

サンプル: コンソール テスト アプリの。 プロジェクト: PartnerSDK.FeatureSample クラス: GetInvoice.cs

REST 要求

リクエスト構文

メソッド 要求 URI
取得 {baseURL}/v1/invoices/{invoice-id} HTTP/1.1

URI パラメーター

請求書を取得するには、次のクエリ パラメーターを使用します。

名前 タイプ 必須 Description
invoice-id 文字列 イエス この値は、リセラーが特定の請求書の結果をフィルター処理できるようにする invoice-id です。

要求ヘッダー

詳細については、「パートナー センター REST ヘッダー」を参照してください。

リクエストの本文

None

要求の例

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 応答

成功した場合、このメソッドは応答本文で Invoice リソースを返します。

応答の成功とエラー コード

各応答には、成功または失敗を示す HTTP ステータス コードと、追加のデバッグ情報が付属しています。 このコード、エラーの種類、追加のパラメーターを読み取るには、ネットワーク トレース ツールを使用します。 完全な一覧については、エラー コードに関するページを参照してください。

応答の例

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"
    }
}
  • Last updated on