Personalização de marca por entidade
Todo PDF abre com um timbre: logotipo, nome da empresa, endereço, identificador fiscal. Esse bloco pertence à entidade — a empresa legal que emite o documento — e não a nenhum modelo. Configure-o uma vez por entidade e todo documento que essa entidade gerar será correto, legalmente, seu. Em um grupo como o da Meridian, isso significa quatro timbres mantidos em quatro lugares, nunca confundidos entre si.
Acesso necessário. Configurar a personalização de marca da entidade exige o conjunto de permissões Accounting Admin v2 ou Accounting Controller v2. Os conjuntos Accounts Payable v2, Accounts Receivable v2 e Read Only v2 permitem visualizar entidades, mas não alterá-las.
Os campos do timbre (na Entidade)
| Campo | No PDF |
|---|---|
| URL do logotipo | O logotipo, no canto superior esquerdo. Precisa ser uma URL de imagem de acesso público (um link público de arquivo do Salesforce ou seu CDN). Um modelo pode substituí-lo para documentos especiais. |
| Nome da empresa (PDF) | O nome impresso — use-o quando o nome de impressão legal for diferente do nome do registro da entidade; se ficar em branco, usa o nome da entidade. |
| Endereço da empresa (PDF) | O bloco de endereço, com as quebras de linha preservadas — sede registrada, exatamente como deve ser impressa. |
| Identificador fiscal | Impresso exatamente como digitado — então digite a linha completa: "GSTIN: 27AAHCM8756Q1Z5" ou "Tax ID 87-4412906". As jurisdições que exigem número de registro nas faturas ficam atendidas aqui. |
No papel, o cartão do timbre é lido de cima para baixo: logotipo, nome impresso da empresa, o slogan do modelo (quando houver um definido), o bloco de endereço e depois o identificador fiscal — e o layout mantém o logotipo em proporções de timbre não importa quão grande seja a imagem de origem. O lado do cliente também é tratado: o Tax Registration Number e o Taxpayer ID dele — mantidos na conta do cliente — são impressos sob Bill To. Uma fatura de GST/IVA precisa dos números das duas partes, e os obtém (o alternador Show Tax Identifiers de um modelo pode suprimir os dois lados onde números de registro não devem aparecer no documento).
Mais duas formas pelas quais a entidade molda o documento
- A coluna de desconto só aparece quando faz sentido. Os PDFs de faturas mostram as colunas de desconto e a linha de total de desconto apenas quando a entidade tem uma Sales Discount GL Account configurada — uma entidade que nunca dá desconto nunca imprime colunas de desconto vazias, em nenhuma fatura.
- O código da moeda é automático. Os valores usam a moeda própria do documento em configurações multimoeda e, caso contrário, o código de moeda da entidade — o papel americano da Meridian traz USD, o do Reino Unido traz GBP, sem nada para configurar por modelo.
Entidade x modelo: quem é responsável por quê
Uma divisão clara que vale a pena internalizar:
- Personalização de marca da entidade = identidade. Quem está emitindo este documento — logotipo, nome, endereço, registro. Muda quando a empresa muda.
- Modelo = apresentação. Cores, fontes, slogans, instruções de pagamento, seções. Muda quando o design ou a política mudam. (Configuração de Modelo de PDF.)
- Mesmo sem nenhum modelo, a personalização de marca da entidade é renderizada — a identidade nunca é opcional.
Checklist de personalização de marca para uma nova entidade
Preencha os quatro campos do timbre
Logo URL (teste se abre em uma janela de navegação privada — público significa público), nome de impressão, endereço, linha do identificador fiscal.
Gere um documento e leia como um fiscal
Contabilize uma fatura de teste (ou escolha uma já contabilizada), gere o PDF e verifique: logotipo correto, razão social correta, endereço correto, número de registro presente e correto.
Depois, aplique o modelo
Cores da marca, slogan, dados de pagamento, condições — o documento da entidade já é funcional a partir da etapa 2; o modelo é o que o torna seu.
Erros comuns a evitar
| Erro | Por que prejudica | Faça isto em vez disso |
|---|---|---|
| Um Logo URL que exige login para ser visualizado | Uma imagem que só você consegue acessar não carrega no PDF nem para o cliente — o documento sai sem logotipo | Use um link genuinamente público (um link público de arquivo do Salesforce ou seu CDN) e teste-o em uma janela de navegação privada |
| Digitar apenas o número puro em Tax Identifier | Ele é impresso exatamente como digitado — um "27AAHCM8756Q1Z5" sem rótulo não significa nada para o leitor nem para o fiscal | Digite a linha completa impressa: "GSTIN: 27AAHCM8756Q1Z5", "Tax ID 87-4412906" |
| Pular a personalização de marca da entidade porque "o modelo cuida do design" | Modelos estilizam; eles não identificam. Sem os campos da entidade, mesmo um documento lindamente estilizado fica sem o nome legal, o endereço e o registro do emissor | Preencha primeiro os quatro campos do timbre; aplique os modelos depois — o checklist acima, nessa ordem |
| Esperar que os números fiscais de Bill To venham da sua entidade | Eles nunca virão — os números do comprador ficam na conta do cliente, e em branco permanecem | Mantenha o Tax Registration Number e o Taxpayer ID nas contas dos clientes, especialmente em jurisdições com GST/IVA |
| Corrigir um endereço errado editando o documento de um PDF já enviado | Arquivos antigos são o registro do que foi emitido; o erro está na entidade, e todo documento futuro vai repeti-lo | Corrija o Company Address (PDF) da entidade e depois gere novamente o que ainda precisa ser enviado |
O que vem a seguir
- Configuração de Modelo de PDF — a camada de apresentação.
- Hierarquia de Modelos — como os modelos de entidade e regionais interagem.
- Entendendo as Entidades — os registros onde tudo isso vive.
Perguntas frequentes
O PDF restringe os logotipos a um tamanho de timbre adequado; forneça uma imagem nítida e de tamanho razoável (logotipos retangulares e alongados renderizam melhor). Se o resultado sair errado, o problema geralmente está na imagem de origem — troque a URL e gere o documento novamente.
Não — os arquivos gerados são registros históricos e permanecem como foram emitidos. Novas gerações (e regenerações) já usam a marca nova imediatamente.
Quem mantém os registros de entidade — na prática, seu Accounting Admin. Trate o identificador fiscal com cuidado: ele é impresso em documentos legais exatamente como foi digitado.
A coluna de desconto e o total correspondente só aparecem quando a entidade tem uma Sales Discount GL Account configurada (e o modelo não está ocultando a linha de desconto). Se sua entidade nunca concede descontos, a fatura limpa, sem essa coluna, é o resultado esperado.
Por documento, não — mas por modelo, sim: a Logo URL Override de um modelo substitui o logotipo da entidade em tudo o que aquele modelo formata. Aponte o documento especial para esse modelo e você terá seu logotipo diferente.
Na conta do cliente — nos campos Tax Registration Number e Taxpayer ID. O identificador da própria entidade é separado e é impresso no timbre. Se ambos estiverem preenchidos e mesmo assim nada for impresso, o alternador Show Tax Identifiers do modelo está desativado.
Isso foi útil?