通过

Partner payouts - Create a new transaction history export request

  • 参考
服务:
Partner Center Rest
API 版本:
1.0

此 API 允许创建新的事务历史记录导出请求。 建议对每个请求使用$filter参数。 有关筛选器的使用以及导出页面界面（UX）中提供的所有筛选器也可通过此 API 获取，从而提供筛选数据的灵活性和一致性。

POST https://api.partnercenter.microsoft.com/v{version}/payouts/transactionhistory
具有可选参数: 
POST https://api.partnercenter.microsoft.com/v{version}/payouts/transactionhistory?$filter={$filter}&enrollmentParticipantId={enrollmentParticipantId}&earningForDate={earningForDate}&transactionAmount={transactionAmount}&earningAmount={earningAmount}&engagementName={engagementName}&Multiple filters={Multiple filters}

URI 参数

名称 在 必需 类型 说明
version
 path True

string

$filter
 query

string

$filter查询参数是用于创建导出操作的可选参数。 但是，我们强烈建议使用$filter来提高导出报表的性能和更快的可用性。 下面是一些可用作导出操作一部分的关键属性筛选器
earningAmount
 query

double

为导出请求获取金额筛选器。 用法：{baseUrl}/payouts/transactionhistory？$filter=earningAmount ge 2000 and earningAmount le 5000
earningForDate
 query

string

导出请求的收益周期日期筛选器。 使用情况：{baseUrl}/payouts/transactionhistory？$filter=earningForDate ge 2023-03-01 和 earningForDate le 2023-04-12
engagementName
 query

string

导出请求的预订名称筛选器。 使用情况：{baseUrl}/payouts/transactionhistory？$filter=engagementName='Azure CSP motion incentives'
enrollmentParticipantId
 query

int

导出请求的已注册 MPN ID 筛选器。 使用情况：{baseUrl}/payouts/transactionhistory？$filter=enrollmentParticipantId=12345
Multiple filters
 query

string

下面是一个示例查询，用于创建包含多个筛选器的导出请求。 用法：{baseUrl}/payouts/transactionhistory？$filter=earningForDate ge 2023-01-01 和 earningForDate le 2023-05-31 and （enrollmentParticipantId eq 'XXXXXXX'） 和 （programName eq 'Microsoft Commerce Incentives'） 和 （paymentSubType eq 'REBATE'） 和 （paymentId eq 'xxxxxxx'） 和 （engagementName eq 'Azure Enterprise and Self-Service Incentive' or engagementName eq 'Azure CSP motion incentives - Indirect Provider'）
transactionAmount
 query

double

导出请求的事务量筛选器。 用法：{baseUrl}/payouts/transactionhistory？$filter=transactionAmount ge 2000 and transactionAmount le 5000

请求头

名称 必需 类型 说明
Authorization True

string

授权持有者令牌
Client-Request-ID

string

用户提供的请求 ID

响应

名称 类型 说明
202 Accepted

Microsoft.Partner.Service.PartnerPayout.Contracts.V1.Export

已成功接受请求进行处理。

标头

Request-ID: string
400 Bad Request

输入缺失或无效。 响应正文将提供错误详细信息。
401 Unauthorized

请求未通过身份验证。 客户端需要首先通过合作伙伴 API 服务进行身份验证。
403 Forbidden

请求已经过身份验证，但被拒绝，因为调用方无权调用该请求。
404 Not Found

找不到资源。
429 Too Many Requests

请求过多。
500 Internal Server Error

合作伙伴 API 服务或其某个依赖项未能满足请求。 调用方可能会重试此操作。

定义

Microsoft.Partner.Service.PartnerPayout.Contracts.V1.Export

名称 类型 说明
blobLocation

string

processingStartDateTime

string

requestDateTime

string

requestId

string

requestPath

string

requestQueryString

string

status enum:
  • Completed
  • Failed
  • Processing
  • Queued