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.
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,,CASHACCESS, 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:
-
Receba uma alocação de financiamento pré-aprovada do MAP
-
Crie aplicativos de benefícios para projetos individuais de migração de clientes
-
Associe esses aplicativos à alocação pré-aprovada
-
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.