Relatórios e etiquetas padrão e personalizados

O ERP MAXIPROD permite o desenvolvimento de relatórios personalizados a partir de um conjunto de relatórios-padrão.

Veja exemplos de cada área:

• Vendas
• Notas fiscais
• Compras
• Estoque
• Engenharia
• Produção
• Financeiro
• Contabilidade
• Qualidade

A partir dos modelos-padrão, podem-se personalizar propostas, pedidos de venda, etiquetas, recibos, ordens de produção e outros documentos em Word ou Excel.

Uma etiqueta é um caso particular de relatório. Portanto, tudo que consta a respeito de relatórios vale também para etiquetas, inclusive a personalização.

Esta página mostra:

• Finalidades, modelos e tags
• Como criar ou modificar um modelo de relatório personalizado?
• Tags
  • Regras gerais das tags 
  • Como usar tags de listas diferentes no mesmo modelo?
  • Como manter o formato de datas e números no Excel?
  • Tags de anexos
• Exemplo
• Como converter um relatório personalizado em padrão?
• Modificadores de tags de relatórios personalizados
• Como limitar o acesso a relatórios

Finalidades, modelos e TAGs

Os relatórios são agrupados por finalidade, por exemplo: nota fiscal, ordem de produção, contas a receber, etc.

Para cada finalidade, podem existir vários modelos de relatórios, em formato .xlsx (Excel) ou .doc (Word). Os modelos-padrão são fornecidos pelo MAXIPROD e não podem ser alterados pelos assinantes. Mas cada assinante pode criar os seus próprios relatórios personalizados, a partir de um modelo padrão.

No menu de relatórios de cada tela são listados os modelos das finalidades associadas (por código) a essa tela. Portanto, se uma finalidade F está associada a uma tela, e for criado um novo modelo de relatório desta finalidade, esse relatório aparecerá no menu de relatórios da tela.

Cada finalidade tem um conjunto de TAGs, que são identificadores de campos. As TAGs são inseridas pelos usuários nos modelos de relatórios personalizados. Quando é gerado um relatório desse modelo, as tags são substituídas pelos seus respectivos textos (strings, números, códigos de barras, imagens).

Como criar ou modificar um modelo de relatório personalizado?

1) Os modelos de relatórios podem ser elaborados em formato .docx (Word) ou .xlsx (Excel).

2) Pode-se criar um modelo novo, ou baixar um modelo existente e alterá-lo, inserindo as tags relativas a cada campo. A criação de um modelo novo pode ser feita em Microsoft Word ou aplicativo similar.

3) Para fazer o download e upload dos modelos de relatórios, clique no menu “Imprimir/exportar > Configurar relatórios personalizados…” das telas de edição de Propostas, Pedidos, Notas fiscais, Ordens de produção, Contas a receber, etc.

Exemplo:

4) Na janela “Modelos de relatórios”, clique no botão “Novo” para criar um novo modelo, no botão “Seta para baixo” verde para baixar um modelo ou no botão “X” para excluir um modelo existente.

Observação: só é permitido excluir modelos próprios.

5) Clicando no botão “Novo“, é aberta a tela de inserção de um novo modelo, selecione o arquivo na máquina e clique em “Importar”.

Tags

⚠️ Importante: as tags são exclusivas de cada dicionário. A utilização de uma tag pertencente ao dicionário de outra tela pode resultar em informações incorretas no relatório ou impedir sua geração corretamente.

1) Na mesma tela anterior de “Modelos de relatórios”, as tags disponíveis podem ser consultadas por meio do menu “Consultar > Dicionário de tags”.

2) Vide, abaixo, a janela de tags para pedidos de venda:

3) Nos modelos de relatórios personalizados, as tags são colocadas no local em que a informação será exibida. Por exemplo, os dados iniciais do cliente podem ser inseridos da seguinte forma:

• Prezado(a): [[ContatoComercial.Nome]],
• Empresa: [[Cliente.NomeFantasia]]. 
• Localizada em: [[Cliente.Endereco.Completo]]

Os filtros “Tag” e “Descrição” podem ser usados na pesquisa da tag.

Regras gerais das tags:

• Nos campos numéricos, a quantidade de casas decimais exibida é informada conforme o exemplo “[[ValorTotal]:casasdecimais(2)]”, que exibe o ValorTotal com duas casas decimais.
• Para ocultar uma linha quando o conteúdo de um campo é vazio, a tag desse campo deve ser seguida da palavra ‘collapse’, como no exemplo “[[TelefonesDoDestinatario]:collapse]”, que exibe uma linha com os telefones do destinatário, somente quando existirem. Se não, oculta a linha.
• Se uma tag contém a palavra “ITEM“, a linha será repetida para cada item do respectivo documento. Insira apenas uma linha com as tags dos itens, e o modelo gerará uma linha de relatório por item. Se estiver editando um modelo em .docx, sempre insira as tags de itens (e demais tags que irão puxar uma lista) dentro de uma tabela. Veja o exemplo abaixo:

