Partner payouts - Create a new transaction history export request

Tjänst:

Partner Center Rest

API-version:

1.0

Med det här API:et kan du skapa en ny exportbegäran för transaktionshistorik. Vi rekommenderar att du använder $filter param för varje begäran. Se nedan om användningen av filtren och alla filter som är tillgängliga i exportsidans gränssnitt (UX) också är tillgängliga via det här API:et, vilket ger flexibilitet och konsekvens vid filtrering av data.

POST https://api.partnercenter.microsoft.com/v{version}/payouts/transactionhistory

Med valfria parametrar:

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-parametrar

Name	I	Obligatorisk	Typ	Description
version	path	True	string
$filter	query		string	$filter-frågeparam är en valfri parameter för att skapa en exportåtgärd. Vi rekommenderar dock starkt att du använder $filter för bättre prestanda och snabbare tillgänglighet för exportrapporten. Nedan visas några av de nyckelattributfilter som kan användas som en del av exportåtgärden
earningAmount	query		double	Filter för intjäningsbelopp för en exportbegäran. Användning: {baseUrl}/payouts/transactionhistory?$filter=earningAmount ge 2000 och earningAmount le 5000
earningForDate	query		string	Datumfilter för intjäningsperiod för en exportbegäran. Användning: {baseUrl}/payouts/transactionhistory?$filter=earningForDate ge 2023-03-01 och earningForDate le 2023-04-12
engagementName	query		string	Namnfilter för åtagande för en exportbegäran. Användning: {baseUrl}/payouts/transactionhistory?$filter=engagementName='Azure CSP motion incentives'
enrollmentParticipantId	query		int	Registrerat MPN-ID-filter för en exportbegäran. Användning: {baseUrl}/payouts/transactionhistory?$filter=enrollmentParticipantId=12345
Multiple filters	query		string	Här är en exempelfråga för att skapa en exportbegäran med flera filter. Användning: {baseUrl}/payouts/transactionhistory?$filter=earningForDate ge 2023-01-01 och earningForDate le 2023-05-31 och (enrollmentParticipantId eq 'XXXXXXX') och (programName eq 'Microsoft Commerce Incentives') och (payableSubType eq 'DISCOUNT') och (paymentId eq 'xxxxxxx') och (engagementName eq 'Azure Enterprise and Self-Service Incentive' eller engagementName eq 'Azure CSP motion incentives - Indirect Provider')"
transactionAmount	query		double	Transaktionsmängdsfilter för en exportbegäran. Användning: {baseUrl}/payouts/transactionhistory?$filter=transactionAmount ge 2000 och transactionAmount le 5000

Begärandehuvud

Name	Obligatorisk	Typ	Description
Authorization	True	string	Token för auktoriseringsbärare
Client-Request-ID		string	ID för begäran som tillhandahålls av användaren

Svar

Name	Typ	Description
202 Accepted	Microsoft.Partner.Service.PartnerPayout.Contracts.V1.Export	Begäran godkändes för bearbetning. Sidhuvuden Request-ID: string
400 Bad Request		Det saknades eller ogiltiga indata. Svarstexten innehåller felinformationen.
401 Unauthorized		Begäran autentiserades inte. Klienten måste autentisera med partner-API-tjänsten först.
403 Forbidden		Begäran autentiserades men nekades eftersom anroparen inte har behörighet att anropa den.
404 Not Found		Det går inte att hitta resursen.
429 Too Many Requests		För många begäranden.
500 Internal Server Error		Partner-API-tjänsten eller något av dess beroenden kunde inte uppfylla begäran. Anropare kan försöka igen.

Definitioner

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

Name	Typ	Description
blobLocation	string
processingStartDateTime	string
requestDateTime	string
requestId	string
requestPath	string
requestQueryString	string
status	enum: Completed Failed Processing Queued