Skip to main content

Python Library to create "boletos de cobrança bancária" for several Brazilian banks

Project description

pyboleto provides a python class to generate “boletos de cobranca” as these are the Brazilian equivalent for invoices.

It’s easy to implement classes for new banks.

This class is still in development and currently has no documented API.

Implemented Banks

You can help writing code for more banks or printing and testing current implementations.

For now here’s where we are.

Bank Carteira / Convenio Implemented Tested
Banco do Brasil 18 Yes Yes
Banrisul x Yes Yes
Bradesco 06, 03 Yes Yes
Caixa Economica SR Yes No
Itau 157 Yes Yes
Itau 175, 174, 178, 104, 109 Yes No
Real 57 Yes No
Santander 102 Yes Yes
Santander 101, 201 Yes No


The best way to learn how to create Boletos using pyboleto is to look at the examples at


You can install pyboleto either via the Python Package Index (PyPI) or from source.

To install using pip,:

$ pip install pyboleto

To install using easy_install,:

$ easy_install pyboleto

Downloading and installing from source

Download the latest version of pyboleto from

You can install it by doing the following,:

$ tar xvfz pyboleto-0.0.0.tar.gz
$ cd pyboleto-0.0.0
$ python build
# python install # as root

Using the development version

You can clone the repository by doing the following:

$ git clone

Executing unittests

You need either setuptools or distribute in order to execute the tests. Chances are you already have one or another. You also need pdftohtml.:

$ cd pyboleto
$ python test


This software is licensed under the New BSD License. See the LICENSE file in the top distribution directory for the full license text.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for pyboleto, version 0.3.1
Filename, size File type Python version Upload date Hashes
Filename, size pyboleto-0.3.1.tar.gz (90.6 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page