Liberação em Confiança - AVA ADM - Karoo Bot

Este documento descreve a realização de um novo serviço responsável por validar e processar a liberação em confiança para a AVA (Assistente Virtual da Alterdata)

no Karoo Bot.

O serviço de Liberação em Confiança permite que clientes inadimplentes sejam liberados para realizar determinadas ações, desde que atendam a critérios específicos. O processo envolve a validação de dados, verificação de inadimplência e controle de boletos em aberto.

Detalhes Técnicos

POST /api/liberation

Exemplo de Request body

{
  "date": "06/02/2025",
  "peopleIdentifier": "001000EBLK",
  "selectedTicket": "string"
}

Campos do Request Body:

Campo	Tipo	Descrição
date	string	Data inserida pelo cliente no formato DD/MM/AAAA.
peopleIdentifier	string	Identificador da pessoa coletado pelo endpoint do Bimer.
selectedTicket	string	Identificador do boleto selecionado para a liberação.

Fluxo de Validação e Processamento

Fluxo	Descrição	Ação
Validação da Data	Verifica se a data informada é menor que a data atual.	Se a data for futura, o sistema retorna uma mensagem de erro.
Verificação de Inadimplência no CRM	Busca a característica de inadimplente (`0010000001`) no CRM.	Caso o cliente não possua essa característica, o sistema retorna uma mensagem de erro.
Verificação de Boletos em Aberto	Verifica se o cliente possui boletos em aberto.	Se não houver boletos em aberto, o sistema retorna uma mensagem de erro. Se algum boleto em aberto tiver passado de dois meses da data de vencimento, o sistema retorna uma mensagem informando.
Controle da Liberação em Confiança	Garante que o cliente só possa ser liberado em confiança uma única vez até que regularize todos os boletos pendentes.	Se o cliente não teve nenhum boleto em aberto que já teve a liberação em confiança, os identificadores dos boletos em aberto são salvos no banco de dados. Caso o cliente tente novamente a liberação sem ter pago esses boletos, o sistema bloqueia a solicitação.
Atualizações no Sistema	Após a liberação, o sistema realiza algumas atualizações.	Remove o marcador de inadimplência do Bimer. Cria um atendimento em aberto no perfil do cliente informando que a AVA removeu a inadimplência devido à liberação em confiança.

Karoo Bot - Fluxo de Liberaçao em Confiança

Critérios de Aceite

O endpoint deve validar corretamente a data inserida, impedindo datas futuras.

O sistema deve verificar a inadimplência do cliente no CRM e impedir a liberação se não for inadimplente.

O endpoint deve confirmar a existência de boletos em aberto antes da liberação.

A liberação em confiança só pode ocorrer uma única vez até que os boletos sejam pagos.

Após a liberação, a inadimplência deve ser removida do Bimer e um atendimento deve ser criado no perfil do cliente.

Conclusão

Este serviço foi desenvolvido para garantir que a liberação em confiança seja realizada de forma segura e controlada, evitando abusos e garantindo que os clientes inadimplentes regularizem suas pendências antes de serem liberados novamente.

Para qualquer dúvida ou necessidade de suporte, entre em contato com a equipe técnica.