Partner payouts - Create a new transaction history export request
Met deze API kunt u een nieuwe exportaanvraag voor transactiegeschiedenis maken. U wordt aangeraden $filter param te gebruiken voor elke aanvraag. Zie hieronder 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/transactionhistoryPOST 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 u 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 |
|
|
earning
|
query |
double |
Filter voor het verdienen van een bedrag voor een exportaanvraag. Gebruik: {baseUrl}/uitbetalingen/transactionhistory?$filter=earningAmount ge 2000 en earningAmount le 5000 |
|
|
earning
|
query |
string |
Datumfilter voor inkomstenperiode voor een exportaanvraag. Gebruik: {baseUrl}/uitbetalingen/transactionhistory?$filter=earningForDate ge 2023-03-01 en earningForDate le 2023-04-12 |
|
|
engagement
|
query |
string |
Naamfilter voor afspraak voor een exportaanvraag. Gebruik: {baseUrl}/uitbetalingen/transactiehistory?$filter=engagementName='Azure CSP motion incentives' |
|
|
enrollment
|
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 and (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')' |
|
|
transaction
|
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 |
Bearer-token voor autorisatie |
| Client-Request-ID |
string |
Id van aanvraag die door de gebruiker is verstrekt |
Antwoorden
| Name | Type | Description |
|---|---|---|
| 202 Accepted |
De aanvraag is geaccepteerd voor verwerking. Kopteksten Request-ID: string |
|
| 400 Bad Request |
Er is een ontbrekende of ongeldige invoer. De hoofdtekst van het antwoord bevat de foutdetails. |
|
| 401 Unauthorized |
De aanvraag is niet geverifieerd. De client moet eerst worden geverifieerd met de partner-API-service. |
|
| 403 Forbidden |
De aanvraag is geverifieerd, maar is geweigerd omdat de beller niet over de rechten beschikt 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 partner-API-service of een van de bijbehorende 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:
|