Partner payouts - Create a new transaction history export request

  • 参考
Service:
Partner Center Rest
API Version:
1.0

此 API 允许创建新的事务历史记录导出请求。 建议对每个请求使用 $filter 参数。 请参阅以下内容，了解筛选器的用法，导出页界面中提供的所有筛选器 (UX) 也通过此 API 提供，从而在筛选数据方面提供了灵活性和一致性。

POST https://api.partner.microsoft.com/v{version}/payouts/transactionhistory
With optional parameters: 
POST https://api.partner.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 and 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 and earningForDate le 2023-05-31 和 (enrollmentParticipantId eq 'XXXXXXX') and (programName eq 'Microsoft Commerce Incentives') and (paymentSubType eq 'REBATE') and (paymentId eq 'xxxxxxx') and (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

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

Headers

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