Configurações de boletos BO99¶
Status, configuração de caminhos e logs do Boleto Service. É a tela usada quando algo dá errado em qualquer outra parte do módulo — verificar se o serviço está rodando, ver logs, reiniciar.
Pré-requisitos¶
- Permissão Master (nível 0) — a tela é restrita
- Acesso ao servidor onde o Sistemax está instalado (para caminhos de arquivo)
Quando vir nessa tela
Sempre que outra tela do módulo (Dashboard, Emissão, Remessa, Retorno) reclamar de serviço offline, timeout ou erro inesperado. Aqui você confere o status e os logs em tempo real.
Passo a passo¶
1. Acessar a tela¶
No menu lateral, clique em Financeiro → Boletos → Configurações.
2. Status do serviço¶
Bloco superior com informações de saúde:
| Campo | Significado |
|---|---|
| Status | running (rodando), stopped (parado), error (com falha). |
| Versão | Versão atual do Boleto Service (ex.: 1.6.1). |
| Porta | Porta HTTP interna usada pelo serviço. |
| Uptime | Tempo desde o último start. |
Botão Verificar Status força uma nova consulta — útil após reiniciar.
3. Reiniciar serviço¶
Botão Reiniciar para o caso de o serviço estar stopped ou error. O painel envia a instrução ao Windows Service e aguarda voltar para running.
O que reiniciar faz
Reiniciar não apaga boletos, cedentes nem arquivos. É equivalente a desligar e ligar o serviço — usado para limpar travamentos ou recarregar configuração.
4. Ver logs¶
Botão Ver Logs abre o bloco de logs (também expansível por Expandir/Recolher). Os logs:
- Vêm direto do arquivo
boleto-service/logs/boleto.log. - Mostram as últimas linhas em tempo real.
- Use Recarregar para puxar o conteúdo atualizado.
Antes de pedir suporte
Recarregue os logs, copie as últimas linhas com erro e anexe ao chamado. Acelera muito o diagnóstico.
5. Caminhos de arquivo¶
Bloco com os diretórios usados pelo serviço:
| Campo | Descrição | Exemplo |
|---|---|---|
| DLL ACBrBoleto | Caminho da biblioteca ACBr usada para gerar boletos. | C:\ACBr\ACBrBoleto64.dll |
| Diretório de Remessas | Pasta onde os arquivos de remessa CNAB são salvos. | C:\boletos\remessas |
| Diretório de Retornos | Pasta onde os arquivos de retorno ficam após o processamento. | C:\boletos\retornos |
| Diretório de PDFs | Pasta dos PDFs gerados. | C:\boletos\pdfs |
| Logo da Empresa | Caminho da imagem que aparece no boleto impresso. | C:\sistemax-erp\libs\ACBrLib\x64-boleto\logo.jpg |
Após editar, clique em Salvar Configurações.
Mudou um caminho?
Reinicie o serviço para que o novo caminho seja considerado. Se o caminho estiver inválido, o serviço pode iniciar mas falhar ao tentar gerar/processar arquivos.
6. Boas práticas¶
- Backup das pastas de remessa e retorno — são o histórico fiscal/financeiro da empresa.
- Logo do boleto deve ser JPG/PNG, de boa qualidade, com fundo branco.
- Não compartilhar o caminho de DLL ou logs em ambientes públicos.
Erros comuns¶
Status \"error\" mesmo após reiniciar
Veja os logs. Costuma ser caminho da DLL inválido, banco fora do ar ou porta ocupada. Corrija o caminho e reinicie.
\"Diretório não encontrado\" ao gerar remessa
O caminho de remessas/retornos/PDFs não existe no disco ou o usuário do serviço não tem permissão. Crie a pasta e dê permissão de escrita.
Logo não aparece no boleto
Caminho da logo errado ou arquivo corrompido. Confirme a extensão (.jpg ou .png) e tamanho (sugerido até 200KB).
Logs vazios
O serviço pode não ter sido iniciado ainda ou o arquivo boleto.log foi rotacionado. Reinicie e verifique novamente.