Como funciona orçamento dinâmico (templates) em pedidos

Configurações iniciais

Algumas pré configurações precisam ser feitas

Cadastrar dados complementares

Vá em cadastro > Configurações > Entidade empresa > Dado complementar

precisamos de um dado complementar de 'item do pedido'. Caso já exista na lista, clique em cima.

Se não existir, clique em 'adicionar formulário +'

Caso clique em 'adicionar formulário'

Crie um dado complementar com:

módulo: Item pedido

Dado complementar : Formulário técnico (personslizável)

Em seguida, clique em 'salvar'

Dentro de perguntas:

Categoria : Categoria importante (personslizável)

Categoria ordem : 1

Pergunta: Informações detalhadas

Pergunta ordem: insira a ordem da pergunta

Tipo pergunta : Texto

obs: Com o tipo 'Texto' selecionado, será possível inserir estilização no texto, como troca de tamanho de fonte, cor e o tipo da fonte.

Anote a pergunta e passe para o próximo passo

Feito isso, clique em 'salvar' o 'Atualizar'

Caso Já exista dado complementar do item do pedido:

1) Na área 'Perguntas', clique em cima da pergunta desejada.

2) Anote a pergunta e passe para o próximo passo

No nosso caso de exemplo, cliquei no segundo item e sua pergunta é Informações detalhadas

Cadastrar a tag conforme a pergunta do DC

Com a pergunta anotada ( no nosso caso é Informações detalhadas)

Navegue até o menu inicial >'Orçamento dinâmico'(ou templates)> Configurações > templates> tags.

Confira se a tag #ItemPedDC_informacoes_detalhada[] existe na lista.

Caso a tag não exista ainda, clique em 'adicionar a tag'

Código tag: #ItemPedDC_informacoes_detalhada[]
Conteúdo: #ItemPedDC_informacoes_detalhada[]
Descrição: Informações detalhadas
Domínio: Item pedido

Atenção especial em ' descrição' pois deve ser a mesma pergunta escrita no passo anterior.
Você também pode criar quantas perguntas desejar, isso se tornará uma coluna a mais personalizada ao gerar um PDF com uma lista dinâmica.
- Para isso, siga o seguinte padrão:
  - coloque sempre #ItemPedDC_ no começo e [] no fim.

por exemplo, poderíamos criar mais uma tag desta maneira :

Código tag: #ItemPedDC_observacao_item_pedido[]
Conteúdo: #ItemPedDC_observacao_item_pedido[]
Descrição: Observação do item do pedido
Domínio: Item pedido

Lembre-se de usar o mesmo nome da descrição , que neste caso é 'Observação do item do pedido' e cadastrar uma pergunta em Dado complementar com o mesmo nome ( repita novamente os passos anteriores )

Cadastrar hashtag referente a versão

Ainda dentro da tela de tags, também crie a tag referente a revisão do documento.

Código tag: #revisao
Conteúdo: #revisao
Descrição: Revisão do orçamento
Domínio: Orçamento

Basta escrever esta hashtag dentro de alguma clausula que a versão do documento será mostrada nele.

Cadastrar marca d'agua

Dentro de parâmetros, cadastre 2 perguntas:

Parâmetro : TAGS_ORCAMENTO_DINAMICO

Grupo : adicione o grupo vigente

Pergunta: MARCADAGUA_PREVISUALIZACAO e MARCADAGUA_NAOVIGENTE

Resposta: Mensagem personalizável

Observação : Mensagem personalizável ( em regra a mesma mensagem da resposta )

Caso não seja cadastrado este parâmetro, será assumido a mensagem Pré-visualização e 'Não-vigente' por padrão

Como funciona o sistema de hashtags dinâmicas e hashtags fixas ao gerar um orçamento

Primeiro vamos entender o conceito de hashtag fixa e hashtag dinâmica

Tags fixas

Entendemos uma hashtag fixa todas as tags que forem salva dentro do orçamento dinâmico com apenas 1 # a frente da frase, como por exemplo:

Tags soltas:

