Pular para conteúdo

PyCobrança

Boletos, CNAB 240/400 e PIX para 18 bancos — em Python puro, num único pip install.

A PyCobrança é a plataforma Open Source de cobrança bancária brasileira em Python. Uma única biblioteca cobre o ciclo completo: emite boletos (código de barras, linha digitável e PDF), gera e lê arquivos CNAB (remessa e retorno 240/400), produz PIX/Bolepix e concilia o extrato OFX — sem dependências de sistema.

pip install pycobranca

from datetime import date
from pycobranca.bancos import Bancos
from pycobranca.render import render_boleto_pdf

Banco = Bancos.find("341")  # Itaú, pelo código FEBRABAN
boleto = Banco(
    valor="127.50",
    cedente="Empresa Exemplo LTDA",
    cedente_documento="11.222.333/0001-81",
    agencia="0057",
    conta="12345",
    carteira="109",
    nosso_numero="12345678",
    data_vencimento=date(2026, 8, 15),
    sacado="Cliente Final da Silva",
    sacado_documento="529.982.247-25",
)
boleto.validar()
print(boleto.linha_digitavel)

open("boleto.pdf", "wb").write(render_boleto_pdf(boleto.contexto_render()))

Por onde começar

Se você quer… Comece por
Entender o escopo e a arquitetura Visão geral · Arquitetura
Avaliar se dá para confiar Compatibilidade e validação
Saber o que cada banco suporta Bancos suportados · Docs por banco
Gerar remessa e ler retorno CNAB
Emitir Bolepix PIX
Personalizar o PDF (boleto, carnê, fatura) Renderização
Expor a engine por HTTP Contrato REST
Tratar erros de validação Validação de campos
Preparar-se para o CNPJ alfanumérico CNPJ alfanumérico
Conciliar o extrato OFX
Emitir em lote Processamento em lote
Adicionar um banco novo Guia de novo banco · Contribuindo

Exemplos executáveis

O repositório traz exemplos executáveis cobrindo boleto, Bolepix, remessa 400/240, retorno, OFX, carnê, fatura, contrato REST e tratamento de erros. A CI roda todos a cada push, então eles nunca ficam desatualizados:

python examples/executa_todos.py