Os cadastros da fazenda — safras, culturas, variedades, talhões, plantio, tipos de atividade, pluviômetros, locais de estoque, classes, produtos, fornecedores, pragas e o resto que as tools cadastrar_* mantêm —, com os ids que as tools cadastrar_* pedem para alterar e para ligar um cadastro ao outro. A visão andamento mostra o que a fazenda já tem: é por ela que se começa uma implantação. O filtro documento (só na visão entidades) recebe a identificação do fornecedor na empresa (código ou número de cadastro), para achá-lo sem depender da grafia do nome. As visões contatos e usuarios existem para completar outros cadastros, não para listar pessoas: contatos traz o e-mail e o WhatsApp comercial dos fornecedores (o contato do convite de cotação) e o contato que recebe as ordens de serviço da equipe; usuarios traz só o nome de quem já usa o upCampo nesta fazenda, para escolher o responsável de uma equipe ou de um local de estoque. Use-as só quando a tarefa pedir esse id.
Visões disponíveis (parâmetro "visao"):
- andamento: Uma linha com a contagem de cada cadastro da fazenda. Ordem da implantação: safra → cultura → variedade → talhão (e o mapa do talhão) → plantio → tipo de atividade → subtipo → pluviômetro → local de estoque → classe → produto → fornecedor → tipo de equipamento → equipamento → funcionário → equipe → bico → estoque inicial (lancar_entrada_nota, Entrada avulsa). Para a colheita: tabelas de desconto → parâmetro de colheita da safra. Por último, as pragas: da base (cadastrar_praga com id_praga_base) e os níveis de controle. O próximo passo é o primeiro que estiver zerado. Filtros: nenhum.
- safras: Safras da empresa, com tudo o que a tela tem: período, bloqueios, esconder no login, dólar, ID de referência, quantos talhões plantados e quantas estufas. Filtros: nome.
- culturas: Culturas da empresa, com tudo o que a tela tem (unidade, cor, fardos, rótulos e tipo padrão do MIP). DA_BASE_UPCAMPO: veio da base da upCampo, com estágios. Filtros: nome.
- variedades: Variedades da fazenda, com a cultura e tudo o que a tela tem (ciclo, florescimento, tecnologia, pesos estimados, dados de plantio, observação). Filtros: nome, cultura.
- talhoes: Talhões da fazenda, com área (ha), setor, quantos plantios em andamento e se já têm MAPA DO TALHÃO (TEM_MAPA; CENTRO_LATITUDE/CENTRO_LONGITUDE é o ponto do talhão), medidas, áreas terrestre/aérea/bordadura/exclusão e quantas camadas e integrações tem. Filtros: nome, setor.
- plantios: O que está plantado em cada talhão, por safra: cultura, variedade, área e data. VARIAS_VARIEDADES: o talhão tem mais de uma variedade (visão plantio_variedades). Traz também emergência, colheita, espaçamento, plantas por metro/hectare, previsto e as marcas separar_*. Filtros: safra, nome, cultura, aceita período.
- tipos_atividade: Tipos de atividade da fazenda, com a categoria, a natureza (plantio, colheita, aplicação…), o que a execução da OS exige e tudo o que a tela tem (bloqueio para levantamento, hora, relatório, checklist, dashboard). Filtros: nome, natureza.
- pluviometros: Pluviômetros da fazenda, um por linha, com os talhões que cada um cobre, tipo (manual ou estação) e o que a estação mede. TEM_CREDENCIAL: a chave e o segredo estão gravados (não aparecem). Filtros: nome.
- locais: Locais de estoque da fazenda, com tudo o que a tela tem: silo, posto de abastecimento (campo informado, produto, galão), controle de saldo e de data, e-mail de saldo negativo, terceiro, onde aparece, setores, moeda, quantos produtos têm saldo, bombas e usuários vinculados. Filtros: nome.
- classes: Classes de produto da empresa, com tipo, classe pai, abreviação, ativo e quantos produtos cada uma tem. Filtros: nome.
- produtos: Produtos da empresa, com tudo o que a tela tem: unidade, classe, doses, valor, exigir lote, organofosforado, registro MAPA, formulação, carência, grupo de resistência, classes toxicológica e ambiental, referências e quantos lotes a fazenda tem. Filtros: nome, classe. Lista no máximo 100 linhas por chamada.
- entidades: Fornecedores, clientes e demais entidades da empresa. DOCUMENTO é a identificação do fornecedor, como está gravada (as antigas podem ter máscara): serve para conferir se um fornecedor já existe antes de cadastrar. Só mostre o documento ao usuário quando ele pedir ou quando for preciso para distinguir dois cadastros. Traz também endereço, inscrições, os papéis (cliente, transportadora, motorista, terceiro…), conta, centro de custo e quantos endereços e contatos tem. Filtros: nome, documento, fornecedor. Lista no máximo 100 linhas por chamada.
- tipos_equipamento: Tipos de equipamento da empresa, com capacidade do tanque de aplicação, vazão, onde aparece (OS e dashboard) e quantos equipamentos a fazenda tem de cada. Filtros: nome.
- equipamentos: Máquinas, veículos e implementos da fazenda, com tipo, medidor, última leitura e placa. IMPLEMENTO distingue implemento de máquina. Traz também tudo o que a tela tem: tipo, centro de custo, documentação (UF, RNTRC, RENAVAM), motorista, terceiro, consumo, limite de horímetro, onde aparece e quantos componentes tem. Filtros: nome, tipo, placa. Lista no máximo 100 linhas por chamada.
- subtipos: Subtipos (Identificação Resumida) da fazenda, com a etapa e os tipos de atividade em que cada um vale, ordem, dashboard e programação. QTDE_TIPOS_ATIVIDADE 0: não está vinculado a nenhum tipo. Filtros: nome, tipo_atividade.
- equipes: Equipes da fazenda, com os funcionários e os equipamentos de cada uma e o envio por WhatsApp (número, usuário responsável, contato, entidade e o destino da OS, do checklist e do plano). Filtros: nome.
- bicos: Bicos de pulverização da empresa, com a vazão por pressão (PSI: L/min) nesta fazenda. Filtros: nome.
- local_bombas: Bombas de cada posto de abastecimento, com produto e leitura. ID_BOMBA altera em cadastrar_local_estoque. Filtros: local.
- local_usuarios: Usuários vinculados a cada local. Quem tem vínculo enxerga só os locais vinculados naquela fazenda; sem nenhum vínculo, vê todos. Filtros: local, usuario.
- local_estoques: Linhas de estoque (local × produto) com saldo, localização, capacidade e estoque mínimo. ID_ESTOQUE altera em cadastrar_local_estoque (a linha nasce pelo primeiro lançamento, não por cadastro). Filtros: local, produto. Lista no máximo 100 linhas por chamada.
- produto_principios_ativos: Princípios ativos de cada produto, com a concentração. ID_ITEM altera em cadastrar_produto. Filtros: produto, nome.
- produto_doses: Dose de cada produto por cultura nesta fazenda (por hectare e por volume, máximo de aplicações, intervalo, bloqueio). ID_ITEM altera em cadastrar_produto. Filtros: produto, cultura.
- produto_ncms: NCMs e códigos de referência de cada produto (por fornecedor). ID_ITEM altera em cadastrar_produto. Filtros: produto, ncm.
- produto_lotes: Lotes de cada produto nesta fazenda, com validade. ID_LOTE altera em cadastrar_produto. Filtros: produto, lote. Lista no máximo 100 linhas por chamada.
- entidade_enderecos: Endereços adicionais de cada fornecedor/entidade. ID_ENDERECO altera em cadastrar_fornecedor. Filtros: entidade.
- contatos: Contatos desta fazenda (e-mail e WhatsApp): os de cada fornecedor e os grupos, sem entidade. O primeiro contato com WhatsApp é o do convite da cotação. ID_CONTATO altera em cadastrar_fornecedor e vai no contato da equipe. Filtros: nome, entidade.
- equipamento_componentes: Componentes de cada equipamento. ID_COMPONENTE altera em cadastrar_equipamento. Filtros: equipamento.
- equipe_funcionarios: Funcionários de cada equipe, com observação e ativo. Filtros: equipe, funcionario.
- moedas: Moedas da fazenda (ID_MOEDA do funcionário e do local). Sem moeda cadastrada, o campo não se usa. Filtros: nome.
- configuracoes_fiscais: Configurações fiscais da fazenda (ID_CONFIGURACAO_FISCAL do funcionário). Filtros: nome.
- usuarios: Usuários com acesso a esta fazenda, só pelo nome (ID_USUARIO do local de estoque e da equipe). Filtros: nome.
- principios_ativos: Princípios ativos cadastrados pela empresa. Os da base da upCampo estão em consultar_base_upcampo visão principios_ativos. Filtros: nome.
- tipos_formulacao: Tipos de formulação da empresa. Sem nenhum, valem os da base (consultar_base_upcampo visão tipos_formulacao). Filtros: nome.
- grupos_resistencia: Grupos de princípio ativo (resistência) da empresa; os da base estão em consultar_base_upcampo visão grupos_resistencia. Filtros: nome.
- tabelas_desconto: Tabelas de desconto da classificação de grãos da empresa, por tipo (Umidade, Impureza…), com as faixas ("14.100%: desconta 1.264%" vale a partir de 14,1% medido). Filtros: nome, tipo.
- parametros_colheita: Parâmetro de colheita de cada safra × cultura: o produto que entra no estoque com o romaneio e a tabela de desconto de cada classe (TABELA_<CLASSE>; <CLASSE>_MANUAL deixa informar o desconto % direto). Sem parâmetro, o romaneio da cultura naquela safra é recusado. Filtros: safra, cultura.
- planos_manutencao: Planos de manutenção da empresa, com os itens a verificar e em quantos equipamentos desta fazenda estão aplicados. A recorrência por equipamento está em consultar_frota visão planos. Filtros: nome.
- plano_contas: Plano de contas da empresa, com a conta-mãe. USO diz onde a conta serve: "Contas a pagar", "Contas a receber" ou "Não recebe lançamento" (grupo/totalizador ou inativa). ID_CONTA é o id_conta_gerencial do lancar_conta_pagar_receber. Filtros: nome, uso.
- centros_custo: Centros de custo da empresa, com o centro acima de cada um. Filtros: nome.
- contas_bancarias: Contas bancárias e caixas da fazenda, com o SALDO_ATUAL e se bloqueiam saldo negativo. ID_CONTA_BANCARIA vai no pagamento, na baixa e na transferência. Filtros: nome.
- departamentos: Departamentos da fazenda (o departamento do pedido de compra), com os aprovadores de pedido: nome, id e valor máximo de cada um. ID_APROVADOR_UNICO vem preenchido quando há um só. SEGUNDOS_APROVADORES aprovam o que passa do valor máximo. Filtros: nome.
- estagios: Estádios fenológicos de cada cultura da empresa, na ordem do ciclo. ID_ESTAGIO vai no nível de controle e no tipo padrão da praga (estádio inicial e final da mesma cultura). Filtros: cultura, nome.
- estufas: Estufas (casa de vegetação) de cada safra: variedade, área e quantidade. ID_ESTUFA altera em cadastrar_safra. Filtros: safra, variedade.
- subestagios: Subestágios de cada cultura, na ordem. ID_SUBESTAGIO altera em cadastrar_cultura. Filtros: cultura, nome.
- crescimento: Crescimento vegetativo ideal (altura × nós ou DAE) das culturas e das variedades. DE diz de qual das duas é; ID_CRESCIMENTO altera em cadastrar_cultura ou cadastrar_variedade. Filtros: cultura, variedade.
- talhao_camadas: Camadas de cada talhão. ID_CAMADA altera em cadastrar_talhao. Filtros: talhao.
- talhao_integracoes: Vínculos de cada talhão com John Deere ou Solinftec. ID_ITEM altera em cadastrar_talhao. Filtros: talhao, tipo.
- plantio_variedades: Variedades de cada plantio com mais de uma, com área, dados de plantio e colheita. ID_ITEM altera em cadastrar_plantio (lista variedades). Filtros: safra, talhao, variedade.
- plantio_outros: Aba "Outros" de cada plantio. ID_ITEM altera em cadastrar_plantio (lista outros). Filtros: safra, talhao.
- tipo_atividade_vazoes: Vazões terrestre e aérea (situações 1 a 3) dos tipos de aplicação, com o bico. Filtros: tipo_atividade.
- operacoes: Operações da fazenda, que entram na aba Operação do tipo de atividade (ID_OPERACAO). Filtros: nome.
- tipo_atividade_operacoes: Aba Operação de cada tipo de atividade. ID_ITEM altera em cadastrar_tipo_atividade. Filtros: tipo_atividade.
- modelos_checklist: Modelos de checklist da fazenda (ID_MODELO_CHECKLIST do tipo de atividade). Filtros: nome.
- relatorios: Relatórios da empresa (ID_RELATORIO do tipo de atividade, o relatório padrão da OS). Filtros: nome.
- classes_praga: Classes de praga da empresa (Lagartas, Fungos…), com o tipo e quantas pragas desta fazenda têm cada uma. Filtros: nome, tipo.
- pragas: Pragas, doenças, daninhas e avaliações da fazenda, com classe, forma de cálculo, os tamanhos, as culturas e quantos níveis de controle cada uma tem. ATIVO false: fora do app. Filtros: nome, tipo, classe, cultura. Lista no máximo 100 linhas por chamada.
- praga_tamanhos: Tamanhos de cada praga (os campos do ponto no app), com forma de cálculo, a FORMULA com os nomes e os níveis pré-definidos do tamanho (NIVEIS, "nome = valor"). ID_TAMANHO vai no nível de controle. Filtros: praga, nome.
- praga_niveis: Níveis pré-definidos (opções de escolha) das pragas e dos tamanhos, com o valor de cada um. TAMANHO vazio: nível da praga. ID_NIVEL serve para alterar em cadastrar_praga. Filtros: praga, tamanho.
- niveis_controle: Níveis de controle (Baixo, Médio, Alto) de cada praga e de cada grupo de praga, por cultura: de VALOR_DE (inclusive) até VALOR_ATE (exclusive), com tamanho e estádios. DE diz se é de praga ou de grupo. Sem estádio: vale para o ciclo todo. Filtros: praga, grupo, cultura.
- tipos_padrao_praga: Tipo padrão de levantamento (por planta ou por metro) de cada praga, por cultura e estádio. Filtros: praga, cultura.
- grupos_praga: Grupos de praga da empresa, com as pragas de cada um e quantos níveis de controle têm. Filtros: nome.
- grupo_praga_itens: Cada praga dentro de cada grupo, com o ID_ITEM que cadastrar_grupo_praga pede para alterar ou tirar. Filtros: grupo, praga.
- funcionarios: Funcionários da fazenda, com função, contato, valor/hora, centro de custo, moeda, configuração fiscal e onde aparecem (abastecimento, OS, requisição, OS de manutenção, checklist). Filtros: nome, funcao.
Quando "visao" não é informada, usa "andamento".
Filtro de texto casa por trecho, sem diferenciar maiúsculas nem acento ("aplicacao" acha
"Aplicação") — exceto os marcados
"(valor exato)", que exigem o valor inteiro, como código, placa e número.
A resposta traz "total_disponivel": quantas linhas o filtro encontra ao todo.
Chame uma vez só, já com o limite que a resposta vai usar — nunca repita a consulta mudando só o limite;
se só o número interessa e o total pode ser grande, um limite baixo basta.