#revisao
#armazenamento
#ISOPVPed_OrdCompra
#ISOPvPed_TotalPedido

e até mesmo uma lista:
#itensPedidoCabAlinha*[#E, #C, #J, #J,#C, #D, #C, #C, #D, #D, #D]*
#tagsTabelaItensAlinha*[#E, #C, #J, #J,#C, #D, #C, #C, #D, #D, #D]*
#itensPedidoCab*[Codigo,Sequencia, Descrição tec det,Obs item ped, Qtd, Vlr Und, %IPI, %ICMS, ST, Vlr Total,Valor Confis ST]*
#tagsTabelaItens*[#ItemPed_ISOPvPedIte_Codigo[],#ItemPed_ISOPrd_Codigo[],#ItemPedDC_informacoes_detalhada[],#ItemPedDC_observacao_item_pedido[],#ItemPed_ISOPvPedIte_Quantidade[],#ItemPed_ISOPvPedIte_ValorUnitario[],#ItemPed_ISOPvPedIte_PercentualIPI[],#ItemPed_ISOPvPedIte_PercentualICMS[],#ItemPed_ISOPvPedIte_VlrSubsTributaria[],#ItemPed_ISOPvPedIte_ValorTotal[],#ItemPed_ISOPvPedIte_ValorCofinsST[]]*

Tags dinâmicas

Entendemos uma hashtag dinâmica tudo que contem 2 # a frente da frase, como por exemplo:

Tags soltas:

##revisao
##armazenamento
##ISOPVPed_OrdCompra
##ISOPvPed_TotalPedido

e até mesmo uma lista:

<div style="font-size: 11px; font-weight: normal; font-family: Arial">##itensPedidoCabAlinha*[#E, #C, #J, #J,#C, #D, #C, #C, #D, #D, #D]*

##tagsTabelaItensAlinha*[#E, #C, #J, #J,#C, #D, #C, #C, #D, #D, #D]*

##itensPedidoCab*[Codigo,Sequencia, Descrição tec det,Obs item ped, Qtd, Vlr Und, %IPI, %ICMS, ST, Vlr Total,Valor Confis ST]*

##tagsTabelaItens*[#ItemPed_ISOPvPedIte_Codigo[],#ItemPed_ISOPrd_Codigo[],#ItemPedDC_informacoes_detalhada[],#ItemPedDC_observacao_item_pedido[],#ItemPed_ISOPvPedIte_Quantidade[],#ItemPed_ISOPvPedIte_ValorUnitario[],#ItemPed_ISOPvPedIte_PercentualIPI[],#ItemPed_ISOPvPedIte_PercentualICMS[],#ItemPed_ISOPvPedIte_VlrSubsTributaria[],#ItemPed_ISOPvPedIte_ValorTotal[],#ItemPed_ISOPvPedIte_ValorCofinsST[]]*

</div>

É importante entender que, após o documento ser substituído pelos valores reais, todas as tags que possuam apenas um # perderão sua referência. Da mesma forma, as tags que iniciarem com ## passarão a se comportar de forma dinâmica a partir desse momento.

Dica importante: o exemplo a cima, temos uma estrutura HTML, para que essa estrutura possa ser válida dentro do editor:

clique nos 3 pontos para abrir a lista de ferramentas ocultas.
coloque na opção código fonte
cole o código a cima.
clique em salvar

Vamos simular um cenário:

Uma lista de itens do pedido
- A lista terá duas ## ( ou seja, dinâmico)
duas hashtag dinâmico
duas hashtah fixa

Na imagem a baixo, temos o resultado disso em uma imagem só

Ao clicar em pré-vizualizador PDF não tem nenhum vestígio de # hastahs.

Isso significa que conseguimos gerar um orçamento com informações dinâmicas e fixas

No meu exemplo, utilizei na cláusula 32 uma tag que representa uma lista dinâmica — ou seja, uma lista com comportamento variável.

