Ação Garantir fundos assíncronos
Garanta fundos para uma fatura e aplique-os à fatura. Opcionalmente, aplique os fundos em uma sequência definida. Se necessário, envie uma solicitação a um provedor de pagamento para registrar fundos autorizados. Essa ação insere uma operação em segundo plano em uma fila de trabalhos assíncronos e retorna o ID da operação para que você possa rastrear seu status. As respostas do gateway de pagamento aparecem no log do gateway de pagamento e não afetam o status de operação em segundo plano.
Edições obrigatórias
| Disponível em: Lightning Experience |
| Exibir edições com suporte. |
| Esse recurso requer o complemento Gerenciamento de pedidos do Salesforce. Para comprar, entre em contato com seu executivo de conta do Salesforce. |
No Flow Builder, adicione um elemento Ação ao fluxo. Selecione a categoria Gerenciamento de pedidos e pesquise Garantir fundos assíncronos.
(Opcional) Para sequenciar pagamentos, no Flow Builder, adicione um elemento Ação ao seu fluxo. Selecione a categoria Gerenciamento de pedidos e procure por garantir fundos com sequência OrderPaymentSummaries.
Definir valores de entrada
Use valores anteriores no fluxo para definir as entradas.
| Incluir parâmetro | Descrição |
|---|---|
| Entrada para Garantir fundos assíncronos | Essa entrada é uma variável definida pelo Apex da classe ConnectApi.EnsureFundsAsyncInputRepresentation. A variável tem estes campos: invoiceId – O ID da fatura para a qual garantir fundos e aplicá-los. isConsiderReservedBalanceAmount - Se verdadeiro, o valor do saldo reservado é usado para o resumo do pedido para financiar a fatura. Se não houver um valor de saldo reservado suficiente, qualquer saldo disponível que não seja reservado por outro resumo será usado. Se falso, qualquer saldo disponível será usado. isAllowPartial - Se verdadeiro, é permitido o financiamento parcial da fatura. Como opção, você pode definir uma sequência na qual capturar pagamentos para a fatura. Se você não definir uma sequência para esse valor ou se esse valor for falso, a lógica de captura padrão será aplicada. sequences – Esse valor é uma lista ordenada de valores e os OrderPaymentSummaries a serem aplicados. É uma lista de variáveis definidas pelo Apex da classe SequenceOrderPaymentSummaryInputRepresentation. Contém estes campos:
|
| ID do resumo do pedido | Referência ao resumo do pedido associado à fatura. |
Armazenar valores de saída
| Parâmetro de saída | Descrição |
|---|---|
| Saída para Garantir fundos assíncronos | Esse valor é uma variável definida pelo Apex da classe EnsureFundsAsyncOutputRepresentation. Retorna apenas o ID da operação em segundo plano assíncrona, independentemente de uma chamada ser feita a um gateway de pagamento externo. Não inclui erros da operação. O campo backgroundOperationId contém o ID da operação de segundo plano. |
Uso
Essa ação aplica fundos para o saldo da fatura de resumos de pagamento do pedido associados ao resumo do pedido especificado seguindo esta lógica:
- Verifique se o saldo da fatura não excede o BalanceAmount total de todos os resumos de pagamento do pedido associados ao resumo do pedido.
- Se um resumo de pagamento do pedido tiver um BalanceAmount igual ao saldo da fatura, aplique os fundos desse resumo de pagamento do pedido.
- Se nenhuma correspondência exata for encontrada, aplique fundos do resumo de pagamento do pedido com o maior BalanceAmount.
- Se a fatura ainda tiver um saldo para garantir, repita as etapas 2 e 3 até garantir o saldo total ou não haver mais fundos capturados.
- Se a fatura ainda tiver um saldo, procure um resumo de pagamento do pedido com um valor autorizado igual ao saldo da fatura restante. Se houver algum, capture e aplique os fundos desse resumo de pagamento do pedido.
- Se nenhuma correspondência exata for encontrada, capture e aplique fundos do resumo de pagamento do pedido com o maior valor autorizado.
- Se a fatura ainda tiver um saldo para garantir, repita as etapas 5 e 6 até garantir o saldo total.
