📘 Tela: Relatório

Esta é a tela onde os relatórios do sistema são cadastrados e organizados — não onde são emitidos. Cada linha aqui é um dos relatórios que aparecem no menu Relatórios: CLI.01.03 - Controle Pluviométrico - Geral, EST.01.09 - Dashboard Visão Geral Local x Estoque, POS.06.01 - Armazenagem - Extrato. É daqui que sai o código que a Central de Ajuda cita nos artigos.

Os códigos mudaram em 04/10/2026. O código passou a dizer onde o relatório fica: ÁREA.ASSUNTO.NN — OPE.01.01 é Operacional › Ficha de recomendação › 1º relatório. Por algumas semanas o código antigo continua no fim do nome, entre parênteses (“Ficha de recomendação (INDIVIDUAL) (003.B)”), e a Central o mostra assim: “OPE.01.01 (antigo 003.B)”. A regra completa, com as áreas e os assuntos, está no Guia Rápido de Relatórios.

É uma tela de configuração, normalmente mexida junto com a equipe da upCampo. O que a fazenda faz com frequência nela é outra coisa: conferir o código de um relatório, tirá-lo do menu, mudar o tema em que ele aparece ou pedir a instalação de um relatório novo.

Para emitir um relatório — filtros, tipos de saída e exportação para Excel —, veja o Guia Rápido de Relatórios.

📍 Localização no sistema

Menu: Arquivo > Relatório


🧩 Função principal

Manter o catálogo de relatórios da empresa: o arquivo do relatório, onde ele aparece no menu, quais filtros ele pergunta antes de rodar e quem pode vê-lo.


📝 Campos principais

CampoDescrição
Tipo (no alto)Relatório, Power BI ou Tabela. O padrão é Relatório — os outros dois são para painel do Power BI e para consulta em forma de tabela.
CódigoObrigatório. É o identificador que aparece no menu e nos artigos: CLI.01.03, OPE.04.03, EST.01.09. Relatório novo só salva com código no padrão ÁREA.ASSUNTO.NN — três letras da área, dois dígitos do assunto e dois da posição, como OPE.02.01 — ou, se for personalizado de uma fazenda, ÁREA.ASSUNTO.Pnn, como OPE.02.P03. Fora disso, o portal avisa “Código fora do padrão”. O código também não pode repetir um que você já enxerga no menu. As letras são passadas para maiúsculas sozinhas.
Código antigoSó leitura. O código que o relatório tinha antes da reorganização de outubro de 2026 (003.B, 15.07…). Serve para achar o relatório pelo número a que a equipe estava acostumada; relatório criado depois disso fica com o campo em branco. É provisório: sai da tela quando a transição terminar.
DescriçãoObrigatório. O nome que o usuário lê no menu.
Nome do arquivoObrigatório. O arquivo do relatório (.mrt) que será executado. Envie pelo botão de upload ao lado: o nome é preenchido sozinho e o sistema avisa que é preciso salvar o cadastro para confirmar. Se já existia um arquivo com o mesmo nome, ele é guardado como cópia antes de ser substituído.
Nome do arquivo pequenoVersão do relatório para tela pequena, quando existe.
Nome do arquivo htmlVersão em HTML, quando existe.
FormulárioTela a que o relatório está ligado.
Tema · OrdemTema é obrigatório. É a área do relatório (Cadastro, Lavoura, Clima, Levantamento, Custos, Operacional, Estoque, Frota, Armazenagem, Financeiro) e aparece na coluna Tema do Pesquisar relatório…. O menu Relatórios, porém, agrupa pelas três letras do código — por isso lá os títulos já são Monitoramento (tema Levantamento) e Pós-Colheita (tema Armazenagem). A ordem deixou de decidir a posição no menu: quem decide é o código.
AssuntoO assunto do relatório dentro da área — Ficha de recomendação, Saldo de estoque, Chuva. Escolha um da lista (são os que já existem) ou digite um novo. É o que aparece na coluna Assunto do Pesquisar relatório…, e deve combinar com os dois dígitos do meio do código.
FormatoLista, Ficha, Relatório, Tabela ou Dashboard: como o relatório se apresenta. É só classificação, para quem procura — não é o mesmo que o Tipo, lá no alto. O Tipo (Relatório, Power BI, Tabela) decide como o relatório abre; o Formato não muda nada na emissão.
Grupo menuSubdivisão dentro do menu de relatórios.
Exibir no menu relatórioDesmarque para tirar o relatório do menu sem excluí-lo.
AtivoDesliga o relatório de vez.
ResumoTexto livre explicando o que o relatório mostra. Vale escrever: é o que ajuda quem vai escolher entre dois parecidos.

