Ações customizadas
Uma ação customizada (no painel, automação) executa uma operação sobre o boleto quando um evento acontece com ele. Exemplo típico: "quando o boleto vencer, cancelar o boleto". Diferente das notificações, que avisam o pagador, a ação customizada altera o boleto.
Onde fica: Automações > Ações Customizadas.
Gatilhos disponíveis
| Evento (como aparece na tela) | Quando dispara |
|---|---|
| Boleto ficou vencido. | O boleto passou do vencimento sem pagamento |
| Evento Customizado: descrição | Um evento customizado da conta, por exemplo "10 dias depois do vencimento do boleto" |
Com eventos customizados é possível, por exemplo, cancelar o boleto só alguns dias depois do vencimento, em vez de no dia em que ele vence.
Automações disponíveis
| Automação | O que faz | Parâmetros |
|---|---|---|
| Cancelar | Cancela o boleto com o motivo escolhido, como no cancelamento feito pelo painel | Carteira (ou Todas as carteiras) e Motivo do Cancelamento (Outro, Fraude, Óbito, Erro operacional, Quitação paga, Cópia Paga, Original Pago, Automático). O padrão é Outro |
| Adicionar ao escopo | Adiciona o boleto a um escopo de acesso | Escopo (obrigatório). Disponível só para contas com escopo de acesso habilitado |
Cadastrar uma automação
| Campo | Obrigatório | Descrição |
|---|---|---|
| Evento | Sim | O gatilho. Não pode ser alterado depois de criada a automação |
| Automação | Sim | O que fazer quando o evento ocorrer. Não pode ser alterado depois de criada a automação |
| Parâmetros da automação | Depende | Os campos da tabela acima, que aparecem ao escolher a automação |
| Ativa? | Não | Automações inativas não são executadas |
Clique em Adicionar Automação (ou Atualizar Automação, na edição).
Uma automação ativa por evento e carteira
Para um mesmo evento só pode haver uma automação ativa por carteira. O painel recusa o cadastro quando:
- já existe automação ativa para o mesmo evento e a mesma carteira ("já existe automação ativa para este evento e carteira");
- a nova automação vale para todas as carteiras e já existe uma ativa para uma carteira específica ("não pode abranger todas as carteiras pois já existe automação ativa para carteira específica");
- a nova automação é de uma carteira e já existe uma ativa para todas as carteiras ("não pode ser criada pois já existe automação ativa para todas as carteiras").
Execução
- O evento ocorre com um boleto (por exemplo, o boleto vence).
- A Kobana procura as automações ativas da conta para esse evento, da carteira do boleto ou de todas as carteiras.
- Para cada uma, registra uma execução e a processa em segundo plano.
Regras da execução:
- Cancelar só age sobre boletos que ainda podem ser cancelados (por exemplo, abertos ou vencidos). Se o boleto já foi pago ou cancelado, a execução é registrada e nada muda no boleto.
- Contas sem assinatura ativa não têm a ação executada.
- Ativar uma automação não age sobre eventos que já aconteceram: ela vale para os eventos seguintes.
Acompanhar as execuções
A tela da automação (Detalhes da automação) tem a aba Execuções, com UID, Evento, Recurso (link para o boleto), Execução, Criada em e Situação. Na situação, o ícone de confirmação indica "Automação executada com sucesso" e o ícone girando indica "Automação sendo executada. Aguarde.". É possível filtrar por recurso e por período de criação.
Ações
No menu Ações da automação: Ver automação, Alterar automação, Ativar/Desativar e Excluir. A lista mostra, para cada automação, o Evento, a Carteira, a Automação, os Parâmetros e a Situação.
Permissões
No cadastro de usuários, módulo Administração, produto Ações Customizadas: Ações Básicas, Criar, Alterar e Excluir.