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 |

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

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