수익 내보내기 요청 만들기

새 수익 및 관련 트랜잭션/결제 데이터 내보내기 요청을 이 API로 큐에 추가하고, 선택적 필터를 사용하여 수익 및 트랜잭션 데이터를 정렬하고 분석하십시오. 큐에 대기 중인 트랜잭션 내보내기 요청의 상태를 확인하기 위해 다시 폴링하는 데 사용할 수 있는 202 HTTP 상태 및 요청 ID를 반환합니다.

API 엔드포인트에 POST 요청을 제출하여 트랜잭션/수익에 대한 새 내보내기 요청을 큐에 대기합니다.

REST 요청

요청 매개 변수

$filter 쿼리 매개 변수는 내보내기 작업을 만들기 위한 선택적 매개 변수입니다. 그러나 내보내기 보고서의 성능과 가용성을 높이기 위해 $filters 사용하는 것이 좋습니다. 다음은 내보내기 작업의 일부로 사용할 수 있는 몇 가지 주요 특성 필터입니다.

여러 요청 매개 변수가 있는 샘플 트랜잭션 기록 필터:

”?$filter=earningForDate ge 2019-01-27T23:16:31.009Z and earningForDate le 2019-09-25T23:16:31.009Z and (enrollmentParticipantId eq 'XXXXXXX') and (programName eq ‘Microsoft Commerce Incentives’) and (payableSubType eq 'REBATE') and (paymentId eq '000000000000') and (engagementName eq 'Azure Enterprise and Self-Service Incentive' or engagementName eq 'Azure CSP motion incentives - Indirect Provider') and (leverCode eq ‘Azure Enterprise and Self-Service Motion’) and (payoutStatus eq 'SENT')”

요청 헤더

자세한 내용은 파트너 센터 REST 헤더 참조하세요.

요청 내용

해당하지 않습니다.

API 응답

HTTP/1.1 202 Accepted

API 응답 페이로드는 다음 특성을 반환합니다.

가능한 값 및 작업

상태에 대한 가능한 값

• 대기: 내보내기 작업이 시작되지 않았습니다.
• 처리: 내보내기 작업이 진행 중입니다.
• 실패한: 내보내기 작업이 여러 번 시도한 후에도 실패했습니다. 새 요청을 큐에 추가해 보세요.
• 완료된: 내보내기 작업이 완료되고 내보내기 파일을 다운로드할 준비가 된 것입니다.

샘플 응답

{
    "value": [
        {
            "requestId": "93c2b3cf-c6d8-4e7e-ade1-007768a6eba4",
            "requestDateTime": "2023-05-25T21:20:46.3727561Z",
            "requestPath": "/v1.0/payouts/transactionhistory",
            "requestQueryString": "earningForDate ge 2023-03-01 and earningForDate le 2023-04-12",
            "blobLocation": "",
            "status": "Queued"
        }
    ],
    "nextLink": null,
    "totalCount": 1
}

API는 HTTP 상태 202를 반환합니다.

요청에 따라 API는 다른 표준 상태를 반환할 수 있습니다.