Como essa tag possui duas hastags (##), sempre que o documento for pré-visualizado, ela exibirá as informações dos itens do pedido de forma atualizada, refletindo os dados mais recentes disponíveis.

##itensPedidoCabAlinha*[#E, #C, #J, #J, #D, #C, #C, #D, #D, #D]*
##tagsTabelaItensAlinha*[#E, #C, #J, #J, #D, #C, #C, #D, #D, #D]*
##itensPedidoCab*[Codigo,Sequencia, Descrição, Qtd, Vlr Und, %IPI, %ICMS, ST, Vlr Total,Valor Confis ST]*
##tagsTabelaItens*[#ItemPed_ISOPvPedIte_Codigo[],#ItemPed_ISOPrd_Codigo[],#ItemPed_ISOPrd_DescricaoDetalhada[],#ItemPed_ISOPvPedIte_Quantidade[],#ItemPed_ISOPvPedIte_ValorUnitario[],#ItemPed_ISOPvPedIte_PercentualIPI[],#ItemPed_ISOPvPedIte_PercentualICMS[],#ItemPed_ISOPvPedIte_VlrSubsTributaria[],#ItemPed_ISOPvPedIte_ValorTotal[],#ItemPed_ISOPvPedIte_ValorCofinsST[]]*

Ao clicar na clausula 15 temos exemplos de tags isoladas
Note que as tags marcadas como FIXO já exibem o valor final.

Isso acontece porque, quando o orçamento é aberto pela primeira vez, o sistema substitui as tags com apenas um # pelo seu valor real — e esse valor não é mais alterado posteriormente.

Porem ao conferir este template (dentro do menu orçamento dinâmico), podemos notar a discrepância de 1# e 2##

Também repare que temos estilização da tag. Ao selecionar com mouse em cima do texto, aplique a estilização desejada.

Ao salvar esse template e vinculá-lo a um pedido, as hashtags terá o seguinte comportamento:

tags com 1# serão substituídas pelos valores reais e permanecerão fixas, enquanto as tags com 2## continuarão dinâmicas, sendo atualizadas automaticamente conforme as informações do pedido.

A regra da estilização da fonte também vale para listas dinâmicas, basta selecionar com o mouse o texto entre `,`(virgulas) e aplicar a estilização desejada. como por exemplo:

No exemplo abaixo foi aplicado estilização de fonte alguns itens, e todos os cabeçalhos contem BOLD aplicado

procure ##itensPedidoCab*[]* e ##tagsTabelaItens*[]* para aplicar esta regra, como a baixo:

<div style="font-size: 11px; font-weight: normal; font-family: Arial">##itensPedidoCabAlinha*[#E, #C, #J, #J, #D, #C, #C, #D, #D, #D]*</div>

<div style="font-size: 11px; font-weight: normal; font-family: Arial">##tagsTabelaItensAlinha*[#E, #C, #J, #J, #D, #C, #C, #D, #D, #D]* </div>

<div style="font-size: 11px; font-weight: normal; font-family: Arial">##itensPedidoCab*[Codigo,Sequencia, Descrição, Qtd, Vlr Und, %IPI, %ICMS, ST, Vlr Total,Valor Confis ST]*</div>

<div style="font-size: 11px; font-weight: normal; font-family: Arial"> ##tagsTabelaItens*[#ItemPed_ISOPvPedIte_Codigo[],#ItemPed_ISOPrd_Codigo[],#ItemPed_ISOPrd_DescricaoDetalhada[],#ItemPed_ISOPvPedIte_Quantidade[],#ItemPed_ISOPvPedIte_ValorUnitario[],#ItemPed_ISOPvPedIte_PercentualIPI[],#ItemPed_ISOPvPedIte_PercentualICMS[],#ItemPed_ISOPvPedIte_VlrSubsTributaria[],#ItemPed_ISOPvPedIte_ValorTotal[],#ItemPed_ISOPvPedIte_ValorCofinsST[]]*</div>

O resultado final deste template já vinculado ao pedido é esse:

Dentro da tela de pedidos

Como funciona os dados complementares do item do pedido

abra o menu Pedido > selecione um pedido > item do pedido> dado complementar (i)

Selecione o dado complementar 'Formulário técnico' e em seguida clique na caneta de edição da pergunta desejada

Como vincular um template a um pedido

Confira se o pedido desejado já possui um orçamento dinâmico vinculado a ele.

Abra o menu orçamento dinâmico ou editar Clausulas

Clique no botão + ( bolinha azul )

e selecione um orçamento dinâmico.

no nosso exemplo iremos usar o Orçamento técnico

Dentro da tela de pedidos

Itens do pedido

Botão editar oçamento

O botão editar orçamento e orçamento dinâmico levam para a mesma tela de edição de clausulas. Dentro dela, é possível editar cada clausulas do pedido de maneira personalizada.

Botão pré-visualização - vigentes

Ao clicar no botão Pré-visualizar, será aberto um novo ambiente

Sera aberto o mesmo ambiente que esse a baixo. Ao clicar no template desejado( lista lateral) ao lado direito será aberto a pré-visualização.

Neste momento não será possível editar as clausulsa, apenas será permitido visualizar o orçamento com marca d'água

Botão pré-visualização - não vigentes

Dentro do botão 'pré-visualização', ao selecionar o filtro 'não-vigente', será apresentado na lista lateral todos os orçamentos não-vigentes ( ou que ja passaram por alguma revisão)

Esta apresentação terá marca d'água
Não será possível editar as clausulas não-vigentes

Botão gerar revisão

Ao clicar no botão gerar revisão, será direcionado para outra tela.

Clique no botão Gerar revisão e logo em seguida clique em SIM

Observe que a revisão atual é a Rev02

Observe que agora o numero da revisão é _Rev03

Ao clicar para visualizar o orçamento(lista lateral com os orçamentos), será gerado automaticamente um PDF sem marca d'agua e automaticamente este mesmo PDF é anexado dentro da tela de anexos do pedido ( confira no próximo passo)

É importante relembrar que o anexo só será anexado em anexos se ele tiver sido aberto pelo menos uma vez atráves do processo deste tópico.

Dentro da tela de anexos, será possível visualizar este documento em PDF.

Quando for necessário responder um e-mail, este mesmo PDF também ficará disponível para acesso em anexos do e-mail.

Basta clicar em anexo ao respodner um e-mail.

Como configurar templates e blocos de informações no orçamento?

Para configurar templates e blocos de informações no orçamento dinâmico, você deve utilizar as ferramentas de cadastro e edição disponíveis no sistema, conforme detalhado nos tópicos abaixo:

1. Acesso e Cadastro de Templates

Para iniciar a configuração, acesse o menu inicial e selecione Orçamento dinâmico (ou Relatórios dinâmicos).

Criar Novo Template: Na tela de listagem, clique no botão "+" na parte inferior para abrir o formulário de cadastro.
Gerenciar Existentes: Você pode visualizar a lista de templates já cadastrados e selecionar um para editar suas cláusulas vinculadas. Também é possível efetuar a cópia de um template existente deslizando o registro para a esquerda e confirmando a operação.

2. Configuração de Blocos de Informações (Cláusulas)

Os blocos de informações são chamados de cláusulas e podem conter textos, imagens e tabelas.

Adicionar Cláusulas: Dentro de um template selecionado, utilize o botão "+ Adicionar/Vincular cláusula" no canto superior direito.
Editor de Conteúdo: O sistema fornece um editor onde você pode escrever e estilizar o texto, além de inserir componentes.
Organização e Proteção: Ao salvar ou vincular uma cláusula, você define a ordem em que ela aparecerá no orçamento e se ela será protegida (editável apenas por usuários habilitados na tela de configuração).
Cabeçalho e Rodapé: Para definir esses blocos fixos, salve a cláusula adicionando a palavra "Cabeçalho" ou "Rodapé" no campo de tipo. Elas serão adicionadas automaticamente no início e fim de cada página do PDF.

3. Uso de Tags e Hashtags para Dados Dinâmicos

As tags permitem que o orçamento puxe informações automaticamente do sistema (como nome do cliente ou dados do pedido).

Tags Fixas (#): Perdem a referência e tornam-se texto estático após o primeiro processamento.
Tags Dinâmicas (##): Permanecem dinâmicas e são atualizadas sempre que o documento é pré-visualizado ou gerado.
Dados Complementares: Você pode criar perguntas personalizadas em "Dados complementares" do item do pedido e vinculá-las a tags específicas (ex: #ItemPedDC_nome_da_pergunta[]) para que as respostas apareçam no orçamento.

4. Configuração de Tabelas de Itens

Para incluir tabelas com os itens do pedido, utilize tags específicas de formatação:

Use tags como ##itensPedidoCabAlinha para definir o alinhamento das colunas (Ex: #D para direita, #E para esquerda).
A tag ##tagsTabelaItens* define quais campos dos itens (código, quantidade, preço, etc.) serão exibidos na tabela.
Importante: Recomenda-se criar uma cláusula exclusiva para a tabela para evitar erros de formatação.

5. Vinculação ao Pedido

Após configurar o template, você deve associá-lo a um pedido específico:

Na tela de pedidos, vá até a aba ou botão Editar orçamento.
Clique no botão "+" (bolinha azul) e selecione o template configurado.
Uma vez vinculado, todos os dados virão como textos editáveis para ajustes pontuais antes da geração do PDF final.

Você pode gerar uma pré-visualização em PDF a qualquer momento para conferir como os blocos de informações e tags estão sendo apresentados.

Como configurar o cabeçalho e rodapé fixos no orçamento?

Para configurar o cabeçalho e o rodapé fixos no orçamento dinâmico, você deve seguir um procedimento específico ao salvar as cláusulas do seu template:

Criação da Cláusula: Dentro do menu de "Orçamento dinâmico" (ou Relatório dinâmico), acesse o template desejado e clique no botão "+ Adicionar/Vincular cláusula".
Identificação do Tipo: No formulário de salvamento da cláusula, você deve escrever obrigatoriamente a palavra "Cabeçalho" ou "Rodapé" no campo destinado ao tipo da cláusula.
Comportamento Automático: Uma vez que a cláusula é salva com esses nomes no campo de tipo, o sistema as reconhecerá automaticamente e as adicionará no início (cabeçalho) e no final (rodapé) de cada página do seu arquivo PDF.
Recomendações Técnicas: As fontes recomendam que você crie apenas uma cláusula de cada tipo por template e utilize as seguintes dimensões para garantir uma melhor formatação visual:
- Cabeçalho: 645x79 pixels.
- Rodapé: 937x185 pixels.

Dessa forma, essas informações se tornarão fixas e serão replicadas em todas as páginas do documento final gerado.

É possível configurar uma marca d'água no PDF?

Sim, é possível configurar uma marca d'água personalizada no PDF do orçamento dinâmico por meio do cadastro de parâmetros específicos no sistema.

Para realizar essa configuração, você deve seguir estes passos:

Acesso aos Parâmetros: No menu de configurações, localize o parâmetro TAGS_ORCAMENTO_DINAMICO.
Cadastro das Perguntas: Você deve cadastrar duas perguntas específicas dentro deste parâmetro:
- MARCADAGUA_PREVISUALIZACAO: Define o texto da marca d'água para quando o documento é apenas pré-visualizado.
- MARCADAGUA_NAOVIGENTE: Define o texto para versões do orçamento que não são mais a vigente (histórico).
Definição do Texto: No campo Resposta, insira a mensagem personalizada que deseja que apareça (ex: "Cópia de Segurança", "Rascunho", etc.). Recomenda-se repetir a mesma mensagem no campo Observação.

Observações Importantes:

Comportamento Padrão: Caso você não realize essa configuração manual, o sistema assumirá automaticamente os textos "Pré-visualização" e "Não-vigente" como padrão para a marca d'água.
Exibição: A marca d'água aparece apenas durante a pré-visualização ou em orçamentos não-vigentes. Ao visualizar o orçamento vigente pela lista lateral para geração final, o PDF será gerado sem marca d'água e anexado automaticamente ao pedido.

Report abuse