tests codecov pypi license contributors pypi-downloads Open in Streamlit

Python library for generating Brazilian auxiliary fiscal documents in PDF from XML documents.

Every Brazilian electronic invoice is issued by the tax authority as an XML file. This library turns that XML into the official, printable PDF that has to accompany the goods or service: NF-e → DANFE, CT-e → DACTE, MDF-e → DAMDFE and NFS-e → DANFSe. It also renders the DACCe, the printout for the NF-e correction-letter event (CC-e).

🇧🇷 Biblioteca Python para gerar em PDF os documentos fiscais auxiliares — DANFE, DACTE, DAMDFE e DANFSe — a partir do XML de NF-e, CT-e, MDF-e e NFS-e. Também gera a DACCe, representação da carta de correção (CC-e) da NF-e. Documentação em português →

Documentation | PyPI | Try it Online

• 🐍 Pure Python — built on fpdf2; no wkhtmltopdf, no headless browser, no HTML templates
• 📄 4 document types — DANFE, DACTE, DAMDFE and DANFSe (plus the DACCe correction-letter event), straight from the official XML
• 🎨 Customizable — issuer logo, margins, fonts, decimal precision, cancellation watermarks and more
• ⚡ 3 ways to use it — Python API, bfrep command line, or the online demo
• ✅ Python 3.8+ — tested on Python 3.8 through 3.13

pip install brazilfiscalreport

This installs the core library with support for DANFE and DACCe. For additional document types and features:

pip install 'brazilfiscalreport[dacte]' # DACTE support (requires qrcode)
pip install 'brazilfiscalreport[damdfe]' # DAMDFE support (requires qrcode)
pip install 'brazilfiscalreport[danfse]' # DANFSe support (requires qrcode)
pip install 'brazilfiscalreport[cli]' # CLI tool
pip install 'brazilfiscalreport[dacte,damdfe,danfse,cli]' # All extras

from brazilfiscalreport.danfe import Danfe
with open("nfe.xml", "r", encoding="utf8") as file:
 xml_content = file.read()
danfe = Danfe(xml=xml_content)
danfe.output("danfe.pdf")

nfe.xml is the authorized XML your ERP or the SEFAZ portal returns once the invoice is approved.

The same pattern works for every document type — import the matching class (Dacte, Damdfe, Danfse, DaCCe), pass the XML and call .output().

Need a logo, custom margins or a different font? Pass a config object:

from brazilfiscalreport.danfe import Danfe, DanfeConfig, Margins, FontType
with open("nfe.xml", encoding="utf8") as file:
 xml_content = file.read()
config = DanfeConfig(
 logo="logo.png",
 margins=Margins(top=5, right=5, bottom=5, left=5),
 font_type=FontType.TIMES,
)
danfe = Danfe(xml=xml_content, config=config)
danfe.output("danfe.pdf")

See the documentation for every option — watermarks, decimal precision, receipt position and more.

🚀 No setup? Try it online — upload your fiscal XML, download the PDF.

pip install 'brazilfiscalreport[cli]'
bfrep danfe nfe.xml # writes nfe.pdf in the current folder

bfrep ships one subcommand per document — danfe, dacte, damdfe and danfse (plus dacce for the NF-e correction letter) — each turning its XML into the matching PDF. Drop a config.yaml next to your files to set issuer data, logo and margins.

See the CLI documentation for all options.

BrazilFiscalReport is free software licensed under the LGPL-3.0 license.

Developed and maintained by Engenere. Issues and pull requests are welcome — see the contributing guide.

Engenere