Resultado, usando a tabela acima em uma proposta com mais de um item:

Isto funciona com qualquer tag. Por exemplo, no caso de uma tag que chama dados dos títulos de um pedido, como, por exemplo, [[PedidoVenda.Titulo.Valor]]. Se houver mais de um título no pedido, então é gerada uma linha para cada título.

Para saber sobre inclusão de tags de códigos de barras em relatórios e etiquetas, clique aqui.

Como usar tags de listas diferentes no mesmo modelo?

O caminho de uma tag é a sequência de nomes separados por ponto, e cada nome é uma propriedade. Uma tag é de lista quando alguma propriedade do caminho pode ter vários itens. Nas ordens de produção, por exemplo, os insumos (InsumosDaOrdemDeProducao), as operações (Operacoes) e os componentes da estrutura do produto (Item.Estruturas) são listas. No relatório, a linha do modelo se repete uma vez para cada item da lista.

Por isso, cada linha do modelo em Excel deve usar tags de uma lista só, ou de listas que ficam uma dentro da outra, como explicado depois do exemplo. Duas listas diferentes não têm relação entre si, e quando ficam na mesma linha o relatório mostra dados de registros que não se correspondem:

• Se a linha está dentro de uma tabela do Excel (criada pelo menu “Página Inicial > Formatar como Tabela” ou “Inserir > Tabela”), cada item de uma lista é combinado com cada item da outra. As linhas se multiplicam, e as somas saem maiores do que deveriam;
• Fora de uma tabela do Excel, os valores das duas listas ficam lado a lado sem correspondência: a primeira linha junta o primeiro item de cada lista, e as linhas seguintes trazem os demais itens de uma lista com as colunas da outra vazias.

No exemplo, a OP 65 tem 2 insumos, e o produto dela tem 3 componentes na estrutura. O modelo abaixo está dentro de uma tabela do Excel e mistura as duas listas na mesma linha:

O relatório traz 6 linhas para essa OP (2 insumos vezes 3 componentes). Cada insumo aparece 3 vezes, e a soma da coluna “Qtd insumo” dá 9 em vez de 3:

Já uma lista que está dentro de outra pode ocupar a mesma linha. Veja como é montada a tag com a data de cada baixa do insumo, [[OrdensDeProducao.InsumosDaOrdemDeProducao.MovimentacaoDeBaixa.DataEHora]]:

• OrdensDeProducao: as ordens de produção, uma por item. É a lista principal, e as demais listas do exemplo estão dentro dela.
• InsumosDaOrdemDeProducao: os insumos de cada OP, uma lista dentro de OrdensDeProducao.
• MovimentacaoDeBaixa: as baixas de cada insumo, uma lista dentro de InsumosDaOrdemDeProducao.
• DataEHora: a data da baixa, que é a informação exibida.

Como as baixas estão dentro dos insumos, essa tag pode ficar na mesma linha das tags do insumo. O insumo sem baixa fica com a data vazia. Pelo mesmo motivo, a coluna com o número da OP pode ficar na mesma linha das listas.

O caminho OrdensDeProducao.Item.Estruturas, ao contrário, sai de OrdensDeProducao por outro caminho, que não passa pelos insumos. Por isso, os componentes da estrutura são uma lista diferente da dos insumos. Para conferir quais propriedades são listas, use o dicionário de tags, como mostrado no fim deste subtópico.

Para montar o modelo sem misturar as listas:

• Para mostrar as informações de cada item, use tags que partem da mesma lista. No exemplo, o código e a quantidade de cada insumo vêm de [[OrdensDeProducao.InsumosDaOrdemDeProducao.Item.Codigo]] e [[OrdensDeProducao.InsumosDaOrdemDeProducao.QuantidadeBruta]], e não da estrutura do produto.
• Para mostrar duas listas diferentes no mesmo arquivo, coloque cada uma em uma aba própria do modelo. Cada aba é preenchida de forma independente. Se preferir, crie um modelo para cada lista.

Nas telas da nova versão, que têm o menu “Imprimir > Dicionário de tags”, o dicionário mostra quais propriedades são listas. Para saber mais sobre o dicionário, clique aqui.

