Converter automações em assíncronas para execuções em lote de fatura
Identifique fluxos ativos e acionadores do Apex em objetos do Billing e converta-os em processos assíncronos antes de agendar uma execução em lote de fatura. Automações síncronas podem interromper uma execução ou deixar faturas em Rascunho em andamento, Publicação em andamento ou Erro.
Edições obrigatórias
| Disponível em: Lightning Experience |
| Disponível em: Edições Enterprise, Unlimited e Developer com a licença Revenue Cloud Advanced ou a licença Revenue Cloud Billing |
| Permissões de usuário necessárias | |
|---|---|
| Para revisar e converter fluxos acionados por registro: | Gerenciar fluxo |
| Para exibir os acionadores do Apex: | Exibir configuração |
| Para converter acionadores do Apex: | Criar Apex |
| Para recuperar faturas paralisadas: | Conjunto de permissões de Administrador de cobrança OU Conjunto de permissões de Usuário de operações de faturamento |
Um fluxo acionado por registro ou acionador do Apex é vinculado a um objeto, como Fatura ou Linha de fatura. Você define e ativa o fluxo nesse objeto no Flow Builder. Uma pessoa que tem a permissão Criar Apex define o acionador do Apex nesse objeto e o define como ativo. Essas automações são personalizadas. O Billing não os cria. Consulte Ativar ou desativar um fluxo e definição de acionadores do Apex.
Quando uma execução em lote de fatura gera faturas, a execução cria ou atualiza registros em objetos de faturamento. Esses objetos incluem faturas, linhas de fatura, linhas de imposto, avisos de débito e crédito, agendas de faturamento e itens de período de faturamento. Qualquer acionador ou fluxo ativo em um objeto Billing então é executado para cada registro que a execução de lote de fatura salva.
Uma automação síncrona é executada como parte do salvamento do registro. A execução do lote de fatura não termina de salvar a fatura até que o fluxo ou o acionador seja concluído. Se a automação consultar registros relacionados para cada fatura, a execução poderá atingir os limites de processamento ou atingir o tempo limite. As faturas podem permanecer em Rascunho em andamento, Publicação em andamento ou Erro.
Uma automação assíncrona espera até que os registros de fatura sejam salvos e é executada. A execução em lote pode terminar de gerar faturas. O fluxo ou o acionador ainda é executado, mas não enquanto a fatura está sendo salva.
- Em Configuração, insira Fluxos na caixa Busca rápida e selecione Fluxos.
-
Revise os fluxos acionados por registro ativos nesses objetos do Billing.
- Fatura
- Linha de fatura
- Imposto da linha da fatura
- Aviso de débito
- Linha de aviso de débito
- Imposto de linha de aviso de débito
- Aviso de crédito
- Linha de aviso de crédito
- Imposto de linha de aviso de crédito
- Agenda de faturamento
- Item do período de faturamento
- Em Configuração, na caixa Busca rápida, insira Acionadores do Apex e selecione Acionadores do Apex.
- Revise acionadores ativos nos mesmos objetos.
-
Para listar as automações com SOQL, abra o Editor de consulta do Developer Console.
Scripts de amostra:
Para a consulta de fluxo, selecione Usar API do conjunto de ferramentas. Para a consulta do acionador do Apex, deixe Usar API de ferramentas desmarcada.
Fluxos:
SELECT Id, IsActive, Label, ProcessType, ManageableState, TriggerObjectOrEventId, TriggerObjectOrEventLabel, TriggerType FROM FlowDefinitionView WHERE TriggerObjectOrEventId IN ('Invoice','InvoiceLine','DebitMemo','DebitMemoLine','CreditMemo','CreditMemoLine','InvoiceLineTax','DebitMemoLineTax','CreditMemoLineTax','BillingSchedule','BillingPeriodItem') AND IsActive = TRUEAcionadores do Apex:
SELECT Id, TableEnumOrId, Name, Status FROM ApexTrigger WHERE TableEnumOrId IN ('Invoice','InvoiceLine','DebitMemo','DebitMemoLine','CreditMemo','CreditMemoLine','InvoiceLineTax','DebitMemoLineTax','CreditMemoLineTax','BillingSchedule','BillingPeriodItem') AND Status = 'Active' - Para cada fluxo acionado por registro após salvar, mova a lógica para um caminho Executar de modo assíncrono para que ela seja executada após a confirmação do salvamento de fatura. Consulte Fluxos acionados.
- Para cada acionador do Apex, trabalhe com uma pessoa que tenha a permissão Autor do Apex para remover a lógica do salvamento de registro. Use o Apex enfileirável ou um acionador do Apex em um evento de alteração, que é executado após a conclusão do salvamento. Consulte Apex enfileirável e Assinar com acionadores do Apex.
Depois de converter as automações, agende a próxima execução em lote da fatura. Consulte gerar faturas automaticamente com base em agendas de faturamento.
Se as faturas de uma execução anterior estiverem travadas em Rascunho em andamento, Publicação em andamento ou Erro, clique em Recuperar na execução do lote da fatura. Em seguida, gere faturas novamente.
