FreteFlow / docs

Configuração do PDF da fatura

Deixe o PDF com a identidade da sua empresa: cores, logo, textos, colunas da tabela de detalhes e blocos opcionais. Cada cliente pode ter um layout próprio que sobrescreve o padrão da empresa.

Onde configurar

Padrão da empresa: /faturamento/configuracoes → card PDF da Fatura.
Por cliente: /faturamento/clientes → abra o cliente → aba Personalizar PDF.

Cores e logo

  • Cor primária — cabeçalhos e destaques (hex, ex.: #0f172a).
  • Cor secundária — linhas, bordas e detalhes.
  • Cor do texto — corpo do documento.
  • Logo — PNG ou JPG, até 500 KB, exibido no cabeçalho.

Textos institucionais

Cada texto aceita até 2.000 caracteres e preserva quebras de linha.

  • Cabeçalho — texto que aparece ao lado do logo.
  • Rodapé — endereço, contatos ou aviso legal em todas as páginas.
  • Agradecimento — mensagem no fim do documento (bloco opcional).
  • Dados bancários — banco, agência, conta, PIX (bloco opcional).

Colunas da tabela "Detalhes da Fatura"

Cada linha da fatura é um documento consolidado. Você escolhe quais colunas exibir, em que ordem e a largura de cada uma (em % da largura útil da página). Colunas disponíveis:

  • documento — CT-e / RPS / NFS-e
  • data — data do documento
  • destinatario — nome do destinatário
  • nf — número da nota fiscal vinculada
  • valor_mercadoria — valor da mercadoria transportada
  • peso_kg — peso em kg
  • base_calculo — base de cálculo
  • icms — ICMS destacado
  • iss — ISS destacado
  • st — ICMS-ST
  • frete — valor do frete

Mínimo de 3 colunas e máximo de 11 visíveis. A soma das larguras deve fechar 100% — o editor avisa antes de salvar.

Blocos opcionais

  • Observações — texto da fatura, quando preenchido.
  • Dados bancários — usa o texto configurado acima.
  • Agradecimento — usa o texto configurado acima.
  • Resumo de totalizadores — subtotais por coluna monetária (mercadoria, ICMS, ISS, frete).
  • Boleto / QR code — placeholder para integração de boleto (aparece se ativo).

Override por cliente

Na aba Personalizar PDF do cliente você preenche apenas o que quer sobrescrever. Campos deixados em branco herdam do padrão da empresa. A mesclagem é campo a campo: se você trocar apenas a cor primária, o resto continua vindo da configuração da empresa.

Marca d'água

A marca d'água é aplicada automaticamente e não pode ser desativada:

  • RASCUNHO — em faturas não emitidas.
  • CANCELADA — em faturas canceladas.
  • HOMOLOGAÇÃO — em ambientes de teste.

Limites

  • PDF disponível apenas para faturas emitida, encerrada ou cancelada.
  • Batch de PDF: até 50 faturas por download.
  • Logo: até 500 KB, PNG ou JPG.
  • Textos institucionais: até 2.000 caracteres cada.