Para conferir se uma propriedade é lista:

1) Na tela em que o relatório é impresso, acesse o menu “Imprimir > Dicionário de tags”. No exemplo, a tela é “Produção > Ordens de produção”.

2) Clique nas propriedades do caminho até chegar à que deseja conferir e passe o mouse sobre o ícone à esquerda dela. No exemplo, clique em OrdensDeProducao e passe o mouse sobre o “cubo” de Operacoes.

3) Com isso, o campo “Tipo de dado” mostra “Lista de …” quando a propriedade é uma lista.

Como manter o formato de datas e números no Excel?

No modelo em Excel, a data e o número só recebem o formato da célula quando a tag está sozinha nela. Se houver qualquer outro conteúdo na célula, mesmo um espaço antes da tag, o valor entra como texto: o formato da célula é ignorado, e a data aparece como um número longo.

Para corrigir:

1) No modelo, apague o espaço ou o texto da célula e deixe só a tag.

2) Coloque o texto que acompanha o valor, como “Emitida em”, na célula ao lado.

3) Salve o modelo e importe-o de novo no sistema, como no tópico Como criar ou modificar um modelo de relatório personalizado?, acima.

4) Com isso, a data e o número recebem o formato da célula.

Observação: se o texto precisar ficar na mesma célula, informe o formato na própria tag. Nas telas da nova versão, a célula com Emitida em [[OrdensDeProducao.EmissaoData]:formatar(dd/MM/yyyy)] gera “Emitida em 26/08/2026”, e a célula com Quantidade: [[OrdensDeProducao.Quantidade]:casasdecimais(2)] gera “Quantidade: 1,00”. Nesse caso, o valor continua como texto, junto com o restante da célula. Para saber mais sobre os modificadores de formato, clique aqui.

Tags de anexos

Os anexos são arquivos vinculados ao cadastro do item e podem ser utilizados em modelos de relatório por meio de tags específicas. O cadastro e o gerenciamento desses anexos são realizados diretamente no cadastro do item. Para saber como informar e gerenciar os anexos, clique aqui.

Após serem cadastrados, os anexos podem ser referenciados nos modelos de relatório por meio das tags correspondentes. Para isso, é necessário habilitar o anexo para utilização em relatórios, marcando todos os tipos de relatório em que ele deverá estar disponível.

Exemplo de utilização:

1) Acesse a tela “Produção > Ordens de produção”.

2) Consulte o dicionário de tags acessando em “Imprimir/Exportar > Configurar relatórios personalizados da ordem de produção”.

3) Na tela que irá abrir, acesse “Consultar > Dicionário de tags”.

4) Localize a tag do item necessário e a copie.

5) Inclua a tag no relatório utilizando o padrão “[[Anexo]:sim]” e importe-a para o sistema, conforme as orientações do tópico Como criar ou modificar um modelo de relatório personalizado?, acima.

6) Ao final, as páginas anexadas no registro serão colocadas como novas páginas ao final de seu relatório.

Exemplo

É interessante trabalhar com tabelas para facilitar a organização das informações.

1) Vá ao menu “Vendas > Pedidos de venda”.

2) Selecione um pedido de venda e clique na edição.

3) Na edição do pedido, vá ao menu “Imprimir/exportar > Configurar relatórios personalizados do pedido de venda”.

4) Na tela de “Modelos de relatórios”, clique no botão “Novo” e, em seguida, no botão , para abrir o dicionário de palavras-chave.

5) Insira as informações de número do pedido, data de emissão e dados do cliente. Copie o texto da tag desejada.

6) No arquivo .docx, cole o texto da tag no local desejado.

7) Para encontrar as tags, utilize os filtros.

8) Copie e insira as tags dos itens dentro de tabelas. Insira apenas uma linha com as tags dos itens, pois elas serão replicadas para cada item do pedido de venda.

9) Após concluir o modelo de relatório, importe-o na tela “Configurar relatórios personalizados do pedido de venda”.

10) Os modelos importados aparecem disponíveis para impressão no menu “Imprimir/exportar” e no submenu “Gerar relatórios personalizados do pedido de venda”.

11) No outro menu “Gerar relatórios personalizados padrão do pedido de venda” encontram-se os relatórios padrão desenvolvidos pela Maxiprod e disponibilizados para todos os usuários.

12) Observe abaixo o resultado, quando imprimimos o modelo, sendo as tags substituídas pelos dados do pedido de venda.

Como converter um relatório personalizado em padrão?

Os passos abaixo se aplicam a quaisquer telas que utilizam relatórios personalizados.

