Embedded Files
A rotina de envio de boletos permite transmitir ao banco os títulos que foram previamente gerados no PlusCom.
Cada boleto é processado individualmente. Dessa forma, mesmo que vários boletos sejam enviados em um mesmo lote, cada um poderá apresentar um resultado diferente.
Alguns podem ser enviados com sucesso, enquanto outros podem apresentar rejeições, dados incompletos, falhas de comunicação ou necessidade de conferência.
O PlusCom registra a situação de cada boleto para evitar reenvios indevidos e permitir o acompanhamento do processamento.
Situações possíveis durante o envio
Pendente de envio
Indica que o boleto foi gerado no PlusCom, mas ainda não foi enviado ao banco.
Esse boleto está disponível para processamento na rotina de envio.
Em envio
Indica que o PlusCom iniciou a comunicação com o banco e está aguardando o resultado da operação.
Enquanto o boleto estiver nessa situação, ele não deverá ser enviado novamente.
Envio confirmado
Indica que o banco confirmou o recebimento e o registro do boleto.
Quando o envio é confirmado, o PlusCom armazena as informações devolvidas pelo banco, como os identificadores do título e da parcela, quando disponibilizados.
Somente boletos com confirmação efetiva do banco são considerados enviados com sucesso.
Erro de validação
Indica que o PlusCom encontrou dados inválidos ou incompletos antes de iniciar o envio.
Isso pode ocorrer, por exemplo, quando existem informações ausentes no cadastro do pagador, no boleto ou na configuração bancária.
Nesse caso, o usuário deverá corrigir os dados informados. Após a correção, o boleto poderá ser disponibilizado novamente para envio.
Como a comunicação com o banco ainda não ocorreu, esse tipo de erro não representa uma tentativa de registro do boleto.
Rejeitado pelo banco
Indica que o banco recebeu a solicitação, mas não aceitou o registro do boleto.
A rejeição poderá ocorrer por dados inválidos, regras bancárias não atendidas ou outras inconsistências informadas pelo próprio banco.
O PlusCom apresentará a mensagem recebida para que o usuário possa identificar e corrigir o problema.
Um boleto rejeitado não deverá ser reenviado sem que a causa da rejeição seja analisada e corrigida.
Falha que permite novo envio
Indica que ocorreu uma falha antes de o pedido ser processado pelo banco.
Nessa situação, o PlusCom possui segurança de que o boleto não foi registrado. Por isso, uma nova tentativa poderá ser realizada.
Esse tratamento pode ser utilizado, por exemplo, quando a conexão com o banco não chega a ser estabelecida.
Resultado indeterminado
Indica que o PlusCom iniciou o envio, mas não conseguiu confirmar se o banco registrou ou não o boleto.
Isso pode acontecer em situações como:
interrupção da conexão durante o envio;
tempo de espera excedido;
encerramento inesperado do PlusCom;
resposta incompleta ou inválida do banco;
indisponibilidade temporária da API;
falha ao salvar localmente uma resposta já recebida.
Nesses casos, não é seguro considerar que o envio falhou.
Também não é seguro reenviar imediatamente o boleto, pois o banco pode ter concluído o registro mesmo que a confirmação não tenha chegado ao PlusCom. Um novo envio poderia provocar a criação de um título duplicado.
Por esse motivo, boletos com resultado indeterminado ficam bloqueados para reenvio até que a situação seja conferida.
Conciliação de um resultado indeterminado
Quando um boleto apresenta resultado indeterminado, o PlusCom deverá tentar localizar o título no banco por meio de uma consulta.
Durante essa verificação, o boleto poderá aparecer como Em conciliação.
A conciliação poderá produzir os seguintes resultados:
caso o título seja localizado e seus dados sejam confirmados, o boleto será considerado enviado com sucesso;
caso o título não seja localizado, o PlusCom poderá realizar novas consultas antes de permitir qualquer reenvio;
caso as informações encontradas sejam diferentes das informações do boleto, será necessária uma análise manual;
caso não exista uma forma segura de confirmar a situação, o boleto permanecerá bloqueado para análise.
O fato de um boleto não ser encontrado em uma única consulta não significa necessariamente que ele não tenha sido registrado. Pode existir um intervalo entre o registro do título e sua disponibilização para consulta.
Intervenção manual
A situação Intervenção manual indica que o PlusCom não conseguiu determinar automaticamente o resultado da operação.
Essa situação poderá exigir contato com o banco ou conferência no ambiente bancário.
Após a confirmação, um usuário autorizado poderá:
marcar o boleto como enviado, caso o registro no banco seja comprovado;
liberar o boleto para um novo envio, caso seja comprovado que ele não foi registrado;
realizar uma nova tentativa de consulta;
registrar uma justificativa para a decisão tomada.
Toda alteração manual deverá ser realizada somente após uma conferência segura, pois uma liberação indevida poderá gerar duplicidade de boletos.
Resultado do lote
O lote serve apenas para agrupar os boletos selecionados para envio.
O resultado do lote é calculado a partir da situação individual de cada boleto. Por isso, um lote poderá ser apresentado como:
pendente;
em processamento;
concluído com sucesso;
concluído com rejeições;
concluído com pendências;
não processado.
Um lote somente será considerado totalmente concluído com sucesso quando todos os seus boletos tiverem o envio confirmado.
Caso exista pelo menos um boleto com resultado indeterminado ou aguardando intervenção manual, o lote deverá ser apresentado como concluído com pendências.
Regras importantes de segurança
Para proteger o usuário contra registros duplicados, o PlusCom aplica as seguintes regras:
Cada boleto é controlado individualmente, mesmo quando pertence a um lote.
Um boleto somente é considerado enviado quando existe confirmação efetiva do banco.
Um erro de comunicação não significa automaticamente que o banco deixou de registrar o título.
Boletos com resultado indeterminado não podem ser reenviados diretamente.
Antes de liberar um novo envio, o PlusCom deverá tentar confirmar se o título já existe no banco.
Quando a confirmação automática não for possível, será necessária uma análise manual.
A situação do envio não representa necessariamente a situação financeira do boleto.
Diferença entre situação do envio e situação do boleto
A situação do envio informa apenas o resultado da comunicação entre o PlusCom e o banco.
Ela não deve ser confundida com a situação financeira do título.
Por exemplo, um boleto pode estar com o envio confirmado e, posteriormente, apresentar uma das seguintes situações bancárias:
em aberto;
vencido;
liquidado;
baixado;
protestado;
alterado.
Essas situações são atualizadas por consultas ou ocorrências posteriores e não fazem parte do processo inicial de envio.
Resumo do fluxo
O fluxo normal de um boleto é:
Pendente de envio → Em envio → Envio confirmado
Quando há alguma inconsistência, o fluxo poderá ser:
Pendente de envio → Erro de validação → Correção dos dados → Pendente de envio
Quando o banco rejeita o registro:
Em envio → Rejeitado pelo banco → Correção dos dados → Novo envio
Quando ocorre uma falha de comunicação sem resultado conclusivo:
Em envio → Resultado indeterminado → Em conciliação
Após a conciliação, o boleto poderá seguir para:
envio confirmado;
nova tentativa de consulta;
intervenção manual.
Um boleto com resultado indeterminado nunca deverá retornar diretamente para pendente de envio sem que exista confirmação de que ele não foi registrado pelo banco.
Page updated
Google Sites
Report abuse