Partner payouts - Create a new transaction history export request

Service:

Partner Center Rest

API Version:

1.0

Met deze API kunt u een nieuwe exportaanvraag voor de transactiegeschiedenis maken. U wordt aangeraden voor elke aanvraag $filter parameter te gebruiken. Hieronder vindt u meer informatie over het gebruik van de filters en alle filters die beschikbaar zijn in de exportpagina-interface (UX) zijn ook beschikbaar via deze API, wat flexibiliteit en consistentie biedt bij het filteren van gegevens.

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

With optional parameters:

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

Name	In	Vereist	Type	Description
version	path	True	string
$filter	query		string	De $filter queryparameter is een optionele parameter voor het maken van een exportbewerking. We raden echter ten zeerste aan om $filter te gebruiken voor betere prestaties en snellere beschikbaarheid van het exportrapport. Hieronder vindt u enkele van de belangrijkste kenmerkfilters die kunnen worden gebruikt als onderdeel van de exportbewerking
earningAmount	query		double	Filter voor verdienbedrag voor een exportaanvraag. Gebruik: {baseUrl}/uitbetalingen/transactionhistory?$filter=earningAmount ge 2000 en earningAmount le 5000
earningForDate	query		string	Datumfilter voor inkomstenperiode voor een exportaanvraag. Gebruik: {baseUrl}/uitbetalingen/transactionhistory?$filter=earningForDate ge 2023-03-01 en earningForDate le 2023-04-12
engagementName	query		string	Naamfilter voor een exportaanvraag. Gebruik: {baseUrl}/uitbetalingen/transactionhistory?$filter=engagementName='Azure CSP motion incentives'
enrollmentParticipantId	query		int	Geregistreerd MPN Id-filter voor een exportaanvraag. Gebruik: {baseUrl}/uitbetalingen/transactionhistory?$filter=enrollmentParticipantId=12345
Multiple filters	query		string	Hier volgt een voorbeeldquery voor het maken van een exportaanvraag met meerdere filters. Gebruik: {baseUrl}/uitbetalingen/transactionhistory?$filter=earningForDate ge 2023-01-01 en earningForDate le 2023-05-31 en (enrollmentParticipantId eq 'XXXXXXX') en (programName eq 'Microsoft Commerce Incentives') en (payableSubType eq 'REBATE') en (paymentId eq 'xxxxxxx') en (engagementName eq 'Azure Enterprise and Self-Service Incentive' of engagementName eq 'Azure CSP motion incentives - Indirect Provider')'
transactionAmount	query		double	Filter voor transactiebedrag voor een exportaanvraag. Gebruik: {baseUrl}/uitbetalingen/transactionhistory?$filter=transactionAmount ge 2000 en transactionAmount le 5000

Aanvraagkoptekst

Name	Vereist	Type	Description
Authorization	True	string	Autorisatie Bearer-token
Client-Request-ID		string	Id van de aanvraag die door de gebruiker is opgegeven

Antwoorden

Name	Type	Description
202 Accepted	Microsoft.Partner.Service.PartnerPayout.Contracts.V1.Export	De aanvraag is geaccepteerd voor verwerking. Headers Request-ID: string
400 Bad Request		Er is een ontbrekende of ongeldige invoer. De antwoordtekst bevat de foutdetails.
401 Unauthorized		De aanvraag is niet geverifieerd. De client moet zich eerst verifiëren bij de partner-API-service.
403 Forbidden		De aanvraag is geverifieerd, maar is geweigerd omdat de aanroeper niet de rechten heeft om deze aan te roepen.
404 Not Found		De resource is niet gevonden.
429 Too Many Requests		Te veel aanvragen.
500 Internal Server Error		De api-service van de partner of een van de afhankelijkheden kan niet voldoen aan de aanvraag. Bellers kunnen dit opnieuw proberen.

Definities

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

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