Ir para o conteúdo

DACTE

DACTE (Documento Auxiliar do Conhecimento de Transporte Eletrônico) é um documento impresso usado no Brasil para acompanhar o conhecimento de transporte eletrônico (CT-e). Ele serve como uma versão simplificada do CT-e, fornecendo os principais detalhes sobre o embarque, como informações da carga, remetente e destinatário, e dados da transportadora.

Uso Básico

from brazilfiscalreport.dacte import Dacte

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

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

# Instanciar o objeto DACTE com o conteúdo XML carregado
dacte = Dacte(xml=xml_content)
dacte.output('output_dacte.pdf')

bfrep dacte /path/to/cte.xml

Personalizando o DACTE 🎨

Esta seção descreve como personalizar a saída PDF do DACTE usando a classe DacteConfig. Você pode ajustar diversas configurações como margens, fontes e outras opções 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 DacteConfig:

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=5, right=5, bottom=5, left=5)
  • Padrão: top, right, bottom e left definidos como 5 mm.

Posição do Recibo

  • Tipo: ReceiptPosition (Enum)
  • Valores: TOP, BOTTOM, LEFT
  • Descrição: Posição da seção de recibo no DACTE.
  • Exemplo: 
    config.receipt_pos = ReceiptPosition.BOTTOM
  • Padrão: TOP

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

Marca d'água Cancelada

  • Tipo: bool
  • Descrição: Quando definido como True, exibe uma marca d'água "CANCELADA" no DACTE para documentos cancelados.
  • Exemplo: 
    config.watermark_cancelled = True
  • Padrão: False

Exemplo de Uso com Personalização

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

from brazilfiscalreport.dacte import (
    Dacte,
    DacteConfig,
    DecimalConfig,
    FontType,
    Margins,
    ReceiptPosition,
)

# Caminho para o arquivo XML
xml_file_path = 'cte.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 = DacteConfig(
    logo='path/to/logo.png',
    margins=Margins(top=10, right=10, bottom=10, left=10),
    receipt_pos=ReceiptPosition.BOTTOM,
    decimal_config=DecimalConfig(price_precision=2, quantity_precision=2),
    font_type=FontType.TIMES,
)

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