Partner payouts - Create a new transaction history export request
Essa API permite criar uma nova solicitação de exportação do histórico de transações. Recomendamos o uso de $filter param para cada solicitação. Veja abaixo sobre o uso dos filtros e todos os filtros disponíveis na interface da página de exportação (UX) também estão disponíveis através desta API, proporcionando flexibilidade e consistência na filtragem de dados.
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}Parâmetros do URI
| Name | Em | Necessário | Tipo | Description |
|---|---|---|---|---|
|
version
|
path | True |
string |
|
|
$filter
|
query |
string |
O $filter query param é um parâmetro opcional para criar uma operação de exportação. No entanto, é altamente recomendável usar $filter para um melhor desempenho e uma disponibilidade mais rápida do relatório de exportação. Abaixo estão alguns dos principais filtros de atributos que podem ser usados como parte da operação de exportação |
|
|
earning
|
query |
double |
Filtro de valor de ganho para uma solicitação de exportação. Uso: {baseUrl}/payouts/transactionhistory?$filter=earningAmount ge 2000 e earningAmount le 5000 |
|
|
earning
|
query |
string |
Filtro de data do período de ganho para uma solicitação de exportação. Uso: {baseUrl}/payouts/transactionhistory?$filter=earningForDate ge 2023-03-01 e earningForDate le 2023-04-12 |
|
|
engagement
|
query |
string |
Filtro de nome de compromisso para uma solicitação de exportação. Uso: {baseUrl}/payouts/transactionhistory?$filter=engagementName='Azure CSP motion incentives' |
|
|
enrollment
|
query |
int |
Filtro de ID MPN inscrito para uma solicitação de exportação. Uso: {baseUrl}/payouts/transactionhistory?$filter=enrollmentParticipantId=12345 |
|
|
Multiple filters
|
query |
string |
Aqui está uma consulta de exemplo para criar uma solicitação de exportação com vários filtros. Uso: {baseUrl}/payouts/transactionhistory?$filter=earningForDate ge 2023-01-01 e earningForDate le 2023-05-31 e (enrollmentParticipantId eq 'XXXXXXX') e (programName eq 'Microsoft Commerce Incentives') e (payableSubType eq 'REBATE') e (paymentId eq 'xxxxxxx') e (engagementName eq 'Azure Enterprise and Self-Service Incentive' ou engagementName eq 'Azure CSP motion incentives - Indirect Provider')" |
|
|
transaction
|
query |
double |
Filtro de valor da transação para uma solicitação de exportação. Uso: {baseUrl}/payouts/transactionhistory?$filter=transactionAmount ge 2000 e transactionAmount le 5000 |
Cabeçalho do Pedido
| Name | Necessário | Tipo | Description |
|---|---|---|---|
| Authorization | True |
string |
Token de portador de autorização |
| Client-Request-ID |
string |
ID do pedido fornecido pelo utilizador |
Respostas
| Name | Tipo | Description |
|---|---|---|
| 202 Accepted |
O pedido foi aceite com sucesso para processamento. Cabeçalhos Request-ID: string |
|
| 400 Bad Request |
Havia uma entrada ausente ou inválida. O corpo da resposta fornecerá os detalhes do erro. |
|
| 401 Unauthorized |
O pedido não foi autenticado. O cliente precisa se autenticar com o serviço de API do parceiro primeiro. |
|
| 403 Forbidden |
O pedido foi autenticado, mas foi recusado, uma vez que o autor da chamada não tem o direito de o invocar. |
|
| 404 Not Found |
O recurso não foi encontrado. |
|
| 429 Too Many Requests |
Demasiados pedidos. |
|
| 500 Internal Server Error |
O serviço de API do parceiro ou uma de suas dependências não conseguiu atender à solicitação. Os chamadores podem tentar novamente. |
Definições
Microsoft.Partner.Service.PartnerPayout.Contracts.V1.Export
| Name | Tipo | Description |
|---|---|---|
| blobLocation |
string |
|
| processingStartDateTime |
string |
|
| requestDateTime |
string |
|
| requestId |
string |
|
| requestPath |
string |
|
| requestQueryString |
string |
|
| status |
enum:
|