Hierarquia de Modelos
A Meridian opera quatro entidades em quatro países. Os EUA e o Reino Unido têm seus próprios modelos de fatura; o da Índia ainda está na lista de pendências. Então o que acontece quando cada entidade gera uma fatura? Uma resolução de quatro níveis responde a isso — o específico vence o geral, e sempre há uma rede de segurança.
Acesso necessário. Qualquer pessoa que possa abrir um registro pode gerá-lo e ler qual modelo foi resolvido. Configurar os modelos e seu escopo 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 podem visualizar os modelos, mas não alterá-los.
Os quatro níveis
Nível 1 — A própria substituição do documento
Se alguém definiu o campo PDF Template do registro, esse modelo vence (desde que esteja ativo). Esta é a exceção por documento — um layout especial para uma conta-chave.
Nível 2 — O modelo da entidade
Um modelo ativo com escopo na entidade do documento e com o tipo de documento correspondente. O vencedor do dia a dia: as faturas da Meridian US usam Meridian US — Sales Invoice.
Nível 3 — O modelo do território
Sem modelo de entidade? Um modelo ativo com escopo no território da entidade entra em ação — um único modelo "Europa" pode vestir todas as entidades europeias até que cada uma tenha o seu.
Nível 4 — O padrão embutido
Nada configurado ainda assim produz um documento completo e profissional a partir da identidade visual da entidade (a tela de geração mostra Default como o modelo). Nenhuma configuração pode deixar você incapaz de enviar uma fatura.
Dois pontos importantes sobre o Nível 1 que vale a pena conhecer antes de confiar nele. Primeiro, a substituição só conta enquanto o modelo estiver ativo — aponte um documento para um modelo desativado e a resolução silenciosamente continua descendo a escada, como se o campo estivesse vazio. Segundo, o campo é protegido: ele só aceita modelos ativos cujo Document Type corresponda ao registro, então uma fatura não pode ser vestida como um recibo por acidente. Uma fatura mostra "Selected template must match Document Type "Sales Invoice" and be active." (desembolsos e ordens de compra nomeiam seus próprios tipos); um recebimento recusa com "O Modelo de PDF deve ser do tipo "Recebimento"." — uma regra que vale mesmo quando os registros chegam por importações e integrações.
A escada em ação: três faturas da Meridian
Mesmo grupo, mesmo dia, três resoluções diferentes:
| Fatura | O que está configurado | O que a tela de geração mostra |
|---|---|---|
| MSI001021 — NovaTech, US$ 9.800, Meridian US | A entidade US tem seu próprio modelo de fatura | Template: Meridian US — Sales Invoice (Nível 2 — o modelo da entidade) |
| Uma fatura da entidade India da Meridian | Ainda sem modelo de entidade; o território tem um modelo alternativo regional | O modelo de fatura do território (Nível 3) — papel com identidade visual sem esperar pelo design próprio da entidade |
| Uma fatura em que alguém preencheu o campo PDF Template do registro | Uma escolha explícita no documento | Esse modelo, pelo nome (Nível 1) — desde que esteja ativo e seja do tipo fatura |
E se a Meridian criasse uma quinta entidade amanhã sem nada configurado? Nível 4: suas faturas ainda seriam geradas, completas e profissionais, com o papel timbrado da entidade — a linha Template da tela mostrando Default.
Dentro de um nível: a correspondência de idioma
Quando vários modelos existem no mesmo nível — digamos, modelos de fatura em inglês e francês em uma entidade canadense — o cliente decide: a geração compara as tags Language/Locale dos modelos com as configurações de idioma do cliente, preferindo a correspondência mais próxima (locale vence idioma, que vence sem tag), e recorre ao modelo marcado como Is Default se nada corresponder. Uma entidade, papel por cliente, esforço zero na hora de faturar.
Precisamente: modelos que correspondem tanto ao idioma quanto ao locale da conta vencem primeiro; se não houver, uma correspondência de locale; se não, uma correspondência de idioma; se não, todo o conjunto compete. Entre os sobreviventes, Is Default desempata, e entre vários Defaults, o modelo mais antigo vence. "O cliente" significa a conta a que o papel é endereçado — o cliente em faturas, notas de crédito e recebimentos; o fornecedor em desembolsos e ordens de compra. Se as configurações de idioma dos seus clientes não estiverem mantidas, as tags não têm nada com que comparar e todos recebem o Default — marque os modelos com tags e mantenha os idiomas das contas atualizados, ou não faça nenhum dos dois.
Uma observação sobre extratos
As exportações de extrato de conta são resolvidas da mesma forma, menos a substituição por documento (um extrato não é um registro) — modelo de Statement da entidade, depois do território, depois o padrão embutido. Também não há correspondência de idioma: dentro de um nível, o modelo Statement Default (ou o mais antigo) simplesmente vence.
Erros comuns a evitar
| Erro | Por que prejudica | Faça isto em vez disso |
|---|---|---|
| Usar substituições por documento como mecanismo diário de identidade visual | Todo documento novo exige uma escolha manual — esqueça uma e ele silenciosamente usa o modelo da entidade ou do território | Configure modelos de entidade/território para a resposta padrão; reserve a substituição para exceções genuínas |
| Esquecer uma substituição depois de defini-la | O documento mantém seu modelo explícito mesmo depois que você cria modelos de entidade melhores — uma fatura fica presa no design do ano passado | Ao aposentar um modelo, procure documentos que o nomeiam e limpe o campo PDF Template deles |
| Desativar um modelo como forma de "desligar" a saída com identidade visual | A resolução não para — ela cai para o próximo nível, então o papel muda de aparência sem que ninguém tenha decidido isso | Tenha o substituto ativo primeiro; trate Is Active como uma decisão de roteamento, não um botão de pausa |
| Marcar modelos com tags de idioma enquanto as contas de clientes não têm configurações de idioma | A correspondência não tem nada para comparar — todo cliente recebe o Default e as variantes nunca são impressas | Implemente os dados de idioma/locale das contas junto com os modelos marcados |
| Marcar vários modelos como Default no mesmo conjunto | O mais antigo vence silenciosamente; seis meses depois ninguém sabe explicar por que o papel tem a aparência que tem | Exatamente um Default por entidade (ou território) e tipo de documento |
O que vem a seguir
- Configuração de Modelos de PDF — o que cada modelo controla.
- Identidade Visual por Entidade — a camada que sempre se aplica, com ou sem modelo.
- Gerando PDFs — observando a resolução acontecer na tela de geração.
Perguntas frequentes
A tela Gerar PDF nomeia o modelo resolvido (ou Default) antes de renderizar — gere uma vez e leia a linha Template. Para uma resposta permanente, defina explicitamente o campo PDF Template do registro.
Primeiro a correspondência de idioma do cliente; entre iguais, o marcado como Is Default; entre os padrões, o mais antigo. Conselho prático: mantenha exatamente um Default por entidade/tipo e a dúvida nunca surge.
Porque o papel é papel da entidade legal — papel timbrado, redação fiscal e idioma variam por empresa e país. O nível de território dá a você a conveniência de "um modelo para várias entidades" sem fingir que existe um documento global.
O modelo indicado quase certamente está inativo — uma substituição inativa é ignorada e a resolução continua descendo a escada. Reative o modelo (ou escolha um ativo) e gere novamente.
Sim — o botão, a geração automática no momento da contabilização e a ação de Fluxo Generate PDF Document executam a mesma resolução. Um documento produz o mesmo papel independentemente do caminho que o gerou.
As do fornecedor — a correspondência sempre lê a conta a que o documento é endereçado. Os clientes decidem faturas, notas de crédito e recebimentos; os fornecedores decidem desembolsos e ordens de compra.
Isso foi útil?