Ir para o conteúdo

Começando

Instalação

Instalação básica

pip install brazilfiscalreport

Isso instala todos os tipos de documento. Requer Python 3.10+.

Linha de comando

O comando bfrep precisa de um extra:

pip install 'brazilfiscalreport[cli]'

Início Rápido

Usando código Python

Gere um DANFE em PDF a partir de um arquivo XML de NF-e em poucas linhas:

from brazilfiscalreport.danfe import Danfe

# Carregar o conteúdo do XML
with open("nfe.xml", "r", encoding="utf8") as file:
    xml_content = file.read()

# Gerar o PDF
danfe = Danfe(xml=xml_content)
danfe.output("danfe.pdf")

Sem um XML em mãos?

Pegue um exemplo em tests/fixtures ou teste a demo online, que também tem exemplos prontos.

O mesmo padrão se aplica a todos os tipos de documentos:

from brazilfiscalreport.danfe import Danfe

danfe = Danfe(xml=xml_content)
danfe.output("danfe.pdf")

from brazilfiscalreport.dacce import DaCCe

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

from brazilfiscalreport.dacte import Dacte

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

from brazilfiscalreport.damdfe import Damdfe

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

from brazilfiscalreport.danfse import Danfse

danfse = Danfse(xml=xml_content)
danfse.output("danfse.pdf")

from brazilfiscalreport.danfce import Danfce

danfce = Danfce(xml=xml_content)
danfce.output("danfce.pdf")

Usando o CLI

Para geração rápida pelo terminal:

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

Veja a documentação do CLI para opções de configuração.

Próximos passos