PROF. SÁTIRO RAMOS
AgroCota
Fertilizantes
MANUAL DE USO
Consulta e interpretação de indicadores
de preços médios de importação
| VERSÃO 1.1 | OUTUBRO DE 2026 Guia do usuário e orientações de instalação no servidor. |
Este manual acompanha a versão corrigida do AgroCota Fertilizantes. As orientações correspondem aos campos, botões e cálculos disponíveis nessa versão.
Fontes dos indicadores: Comex Stat / MDIC e Banco Central do Brasil.
O que o sistema apresenta
Médias mensais das importações brasileiras de fertilizantes, em dólares por tonelada, com histórico, variações e conversão de referência para reais.
| Os valores não representam preços de revenda ao produtor nem ofertas comerciais. A conversão para reais não acrescenta tributos, despesas de internalização, armazenagem, transporte nacional ou margem comercial. |
Edição: 6 de outubro de 2026
1. Comece por aqui
Para consultar os indicadores, você precisa de conexão com a internet e de um navegador com JavaScript habilitado. O uso da página não exige cadastro, chave de API ou token.
Primeira consulta em oito passos
1. Abra a página do AgroCota e aguarde a identificação do último mês disponível na base.
2. Em Fertilizante, selecione o produto que deseja analisar.
3. Confira o Mês de referência. Ele define o mês dos indicadores principais.
4. Em Preço, escolha CIF ou FOB. Em Histórico, escolha 3, 6, 12 ou 24 meses.
5. Clique em Consultar uma vez e aguarde a conclusão da busca.
6. Leia o preço em US$/t, as variações, o gráfico e a tabela de dados mensais.
7. Para obter R$/t, vá a Câmbio para conversão e clique em Buscar PTAX ou informe uma taxa.
8. Confira o período, a taxa de câmbio e as ressalvas do produto antes de utilizar os resultados.
Onde encontrar cada orientação
| Seção | Conteúdo | Página |
| 2 | Campos e comportamento da consulta | 3 |
| 3 | Painel, gráfico e tabela | 4 |
| 4 | Conversão para reais e PTAX | 5 |
| 5 | Fertilizantes e códigos NCM | 6 |
| 6 | Fórmulas e exemplos de cálculo | 7 |
| 7 | Mensagens, erros e cache | 8 |
| 8 | Instalação e atualização | 9 |
| 9 | Glossário, limites e fontes | 10 |
| A busca do câmbio é separada da consulta de fertilizantes. Se a conversão em reais estiver com um traço, mas os preços em dólares estiverem preenchidos, defina a taxa de câmbio. |
2. Configure sua consulta
| Campo ou comando | Como usar |
| Fertilizante | Selecione entre ureia, MAP, KCl, DAP, sulfato de amônio, SSP e TSP. Consulte as limitações de cada grupo na seção 5. |
| Mês de referência | Escolha o mês que deseja analisar. A interface permite referências a partir de janeiro de 2022 e limita a seleção à cobertura identificada da base. |
| Preço — CIF | Mostra a média do valor da mercadoria somado ao frete internacional e ao seguro, por tonelada. |
| Preço — FOB | Mostra a média do valor da mercadoria a bordo na origem, sem acrescentar frete internacional e seguro, por tonelada. |
| Histórico | Define quantos meses aparecem no gráfico e na tabela: 3, 6, 12 ou 24. O período termina no mês de referência. |
| Consultar | Busca os dados do fertilizante e período selecionados ou reaproveita uma consulta válida em cache. |
Quando é necessário consultar novamente?
- Ao mudar o fertilizante ou o mês de referência, os resultados anteriores são retirados. Clique novamente em Consultar.
- Após uma consulta válida, mudar CIF/FOB ou o tamanho do histórico reorganiza os dados já carregados; não exige uma nova busca.
- Alterar o câmbio recalcula apenas a conversão em reais. Os preços em dólares e as variações percentuais permanecem os mesmos.
Último mês disponível
Ao abrir a página, o sistema consulta a cobertura da base e sugere o último mês publicado. “Base até” informa a cobertura identificada; não é uma cotação do dia. A publicação é mensal e pode ser revista pela fonte.
Se aparecer “Último mês não confirmado”, escolha um mês encerrado e tente Consultar. Essa mensagem indica falha na verificação da cobertura e não demonstra, por si só, ausência de importações.
| O quadro “Últimos 12 meses” sempre considera 12 meses encerrados na referência, mesmo quando você escolhe 3, 6 ou 24 meses no gráfico. |
3. Leia os resultados
A captura abaixo foi fornecida durante o teste da versão 1.1. Ela exemplifica a leitura do painel; seus números não devem ser tratados como cotação atual.
Figura 1 — Painel consultado pelo usuário. Referência exibida: setembro de 2026. Fonte da imagem: captura fornecida pelo usuário.
| Elemento | Interpretação |
| Preço médio CIF/FOB | Preço do mês de referência em US$/t. Na captura: US$ 448,35/t, na modalidade CIF. |
| Variação mensal e em 12 meses | A captura mostra −0,90% contra agosto/2026 e −2,25% contra setembro/2025. O sinal negativo indica queda; o positivo, aumento. |
| Histórico de preços | Cada ponto é uma média mensal em US$/t. Lacunas indicam meses sem preço calculável; os pontos não são estimativas diárias. |
| Últimos 12 meses | Apresenta a menor e a maior média mensal, a média ponderada e a cobertura. “12/12” significa 12 meses com preço calculável. |
| Dados mensais | A tabela abaixo do gráfico mostra FOB, CIF, volume em toneladas e variação mensal na modalidade selecionada. |
No celular, deslize a tabela horizontalmente para visualizar todas as colunas. A seleção do câmbio não transforma o gráfico em reais: ele continua em US$/t.
4. Converta para reais
A seção Câmbio para conversão fica abaixo do gráfico e do quadro de estatísticas. O preço em reais só aparece quando houver preço calculável no mês consultado e uma taxa positiva válida.
Opção A — Buscar PTAX
1. Clique em Buscar PTAX.
2. Aguarde a consulta ao Banco Central. O sistema procura a cotação de venda mais recente retornada no intervalo dos últimos 14 dias.
3. Confira a taxa e a data exibidas na mensagem. A data pode ser anterior ao dia de acesso.
4. Observe o preenchimento do quadro Conversão de referência, em R$/t.
Opção B — Informar uma taxa manual
Digite a taxa no campo R$ por US$ 1, por exemplo 5,4000. Use o separador decimal aceito pelo seu navegador. O sistema aceita taxas positivas de até 1.000, com até quatro casas decimais no controle de entrada. Ao editar o valor, a origem passa a ser identificada como “taxa manual”.
| Situação | O que acontece |
| Taxa válida | O valor do mês consultado é multiplicado pela taxa e exibido em R$/t. |
| Campo vazio, zero ou taxa inválida | A conversão não é calculada. Os indicadores em dólares continuam disponíveis. |
| Falha na busca da PTAX | Você pode informar uma taxa manual. Se já existia uma taxa definida, a mensagem informa sua manutenção. |
| Mudança de CIF para FOB | O quadro em reais acompanha o preço selecionado, usando a mesma taxa definida. |
Exemplo de conversão
Exemplo didático, com câmbio hipotético:
| US$ 448,35/t × R$ 5,4000 por US$ 1 = R$ 2.421,09/t |
Essa conversão não corresponde necessariamente ao valor em reais efetivamente pago nas importações. A versão 1.1 usa a taxa escolhida para o mês consultado; não recupera o câmbio histórico de cada operação ou de cada mês.
A PTAX é uma taxa de referência. Ela não deve ser confundida com a taxa negociada em um contrato de câmbio ou com o custo final de compra do fertilizante.
5. Conheça os fertilizantes consultados
Os produtos são agrupados pela Nomenclatura Comum do Mercosul (NCM). A descrição comercial apresentada na tela facilita a consulta, mas a abrangência do código determina quais importações entram no cálculo.
| Produto | NCM | Abrangência e cuidado de interpretação |
| Ureia | 31021010 | Ureia com mais de 45% de N no produto anidro. Abrange a ureia 46%, mas não distingue exclusivamente uso agrícola, granulado ou perolado. |
| MAP | 31054000 | Fosfato monoamônico, inclusive misturado com fosfato diamônico. Não isola uma formulação comercial específica. |
| KCl | 31042010 31042090 | Cloreto de potássio nas faixas de teor de K₂O da nomenclatura. Os dois códigos são reunidos. |
| DAP | 31053010 31053090 | Fosfato diamônico nas classes de teor de arsênio da nomenclatura. Os dois códigos são reunidos. |
| Sulfato de amônio | 31022100 | Sulfato de amônio. O código não separa todas as apresentações ou características comerciais. |
| SSP — aproximação | 31031900 | Outros superfosfatos, fora da faixa ≥35% de P₂O₅. Indicador aproximado; não identifica exclusivamente SSP comercial. |
| TSP — aproximação | 31031100 | Superfosfatos com 35% ou mais de P₂O₅. Indicador aproximado para TSP; não isola um teor comercial específico. |
Por que essa distinção é importante?
Uma mudança na média pode refletir alterações no preço, mas também mudanças nos países de origem, nos teores, na qualidade, nas condições de importação ou na proporção de produtos dentro do grupo. Por isso, compare períodos do mesmo grupo com atenção à sua abrangência.
| O sistema calcula preço por tonelada de produto importado. Ele não calcula preço por quilograma de N, P₂O₅ ou K₂O e não faz recomendação de adubação. |
6. Entenda os cálculos
6.1 Preço médio por tonelada
| Preço médio (US$/t) = valor total em US$ ÷ peso líquido total em kg × 1.000 |
O cálculo usa FOB ou CIF, conforme sua escolha. Quando o grupo reúne dois NCMs, os valores e pesos são somados antes da divisão. Exemplo hipotético: US$ 32.000.000 ÷ 80.000.000 kg × 1.000 = US$ 400,00/t.
6.2 Relação entre CIF e FOB
CIF = FOB + frete internacional + seguro. Se o campo CIF não vier preenchido, a aplicação só o reconstrói quando os três componentes estiverem disponíveis. Campos ausentes não são substituídos por zero. Sem peso válido e positivo, não há preço calculável.
6.3 Variações mensal e anual
| Variação (%) = [(preço do mês de referência ÷ preço de comparação) − 1] × 100 |
Na variação mensal, a comparação é com o mês imediatamente anterior. Na variação em 12 meses, é com o mesmo mês do ano anterior. Exemplo hipotético: de US$ 400,00/t para US$ 420,00/t, a variação é +5,00%. Se faltar um dos preços ou a base de comparação for zero, o sistema exibe um traço.
6.4 Média ponderada dos últimos 12 meses
A média do período usa a soma dos valores importados dividida pela soma dos pesos, considerando os meses com preço calculável. Meses com maior volume têm maior participação no resultado.
| Exemplo hipotético | Quantidade | Preço | Valor |
| Mês A | 100 t | US$ 300/t | US$ 30.000 |
| Mês B | 900 t | US$ 500/t | US$ 450.000 |
| Período | 1.000 t | US$ 480/t | US$ 480.000 |
O resultado é US$ 480.000 ÷ 1.000 t = US$ 480/t. A média simples de US$ 300 e US$ 500 seria US$ 400/t e não corresponde ao cálculo utilizado. A mínima e a máxima representam extremos das médias mensais, não preços mínimos ou máximos de operações individuais.
7. Resolva mensagens e dificuldades
| Mensagem ou situação | Como proceder |
| Conversão de referência com “—” | Clique em Buscar PTAX ou informe uma taxa manual. Confira também se existe preço calculável no mês de referência. |
| Limite de requisições / HTTP 429 | A consulta de série faz uma nova tentativa após 12 segundos. Se persistir, aguarde antes de tentar outra vez. Evite vários cliques ou abas consultando simultaneamente. |
| Erro 429 na versão antiga | Confira o rodapé. Substitua HTML e PHP pela versão 1.1 e use Ctrl + F5. A correção de protocolo não elimina limites que a fonte venha a aplicar. |
| Não foi possível conectar / CORS | Verifique a internet. Se a falha ocorrer no acesso direto, o responsável pelo site deve conferir a instalação do PHP e escolher Pelo servidor (PHP). |
| Resposta não é JSON válido | O responsável pelo site deve conferir nome e localização do PHP, execução de PHP na hospedagem e eventuais páginas de bloqueio retornadas pelo servidor. |
| Último mês não confirmado | A cobertura da base não pôde ser verificada. Escolha um mês encerrado e tente Consultar. |
| Nenhum registro / mês sem preço | Confira produto e período. Ausência de registro não é preço zero. Um mês anterior não é usado automaticamente como se fosse o mês escolhido. |
| Falha de certificado HTTPS | Solicite à hospedagem a atualização dos certificados de confiança. Não desative a verificação do certificado. |
O que significa “Dados em cache”?
Uma resposta válida foi guardada para evitar consultas repetidas. As séries e o câmbio podem ser reutilizados por até 6 horas. A data “Obtidos em” informa quando os dados foram buscados; ela não altera o mês de referência dos preços.
Ctrl + F5 ajuda a carregar os arquivos atualizados da página, mas não garante a eliminação do cache de dados do servidor. Uma janela privativa evita o cache local da sessão anterior; o cache do servidor continua até expirar.
Se precisar relatar um erro
Anote a versão do rodapé, produto, mês, modalidade FOB/CIF, modo de acesso e mensagem completa. Envie uma captura incluindo esses campos. Essas informações ajudam a distinguir falha de instalação, de conexão ou da fonte.
8. Instalação e atualização no site
Esta seção é destinada ao responsável pela publicação. O AgroCota 1.1 é uma página independente com uma ponte PHP opcional para acesso às fontes; o pacote não é um plugin instalável do WordPress.
Arquivos e requisitos
| Arquivo | Função |
| agrocota-fertilizantes.html | Contém a interface, estilos e cálculos no navegador. |
| agrocota-api.php | Faz as consultas a partir do servidor e mantém cache local. |
| LEIA-ME.txt | Reúne orientações de instalação e notas da versão. |
Para usar a ponte: servidor com PHP compatível (mínimo técnico 7.4; prefira uma versão mantida pelo provedor), extensão cURL, acesso de saída HTTPS às fontes e permissão de escrita no diretório temporário. Não é necessário banco de dados.
Instalação em cinco passos
1. Descompacte o pacote da versão 1.1.
2. Envie o HTML e o PHP para a mesma pasta do servidor, preservando seus nomes.
3. Abra o HTML pelo endereço HTTPS do site. Não abra o PHP por duplo clique no computador.
4. Faça uma consulta de fertilizante e use Buscar PTAX para testar as duas fontes.
5. Confira a versão no rodapé e, em Configuração de conexão e diagnóstico, o modo de acesso utilizado.
Exemplo de pasta: public_html/sistemas/agrocota/. Após publicar nessa estrutura, o endereço poderá ser https://www.satiroramos.com/sistemas/agrocota/agrocota-fertilizantes.html. O caminho é ilustrativo e depende da organização do servidor.
Modos de acesso
Automático: usa o PHP na mesma pasta quando detectado; sem ele, tenta acesso direto. Pelo servidor (PHP): exige a ponte instalada e funcionando. Direto no navegador: consulta as fontes pelo navegador e pode estar sujeito a bloqueios de origem.
Atualização da versão anterior
Guarde uma cópia dos arquivos anteriores, substitua HTML e PHP e recarregue com Ctrl + F5. Confira “Versão 1.1”. No WordPress, use um link de menu para a página independente; não cole o PHP em um bloco HTML.
9. Glossário, limites e fontes
| Termo | Significado neste sistema |
| US$/t e R$/t | Dólares ou reais por tonelada de produto. Uma tonelada corresponde a 1.000 kg. |
| FOB e CIF | Bases de valor da importação. CIF acrescenta frete internacional e seguro ao FOB. |
| NCM | Classificação de mercadorias utilizada para definir o grupo consultado. |
| PTAX | Taxa de câmbio de referência publicada pelo Banco Central; o sistema usa a cotação de venda. |
| Cache | Armazenamento temporário de respostas já obtidas para reduzir chamadas às fontes. |
| Cobertura 12/12 | Doze meses com preço calculável dentro da janela de 12 meses analisada. |
Uso adequado dos resultados
Use os indicadores para acompanhar o histórico e comparar médias mensais. Para avaliar uma compra, considere também a especificação do fertilizante, os custos locais e a proposta comercial. O AgroCota não apura o preço final entregue na propriedade.
Os dados podem ser revisados pelo MDIC. A disponibilidade depende das fontes externas. A versão 1.1 não oferece exportação nativa para Excel ou PDF, comparação simultânea de vários fertilizantes, preços de lojas ou conversão histórica mensal do câmbio.
Fontes e documentação
Links de consulta das fontes utilizadas no sistema e neste manual. Verificação da versão: 6 de outubro de 2026.
MDIC — Comex Stat: portal de consulta
MDIC — Dados abertos e metodologia da base
MDIC — Disponibilização de API, CIF, frete e seguro
Banco Central — Dólar comercial e PTAX
Receita Federal — Nomenclatura Comum do Mercosul
Base funcional do manual: arquivos agrocota-fertilizantes.html, agrocota-api.php e LEIA-ME.txt da versão 1.1. A interface e o comportamento descritos foram conferidos nesses arquivos.