A referência Central de Parceiros da AWS da API foi reestruturada. Para obter mais informações sobre as operações de API suportadas, consulte a Referência [Central de Parceiros da AWS da API](https://docs.aws.amazon.com/partner-central/latest/APIReference/Welcome.html).
As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Trabalhando com alocações de benefícios
Uma alocação de benefícios representa um benefício que foi concedido a um parceiro. Quando uma solicitação de benefício é aprovada,AWS cria uma ou mais alocações de benefícios que fornecem aos parceiros os créditos reais, o financiamento, o acesso ou o cumprimento de outros benefícios.
## Entendendo as alocações de benefícios
As alocações de benefícios podem representar vários tipos de atendimento:
+ **Desembolsos financeiros (CASH)** - Pagamentos financeiros diretos a parceiros com rastreamento de desembolsos
+ **AWS Créditos (CRÉDITOS)** - Códigos de crédito aplicáveis a AWS contas com rastreamento de uso
+ **Alocações de consumíveis** - valores de Pre-approved financiamento ou carteiras com rastreamento de utilização
+ **Concessões de acesso (ACCESS)** - Acesso a sistemas, ferramentas ou recursos
+ **Reconhecimento (RECONHECIMENTO)** - Emblemas digitais, certificações ou designações de status
+ **Recursos (RESOURCE)** - Suporte técnico, serviços de consultoria ou ProServe contratos
Cada alocação de benefícios tem um ciclo de vida rastreado por meio de seu campo Status:
+ **ATIVO** - A alocação está disponível para uso
+ **INATIVO** - A alocação está temporariamente indisponível
+ **CUMPRIDA** - A alocação foi totalmente usada ou entregue
As alocações de benefícios também incluem informações temporais que definem quando elas se tornam efetivas (StartsAt) e quando expiram (ExpiresAt), permitindo que os parceiros entendam os prazos de utilização dos benefícios.
## Listando alocações de benefícios
Os parceiros podem ver todas as alocações de benefícios usando a ação da `ListBenefitAllocations` API. Isso retorna uma lista paginada de resumos de alocação com recursos abrangentes de filtragem.
Os parceiros podem filtrar as alocações por:
+ **Identificador de benefícios** - Visualize as alocações para um benefício específico
+ **Identificador do aplicativo de benefícios** - Visualize as alocações resultantes de um aplicativo específico
+ **Tipo de atendimento** - Filtrar por tipo de alocação (`CREDITS`,, `CASH``ACCESS`, etc.)
+ **Status** - Filtrar por status de alocação (`ACTIVE`,`INACTIVE`,`FULFILLED`)
A resposta da lista inclui resumos de alocação contendo:
+ ID de alocação, ARN e nome
+ ID do benefício associado e ID do pedido de benefício (se aplicável)
+ Tipo de atendimento
+ Status atual
+ Carimbo de data e hora de criação
+ Data de início
Essa exibição de lista permite que os parceiros criem painéis de rastreamento de alocação e identifiquem:
+ Alocações ativas disponíveis para uso imediato
+ Alocações que se aproximam do vencimento
+ Alocações preenchidas para rastreamento histórico
+ Valor total da alocação por programa ou tipo de atendimento
## Exibindo informações detalhadas de alocação
Os parceiros podem recuperar detalhes completos da alocação usando a ação da `GetBenefitAllocation` API. Isso fornece informações abrangentes sobre a alocação, incluindo detalhes específicos do atendimento que variam de acordo com o tipo de alocação.
**Informações básicas de alocação:**
+ Identificador exclusivo (ID) e nome de recurso da Amazon (ARN)
+ Nome e status da alocação
+ Motivo do status (explicação do status atual)
+ ID do benefício associado e ID do pedido de benefício
+ Tipo de atendimento
+ Carimbos de data e hora de criação, atualização, início e expiração
**Detalhes de atendimento (Type-Specific):**
O FulfillmentDetail campo contém diferentes estruturas de informações com base no tipo de atendimento:
### Detalhes do desembolso de dinheiro (tipo CASH)
Para pagamentos diretos em dinheiro, os detalhes de atendimento incluem:
+ Valor **desembolsado - O valor** total do financiamento desembolsado, incluindo valor do valor e código da moeda
+ **Detalhes da emissão (se aplicável)** - Informações sobre pedidos de compra ou eventos de emissão:
+ ID de emissão - Identificador exclusivo para o desembolso
+ Valor da emissão - Valor em moeda local
+ Emitido em - Data e hora do desembolso
Essa estrutura suporta desembolsos únicos e cenários de financiamento pré-aprovados, nos quais várias emissões podem ocorrer em relação a uma única alocação.
### Detalhes do crédito (tipo de CRÉDITOS)
Para AWS créditos, os detalhes do processamento incluem:
+ **Valor alocado - Valor** total de crédito alocado
+ **Valor emitido - Valor** total do crédito emitido (pode ser menor do que o alocado para emissão em fases)
+ **Códigos de crédito** - Conjunto de detalhes de códigos de crédito individuais:
+ AWS ID da conta - Conta em que o crédito é aplicado
+ Valor - Valor monetário do código de crédito
+ AWS Código de crédito - A sequência real do código de crédito
+ Status - Status do código de crédito (`ACTIVE`,`INACTIVE`,`FULFILLED`)
+ Emitido em - Quando o código de crédito foi emitido
+ Expira em - Quando o código de crédito expira
Esse rastreamento de crédito detalhado permite que os parceiros monitorem a utilização do crédito em várias contas e entendam quais créditos estão disponíveis, parcialmente usados ou totalmente consumidos.
### Detalhes da alocação de consumíveis () Pre-Approved Amounts/Wallets
Para grupos de financiamento pré-aprovados, os detalhes do atendimento incluem:
+ Quantia **alocada - Valor** total na alocação
+ **Quantidade restante - Quantidade** não utilizada ainda disponível
+ **Quantidade utilizada - Quantidade** já consumida
+ **Detalhes da emissão (se aplicável)** - Informações da ordem de compra para a alocação
As alocações de consumíveis permitem que os parceiros retirem fundos conforme necessário para atividades elegíveis, com rastreamento em tempo real do saldo restante.
### Detalhes de acesso (tipo de acesso)
Para concessões de acesso, os detalhes de atendimento incluem:
+ **Descrição** - Explicação detalhada do acesso que está sendo concedido e como utilizá-lo
As alocações de acesso podem fornecer acesso a serviços de pré-visualização, ferramentas especializadas ou recursos restritos. O campo de descrição fornece instruções sobre como os parceiros podem ativar e usar o acesso concedido.
## Aplicando alocações a novos pedidos de benefícios
O ApplicableBenefitIds campo em alocações de benefícios identifica outros benefícios que podem alavancar essa alocação. Isso permite a cadeia de benefícios, na qual os parceiros podem usar as alocações existentes para solicitar benefícios adicionais.
Por exemplo, um parceiro pode:
1. Receba uma alocação de financiamento pré-aprovada do MAP
1. Crie aplicativos de benefícios para projetos individuais de migração de clientes
1. Associe esses aplicativos à alocação pré-aprovada
1. Retire fundos da alocação à medida que os projetos são aprovados
Essa abordagem simplifica o processo de solicitação de benefícios para parceiros com financiamento pré-aprovado, reduzindo o ciclo de revisão para solicitações de projetos individuais.