Manage billing - Get invoice line items

Service:

Partner Center Rest

API Version:

v1

获取 GTM 方案的行项。 当前和上一个月的第一方和第三方未计费的每日分级使用量。 第一方和第三方对调用的每日分级使用量计费。 当前和上一个月的第一方和第三方未计费对帐。

GET https://api.partnercenter.microsoft.com/v1/invoices/{invoice_id}/lineitems

With optional parameters:

GET https://api.partnercenter.microsoft.com/v1/invoices/{invoice_id}/lineitems?provider={provider}&invoiceLineItemType={invoiceLineItemType}&hasPartnerEarnedCredit={hasPartnerEarnedCredit}&currencyCode={currencyCode}&period={period}&size={size}&offset={offset}&seekOperation={seekOperation}

URI 参数

名称	在	必需	类型	说明
invoice_id	path	True	string	发票 ID。对于未计费的行项，invoiceId 设置为“unbilled”。
currencyCode	query		string	货币代码。
hasPartnerEarnedCredit	query		boolean	该值指示是否返回应用了合作伙伴赚取的返点的行项。
invoiceLineItemType	query		string	发票行项。 示例：BillingLineItems、UsageLineItems。
offset	query		integer int32	页偏移量。
period	query		string	未计费对帐的期限。 示例：current、previous。
provider	query		string	提供程序类型。 示例：All、Marketplace。
seekOperation	query		string	要执行的查找操作。 仅支持 Next。
size	query		integer int32	页面大小。

请求头

名称	必需	类型	说明
Authorization	True	string	授权持有者令牌
ms-correlationid		string	用于在内部跟踪请求。 如果未提供 ms-correlationid，服务器将为每个请求生成一个新的
ms-cv		string	用于在内部跟踪请求。 如果未提供 ms-cv，服务器将为每个请求生成一个新的
ms-requestid		string	用于请求的幂等性。 如果未提供 ms-requestid，服务器将为每个请求生成一个新请求

响应

名称	类型	说明
200 OK	Collections.PagedResourceCollection[InvoiceLineItem]	请求已成功。 响应正文包含请求的对帐行项。 Media Types: "application/json", "text/json"
400 Bad Request		输入缺失或无效。 响应正文将提供错误详细信息。 Media Types: "application/json", "text/json"
401 Unauthorized		请求未经过身份验证。 客户端需要先向合作伙伴 API 服务进行身份验证。 Media Types: "application/json", "text/json"
403 Forbidden		请求已经过身份验证，但被拒绝，因为调用方无权调用它。 Media Types: "application/json", "text/json"
404 Not Found		找不到该资源，或者对于给定的输入参数不可用。 Media Types: "application/json", "text/json"
500 Internal Server Error		合作伙伴 API 服务或其依赖项之一无法满足请求。 调用方可以重试此操作。 Media Types: "application/json", "text/json"

定义

名称	说明
Collections.PagedResourceCollection[InvoiceLineItem]
InvoiceLineItem
Link
ResourceAttributes
ResourceLinks
System.Collections.Generic.KeyValuePair[System.String,System.String]

Collections.PagedResourceCollection[InvoiceLineItem]

名称	类型	说明
attributes	ResourceAttributes
continuationToken	string
items	InvoiceLineItem[]
links	ResourceLinks
totalCount	integer

InvoiceLineItem

名称	类型	说明
attributes	ResourceAttributes
billingProvider	enum: all azure marketplace none office oneTime
invoiceLineItemType	enum: billingLineItems none usageLineItems

Link

名称	类型	说明
headers	System.Collections.Generic.KeyValuePair[System.String,System.String][]
method	string
uri	string

ResourceAttributes

名称	类型	说明
etag	string
objectType	string

ResourceLinks

名称	类型	说明
next	Link
previous	Link
self	Link

System.Collections.Generic.KeyValuePair[System.String,System.String]

名称	类型	说明
key	string
value	string