BrazilFiscalReport 0.7.1

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

Brazil Fiscal Report

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

Documentation | PyPI | Try it Online

Supported Documents

Document	Description	XML Source
DANFE	Documento Auxiliar da Nota Fiscal Eletrônica	NF-e
DACCe	Documento Auxiliar da Carta de Correção Eletrônica	CC-e
DACTE	Documento Auxiliar do Conhecimento de Transporte Eletrônico	CT-e
DAMDFE	Documento Auxiliar do Manifesto Eletrônico de Documentos Fiscais	MDF-e
DANFSE	Documento Auxiliar da Nota Fiscal de Serviços Eletrônica	NFS-e

Installation

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[cli]'     # CLI tool
pip install 'brazilfiscalreport[dacte,damdfe,cli]'  # All extras

Quick Start

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")

The same pattern applies to all document types:

from brazilfiscalreport.dacte import Dacte
from brazilfiscalreport.damdfe import Damdfe
from brazilfiscalreport.dacce import DaCCe

dacte = Dacte(xml=cte_xml)
dacte.output("dacte.pdf")

damdfe = Damdfe(xml=mdfe_xml)
damdfe.output("damdfe.pdf")

dacce = DaCCe(xml=cce_xml)
dacce.output("dacce.pdf")

CLI

Generate PDFs directly from the terminal:

bfrep danfe /path/to/nfe.xml
bfrep dacte /path/to/cte.xml
bfrep damdfe /path/to/mdfe.xml
bfrep dacce /path/to/cce.xml
bfrep danfse /path/to/nfse.xml

See the CLI documentation for configuration options.

Dependencies

• FPDF2 - PDF creation library for Python
• phonenumbers - Phone number formatting
• python-barcode - Barcode generation
• qrcode - QR code generation (required for DACTE and DAMDFE)

Credits

This is a fork of the nfe_utils project, originally created by Edson Bernardino.

Maintainer