Começando

Instalação

Instalação básica

pip install brazilfiscalreport

Isso instala a biblioteca principal com suporte para DANFE e DACCe.

Dependências opcionais

Alguns tipos de documentos requerem pacotes adicionais:

DACTEDAMDFECLITodos os extras

pip install 'brazilfiscalreport[dacte]'

pip install 'brazilfiscalreport[damdfe]'

pip install 'brazilfiscalreport[cli]'

pip install 'brazilfiscalreport[dacte,damdfe,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")

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

DANFEDACCeDACTEDAMDFE

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

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

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

Próximos passos

• Conheça as opções de personalização para cada tipo de documento: DANFE, DACTE, DAMDFE, DACCe
• Configure o CLI para geração em lote