Ir para o conteúdo

DAMDFE

DAMDFE (Documento Auxiliar do Manifesto Eletrônico de Documentos Fiscais) é uma representação impressa do MDF-e (Manifesto Eletrônico de Documentos Fiscais) usado no Brasil. Ele consolida informações sobre o transporte de mercadorias, vinculando múltiplos CT-e ou NF-e a uma única operação de transporte, e é obrigatório para acompanhar a carga durante o trânsito.

Uso Básico

from brazilfiscalreport.damdfe import Damdfe

# Caminho para o arquivo XML
xml_file_path = 'mdfe.xml'

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

# Instanciar o objeto DAMDFE com o conteúdo XML carregado
damdfe = Damdfe(xml=xml_content)

# Salvar o PDF gerado em um arquivo
damdfe.output('damdfe.pdf')

bfrep damdfe /path/to/mdfe.xml

Personalizando o DAMDFE 🎨

Esta seção descreve como personalizar a saída PDF do DAMDFE usando a classe DamdfeConfig. Você pode ajustar diversas configurações como margens, fontes e precisão decimal de acordo com suas necessidades.

Opções de Configuração ⚙️

Aqui está uma descrição de todas as opções de configuração disponíveis em DamdfeConfig:

Logo

  • Tipo: str, BytesIO ou bytes
  • Descrição: Caminho para o arquivo de logo ou dados binários da imagem a ser incluída no PDF. Você pode usar uma string com o caminho do arquivo ou passar os dados da imagem diretamente.
  • Exemplo: 
    config.logo = "path/to/logo.jpg"  # Usando caminho do arquivo
  • Padrão: Sem logo.

Margens

  • Tipo: Margins
  • Campos: top, right, bottom, left (todos do tipo Number)
  • Descrição: Define as margens da página do documento PDF.
  • Exemplo: 
    config.margins = Margins(top=10, right=10, bottom=10, left=10)
  • Padrão: top, right, bottom e left definidos como 5 mm.

Configuração Decimal

  • Tipo: DecimalConfig
  • Campos: price_precision, quantity_precision (ambos int)
  • Descrição: Define o número de casas decimais para preços e quantidades.
  • Exemplo: 
    config.decimal_config = DecimalConfig(price_precision=2, quantity_precision=2)
  • Padrão: 4 para ambos os campos.

Tipo de Fonte

  • Tipo: FontType (Enum)
  • Valores: COURIER, TIMES
  • Descrição: Estilo de fonte usado em todo o documento PDF.
  • Exemplo: 
    config.font_type = FontType.COURIER
  • Padrão: TIMES

Exemplo de Uso com Personalização

Veja como configurar um objeto DamdfeConfig com um conjunto completo de personalizações:

from brazilfiscalreport.damdfe import (
    Damdfe,
    DamdfeConfig,
    DecimalConfig,
    FontType,
    Margins,
)

# Caminho para o arquivo XML
xml_file_path = 'mdfe.xml'

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

# Criar uma instância de configuração
config = DamdfeConfig(
    logo='path/to/logo.png',
    margins=Margins(top=10, right=10, bottom=10, left=10),
    decimal_config=DecimalConfig(price_precision=2, quantity_precision=2),
    font_type=FontType.TIMES,
)

# Usar esta configuração ao criar uma instância do Damdfe
damdfe = Damdfe(xml_content, config=config)
damdfe.output('output_damdfe.pdf')