1) Estamos na tela de Propostas (acessada pelo menu “Vendas > Propostas”). Vá ao menu “Imprimir/exportar > Configurar relatórios personalizados da proposta”.

2) Na tela de configuração, selecione o relatório que deseja tornar padrão e vá ao menu “Ações > Definir padrão”.

3) Agora, sempre que clicar no ícone de impressora na tela de Propostas, enviar o documento por e-mail ou clicar no botão principal de impressão do documento, o modelo utilizado será o definido como padrão.

4) Para restaurar o modelo original como padrão, entre na tela de configurações e clique no menu “Ações > Restaurar padrão”.

Modificadores de tags de relatórios personalizados

• [[tag]:page] = faz sair um por página, ou seja, independente de haver espaço na página, cada repetição da tag gera uma nova página. Assim, para gerar um relatório de cada registro (nota fiscal, pedido de venda, etc) por página, o “:page” deve ser preenchido em apenas uma das tags. Este modificador pode não funcionar com tags de informações gerais, como tags de data atual e informações da própria empresa.
• [[tag]:hide] = esconde a informação gerada pela tag. Em documentos Word, este modificador tem a mesma função do “:page”, desde que esteja preenchido fora de uma tabela.
• [[tag]:casasdecimais(X)] , onde X é a quantidade de casas decimais do valor numérico trazido pela tag.
• [[tag]:horizontal-resize] = ao invés das linhas da lista ficarem na vertical (que é o padrão), ficarão na horizontal
• [[equals]][[tag]]*[[tag]] = coloque [[equals]] antes de expressões de tags, separadas por operadores aritméticos. A expressão é calculada antes da inserção no relatório.
• [[tag]:collapse] = quando a tag não tiver valor, for null, a linha é eliminada; dessa forma, o template não terá uma linha a mais em branco.

Cuidado: com a linha são eliminadas todas as suas informações, então não colocar :collapse se desejar que a linha seja exibida.

• [[Item.CadastroDoItem.Imagem]:altura(300)] = definir a altura, em pixels, de uma imagem. A imagem é redimensionada proporcionalmente à sua altura em pixels.
• [[LogotipoDaMinhaEmpresa]:alturalogo(300)] = definir a altura, em pixels, do logotipo da empresa. O logotipo é redimensionado proporcionalmente à sua altura em pixels.
• [[tag de valor]:ValorPorExtenso] = traz o valor numérico por extenso.

Como limitar o acesso a relatórios

Para limitar a geração de relatórios a apenas alguns usuários ou grupos de usuários, devem ser criados vínculos entre perfis e relatórios. Os relatórios vinculados a perfis podem ser gerados apenas por usuários com esses perfis. Esse vínculo pode ser criado tanto com os relatórios-padrão como com os relatórios personalizados.

Permissões

Para criar esses vínculos, o usuário deve ter as permissões:

• • REL001 – Consultar perfis de acesso x relatórios.
  • REL002 – Criar e editar perfis de acesso x relatórios.

Para um usuário poder gerar relatórios, independentemente de ter um perfil de acesso necessário para gerá-los, deve ter a permissão:

• • REL004 – Gerar relatórios mesmo sem ter perfis de acesso vinculados a eles.

Para criar vínculos entre perfis e relatórios:

1) Acesse o menu “Roda dentada > Perfis de acesso x relatórios”.

2) É exibida a lista de vínculos entre perfis e relatórios. Para criar um vínculo, clique em “Novo”.

3) Na janela que será aberta, devemos:

a) Selecionar o nome do relatório ao qual deseja dar permissão (podemos ser modelos padrão ou personalizados).

b) Na seção “Selecione os perfis de acesso para inserir”, utilize o campo “Pesquisar” no lado esquerdo para selecionar os perfis de acesso.

c) Para incluir o perfil a ter permissão ao relatório, podemos usar os botões “>” para adicionar um ou mais perfis ou “<” para remover.

d) Para efetivar as alterações, clique em “Salvar“.

4) Agora, o sistema permitirá que o relatório seja gerado somente por usuários com o perfil de acesso selecionado.

5) Um mesmo relatório pode ser vinculado a vários perfis, e vários relatórios a um mesmo perfil.

6) Pode-se também criar vínculos entre um perfil de acesso e seus relatórios na seção “Relatórios” da tela de edição de perfis de acesso.

Veja no vídeo abaixo como criar um modelo de relatório personalizado:

Para mais informações, entre em contato com o suporte.

Veja também:

• Etiquetas
• Código de barras em relatórios e etiquetas 
• Dicas e utilidades de relatórios personalizados