Este artigo explica como interpretar o Cartão Inteligente de Diagnóstico do Serviço Boleto Rápido.

O cartão utiliza indicadores de cores para demonstrar a saúde da operação e indicar quando é necessário realizar verificações ou ajustes na configuração do serviço.


Tópicos deste artigo:
 

Como interpretar o cartão

As cores exibidas no cartão indicam o estado do serviço e o nível de atenção necessário.

(Inserir imagem do cartão aqui)

🔴 Erro crítico (Status Vermelho)

O status vermelho ocorre quando o serviço está ativo, porém não existe nenhuma conta bancária credenciada para operar o Boleto Rápido.

Sem uma conta credenciada, o sistema não consegue:

• enviar boletos

• registrar títulos

• processar baixas automáticas

Mesmo sem funcionamento, o contrato do serviço continua ativo.

Impacto no serviço

Quando esse status ocorre:

• o serviço fica totalmente inoperante

• nenhum boleto é enviado

• as baixas automáticas não são processadas

Como resolver

1. Acesse Boleto Rápido → Contas

2. Verifique se existe alguma conta com status Credenciada / Ativa

3. Caso não exista, realize o credenciamento da conta

4. Após credenciar, reteste o envio ou registro de boletos

🟡 Avisos e pendências (Status Amarelo)

O cartão amarelo indica que o serviço não está totalmente bloqueado, mas existem situações que exigem verificação.

A seguir estão os cenários mais comuns.

Parâmetro indevido — SERVERHOSTSCHED

Indica uma configuração que pode impedir a execução automática de tarefas do sistema.

Como resolver

1. Acesse Preferências → Parâmetros

2. Pesquise pelo parâmetro SERVERHOSTSCHED

3. Limpe o campo Texto

4. Salve as alterações

5. Reinicie o servidor de aplicação

Jobs sem execução recente

Um ou mais processos automáticos essenciais estão atrasados ou não foram executados.

Checklist de verificação

• verificar se o parâmetro SERVERHOSTSCHED está vazio

• verificar se o servidor de aplicação está funcionando corretamente

• confirmar se as contas estão credenciadas e ativas

• caso persista, acionar o suporte técnico para análise de logs

Contas sem ocorrência de remessa

A conta não possui a configuração mínima de ocorrências necessária para operar o Boleto Rápido.

Isso pode impedir:

• envio de boletos

• alterações de títulos

• cancelamentos
   

Como configurar

Acesse Ocorrências de Remessa → Incluir Conta e configure as ocorrências conforme necessidade.

Boletos não enviados para o serviço

Ocorre quando títulos no ERP não entram corretamente no fluxo do Boleto Rápido.

Situações mais comuns

Título com boleto gerado, mas sem registro no sistema

O boleto possui:

• Nosso Número

• Código de Barras

• Linha Digitável

Porém não existe registro correspondente no sistema.

O que fazer

• confirmar se a conta está credenciada

• confirmar se existem ocorrências configuradas

• se necessário, renegociar o título e gerar um novo boleto

Registro pendente de envio

O registro foi criado, mas ainda não foi enviado ao banco.

Onde verificar:

Acompanhamento do Boleto → painel de status

Ação recomendada

• validar credenciamento da conta

• confirmar execução dos jobs

• reprocessar o registro

Aguardando processamento

O envio foi solicitado e está na fila de processamento.

Ação recomendada

• aguardar o processamento

• confirmar execução dos jobs

• caso permaneça parado por muito tempo, acionar suporte

Erro retornado pelo banco

O banco retornou uma rejeição ou erro técnico.

Como tratar

1. Acesse Acompanhamento do Boleto

2. Abra os detalhes do registro

3. Consulte a mensagem de retorno do banco

4. Ajuste a inconsistência indicada

5. Reprocesse o registro

Conta com credenciamento incompleto

O credenciamento foi iniciado, mas não foi concluído.

Ação recomendada

• repetir o credenciamento

• confirmar o status Ativa / Credenciada

🟢 Status normal (Verde)

Indica que o serviço está operando normalmente.

O sistema valida automaticamente:

• contas bancárias credenciadas

• envio e registro de boletos

• retornos bancários

• execução de jobs

• processamento de baixas automáticas

Nenhuma ação é necessária.

⚪ Inatividade / sem uso (Cinza)

Esse status indica ausência de utilização recente do serviço.

Pode ocorrer quando:

• o cliente nunca utilizou o Boleto Rápido

• o credenciamento inicial ainda não foi iniciado

• não houve emissão ou registro de boletos nos últimos 30 dias

Isso não representa um erro, apenas ausência de uso.
 

Dica: Para informações sobre modelos de contratação e custos, consulte o artigo Detalhes de cobrança de serviço do Boleto rápido.

📌Conheça mais Cartões Inteligentes!