Em produção · Würth Industry · Greatek · Bombas Rowa
O título nasce da fatura, vai ao banco por API ou por remessa CNAB, o pagador recebe boleto com QR PIX no mesmo papel e a baixa volta sozinha para o contas a receber. Com a sua conta, o seu convênio e a tarifa que você já negociou.
40 bancos e PSPs por API · 105 bancos por remessa CNAB240 · ativação em ~1 semana por conta
Quem já cobra pelo TETIS todo mês
O problema
Entre a fatura no sistema e o dinheiro na conta existe um vão que quase toda operação atravessa na mão: alguém abre o internet banking, digita título por título, salva PDF, manda e-mail e depois volta para conferir quem pagou.
A fatura já existe no ERP com valor, vencimento, pagador e documento. Mesmo assim alguém redigita tudo no site do banco. Uma cobrança mensal de 300 títulos vira uma manhã inteira de digitação, todo mês, com o erro de centavo e de CNPJ embutido no processo.
O extrato mostra o crédito, mas não diz qual fatura ele quita. O financeiro casa na mão, atrasa dois dias, e nesse meio-tempo a régua de cobrança dispara em cima de quem já pagou. Cliente irritado, e a culpa é do processo.
Um convênio abre API com certificado, outro só aceita arquivo de remessa, o terceiro exige carteira e faixa de nosso número diferentes. Trocar de banco ou abrir uma segunda conta vira projeto de TI em vez de decisão de tesouraria.
Sexta-feira à noite, com o boleto na mão, o cliente encara 47 dígitos de linha digitável para conseguir pagar. Muita gente adia para segunda, e segunda vira quarta. O atraso não é falta de dinheiro, é atrito.
O fluxo, ponta a ponta
Toda a cobrança acontece dentro do ERP que já emite a fatura. Telas reais do sistema, etapa por etapa:
O contas a receber já tem valor, vencimento, pagador, documento e endereço. Gerar o boleto é uma ação na própria fatura: o TETIS monta o título com o convênio da conta bancária escolhida, calcula juros, multa e desconto pelas regras cadastradas e grava o registro com status Gerado.
Contrato mensal não precisa nem disso: a cobrança do contrato gera a fatura e o boleto no dia certo, pelo cron de faturamento.
No cadastro da conta bancária você escolhe o modo: API, e o TETIS registra o boleto direto no banco; ou arquivo, e o título espera entrar numa remessa CNAB240. Convênio, carteira, código do beneficiário e sequencial do arquivo ficam na mesma tela.
Credenciais e certificados são cifrados em AES no banco de dados e nunca voltam para a tela: quem edita a conta não consegue ler o segredo que já está gravado.
Em modo API, o cron pega os boletos com status Gerado, autentica na instituição por OAuth2 (com certificado mTLS onde o banco exige) e registra cada título. O retorno traz nosso número, linha digitável, código de barras e o PDF do banco. Erro de registro entra no histórico do boleto com a mensagem que o banco devolveu.
Cancelou uma fatura? O cancelamento também sobe sozinho, com motivo, usuário e data guardados.
A tela lista as contas em modo arquivo, mostra os títulos pendentes de cada uma e monta o arquivo no layout FEBRABAN: header de arquivo e de lote, segmentos P, Q e R, trailers fechando em 240 posições. Você baixa o .REM e sobe no canal do banco. Os boletos passam para Aguardando Pagamento com o número da remessa no histórico.
O sequencial do arquivo é reservado de forma atômica por conta: duas pessoas gerando ao mesmo tempo não produzem dois arquivos com o mesmo NSA.
07700000 2 12345678000199 0001234567890123 0001 1 12345678 9 0770001T01 030 2 12345678000199 0001234567890123 0001 1 12345678 9 MINHA EMPRESA LTDA 0770001300001P 01 00012345678901234567 1 01 000123 2 15082026 000000000148750 0770001300002Q 01 1 12345678000199 CONSTRUTORA SAO JORGE LTDA AV BRASIL 1200 07700015 000004 000000000148750
Trecho real de uma remessa de cobrança gerada pelo TETIS. As posições de cada campo ficam numa tabela editável: banco com particularidade de convênio se ajusta sem tocar em código.
Onde o banco entrega o QR PIX junto com o registro, ele vai impresso no próprio título. Mesmo valor, mesmo vencimento, mesmos juros e multa, recalculados pelo banco na hora da leitura. O copia-e-cola acompanha o e-mail de cobrança, a régua de lembretes e a 2ª via no portal do cliente.
O QR vem sempre do banco emissor, nunca é montado aqui dentro. Se a instituição não devolve o EMV, o título sai como boleto tradicional e ninguém finge que tem PIX.
Cada etapa da régua tem um deslocamento em dias em relação ao vencimento (−3, no dia, +5, +15), um modelo de mensagem e um canal: e-mail, WhatsApp ou os dois. O texto puxa nome, código, valor, vencimento, linha digitável e PIX copia-e-cola do próprio título.
Quem já pagou sai da varredura, porque a régua só olha título em aberto com saldo maior que zero. E cada envio fica registrado: a mesma etapa não dispara duas vezes para a mesma fatura.
Nas contas em modo API o TETIS consulta o banco em ciclo curto e, quando o título é liquidado, dá baixa na fatura, lança o pagamento e registra se a liquidação veio por PIX ou por código de barras. Sábado à noite e feriado incluídos.
A baixa é idempotente por desenho: um boleto já pago que voltar a ser processado é ignorado. Fatura quitada duas vezes é um bug que este módulo já teve e fechou.
Os bancos
Onde a instituição abre API, o TETIS registra o título nela e recebe a baixa de volta. Onde o caminho ainda é arquivo, o TETIS gera a remessa no padrão FEBRABAN. A escolha é por conta bancária, então dá para ter uma conta em cada modo ao mesmo tempo.
Library dedicada por instituição, com OAuth2 e, em 21 delas, certificado mTLS da sua própria conta. O título nasce registrado e a baixa chega sem intervenção. As 16 marcadas com PIX devolvem o QR do boleto híbrido, impresso no próprio título.
Cobrança dos seus clientes e borderô de pagamento aos fornecedores, no mesmo motor. Os 105 bancos já vêm cadastrados com o perfil FEBRABAN; convênio, carteira, versão de layout e composição do nosso número se ajustam na tela Bancos CNAB.
Seu banco não aparece na lista de API? Fale com a gente. O CNAB240 é padrão FEBRABAN, então quase sempre a conta entra pelo modo arquivo já na primeira semana, e a library de API entra depois como evolução.
Antes × depois
| Com a Cobrança Bancária TETIS | Cobrando pelo internet banking | |
|---|---|---|
| Emissão dos títulos | Sai da fatura que já existe, em lote | Digitado título por título no site do banco |
| Envio ao banco | API no cron ou remessa CNAB240 num clique | Upload manual, quando alguém lembra |
| Forma de pagar | QR PIX, copia-e-cola, código de barras e linha digitável | Código de barras e linha digitável |
| Baixa na fatura | Automática, com o meio de liquidação registrado | Casada no extrato, dois dias depois |
| Cobrança de quem atrasou | Régua por offset de dias, e-mail e WhatsApp | Planilha de controle e telefonema |
| Cliente que já pagou | Sai da régua no mesmo dia da baixa | Recebe cobrança indevida |
| Segunda conta bancária | Cadastro novo, modo próprio, mesma tela | Outro portal, outro processo, outra planilha |
| Rastro de auditoria | Histórico por título, do registro à baixa | PDF numa pasta de rede |
Diferenciais
Client id, secret, senha e token da conta bancária são cifrados em AES no banco de dados. O front nunca recebe esses campos, nem para editar: salvar a conta sem preencher mantém o segredo antigo em vez de apagá-lo.
A conta do Inter roda por API e a da cooperativa roda por arquivo, no mesmo mês, na mesma empresa. Quem está em modo arquivo é pulado pelo cron de API, sem gerar erro nem título fantasma.
O código do PIX vem do banco que registrou o título e é apenas renderizado no PDF. Nada de montar BR Code aqui dentro: é o que a norma do arranjo exige, e é o que evita QR que o app do pagador recusa.
O retorno do banco pode chegar por mais de um caminho. Reprocessar um boleto já pago não gera outro pagamento nem requita a fatura: a guarda de idempotência trata como no-op e registra no log.
As posições de cada campo do arquivo vivem numa tabela, não em código. Banco com particularidade de convênio, versão de lote ou composição de nosso número se resolve na tela Bancos CNAB, sem esperar release.
A etapa escolhe e-mail, WhatsApp ou os dois. O WhatsApp sai pela instância da própria empresa, com a linha digitável e o PIX copia-e-cola no texto. Sem instância configurada, a etapa registra a pendência em vez de falhar calada.
Onde este módulo começa e termina
A Cobrança Bancária cuida do trecho entre a fatura e a instituição: registro do título, boleto, PIX, remessa, borderô e baixa. O que vem antes e o que vem depois tem dono próprio no TETIS, e os três conversam sem exportar planilha.
Fatura, contas a receber e a pagar, rateio por centro de custo, DRE, aging e fluxo de caixa. É de lá que sai o título que este módulo leva ao banco. A Cobrança Bancária não roda sem ele.
Importação de OFX, casamento de lançamento com fatura, transferência entre contas e exportação contábil. Quanto mais boleto baixa sozinho aqui, menos linha sobra para conciliar lá.
A cobrança recorrente do contrato gera a fatura na data e já dispara o boleto. Trezentos contratos viram trezentos títulos registrados numa rodada de madrugada, sem ninguém acordado.
Como entra
Ativação por conta bancária, não por sistema inteiro. Você começa pelo banco onde está o grosso da carteira e vai somando.
Você pede ao gerente o convênio de cobrança e as credenciais de API (ou o certificado, onde o banco exige mTLS). A gente cadastra a conta, cifra os segredos e testa o registro em homologação.
~3 dias úteisUm lote pequeno de títulos reais, acompanhado por nós: registro, conferência da linha digitável no app do banco, teste de pagamento e baixa. Só depois disso a carteira inteira entra.
~1 semanaEtapas de lembrete configuradas com os seus textos, canal escolhido por etapa e a 2ª via liberada no portal do cliente. A partir daí o financeiro só olha exceção.
rodandoDúvidas frequentes
Próximo passo
Traga uma conta bancária e a sua carteira de títulos. A gente registra o primeiro lote junto com você e você vê a baixa chegar sozinha.