請求書の推定リンクを取得する
適用対象: パートナー センター | 21Vianet が運営するパートナー センター | Microsoft Cloud for US Government のパートナー センター
未請求の調整明細の詳細を照会するのに役立つ見積もりリンクを取得できます。
前提条件
パートナー センターの認証に関するページで説明している資格情報。 このシナリオでは、スタンドアロンの App と App+User の両方の資格情報を使用した認証がサポートされています。
請求書識別子。 これにより、明細を取得する請求書が識別されます。
C#
次のコード例は、見積もりリンクを取得して、特定の通貨の未請求明細を照会する方法を示しています。 応答には、各期間 (現在と前の月など) の見積もりリンクが含まれています。
// IAggregatePartner partnerOperations;
// string curencyCode;
// all the operations executed on this partner operation instance will share the same correlation Id but will differ in request Id
IPartner scopedPartnerOperations = partnerOperations.With(RequestContextFactory.Instance.Create(Guid.NewGuid()));
// read estimate links for currencycode
var estimateLinks = scopedPartnerOperations.Invoices.Estimates.Links.ByCurrency(curencyCode).Get();
同様の例については、次を参照してください。
- サンプル: コンソール テスト アプリ
- プロジェクト: パートナー センター SDK のサンプル
- クラス: GetEstimatesLinks.cs
REST 要求
要求の構文
認証方法 | 要求 URI |
---|---|
GET | {baseURL}/v1/invoices/estimates/links?currencycode={currencycode} HTTP/1.1 |
URI パラメーター
要求を作成するときは、次の URI とクエリ パラメーターを使用します。
名前 | タイプ | Required | 説明 |
---|---|---|---|
currencyCode | string | はい | 未請求明細の通貨コード。 |
要求ヘッダー
詳細については、「パートナー センター REST ヘッダー」を参照してください。
リクエストの本文
なし。
要求の例
GET https://api.partnercenter.microsoft.com/v1/invoices/estimates/links?currencycode=usd HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 1234ecb8-37af-45f4-a1a1-358de3ca2b9e
MS-CorrelationId: 5e612512-4345-4bb0-866e-47aeda031234
X-Locale: en-US
MS-PartnerCenter-Application: Partner Center .NET SDK Samples
Host: api.partnercenter.microsoft.com
重要
2023 年 6 月の時点で、最新のパートナー センター .NET SDK リリース 3.4.0 がアーカイブされるようになりました。 SDK リリースは、有用な情報が記載された readme ファイルと一緒に GitHub からダウンロードできます。
パートナーの皆様には、パートナー センター REST API を引き続き使用することをお勧めします。
REST 応答
成功した場合、応答には、未請求の見積もりを取得するためのリンクが含まれます。
応答の成功とエラーのコード
各応答には、成功または失敗を示す HTTP ステータス コードと、追加のデバッグ情報が付属しています。 このコード、エラーの種類、追加のパラメーターを読み取るには、ネットワーク トレース ツールを使用します。 完全な一覧については、パートナー センターの REST エラーコードに関する記事を参照してください。
応答の例
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Server: Microsoft-IIS/10.0
MS-CorrelationId: 80EAA055-B5D3-4D88-BFE8-924A3F706462
MS-RequestId: 1b18689e-3fe3-4fdb-d09e-39d13941390b
X-Locale: en-US
X-SourceFiles: =?UTF-8?B?RDpcU291cmNlc1xSUEUuUGFydG5lci5TZXJ2aWNlLkJpbGxpbmdTZXJ2aWNlXHYxLjFcV2ViQXBpc1xCaWxsaW5nU2VydmljZS5WMi5XZWJcdjFcaW52b2ljZXNcZXN0aW1hdGVzXGxpbmtz?=
X-Powered-By: ASP.NET
Date: Thu, 14 Mar 2019 18:15:06 GMT
Content-Length: 1857
{
"totalCount": 4,
"items": [
{
"type": "daily_rated_usage",
"title": "Daily rated usage unbilled",
"description": "This invoice line items includes unbilled consumption based data only.",
"period": "Current",
"link": {
"uri": "/invoices/unbilled/lineitems?provider=Marketplace&invoicelineitemtype=UsageLineItems¤cycode=USD&period=current&size=2000",
"method": "GET",
"headers": []
}
},
{
"type": "daily_rated_usage",
"title": "Daily rated usage unbilled",
"description": "This invoice line items includes unbilled consumption based data only.",
"period": "Previous",
"link": {
"uri": "/invoices/unbilled/lineitems?provider=Marketplace&invoicelineitemtype=UsageLineItems¤cycode=USD&period=previous&size=2000",
"method": "GET",
"headers": []
}
},
{
"type": "non_consumption",
"title": "Unbilled reconciliation line items",
"description": "This includes reconciliation line items for unbilled data only.",
"period": "Current",
"link": {
"uri": "/invoices/unbilled/lineitems?provider=all&invoicelineitemtype=billinglineitems¤cycode=USD&period=current&size=2000",
"method": "GET",
"headers": []
}
},
{
"type": "non_consumption",
"title": "Unbilled reconciliation line items",
"description": "This includes reconciliation line items for unbilled data only.",
"period": "Previous",
"link": {
"uri": "/invoices/unbilled/lineitems?provider=all&invoicelineitemtype=billinglineitems¤cycode=USD&period=previous&size=2000",
"method": "GET",
"headers": []
}
}
],
"attributes": {
"objectType": "Collection"
}
}