Como criar layouts para documentos financeiros?
Layouts para documentos financeiros: criar um modelo do Word com marcadores de posição (incluindo modelos para download e a referência completa dos marcadores de posição), definir cores e margens e atribuir o layout a um orçamento ou a uma fatura.
No Univents, um Layout determina o aspeto dos documentos financeiros em PDF: o cabeçalho do modelo do Word, as cores e as margens da tabela de linhas e as linhas apresentadas. Este artigo mostra, passo a passo, como criar um modelo do Word próprio (com modelos prontos para transferir), que marcadores de posição estão disponíveis e como atribuir depois o layout a um orçamento ou a uma fatura.

Os novos workspaces funcionam sem Word. Num workspace recém-criado, os orçamentos, as faturas, as guias de remessa e as notas de crédito são criados apenas com o editor de layouts e o catálogo de modelos. O layout predefinido é o layout padrão do Univents — tem o mesmo aspeto do modelo Word padrão anterior — e é criado apenas no idioma do workspace. O catálogo contém os seis designs para cada tipo de documento (filtro por tipo de documento); ver Utilizar a biblioteca de modelos e o editor de layouts. Os workspaces existentes mantêm tudo como está: os modelos do Word descritos neste artigo continuam a funcionar nesses workspaces. Se, mesmo assim, forem necessários modelos do Word num workspace novo, contacte-nos através do chat.
O que é um layout?
Um layout é a configuração visual de um documento PDF: o modelo do Word subjacente, com o cabeçalho e os textos, e ainda as cores e os contornos da tabela de linhas. Controla o aspeto, não o conteúdo. Não confundir com estes dois outros tipos de modelos:
- Modelo de linhas — um conjunto guardado de linhas individuais que pode ser inserido em qualquer documento financeiro. Ver Criar e utilizar modelos de linhas financeiras.
- Modelo de documento financeiro — um documento completo como modelo reutilizável. Ver Criar e utilizar modelos de documentos financeiros.
Não quer começar do zero? Em vez de criar um modelo do Word de raiz, é possível começar com um modelo pronto da biblioteca de modelos e adaptá-lo diretamente no navegador, sem Word. Mais detalhes em Utilizar a biblioteca de modelos e o editor de layouts.
Passo 1: criar o modelo do Word
A base de cada layout é um ficheiro Word normal (.docx). Nele definem-se o cabeçalho, a carta de apresentação e o rodapé — e, nos locais onde o Univents deve inserir dados reais, colocam-se marcadores de posição entre chavetas, por exemplo {Customer_Name} ou {doc_number}. Ao gerar o PDF, o Univents substitui cada marcador de posição pelo valor correspondente do documento, do evento e do contacto.
Modelos para download
A forma mais rápida de começar é com os nossos modelos padrão — são exatamente os ficheiros que estão por trás dos layouts «Univents Default» incluídos. Basta transferi-los, substituir o logótipo e os textos pelos seus próprios e carregá-los novamente como novo layout:
| Tipo de documento | Download |
|---|---|
| Orçamento | Transferir modelo do Word de orçamento |
| Fatura | Transferir modelo do Word de fatura |
| Guia de remessa | Transferir modelo do Word de guia de remessa |
| Nota de crédito | Transferir modelo do Word de nota de crédito |
Dicas para a estrutura no Word
- Utilizar o cabeçalho e o rodapé: inserir o logótipo no cabeçalho, para que se repita em todas as páginas. No Word também é possível definir um cabeçalho diferente para a primeira página. Os marcadores de posição também funcionam no cabeçalho e no rodapé. No editor de layouts, isto corresponde à opção A partir da página 2 no elemento (secção Elementos livres, grupo Repetir) — ver Utilizar a biblioteca de modelos e o editor de layouts.
- Tabelas invisíveis para o cabeçalho: um cabeçalho com várias colunas (destinatário à esquerda, dados da empresa à direita) faz-se mais facilmente com uma tabela do Word cujos limites estejam ocultos. No PDF final, a tabela não é visível.
- A formatação é mantida: se um marcador de posição for formatado a negrito, com cor ou com um tamanho de letra específico, essa formatação aplica-se também ao texto inserido.
- Não utilizar caixas de texto do Word: em caixas de texto e formas, o Univents não consegue substituir marcadores de posição — estes ficariam literalmente no documento. Colocar os marcadores de posição apenas em texto normal, em tabelas ou no cabeçalho/rodapé.
- Posicionar as imagens de forma fixa: para que as imagens não se desloquem quando os marcadores de posição são substituídos, atribuir-lhes no Word uma posição fixa na página (Opções de esquema → «Fixar posição na página»).
- Marcadores de posição de tabelas num parágrafo próprio:
{inserted_table},{optionals_table},{insert_table_...}e{Event_Schedule}substituem, na geração, o parágrafo completo. Se existir mais texto no mesmo parágrafo, este também é removido — por isso, colocar sempre estes marcadores de posição sozinhos numa linha própria.
Passo 2: Inserir marcadores de posição
A distinção entre maiúsculas e minúsculas não é relevante no reconhecimento. Um marcador de posição que o Univents não reconheça (p. ex., por causa de um erro de digitação) permanece literalmente no PDF — assim, os erros são detetados de imediato no resultado. Se um valor não estiver preenchido no documento (por exemplo, um NIF-IVA em falta), o marcador de posição é substituído por um texto vazio.
Documento
| Marcador de posição | Substituído por |
|---|---|
{doctype} | O tipo de documento (orçamento, fatura, guia de remessa, nota de crédito) no idioma do layout. |
{Document_Title} | O título do documento. |
{doc_number} | O número do documento. |
{Date} | A data de emissão. |
{Due_Date} | A data de vencimento — definida diretamente ou calculada a partir do prazo de pagamento (p. ex., «14 dias»). |
{clerk} | O nome do responsável pelo documento. |
{Clerk-Position} | O cargo do responsável (p. ex., «Event Manager»), desde que esteja associado um contacto. |
{Clerk-Mail} | O endereço de e-mail do responsável. |
{Clerk-Mobile-Phone} | O número de telemóvel do responsável. Se não existir nenhum, é utilizado automaticamente o número de telefone fixo ou de telemóvel do workspace. |
{begin_Performance_Period} | O início do período da prestação. Inclui automaticamente a hora quando o período da prestação é gerido com hora no documento. |
{end_Performance_Period} | O fim do período da prestação. |
{earlyPaymentDiscount} | A taxa do desconto de pronto pagamento, em percentagem. |
{earlyPaymentDays} | O prazo do desconto de pronto pagamento, em dias. |
Cliente
| Marcador de posição | Substituído por |
|---|---|
{Customer_Name} | O nome completo do cliente (empresa ou nome próprio + apelido). Não colocar em conjunto com {Customer_Company} no bloco do destinatário — no caso de um cliente empresarial, o nome da empresa apareceria duas vezes, uma por baixo da outra. |
{Customer_salutation} | O tratamento registado no contacto em Tratamento («Sr.», «Sra.»). Colocá-lo no bloco do destinatário imediatamente antes de {Customer_First_Name} {Customer_Last_Name}; assim, nos clientes particulares aparece «Sr. Max Mustermann» por cima da morada. Não é necessária uma regra «se-então»: um contacto de empresa não tem tratamento, o marcador de posição fica aí vazio e desaparece — no caso de empresas, ficam apenas o nome da empresa e a linha «A/C» ({Address_Line_4}). Se o contacto não tiver tratamento registado, o marcador de posição também fica vazio. |
{Customer_Title} | O título académico registado no contacto em Título («Dr.», «Eng.», «DI»). Colocá-lo no bloco do destinatário entre o tratamento e o nome: {Customer_salutation} {Customer_Title} {Customer_First_Name} {Customer_Last_Name}. Se o contacto não tiver título registado, o marcador de posição fica vazio e desaparece. Em {Customer_Greeting} e no bloco do destinatário dos layouts de página, o título aparece automaticamente — aí não é preciso acrescentar nada. |
{Customer_Greeting} | A linha de saudação completa: «Exma. Sra. Rau», «Exmo. Sr. Dr. Vogt» — e «Exmos. Senhores», quando o documento é dirigido a uma empresa sem pessoa de contacto. A pontuação pertence ao modelo: escrever {Customer_Greeting}, em vez de «Exmo(a). Sr(a). {Customer_First_Name} {Customer_Last_Name},». |
{Customer_First_Name} | O nome próprio. Num contacto de empresa fica vazio enquanto não houver aí uma pessoa de contacto real — assim, o nome da empresa nunca aparece duas vezes, uma por baixo da outra. |
{Customer_Last_Name} | O apelido. Aplica-se a mesma regra que no nome próprio. |
{Customer_Company} | O nome da empresa — nos contactos de empresa, o nome da própria empresa; no caso de uma pessoa, o nome da empresa associada. Num particular sem empresa, a substituição fica vazia. Por isso, colocar sempre também {Customer_First_Name} {Customer_Last_Name} por baixo, no bloco do destinatário; caso contrário, nos clientes particulares não aparece qualquer nome por cima da morada. |
{Customer_Tax_ID} | O NIF-IVA do cliente. Se a pessoa não tiver nenhum, é utilizado o da empresa associada. |
{Customer_email} | O endereço de e-mail do cliente. |
{Customer_telephone} | O número de telefone do cliente; se não existir nenhum, o número de telemóvel. |
{Customer_mobile} | O número de telemóvel do cliente; se não existir, o número fixo. Se no documento quiseres mostrar primeiro o telemóvel, usa este marcador — {Customer_telephone} mantém «primeiro o fixo». |
{Customer_landline} | Apenas o número fixo do cliente. Se não existir, o espaço fica vazio. |
{CU_number} | O número de cliente formatado (p. ex., «KU - 00000836»). |
{Customer_Buyer_Reference} | A referência do comprador do contacto (campo «Referência do comprador / Leitweg-ID»), p. ex., o número de encomenda ou de referência do cliente. Se a pessoa não tiver nenhuma, é utilizada a da empresa associada. Se nada estiver preenchido, o espaço fica vazio. |
{Address_Line_1} | Rua e número de porta. |
{Address_Line_2} | Código postal e localidade. |
{Address_Line_3} | O país. |
{Address_Line_4} | O complemento de morada do contacto — a linha «A/C» (p. ex., «A/C Sr. Mayer») ou um departamento, se estiver preenchido. Preenche-se no contacto em Morada → Informação adicional. Colocar o marcador de posição no modelo imediatamente por baixo das linhas de nome; assim, aparece por cima da rua, como é habitual na correspondência comercial. |
Nota para quem migra: O significado dos marcadores de posição Address_Line mudou em relação à versão antiga do Univents — o complemento de morada passou da linha 1 para a linha 4, e rua/localidade/país subiram cada um uma linha. Ao reaproveitar modelos antigos, convém verificá-los.
Evento
| Marcador de posição | Substituído por |
|---|---|
{event_name} | O nome do evento. |
{event_project_number} | O número de projeto do evento, p. ex. P-2026-014. |
{event_date} | A data de início do evento. |
{Event_End_Date} | A data de fim do evento. |
{Event_Start_Time} | A hora de início. |
{Event_End_Time} | A hora de fim. |
{event_weekday} | O dia da semana da data de início, por extenso (p. ex., «Terça-feira»). Escrever {event_weekday}, {event_date} no modelo para imprimir «Terça-feira, 25.08.2026». |
{Event_End_Weekday} | O dia da semana da data de fim. |
{event_location} | A morada do espaço reservado. |
{event_location_name} | O nome do espaço reservado. |
{event_guests} | O número de convidados. |
{event_distance_km} | A distância ao local do evento em quilómetros, com uma casa decimal (p. ex., «24,5 km»). Se não houver distância registada no evento, o campo fica vazio. |
{event_tags} | As etiquetas do evento como lista separada por vírgulas — prático para números de projeto ou de encomenda dos clientes. |
{Event_Schedule} | O programa do evento como lista, um ponto por linha («10:00 - 11:00: Montagem»). Se o programa abranger vários dias, um layout no novo motor imprime um título por dia («18.01.») e, por baixo, os pontos apenas com a hora; entre os dias fica uma linha vazia. Os programas de um só dia mantêm-se iguais. Os layouts no motor anterior (modelo Word) continuam a imprimir a data em todas as linhas — o selo no cartão do layout no documento ou nas definições de modelos mostra o motor, e é aí que se muda. Que programa é impresso: o escolhido no cabeçalho do documento em Programa. Se aí não houver nenhum escolhido e o evento tiver exatamente um programa com entradas, o Univents imprime-o automaticamente; se houver vários, escolhe-se no cabeçalho do documento. Tem de estar sozinho num parágrafo próprio. |
A empresa (remetente)
| Marcador de posição | Substituído por |
|---|---|
{workspace_name} | O nome do workspace. |
{workspace_company_name} | A designação legal da empresa, em Definições > Branding. |
{workspace_address_1} | Rua e número de porta da empresa. |
{workspace_address_2} | Código postal e localidade. |
{workspace_address_3} | O país. |
{workspace_landline} | O número de telefone fixo. |
{workspace_mobile} | O número de telemóvel. |
{workspace_fax_number} | O número de fax. |
{workspace_mail_address} | O endereço de e-mail. |
{workspace_website} | O site. |
{workspace_VAT_ID} | O NIF-IVA da empresa. |
{workspace_tax_number} | O número de contribuinte registado nas definições. Utilizar o marcador de posição em vez de escrever o número no modelo — caso contrário, na próxima alteração o número antigo continua lá sem que ninguém dê por isso. |
{workspace_bank_name} | O nome do banco. |
{workspace_IBAN} | O IBAN. |
{workspace_BIC} | O BIC. |
Totais e montantes
Todos os montantes são calculados a partir das linhas fixas do documento — as linhas marcadas como «Opcional» não entram nos totais. Cada marcador de posição de totais já inclui o símbolo da moeda («1.234,56 €» ou «€1,234.56» quando o documento está em inglês) — por isso, não escrever um «€» adicional a seguir ao marcador de posição, caso contrário aparece duplicado no PDF.
| Marcador de posição | Substituído por |
|---|---|
{subtotal_net} | O subtotal sem IVA. |
{total_discount} | O desconto total (sem IVA). |
{total_net_discount_deducted} | O valor sem IVA após dedução do desconto. |
{VAT_total_amount} | O valor total do IVA. |
{total_gross} | O valor total com IVA. |
{VAT_total_19}, {VAT_total_7}, … | O valor do IVA por taxa — o número no fim é a percentagem. Assim, com taxas de IVA mistas, cada imposto é discriminado individualmente. Se uma taxa não existir de todo no documento, o respetivo campo fica vazio. |
{price_per_guest_gross} | O preço com IVA por convidado (total com IVA dividido pelo número de convidados, descontos incluídos). Se não estiver definido o número de convidados, a linha com este marcador de posição é removida automaticamente. |
{price_per_guest_net} | O preço sem IVA por convidado — comporta-se como {price_per_guest_gross}. |
Totais por categoria
Existem os mesmos cinco totais também por categoria de produto. Para isso, substituir o início do marcador de posição pelo nome interno da categoria, tal como consta do inventário:
| Marcador de posição | Substituído por |
|---|---|
{Kategorie_subtotal_net} | Subtotal sem IVA da categoria — p. ex., {Speisen_subtotal_net} para a categoria «Refeições». |
{Kategorie_total_discount} | Desconto da categoria — a soma dos descontos das respetivas linhas. |
{Kategorie_total_net_discount_deducted} | Valor sem IVA da categoria após desconto. |
{Kategorie_VAT_total_amount} | Valor do IVA da categoria — a soma do IVA das respetivas linhas. |
{Kategorie_total_gross} | Total com IVA da categoria (valor sem IVA após desconto mais IVA). |
Em vez de uma única categoria, cada um destes cinco totais também pode ser formado através do «Nome para fatura»: para isso, acrescentar _invoice_display ao marcador de posição, por exemplo {Drinks_total_gross_invoice_display}. Assim, agrupam-se várias categorias que tenham o mesmo «Nome para fatura» nas definições da categoria — o total é então calculado sobre todas as linhas dessas categorias. A grafia tem de estar exata, incluindo a distinção entre maiúsculas e minúsculas.
Os cinco totais por categoria são calculados tanto pelo motor de impressão anterior como pelo novo — um layout imprime-os, portanto, independentemente do motor em que é executado. As linhas marcadas como «Opcional» não são contabilizadas, tal como nos totais gerais.
Utilizar apenas marcadores de categoria cuja categoria exista também no documento. Num layout criado no editor de layouts, a linha fica então vazia — nunca adivinhamos um montante; num modelo Word no motor anterior, o marcador de posição aparece literalmente no PDF.
Tabelas de linhas
Estes marcadores de posição são âncoras: no seu lugar, o Univents insere uma tabela completa. Por isso, têm de estar sozinhos num parágrafo próprio.
| Marcador de posição | Substituído por |
|---|---|
{inserted_table} | A tabela principal com todas as linhas do documento, agrupadas por categorias. Também funciona a grafia {inserted table}. Com o agrupamento de guias de remessa ativado, aparecem neste ponto as tabelas agrupadas. |
{insert_table_kategorie} | Uma tabela separada apenas com as linhas de uma categoria — p. ex., {insert_table_food}. A parte do nome tem de corresponder exatamente ao nome interno da categoria. Os marcadores de posição de categorias que não existem no documento são removidos automaticamente. |
{optionals_table} | Uma tabela própria para todas as linhas marcadas como opcionais. Se o modelo contiver este marcador de posição, as linhas opcionais aparecem apenas aí; sem ele, são apresentadas, devidamente assinaladas, nas tabelas normais. |
É possível combinar a tabela principal e as tabelas de categoria: {inserted_table} como visão geral, mais alguns {insert_table_...} para a parte de detalhe. A ordem é definida pela posição no modelo.
Textos livres
| Marcador de posição | Substituído por |
|---|---|
{custom_text_0} a {custom_text_9} | Até dez blocos de texto de preenchimento livre. A designação e o texto predefinido são geridos no layout (botão Textos livres); ao criar um documento, cada texto pode ser substituído individualmente. |
Os textos livres podem, por sua vez, conter marcadores de posição — o Univents substitui-os também. Assim resolve-se, por exemplo, uma saudação própria: como texto predefinido para {custom_text_0} define-se «Bom dia {Customer_First_Name} {Customer_Last_Name},», ajustando-o por documento apenas quando necessário. Para a saudação formal, isto não é necessário — para isso existe {Customer_Greeting}.
Logótipo
Não existe nenhum marcador de posição para o logótipo. Nos layouts padrão do Univents fornecidos, o logótipo registado em Definições > Branding é inserido automaticamente no canto superior direito do cabeçalho. Num modelo Word próprio, o logótipo é integrado diretamente como imagem no modelo — assim, há controlo total sobre o tamanho e a posição. Mais detalhes sobre o branding em Configurar o branding.
Pedir à IA que crie o modelo
Não é preciso montar o modelo à mão no Word: com um assistente de IA como o Claude, há duas formas de o fazer.
Com o Claude: modelo de raiz
Para ter controlo total sobre cada detalhe, criar o ficheiro Word com um assistente de IA como o Claude ou o Claude Code: anexar o logótipo e o papel timbrado como referência e usar este prompt (se necessário, copiar para lá outros marcadores de posição das tabelas acima):
Cria-me um modelo Word (.docx) para os meus orçamentos e faturas na Univents.
A Univents substitui neste modelo os marcadores de posição entre chavetas
por dados reais.
Gera o ficheiro por script (por exemplo com python-docx), não como texto
corrido — cada marcador de posição tem de se manter como texto contínuo.
Estrutura:
1. Cabeçalho: o meu logótipo (ficheiro de imagem em anexo), alinhados à
direita os dados da minha empresa:
{workspace_company_name}, {workspace_address_1}, {workspace_address_2},
{workspace_mail_address}, {workspace_website}
2. Bloco do destinatário, cada dado numa linha própria e por esta
ordem: {Customer_Company}, {Customer_salutation}
{Customer_First_Name} {Customer_Last_Name}, {Address_Line_4},
{Address_Line_1}, {Address_Line_2}, {Address_Line_3}
(as duas linhas de nome devem constar: numa empresa preenche-se a
primeira, numa pessoa singular a segunda — a outra fica vazia)
({Customer_salutation} é o tratamento do contacto e fica na mesma
linha que o nome, para que nos clientes particulares apareça
«Sr. Max Mustermann»; numa empresa fica vazio e desaparece)
({Address_Line_4} é o complemento de morada ou a linha «à atenção de»
e fica acima da rua, como numa carta comercial; fica vazio se não
houver nada indicado no contacto)
3. Linha de assunto: {doctype} {doc_number} — {Document_Title}, à direita
a data {Date} e o número de cliente {CU_number}
4. Saudação como texto livre: {custom_text_0}
5. A seguir, num parágrafo PRÓPRIO sem mais texto: {inserted_table}
6. Bloco de totais alinhado à direita: Subtotal {subtotal_net}, Desconto
{total_discount}, Total sem IVA {total_net_discount_deducted}, IVA
{VAT_total_amount}, Total {total_gross}
7. Texto final como texto livre: {custom_text_1}
8. Rodapé em três colunas: morada ({workspace_company_name},
{workspace_address_1}, {workspace_address_2}), contacto
({workspace_landline}, {workspace_mail_address}), banco
({workspace_bank_name}, {workspace_IBAN}, {workspace_BIC},
NIF {workspace_VAT_ID})
Regras:
- Escrever os marcadores de posição exatamente como indicado, incluindo
chavetas e sublinhados.
- {inserted_table} e {Event_Schedule} substituem, na renderização, o
parágrafo inteiro — têm de estar sozinhos numa linha própria.
- Não usar caixas de texto nem formas do Word, porque aí os marcadores
de posição não são substituídos.
- A formatação de um marcador de posição (negrito, cor, tamanho) aplica-se
depois ao texto inserido.
- Seguir as cores e a estrutura do modelo de referência em anexo.
No fim, dá-me o ficheiro .docx pronto para transferir.
Com o Claude: recriar um PDF existente como modelo Word
Já tem um orçamento com design final em PDF, por exemplo do sistema anterior ou da agência? Então pedir ao Claude que construa diretamente o modelo Word a partir dele. Anexar o PDF e usar este prompt:
Anexo um orçamento existente em PDF. Recria a partir dele um modelo
Word (.docx) para a Univents — mesmos tipos de letra, cores, posição do
logótipo e estrutura da página, o mais próximo possível do original.
A Univents substitui no modelo os marcadores de posição entre chavetas
por dados reais. Por isso, substitui todos os valores concretos do PDF
pelos marcadores de posição adequados:
- Nome e morada do destinatário → {Customer_Company},
{Customer_salutation} {Customer_First_Name} {Customer_Last_Name},
{Address_Line_4}, {Address_Line_1}, {Address_Line_2},
{Address_Line_3}
(exatamente por esta ordem; {Customer_salutation} é o tratamento do
contacto e fica na mesma linha que o nome; {Address_Line_4} é o
complemento de morada ou a linha «à atenção de» e fica acima da rua)
- Número do documento → {doc_number}, data → {Date},
título → {Document_Title}, número de cliente → {CU_number}
- Os meus dados de remetente → {workspace_company_name}, {workspace_address_1},
{workspace_address_2}, {workspace_landline}, {workspace_mail_address},
{workspace_VAT_ID}, {workspace_tax_number}, {workspace_bank_name},
{workspace_IBAN},
{workspace_BIC}
- Dados do evento → {event_name}, {event_date}, {event_location}
- Saudação → {Customer_Greeting}, textos livres → {custom_text_0} e
{custom_text_1}
- Remove a tabela de linhas completa, incluindo a linha de cabeçalho, e
coloca em vez dela {inserted_table} num parágrafo PRÓPRIO sem mais
texto — a Univents insere aí a tabela real
- Bloco de totais → {subtotal_net}, {total_discount},
{total_net_discount_deducted}, {VAT_total_amount}, {total_gross}
Regras:
- Gera o ficheiro por script (por exemplo python-docx) — cada marcador de
posição tem de se manter como texto contínuo.
- Não usar caixas de texto nem formas do Word, porque aí os marcadores
de posição não são substituídos.
- Aplicar o logótipo do PDF como imagem no cabeçalho.
No fim, dá-me o ficheiro .docx pronto para transferir.
Ainda mais simples: transferir um dos nossos modelos acima, anexá-lo juntamente com o papel timbrado e escrever: «Adapta este modelo da Univents ao meu design — todos os marcadores de posição entre chavetas têm de se manter inalterados.»
Passo 3: criar o layout na Univents
- Abrir Definições > Modelos e escolher o chip de filtro Modelo de layout. A gestão de layouts abre diretamente no hub de modelos.
- Clicar em Novo layout, no canto superior direito.
- Atribuir um Nome (p. ex. «Orçamento para feiras»).
- Escolher o Tipo, ou seja, para que tipo de documento o layout se aplica: orçamento, fatura, guia de remessa ou nota de crédito.
- Escolher o Idioma do documento — alemão, inglês, francês, neerlandês, italiano, espanhol, polaco ou português. Determina os títulos das colunas da tabela de linhas («Position, Einheit, Preis, Rabatt, MwSt., Gesamt» ou «Item, Unit, Price, Discount, VAT, Total»), textos intermédios como «Enthält:» e o formato de números e moeda no PDF. Se o modelo Word estiver em inglês, definir o idioma como Inglês — caso contrário, o texto em inglês aparece ao lado de cabeçalhos de coluna em alemão.
- Carregar o Modelo Word (.docx).
- Clicar em Guardar.
O idioma pode ser alterado a qualquer momento no layout guardado; o próximo PDF gerado assume-o de imediato. Só num layout que seja Predefinido do seu tipo de documento é que a alteração fica bloqueada enquanto o outro idioma já tiver aí um layout predefinido — nesse caso, retirar primeiro o estado predefinido ao layout.
Para gerir os Textos livres (designação e texto predefinido por marcador de posição {custom_text_...}), abrir novamente o layout guardado para edição.
Ao abrir novamente um layout guardado, a secção Modelo Word mostra se existe um modelo próprio e qual o tamanho do ficheiro. Com Transferir, ao lado, transfere-se o ficheiro guardado para verificar se é o correto. Na lista de layouts, a etiqueta Modelo Word identifica todos os layouts com modelo próprio; os layouts sem modelo próprio usam o modelo predefinido da Univents.
Num layout concebido no Editor de layouts, o modelo Word (.docx) é associado através de Carregar modelo no cartão do layout — o caminho até lá é indicado no formulário do layout. Os marcadores de posição com chaveta simples, como {doc_number}, também são substituídos na impressão. Se este layout já imprimir com o novo motor, o modelo é guardado mas não impresso: continua a valer o design do editor ou o design padrão do novo motor, e o ficheiro só produz efeito depois de o assumires no editor ou de voltares ao motor anterior. O aviso no carregamento diz-te isso. Os cartões do novo design não mostram no documento os botões do Word (Transferir modelo, Carregar modelo, Reduzir imagens), porque aí não têm efeito.
Apenas o novo motor de impressão deixa de fora o tipo de documento duplicado: se o nome do documento começar pelo tipo de documento (p. ex. «Fatura Festa de verão …»), o PDF não imprime o tipo duas vezes: «{doctype} {doc_number} — {Document_Title}» passa a «Fatura 2026-0144 — Festa de verão …». Um layout com modelo Word imprime o nome do documento sem alterações no motor anterior.
As imagens são reduzidas ao carregar
O tamanho do modelo Word influencia o tempo que a Univents demora a gerar cada PDF: o modelo é enviado por inteiro ao renderizador em cada geração de PDF. Um modelo de 5 MB custa cerca de um minuto por documento; o mesmo modelo com 0,5 MB demora apenas metade. Quase sempre, os megabytes estão em imagens incorporadas — um logótipo ou papel timbrado em resolução de impressão que, no PDF, ocupa apenas alguns centímetros.
Por isso, a Univents reduz as imagens do modelo logo ao carregar, ainda no browser:
- Cada imagem é reduzida para no máximo 1600 píxeis no lado maior — mais do que suficiente para imprimir em A4.
- As fotografias passam a JPEG — mesmo quando estão no modelo como PNG (o motivo mais frequente de modelos com vários megabytes). Logótipos e motivos recortados com transparência continuam em PNG, para que o fundo se mantenha transparente. JPEG continua JPEG. As imagens que já são suficientemente pequenas não são alteradas.
- Durante o processamento aparece A reduzir imagens… e, depois, a linha de resultado, por exemplo Modelo reduzido de 5,5 MB para 0,6 MB (2 imagens). O ficheiro reduzido só é enviado ao clicar em Guardar.
- Se, mesmo assim, o modelo ficar acima de 1 MB, aparece por baixo Modelo grande — a geração do PDF demora mais. Nesse caso, compensa remover imagens no Word ou substituí-las por outras mais pequenas.
O ficheiro original no computador mantém-se inalterado — só a versão reduzida é carregada.
Reduzir modelos existentes
Os modelos carregados antes desta funcionalidade continuam guardados no tamanho original. Os layouts com um modelo Word próprio acima de 1 MB têm na lista de layouts a etiqueta Modelo grande, com o tamanho do ficheiro, e ao lado o botão Reduzir imagens — o mesmo botão existe no diálogo de edição, na secção Modelo Word, e no cartão do layout no documento.
Com um clique, o modelo guardado é carregado para o browser, as imagens são reduzidas e o resultado é guardado como novo modelo. A mensagem indica o tamanho antes e depois. O original fica guardado e pode ser recuperado pelo suporte; o botão aparece apenas uma vez por layout. Se todas as imagens já forem suficientemente pequenas, tudo fica como está e aparece o aviso Nada para reduzir.
Cada linha da lista mostra o nome, o tipo e o idioma. Com os botões de cada linha é possível Editar um layout, copiá-lo para o outro idioma (alemão/inglês) com Criar variante de idioma, Duplicar ou Eliminar. Ao copiar, o modelo Word não é transferido — carregá-lo novamente para o novo idioma.
Definir cores e contornos
As tabelas de linhas não se desenham no Word, mas no próprio layout. Num layout, clicar em Editar cores e contornos. Logo no topo há uma Pré-visualização: uma tabela de linhas de exemplo que se altera de imediato à medida que se definem cores e contornos. Assim, vê-se logo que cor atua em que linha. Os conteúdos da pré-visualização são marcadores de posição e nunca chegam a um documento real.
Na secção Cores definem-se oito cores — fundo e cor do texto para cada uma das quatro áreas da tabela:
| Área | Cores |
|---|---|
| Cabeçalhos | Fundo dos cabeçalhos · Cor do texto dos cabeçalhos |
| Linhas de categoria | Fundo das linhas de categoria · Cor do texto das linhas de categoria |
| Linhas ímpares | Fundo das linhas ímpares · Cor do texto das linhas ímpares |
| Linhas pares | Fundo das linhas pares · Cor do texto das linhas pares |
Cada cor escolhe-se no seletor de cor ou introduzindo um valor hexadecimal (p. ex. #1a1a1a).
Copiar cores de outro layout
Para que todos os layouts tenham o mesmo aspeto, não é preciso voltar a escrever as oito cores em cada um. Acima da secção Cores, em Copiar cores de outro layout, selecionar um layout existente e clicar em Aplicar. As cores, os interruptores de apresentação e os contornos desse layout são então passados para o formulário aberto.
Importante:
- Só são copiadas as cores, a apresentação e os contornos. O nome, o tipo, o modelo Word e os textos livres do layout aberto mantêm-se inalterados.
- Só se guarda com Guardar. Se o resultado não agradar, fechar o diálogo com Cancelar — tudo fica como antes.
- Estão disponíveis para escolha todos os layouts que não estejam ocultos. Se o workspace tiver apenas um layout, a seleção não aparece.
Na secção Contornos, definem-se para Contorno exterior, Contorno do cabeçalho, Contorno da categoria, Cor do contorno das linhas e Contorno vertical a cor, a largura (px) e o estilo de traço. Como estilo de traço, estão disponíveis Contínuo, Tracejado, Ponteado, Duplo e Sulcado. Para tornar uma linha invisível, definir a largura como 0. No fim, Guardar.
Todas as definições se aplicam ao layout no seu conjunto — ou seja, a todos os documentos que usam este layout.
Mostrar categorias no PDF
Na secção Apresentação (também em «Editar cores e contornos»), dois interruptores determinam o quanto o PDF é estruturado por categorias:
- Mostrar o nome da categoria como linha na tabela principal.
- Mostrar o nome da categoria como linha nas tabelas de categoria.
O primeiro interruptor tem efeito direto na pré-visualização acima: ao desativá-lo, a linha de categoria desaparece também aí.
Esta secção Apresentação só existe nos layouts com o motor anterior — aí o botão do cartão do layout chama-se Editar cores e contornos. Se o layout já funcionar com o novo motor, o botão chama-se Editar layout e as linhas de categoria ajustam-se no editor de layouts:
- Num orçamento ou numa fatura, abrir o seletor de layout e clicar em Editar layout no cartão do layout. Em Definições > Modelos não há cartões — aí clicar na linha do layout, que num layout com o novo motor abre diretamente o editor (o mesmo pelo menu da linha Abrir no editor de layout).
- No editor, clicar em Tabela de linhas.
- À direita, na secção Estilo, ativar ou desativar Faixas de categoria na tabela.
- Clicar em Guardar.
Desativado, a tabela deixa de imprimir linhas de categoria. Os títulos de secção mantêm-se e, ao agrupar por guia de remessa, as cabeceiras das guias de remessa também. A definição aplica-se a todos os documentos que usam este layout.
Atribuir um layout a um documento
Ao criar ou editar um orçamento (ou uma fatura, etc.), no topo encontra-se a secção Layout, com uma fila de cartões de todos os layouts adequados.
- Percorrer os cartões — um orçamento mostra apenas layouts de orçamento (e os independentes do tipo).
- No cartão pretendido, clicar em Selecionar. O layout ativo fica marcado como selecionado.
- Para que este layout passe a aplicar-se automaticamente a todos os documentos deste tipo, clicar em Definir como predefinido para faturas.
Os novos documentos de um tipo começam então automaticamente com o layout predefinido atribuído. Editar, Selecionar e Predefinido explicam-se ao passar o rato por cima.
Perguntas frequentes
Porque é que um marcador de posição aparece literalmente no PDF final? O marcador de posição não foi reconhecido — normalmente por um erro de escrita no nome ou por estar numa caixa de texto do Word (aí a substituição não funciona). Comparar a grafia com as tabelas acima; a distinção entre maiúsculas e minúsculas não importa.
Porque é que, de repente, falta texto no meu modelo? Os marcadores de posição de tabelas e {Event_Schedule} substituem o parágrafo completo. Se existia texto próprio no mesmo parágrafo, foi removido juntamente. Colocar estes marcadores de posição sozinhos numa linha própria.
É necessário preencher as cores se utilizar um modelo Word próprio? Sim — continuam a ser utilizadas. O modelo Word define o cabeçalho, os textos e o rodapé; as cores e as margens do layout definem a tabela de linhas que o Univents insere no modelo. Se ficarem nos valores predefinidos, a tabela aparece precisamente nessas cores predefinidas.
O meu logótipo é inserido automaticamente? Apenas nos layouts padrão do Univents. Num modelo Word próprio, o logótipo tem de ser inserido manualmente como imagem.
Porque é que a geração do PDF demora tanto com um layout? Normalmente, o modelo Word é demasiado grande — o ficheiro é enviado na íntegra a cada PDF, e as imagens incorporadas em resolução de impressão rapidamente fazem dele vários megabytes. Se o layout indicar Modelo grande, clicar em Reduzir imagens (ver Reduzir modelos existentes). Os novos carregamentos são reduzidos automaticamente.
As minhas imagens perdem nitidez com a redução? Não. As imagens mantêm um lado maior de até 1600 píxeis — numa página A4, isso continua a corresponder a muito mais do que o olho distingue na impressão. Um logótipo no cabeçalho tem, por norma, apenas alguns centímetros de largura no PDF. As fotografias são guardadas como JPEG em alta qualidade; os logótipos com transparência mantêm-se sem perdas em PNG.
Como obter uma capa (página de rosto) antes do meu orçamento? A capa faz parte do modelo Word — o Univents não tem carregamento de capa nem interruptor próprio. Criar a página de rosto como primeira página do ficheiro .docx e inserir a seguir uma quebra de página (no Word: Inserir > Quebra de página). Tudo o que se segue — bloco do destinatário, {inserted_table}, bloco de totais — permanece inalterado. Os marcadores de posição também funcionam na capa, por exemplo {Document_Title}, {event_name} ou {Customer_Name}; para texto que se pretenda adaptar a cada orçamento, utilizar um texto livre como {custom_text_0}. As imagens são inseridas diretamente como imagem na primeira página. Se o cabeçalho ou o rodapé da capa devem ser diferentes dos das páginas seguintes, ativar no Word, em Esquema > Configurar página > Esquema, a opção Primeira página diferente.
Porque é que não vejo layouts de fatura no meu orçamento? Os layouts estão associados a um tipo de documento. Num orçamento só aparecem layouts de orçamento e layouts sem tipo fixo. Se necessário, criar um layout próprio para o respetivo tipo.
O que acontece aos documentos se eliminar um layout? Os documentos existentes que utilizavam o layout passam automaticamente para o layout predefinido. Não se perde nenhum conteúdo. Se o layout for o Predefinido para orçamentos, faturas, guias de remessa ou notas de crédito, a pergunta de confirmação indica antes para que tipos de documento isso se aplica: os novos documentos desse tipo são depois impressos com o layout predefinido fornecido, até voltar a definir outro como predefinido.
É possível oferecer o mesmo layout em vários idiomas? Sim. No layout, clicar em Criar variante de idioma para criar uma cópia noutro idioma. Além de alemão e inglês, estão disponíveis francês, neerlandês, italiano, espanhol, polaco e português. O modelo Word tem de ser carregado novamente para o novo idioma. Se não pretender um segundo layout, mas apenas alterar o idioma de um existente, abri-lo com Editar e alterar aí o Idioma do documento.
O meu PDF está em inglês, mas os cabeçalhos das colunas continuam em alemão — porquê? Os cabeçalhos seguem o Idioma do documento definido no layout, e não o texto em inglês do modelo Word. Abrir o layout com Editar, definir o idioma como Inglês e gerar o PDF novamente.
Como ocultar as linhas de categoria na fatura? Depende do motor em que o layout é executado. Num layout com o motor anterior, abrir Editar cores e contornos e desativar, na secção Apresentação, o interruptor Mostrar o nome da categoria como linha na tabela principal. Num layout com o novo motor, clicar em Editar layout no cartão do layout, clicar em Tabela de linhas no editor e desativar à direita, em Estilo, o interruptor Faixas de categoria na tabela. Depois clicar em Guardar — a alteração aplica-se a todos os documentos com este layout.
Onde se definem os intervalos de numeração ou as condições de preço? Não são definições de layout. Encontram-se separadamente — ver Números de documento e condições de preço.