A lista traz Código, Código antigo, Descrição, Tema, Assunto, Formato, Tipo, Empresa e Ativo, com busca em cada coluna.

Como escolher o código de um relatório novo

O botão Novo não sugere mais número: o código depende da área e do assunto, e só quem cadastra sabe quais são. O caminho é:

  1. Área: a do menu onde fica a tela de origem do relatório (romaneio → POS, ordem de serviço → OPE).
  2. Assunto: um dos que a área já tem. Assunto novo só se nenhum couber — e ele entra no fim da área.
  3. Número: o próximo livre do assunto. Personalizado de uma fazenda usa o próximo P livre daquela fazenda.
  4. Preencha também Assunto e Formato.

Relatório que já existia e ainda está com código antigo continua salvando normalmente; a regra vale para os novos.


🔘 Botões

BotãoO que faz
VisualizarRoda o relatório na hora, para conferir o resultado sem sair da tela.
ClonarCria uma cópia do relatório selecionado, com filtros e queries junto. É o caminho para partir de um relatório pronto e ajustar o que a fazenda quer diferente — sem mexer no original.
Setar para empresa padrãoMarca o relatório como padrão da empresa.

Clonar e Setar para empresa padrão exigem que o relatório já esteja salvo.


🗂 Guias Filtros e Querys

São as duas guias que fazem o relatório perguntar antes de rodar e buscar os dados.

Filtros é a lista de perguntas que aparecem antes da emissão — safra, período, talhão, técnico. Cada filtro tem Nome, Ordem, Tipo, se é Obrigatório, se Exibe pesquisa, se aceita somente um valor, o Valor padrão e a consulta que alimenta a lista de opções.

Querys guarda as consultas que o relatório executa, com Nome, Ordem e Ativo.

As duas guias são território técnico: mexer nelas sem conhecer a estrutura do banco quebra o relatório para todo mundo da empresa. Peça à equipe da upCampo — e, se quiser experimentar, faça no Clonar, nunca no original.


👀 Quem enxerga cada relatório

Estar cadastrado aqui não basta para o usuário ver o relatório: a liberação por pessoa fica na guia Relatórios da tela de Usuários, onde se marca o Permite relatório a relatório. E o relatório que sai automaticamente por e-mail é escolhido na guia Envio automático de Configurações da Empresa/Cultura.

✅ Resultado: com o catálogo de relatórios organizado:
  • O menu de relatórios fica com o que a fazenda usa, agrupado por assunto
  • Cada relatório tem código fixo, que diz a área e o assunto — fácil de pedir por telefone ou citar num chamado
  • Personalizações ficam em cópias, sem quebrar o relatório original
  • O relatório certo chega a quem precisa, por menu ou por e-mail

❓ Perguntas frequentes

Onde vejo o código de um relatório?

Na coluna Código desta tela — é o mesmo código que aparece no menu de relatórios e no Pesquisar relatório…, no formato CLI.01.03. Ele é o jeito mais rápido de identificar um relatório ao pedir ajuda. Se você só lembra do número antigo (006.A), procure na coluna Código antigo ou digite-o no Pesquisar relatório…, que acha pelos dois.

Qual a diferença entre Formato e Tipo?

O Tipo decide como o relatório abre: no visualizador (Relatório), em grade com exportação para Excel (Tabela) ou num painel do Power BI. O Formato — Lista, Ficha, Relatório, Tabela ou Dashboard — é só uma etiqueta para quem procura, e não muda nada na emissão.

Quero um relatório com o logo e o layout da minha fazenda. Dá?

Dá. O logo sai do cadastro de Fazenda; o layout é o arquivo do relatório. Para mudar o layout sem afetar os outros, use o Clonar, ajuste a cópia e tire o original do menu. Fale com a equipe da upCampo — o desenho do arquivo é feito em ferramenta própria.

Como tiro do menu um relatório que ninguém usa?

Abra o relatório e desmarque Exibir no menu relatório. Ele sai do menu e continua cadastrado, com o histórico intacto — dá para voltar atrás quando quiser. Se a intenção é esconder o relatório só de algumas pessoas, o lugar é a guia Relatórios da tela de Usuários.

Um relatório parou de abrir. O que olho aqui?

Clique em Visualizar nesta tela: se ele não abre nem daqui, o problema é do relatório, não da permissão. Confira se o Nome do arquivo está preenchido e se o Ativo está marcado. Se estiver tudo certo, abra um chamado com o código do relatório.