Zarc-NM-docs
API Zarc NM (SiNM)
🧭 Procurando outra coisa? O Início é o mapa da documentação — integração, credenciamento, processo de entregas e referência de campos.
O SiNM foi desenvolvido com o propósito de receber dados relacionados à glebas (ou talhões) produtivas e a partir dos dados recebidos, classificar a gleba de acordo com o seu nível de manejo, seguindo a metodologia de classificação publicada em 2022 pela Embrapa com o título "Níveis de manejo do solo para avaliação de riscos climáticos na cultura da soja." (DEBIASI, H.; MONTEIRO, J. E. B. de A.; FRANCHINI, J. C.; FARIAS, J. R. B.; CONTE, O.; CUNHA, G. R. da; MORAES, M. T. de; BALBINOT JUNIOR, A. A.; SILVA, F. A. M. da; EVANGELISTA, B. A.; MARAFON, A. C.).
Requisitos
Os principais requisitos que guiaram a construção da API são listados abaixo:
- Aplicar todas as regras de cálculo da classificação de nível de manejo (níveis de 1 a 4) de forma flexível para que as regras possam ser alteradas de maneira simples, assim como novas regras possam ser incorporadas e/ou removidas.
- As regras de cálculo precisam ser versionadas para que haja rastreabilidade entre classificações já realizadas e regras/parâmetros aplicados.
- Os dados das glebas precisam ser geolocalizados, para que se possa criar mecanismos de verificação via monitoramento por imagens de satélite/drone.
- Tanto os dados das glebas enviados para a API, quanto os dados de classif icação gerados pela aplicação das regras precisam ser armazenados em banco de dados para posterior consulta e auditoria.
- Permitir que parceiros possam enviar dados automaticamente via sistemas/máquinas.
- Os dados da gleba relacionados às características da gleba (propriedade, localização) ao histórico de cultivo (diversidade de culturas ao longo do tempo) e de operações de manejo realizadas serão enviados em um endpoint específico com permissão a um perfil de usuário (Operador de Contratos).
- Os dados da gleba relacionados à análise de amostras de solo (variáveis químico, físico e orgânicas do solo) serão enviadas em um endpoint específico com permissão a um perfil de usuário (Operador de Análise de Solo).
- Os dados da gleba relacionados ao sensoriamento remoto, tais como índices vegetativos, interpretação de culturas e datas de operações serão enviadas em um endpoint específico com permissão a um perfil de usuário (Operador de Sensoriamento Remoto).
- O score final relacionado à classificação de nível de manejo de uma gleba será dado por um conjunto de regras definidas.
- As consultas ao resultado de uma classificação de nível de manejo para uma gleba retornarão apenas o score final de classificação da gleba.
Principais atores interessados:
Arquitetura
Visão geral do SiNM:
Visão Arquitetural do SiNM:
Autorização e Níveis de Acesso
Autorização no SiNM — Guia para Clientes e Integradores.
Homologação de integradores
Parceiro novo? Veja o Guia de Homologação — do formulário de credenciamento ao fluxo de teste ponta a ponta no ambiente de homologação (hml).
Acesso ao ambiente de produção
Produção é para dados reais e só para operadores credenciados. O credenciamento exige dois documentos: o Formulário de Credenciamento e os Termos de Uso e de Responsabilidades assinados digitalmente via gov.br. Se este é seu primeiro contato com o SiNM, prefira a homologação antes.
Requisitos, documentos e resumo dos Termos: Acesso ao Ambiente de Produção.
Versões da API: v1 e v2
Análise de solo e sensoriamento remoto existem em duas versões, com exatamente a mesma semântica, as mesmas regras de negócio e a mesma autorização. O que muda é só a forma do payload: o v2 abandonou nomes de campo que ficaram confusos ao longo do tempo.
/api/v1 (congelado) |
/api/v2 (limpo) |
|
|---|---|---|
| Análise de solo | /api/v1/analises-solo/{quimica,fisica} |
/api/v2/analises-solo/{quimica,fisica} |
| Sensoriamento remoto | /api/v1/sensoriamentos-remotos |
/api/v2/sensoriamentos-remotos |
cnpj (CNPJ da propriedade) |
aceito e devolvido | só cnpjPropriedade |
cnpjProdutor (listagem de sensoriamento) |
devolvido | só cnpjPropriedade |
betaGlicosidade |
aceito | só betaGlicosidase |
Nó laboratorio |
aceito¹ | só cnpjLaboratorio |
Você não precisa executar nada agora. O /api/v1 está congelado, não tem data de
desligamento, e a remoção dos nomes legados que havia sido anunciada para a virada de safra foi
cancelada (Cf.
Mudanças Obrigatórias). O
quando migrar é escolha sua.
📌 Mas planeje-se. Congelado significa que o v1 não recebe mais evolução de contrato — só o v2 recebe — e que ele será depreciado num futuro próximo. A migração para o/api/v2vai ser necessária em algum momento; trate a troca de rota e dos nomes de campo como item de backlog de um próximo release, não como algo indefinido. O desligamento não é automático: ele só acontece quando o uso residual for praticamente nulo e é comunicado à parte, com antecedência, em Mudanças Obrigatórias.
⚠️ Se decidir migrar. Enviar um nome antigo para o v2 não devolve erro — a chave é ignorada e o valor descartado em silêncio, como qualquer campo desconhecido. Não conte com um400para descobrir que esqueceu de trocar um campo: migre a rota e os nomes de campo juntos, ou permaneça no v1. No Swagger, as seções terminadas em (v1) e (v2) separam as duas versões.
¹ O nó laboratorio continua aceito no v1, sem prazo — a descontinuação anunciada para
29/08/2026 foi cancelada no v1. No v2 ele não existe e o cnpjLaboratorio é obrigatório
(a falta dele devolve 400) — Cf.
Mudanças Obrigatórias.
Os demais recursos (gleba/talhão, classificação, culturas, satélites) existem só no v1: eles não sofreram nenhuma alteração de contrato, e por isso não precisaram de uma versão nova.
Como usar?
📌 Para explorar e testar os endpoints, use a Documentação Swagger de cada ambiente (botão Authorize para autenticar) e o Dicionário de Dados para o significado de cada campo. O passo a passo abaixo mostra como autenticar e usar a API com qualquer cliente HTTP.
1. Autenticação de usuário
Para ter acesso ao SiNM o usuário precisa estar autenticado. A autenticação é realizada via protocolo OpenId Connect (OIDC) usando o fluxo Password Credentials da especificação OAuth2: a aplicação cliente troca as credenciais da empresa e do usuário por um token de acesso no Keycloak e envia esse token em cada requisição ao SiNM.
O endpoint de obtenção de token de cada ambiente é:
| Ambiente | Endpoint de token |
|---|---|
| Homologação e Testes | https://www.keycloak.cnptia.embrapa.br/realms/zarcnm-h/protocol/openid-connect/token |
| Produção | https://www.keycloak.cnptia.embrapa.br/realms/zarcnm/protocol/openid-connect/token |
Exemplo de requisição de token (ambiente de homologação), com qualquer cliente HTTP — aqui, curl:
curl -X POST 'https://www.keycloak.cnptia.embrapa.br/realms/zarcnm-h/protocol/openid-connect/token' \
-H 'Content-Type: application/x-www-form-urlencoded' \
-d 'grant_type=password' \
-d 'client_id=<CNPJ da empresa, somente dígitos>' \
-d 'client_secret=<Client Secret da empresa>' \
-d 'username=<e-mail do usuário>' \
-d 'password=<senha do usuário no Keycloak>'A resposta traz o campo access_token (um JWT) e o campo expires_in (validade em segundos). Enquanto o token estiver válido, envie-o em toda requisição ao SiNM no cabeçalho HTTP Authorization: Bearer <access_token>. Quando expirar, basta repetir a requisição de token.
O fluxo, do pedido de token à resposta do SiNM:
-
a aplicação cliente envia as credenciais ao Keycloak;
-
o Keycloak valida as credenciais e devolve o token de acesso;
-
a aplicação envia a requisição ao SiNM com o token;
-
o SiNM verifica a autenticidade e a validade do token;
-
o SiNM responde à aplicação cliente.
Para testar os endpoints diretamente pelo navegador, abra a Documentação Swagger do ambiente desejado, clique no botão Authorize e informe as mesmas credenciais (Client ID, Client Secret, Username e Password) — a partir daí, o botão Try it out de cada endpoint já envia as requisições autenticadas.
Em caso de problemas com senha, Client Secret ou cadastro, consulte Ajuda — Problemas de Autenticação. Os perfis de acesso (papéis) exigidos por cada endpoint estão descritos em Autorização no SiNM.
2. Envio de dados da gleba/talhão
Dados da gleba/talhão (propriedade, glebas, culturas e manejos). Essas informações são necessárias para dar início ao processo de classificação da gleba/talhão, para a qual se deseja obter o nível de manejo. Após realizar o processo de autenticação descrito na Subseção Autenticação de usuário, o envio é feito com o perfil Operador de Contratos por:
POST /api/v1/glebasA estrutura completa do corpo da requisição (e exemplos prontos) está na Documentação Swagger; o significado de cada campo está no Dicionário de Dados. Neste payload, o CNPJ da propriedade é informado no campo propriedade.cnpj.
Se todas as informações enviadas no cabeçalho e no corpo da requisição estiverem corretas, o SiNM retorna o código 201 Created - HTTP Status informando que o recurso foi criado com sucesso. No corpo da resposta são retornados os dados que foram enviados na requisição e uma chave nomeada de chave da classificação de nível de manejo - chaveClassificacaoNM — que deverá ser guardada. Esta chave será a identificação usada para envio posterior dos dados de análise de solo, de sensoriamento remoto e de consulta ao nível de manejo calculado.
3. Envio de dados de análise de solo
Dados de análise de solo (do conjunto de amostras de solo). Essas informações são necessárias para dar continuidade no processo de classificação após cadastro da(s) gleba(s). Para enviar estes dados, o usuário deve estar autenticado (Cf. Subseção Autenticação de usuário) com o perfil Operador de Análise de Solo e precisa ter a chave chaveClassificacaoNM gerada com o cadastro da gleba na etapa anterior.
A análise de solo é tratada como duas análises independentes — uma química e uma física. Os endpoints recomendados são os endpoints por tipo:
POST /api/v1/analises-solo/quimica/{chaveClassificacaoNM}
POST /api/v1/analises-solo/fisica/{chaveClassificacaoNM}Cada tipo também oferece GET (consulta por uuid e listagem) e PUT (atualização por uuid). O envio combinado POST /api/v1/analises-solo/{chaveClassificacaoNM} (com amostrasQuimicas e amostrasFisicas no mesmo corpo) segue aceito por compatibilidade e cria as duas metades automaticamente, mas está descontinuado (deprecated) junto com a listagem combinada GET /api/v1/analises-solo — prefira os endpoints por tipo.
Campos importantes do payload:
cnpjPropriedade— nome canônico do CNPJ da propriedade. O nome legadocnpjsegue aceito no/api/v1, sem data de remoção — a remoção que havia sido anunciada foi cancelada (Cf. Mudanças Obrigatórias). Quem quiser o payload já limpo pode usar o/api/v2. O CNPJ informado localiza a propriedade cadastrada: quando não resolve para exatamente uma, o envio é aceito com a inconsistência RN24 (Cf. Dicionário de Dados).cnpjLaboratorio— CNPJ do laboratório responsável, no nível da análise. No/api/v2é obrigatório e é a única forma de informar o laboratório; no/api/v1o nólaboratoriosegue aceito (Cf. Mudanças Obrigatórias).amostrasQuimicas[].camada/amostrasFisicas[].camada— códigos de profundidade (Cf. Códigos de camada).
A estrutura completa dos corpos de requisição está na Documentação Swagger e o significado de cada campo no Dicionário de Dados. Se todas as informações estiverem corretas, o SiNM retorna o código 201 Created - HTTP Status com os dados enviados no corpo da resposta.
Antes de solicitar uma nova análise, é possível descobrir se o produtor já tem análises válidas — sem expor o conteúdo delas — com GET /api/v1/analises-solo/disponiveis?cpf={cpf}&dataReferencia={yyyy-MM-dd}. Cada item traz o uuidAnaliseSolo, que permite consultar a análise em GET /api/v1/analises-solo/quimica/{uuid} ou /fisica/{uuid}, conforme a lista de onde o item veio. O uuid identifica, não autoriza: a consulta segue exigindo as mesmas permissões (Cf. Dicionário de Dados).
4. Envio de dados de sensoriamento remoto
Dados de sensoriamento remoto relacionados à gleba/talhão para a qual foi solicitada uma classificação de nível de manejo. Os dados de geoprocessamento serão necessários para validar as informações fornecidas pelo agente do contrato no processo de classificação das glebas/talhões. Para realizar o envio desses dados, o usuário deve estar autenticado (Cf. Subseção Autenticação de usuário) com o perfil Operador de Sensoriamento Remoto e precisa ter a chave chaveClassificacaoNM gerada com o cadastro da gleba na etapa anterior.
O envio é feito passando a chave na URL:
POST /api/v1/sensoriamentos-remotos/{chaveClassificacaoNM}Também estão disponíveis GET /api/v1/sensoriamentos-remotos (listagem), GET /api/v1/sensoriamentos-remotos/{uuid} (consulta individual) e PUT /api/v1/sensoriamentos-remotos/{uuid} (atualização).
Campos importantes do payload (MonitoramentoSateliteInput):
cnpjPropriedade— nome canônico do CNPJ da propriedade. O nome legadocnpjsegue aceito no/api/v1, sem data de remoção — a remoção que havia sido anunciada foi cancelada (Cf. Mudanças Obrigatórias). Quem quiser o payload já limpo pode usar o/api/v2. O CNPJ informado localiza a propriedade cadastrada: quando não resolve para exatamente uma, o envio é aceito com a inconsistência RN24 (Cf. Dicionário de Dados).cnpjEmpresaSensoriamento— CNPJ da empresa de sensoriamento responsável pelos dados (opcional).indices[].codigoSatelitee demais camposcodigoSatelite*— códigos do satélite de origem (Cf. Códigos de satélite).
A estrutura completa do corpo da requisição está na Documentação Swagger e o significado de cada campo no Dicionário de Dados. Se todas as informações estiverem corretas, o SiNM retorna o código 201 Created - HTTP Status com os dados enviados no corpo da resposta. Além disso, logo após o envio desses dados, é realizado o cálculo da classificação de nível de manejo para a gleba/talhão referente à chave informada. E o usuário pode consultar o resultado da classificação no SiNM (Cf. Subseção Consulta da classificação de nível de manejo).
5. Consulta da classificação de nível de manejo
Uma vez que o registro dos dados obrigatórios tenha sido finalizado e o cálculo da classificação tenha ocorrido, é possível consultar a classificação do nível de manejo de uma determinada gleba/talhão no SiNM. Para a consulta, o usuário deve estar autenticado (Cf. Subseção Autenticação de usuário) e precisa ter a chave chaveClassificacaoNM gerada com o cadastro de uma determinada gleba/talhão.
A consulta é feita passando a chave na URL:
GET /api/v1/classificacoes/{chaveClassificacaoNM}Também é possível listar todas as classificações às quais o usuário tem acesso com GET /api/v1/classificacoes.
Se todas as informações enviadas no cabeçalho da requisição estiverem corretas, o SiNM retorna o código 200 OK - HTTP Status informando que o recurso foi encontrado. No corpo da resposta é retornada a chave da classificação (chaveClassificacaoNM), o score final (nível de manejo), a data e hora em que se chegou a esse resultado (dataCalculo), a data e hora do último recálculo (dataUltimoCalculo) e uma lista de inconsistências, se houver dados inconsistentes. Cada item traz o tipo, a descrição, a data e hora do registro e — a partir da v8.2026 — grupoDado (GLEBA, ANALISE_SOLO ou MONITORAMENTO_SATELITE) e uuidEnvio, que dizem exatamente qual envio precisa ser corrigido (Cf. Dicionário de Dados). Se o usuário tentar consultar o resultado de uma classificação que ainda não foi finalizada, o SiNM retorna o código 404 Not Found - HTTP Status e uma mensagem informando qual ou quais dado(s) estão faltando para finalizar o cálculo de classificação de nível de manejo.
A lista traz apenas as inconsistências vigentes — as do envio mais recente de cada dado —, então o que sumiu da lista é o que você já corrigiu. GET /api/v1/classificacoes/{chave}?incluirSuperadas=true devolve o histórico completo, com o campo vigente (true/false) em cada item; o parâmetro vale igualmente para GET /api/v1/niveis-manejo/{chave}. A listagem GET /api/v1/classificacoes não traz inconsistências — ela devolve chave, score, dataCalculo e dataUltimoCalculo de cada classificação.
dataCalculo só muda quando o resultado muda; dataUltimoCalculo (a partir da v10.2026) avança a cada recálculo, inclusive quando ele chega à mesma nota (Cf. Dicionário de Dados).
6. Racional da classificação (por que esse nível de manejo?)
Além do score final, o SiNM expõe o racional do cálculo — uma explicação de por que a gleba/talhão recebeu aquele nível de manejo. É útil para o integrador justificar o resultado ao produtor e identificar pontos de melhoria no manejo.
Para cada indicador, o racional diz o que melhorar primeiro: regraDeterminante e limitantesPrincipais[] na classificação, papelNaNota e contribuicao em cada indicador.
A consulta é feita pelo método GET, informando a chave da classificação:
GET /api/v1/classificacoes/{chaveClassificacaoNM}/racionalPontos de atenção:
- Apenas para a classificação completa. O racional só existe para a classificação completa (com dados de análise de solo e de sensoriamento remoto). Para uma classificação preliminar ou ainda em processamento, o
SiNMretorna 404 Not Found — não há racional de preliminar. - Quem tem a chave consulta. A autorização é a mesma da consulta da classificação.
- A resposta tem duas formas, conforme o perfil do token:
- Com o perfil Operador de Análise de Solo, cada indicador vem com valor medido, unidade, faixa, score parcial e
contribuicao(projeção completa). - Sem esse perfil (ex.: Operador de Contratos), cada indicador vem apenas com nome, origem,
papelNaNotaeefeitoNaNota(projeção compacta) — sem expor valores da análise de solo. - A explicação da nota —
regraDeterminante,limitantesPrincipais[],fatoresRestritivos[]epapelNaNota— é sempre visível, nas duas projeções: diz o motivo da nota sem revelar valores medidos.
- Com o perfil Operador de Análise de Solo, cada indicador vem com valor medido, unidade, faixa, score parcial e
O corpo da resposta traz, em ambas as formas:
| Campo | Descrição |
|---|---|
chaveClassificacaoNM |
Chave da classificação. |
scoreFinal |
Nível de manejo final (1 a 4). |
scoreMedio |
Média dos 6 indicadores, antes de eventuais fatores restritivos. |
dataCalculo |
Data/hora em que se chegou ao resultado atual. Não muda quando um recálculo chega à mesma nota. |
dataUltimoCalculo |
Data/hora do último recálculo da classificação. Igual a dataCalculo quando o último cálculo produziu o resultado atual; posterior, quando houve recálculo de mesmo resultado. |
regraDeterminante |
Qual regra fixou a nota. BANDA_DA_MEDIA quando a nota veio mesmo da média; caso contrário, a regra de teto que a travou — DOIS_OU_MAIS_NM1, DOIS_OU_MAIS_NM2, UM_NM1_UM_NM2, SATURACAO_ALUMINIO_CRITICA, SATURACAO_ALUMINIO_ALTA, CULTURA_EM_SUCESSAO (mesma espécie da cultura-alvo em sucessão — soja ou milho; até a v9.2026 vinha como SOJA_EM_SUCESSAO, ver Mudanças Obrigatórias), LEGUMINOSAS_EM_SUCESSAO, DECLIVIDADE_ACENTUADA. Em classificações antigas, um rebaixamento cuja regra exata não é mais recuperável vem como TETO_AMBIENTAL. Sempre visível. |
limitantesPrincipais[] |
Nomes dos indicadores que foram o gatilho da regraDeterminante — são exatamente os que vêm com papelNaNota = LIMITANTE_PRINCIPAL. Vazio quando não há limitante identificável (ex.: NM4, o topo da escala). Sempre visível. |
indicadores[] |
Lista dos 6 indicadores. Cada item sempre traz nome, origem (ANALISE_SOLO/MANEJO/SENSORIAMENTO_REMOTO), papelNaNota e efeitoNaNota (ELEVOU/REBAIXOU/NEUTRO, depreciado); na projeção completa traz também contribuicao, valor, unidade, faixa e scoreParcial. |
fatoresRestritivos[] |
Fatores que rebaixaram a nota abaixo do que a média indicaria (ex.: soja em sucessão, declividade acentuada). Nunca vem vazio quando houve rebaixamento — sempre que a nota final fica abaixo da faixa do scoreMedio, há ao menos um fator descrito aqui. Vazio quando não houve rebaixamento — seja porque a nota veio da média (BANDA_DA_MEDIA), seja porque a regra de teto coincidiu com a faixa da média e não baixou nada. Sempre visível. Cada item traz fator, descricao, scoreAntes e scoreDepois. |
memoriaCalculo |
Narrativa legível do raciocínio. |
Em cada indicador, dois campos respondem perguntas diferentes:
| Campo do indicador | Valores | O que responde |
|---|---|---|
papelNaNota |
LIMITANTE_PRINCIPAL · LIMITANTE · FAVORAVEL · ALINHADO |
O que melhorar primeiro. LIMITANTE_PRINCIPAL é o gatilho da regraDeterminante — o que precisa mudar para a nota subir. LIMITANTE segura a nota, mas não é o decisivo. FAVORAVEL está acima da nota: é força de manejo que não elevou porque o teto limitou. ALINHADO acompanha a nota sem puxar (típico em NM4). |
contribuicao |
ACIMA · NA_MEDIA · ABAIXO |
Posição do indicador em relação ao scoreMedio — não à nota final. Só na projeção completa. |
Cada regra de teto tem um texto fixo. Quando ela rebaixa a nota, o item de fatoresRestritivos[] traz o nome da regra em fator e o texto em descricao:
regraDeterminante / fator |
descricao |
|---|---|
DECLIVIDADE_ACENTUADA |
Declividade média ≥ 3% sem histórico de plantio em contorno — teto de NM1 |
CULTURA_EM_SUCESSAO |
Cultivos consecutivos da mesma espécie da cultura-alvo em sucessão, sem rotação (soja sobre soja quando o alvo é soja; milho sobre milho quando o alvo é milho) — teto de NM1 |
DOIS_OU_MAIS_NM1 |
Dois ou mais indicadores em nível 1 — teto de NM1 |
DOIS_OU_MAIS_NM2 |
Dois ou mais indicadores em nível 2 — teto de NM2 |
UM_NM1_UM_NM2 |
Um indicador em nível 1 e outro em nível 2 — teto de NM2 |
SATURACAO_ALUMINIO_CRITICA |
Saturação de alumínio em nível crítico (NM1) — teto de NM2 |
SATURACAO_ALUMINIO_ALTA |
Saturação de alumínio em nível 2 — teto de NM3 |
LEGUMINOSAS_EM_SUCESSAO |
Cultivos da mesma família botânica da cultura-alvo em sucessão, sem intercalação (soja após feijão quando o alvo é soja; milho após trigo quando o alvo é milho); culturas de cobertura do solo e de pastagem valem como intercalação e não rebaixam — teto de NM2 |
TETO_AMBIENTAL |
Nota limitada por fator de manejo/ambiental abaixo da média — regra determinante não recuperável sem o snapshot do cálculo |
Com milho como cultura-alvo: milho sobre milho é CULTURA_EM_SUCESSAO (NM1); gramínea sobre gramínea — milho após trigo, por exemplo — é LEGUMINOSAS_EM_SUCESSAO (NM2). O nome LEGUMINOSAS_... é mantido por compatibilidade; a regra vale para a família botânica da cultura-alvo, seja ela qual for. BANDA_DA_MEDIA não rebaixa e, por isso, nunca aparece em fatoresRestritivos[].
O racional acompanha o último recálculo. Quando um envio novo é recalculado e chega à mesma nota, o racional passa a descrever esse cálculo — os indicadores medidos e a regraDeterminante podem mudar sem a nota mudar (ex.: a declividade cai abaixo de 3% e a nota continua NM1, agora por outra regra). dataUltimoCalculo diz quando foi esse cálculo.
Os detalhes de cada campo e exemplos das duas projeções estão na Documentação Swagger da API.
⚠️ efeitoNaNotaestá depreciado — não use para decidir o que melhorar. Ele compara cada indicador com a nota final, então engana quando a nota foi fixada por uma regra de teto em vez da média: com a nota travada em NM1, nenhum indicador pode ficar abaixo dela — os indicadores que causaram o NM1 aparecem comoNEUTROe os fortes comoELEVOU, como se tivessem ajudado. O campo continua na resposta, com o mesmo comportamento (nada quebra), mas a leitura correta agora éregraDeterminante+limitantesPrincipais[]+papelNaNotapara a causa, econtribuicaopara a posição. Uma eventual remoção doefeitoNaNotaserá comunicada com antecedência em Mudanças Obrigatórias.
7. Lista de culturas
Para enviar os dados de uma determinada gleba/talhão (Cf. Subseção Envio de dados da gleba/talhão), é preciso informar as culturas cultivadas na gleba/talhão durante o período de três anos. Essa informação é adicionada no campo codigo, do objeto cultura presente na lista de producoes que compõe os dados da gleba/talhão (Cf. Dicionário de Dados).
Para auxiliar o usuário na hora de adicionar essa informação, o SiNM disponibiliza uma lista com os nomes e códigos das culturas que ele aceita:
GET /api/v1/culturasSe todas as informações enviadas no cabeçalho da requisição estiverem corretas, o SiNM retorna o código 200 OK - HTTP Status e, no corpo da resposta, a lista contendo todos os nomes e códigos das culturas.
A lista traz todas as culturas aceitas no histórico de cultivos e não indica quais podem ser classificadas. Cultura-alvo são só soja (grão), 001, e milho (grão), 002. As variantes de silagem/feno — Milho (silagem/feno) é o código 072 — entram no histórico, mas não são alvo: no /api/v2/glebas são recusadas com 400 em culturaAlvo; no /api/v1, uma produção a classificar com elas é calculada como soja e devolve a inconsistência Cultura-alvo não suportada (ver Dicionário de Dados).
8. Códigos de satélite
No envio de dados de sensoriamento remoto (Cf. Subseção Envio de dados de sensoriamento remoto), os campos que identificam o satélite de origem (indices[].codigoSatelite, codigoSateliteDeclividadeMedia e, quando aplicável, codigoSatelitePlantioContorno e codigoSateliteTerraceamento) usam um código de 3 caracteres. A relação dos códigos aceitos e o comportamento em caso de código desconhecido estão documentados em Códigos de satélite. A lista vigente também pode ser consultada pela API em GET /api/v1/satelites.
9. Códigos de camada
No envio de dados de análise de solo (Cf. Subseção Envio de dados de análise de solo), o campo camada de cada amostra (amostrasQuimicas[].camada e amostrasFisicas[].camada) usa um código de 6 caracteres que identifica a profundidade (ex.: 00_020 para 0–20 cm). A relação dos códigos aceitos e o comportamento quando o código não é reconhecido (a amostra é preservada e uma inconsistência é registrada na classificação) estão documentados em Códigos de camada.
Links úteis
-
Documentação Swagger da API (Ambiente Homologação e Testes)
-
Documentação Swagger da API (Ambiente Produção)
-
Dicionário de Dados dos Payloads (significado de cada entidade e campo dos envios — complementa o Swagger)
-
Formulário de Credenciamento ao SiNM (online, um por ambiente): homologação · produção — preencha, assine no gov.br o PDF gerado e devolva pelo link do e-mail
-
Acesso ao Ambiente de Produção (credenciamento em produção: formulário e Termos de Uso assinados via gov.br)
-
Termos de Uso e de Responsabilidades do SiNM (versão vigente e anteriores; assinatura obrigatória para acesso à produção)
-
Ajuda — Problemas de Autenticação (esqueci a senha, recuperar Client Secret, sem cadastro)
-
E-mails para contato:
credenciamentoNM@embrapa.br (documentação e credenciamento)
suporteNM@embrapa.br (específico para questões técnicas do sistema e TI)
zarcNM@embrapa.br (assuntos diversos, dúvidas, metodologia)
-
Plano de desenvolvimento e evolução do SINM
As novas funcionalidades implementadas e os planos de novas evoluções podem ser consultadas aqui. Precisa se adaptar a alguma mudança obrigatória? Veja o Registro de Mudanças Obrigatórias.











