{"openapi":"3.0.0","info":{"title":"Agritec","description":"API Agritec reúne informações úteis para o gerenciamento da produção de culturas agrícolas. Contempla a oferta de dados e modelos sobre: (i) época\nideal de plantio para dezenas de culturas, com base no Zoneamento Agrícola de Risco Climático (Zarc); (ii) relação de cultivares mais aptas, para 12 culturas\n(Arroz, Algodão, Amendoim, Cevada, Feijão, Feijão Caupi, Girassol, Mamona, Milho, Soja, Sorgo e Trigo) diferentes; (iii) indicação de adubação e\ncorreção de solo conforme resultado prévio de análise de solo, previsão de produtividade e condições climáticas antes e durante a safra para cinco\nculturas (Arroz, Feijão, Milho, Soja e Trigo).\n","version":"v2"},"tags":[{"name":"Cultivares","description":"Recursos da API envolvendo informações de cultivares."},{"name":"Culturas","description":"Recursos da API envolvendo informações de culturas."},{"name":"Health","description":"Verifica a disponibilidade do funcionamento da API."},{"name":"Municípios","description":"Recursos da API envolvendo informações de municípios brasileiros."},{"name":"Obtentores","description":"Recursos da API envolvendo informações de organizações obtentoras/mantenedoras de cultivares."},{"name":"Produtividade","description":"Recursos da API que fornece a estimativa de produtividade em função do local, data de plantio e da cultura informada."},{"name":"Solos","description":"Recursos da API envolvendo informações de solos."},{"name":"Zoneamento","description":"Recursos da API envolvendo informações do Zoneamento Agrícola de Risco Climático (Zarc)."}],"paths":{"/zoneamento":{"get":{"tags":["Zoneamento"],"summary":"Serviço informa a melhor janela de plantio baseado no Zoneamento Agrícola de Risco Climático (Zarc) para riscos de 20%, 30% ou 40%.\nEste valor indica o risco de insucesso do empreendimento pretendido de data indicada for selecionada.\n","description":"Retorna as datas de plantio com base no Zoneamento Agrícola de Risco Climático (Zarc).","operationId":"find","parameters":[{"name":"idCultura","in":"query","description":"Identificador da cultura da qual se quer obter informações do Zarc","required":true,"schema":{"type":"integer"},"example":60},{"name":"codigoIBGE","in":"query","description":"Código IBGE do município da qual se quer obter informações do Zarc","required":true,"schema":{"type":"integer"},"example":3502804},{"name":"risco","in":"query","description":"Risco máximo admitido na recuperação do zoneamento de risco climático. Os valores possíveis são: 20, 30, 40 ou todos. Que correspondem aos riscos de 20%, 30% e 40%.\nCaso não seja informado, o risco de 20% será recuperado.\n","required":true,"schema":{"type":"string","enum":["20","30","40","todos"],"default":"20"},"example":20}],"responses":{"200":{"description":"Dados do Zarc","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ZoneamentoResponse"},"example":{"meta":{"totalCount":18},"data":[{"municipio":"ARACATUBA","uf":"SP","cultura":"SOJA","culturaNomeCompleto":"SOJA SEQUEIRO","culturaSafra":"não informado","culturaCultivo":"SEQUEIRO","culturaClima":"Não se aplica","ciclo":"GRUPO I","solo":"AD1","diaIni":21,"mesIni":11,"diaFim":30,"mesFim":11,"safraIni":2025,"safraFim":2026,"risco":20,"portaria":"Port. 381 de 26/06/2025"},{"municipio":"ARACATUBA","uf":"SP","cultura":"SOJA","culturaNomeCompleto":"SOJA SEQUEIRO","culturaSafra":"não informado","culturaCultivo":"SEQUEIRO","culturaClima":"Não se aplica","ciclo":"GRUPO I","solo":"AD2","diaIni":21,"mesIni":10,"diaFim":31,"mesFim":12,"safraIni":2025,"safraFim":2026,"risco":20,"portaria":"Port. 381 de 26/06/2025"},{"municipio":"ARACATUBA","uf":"SP","cultura":"SOJA","culturaNomeCompleto":"SOJA SEQUEIRO","culturaSafra":"não informado","culturaCultivo":"SEQUEIRO","culturaClima":"Não se aplica","ciclo":"GRUPO I","solo":"AD3","diaIni":21,"mesIni":10,"diaFim":31,"mesFim":12,"safraIni":2025,"safraFim":2026,"risco":20,"portaria":"Port. 381 de 26/06/2025"},{"municipio":"ARACATUBA","uf":"SP","cultura":"SOJA","culturaNomeCompleto":"SOJA SEQUEIRO","culturaSafra":"não informado","culturaCultivo":"SEQUEIRO","culturaClima":"Não se aplica","ciclo":"GRUPO I","solo":"AD4","diaIni":11,"mesIni":10,"diaFim":31,"mesFim":12,"safraIni":2025,"safraFim":2026,"risco":20,"portaria":"Port. 381 de 26/06/2025"},{"municipio":"ARACATUBA","uf":"SP","cultura":"SOJA","culturaNomeCompleto":"SOJA SEQUEIRO","culturaSafra":"não informado","culturaCultivo":"SEQUEIRO","culturaClima":"Não se aplica","ciclo":"GRUPO I","solo":"AD5","diaIni":11,"mesIni":10,"diaFim":31,"mesFim":12,"safraIni":2025,"safraFim":2026,"risco":20,"portaria":"Port. 381 de 26/06/2025"},{"municipio":"ARACATUBA","uf":"SP","cultura":"SOJA","culturaNomeCompleto":"SOJA SEQUEIRO","culturaSafra":"não informado","culturaCultivo":"SEQUEIRO","culturaClima":"Não se aplica","ciclo":"GRUPO I","solo":"AD6","diaIni":11,"mesIni":10,"diaFim":31,"mesFim":12,"safraIni":2025,"safraFim":2026,"risco":20,"portaria":"Port. 381 de 26/06/2025"},{"municipio":"ARACATUBA","uf":"SP","cultura":"SOJA","culturaNomeCompleto":"SOJA SEQUEIRO","culturaSafra":"não informado","culturaCultivo":"SEQUEIRO","culturaClima":"Não se aplica","ciclo":"GRUPO II","solo":"AD1","diaIni":11,"mesIni":11,"diaFim":30,"mesFim":11,"safraIni":2025,"safraFim":2026,"risco":20,"portaria":"Port. 381 de 26/06/2025"},{"municipio":"ARACATUBA","uf":"SP","cultura":"SOJA","culturaNomeCompleto":"SOJA SEQUEIRO","culturaSafra":"não informado","culturaCultivo":"SEQUEIRO","culturaClima":"Não se aplica","ciclo":"GRUPO II","solo":"AD2","diaIni":21,"mesIni":10,"diaFim":20,"mesFim":12,"safraIni":2025,"safraFim":2026,"risco":20,"portaria":"Port. 381 de 26/06/2025"},{"municipio":"ARACATUBA","uf":"SP","cultura":"SOJA","culturaNomeCompleto":"SOJA SEQUEIRO","culturaSafra":"não informado","culturaCultivo":"SEQUEIRO","culturaClima":"Não se aplica","ciclo":"GRUPO II","solo":"AD3","diaIni":11,"mesIni":10,"diaFim":31,"mesFim":12,"safraIni":2025,"safraFim":2026,"risco":20,"portaria":"Port. 381 de 26/06/2025"},{"municipio":"ARACATUBA","uf":"SP","cultura":"SOJA","culturaNomeCompleto":"SOJA SEQUEIRO","culturaSafra":"não informado","culturaCultivo":"SEQUEIRO","culturaClima":"Não se aplica","ciclo":"GRUPO II","solo":"AD4","diaIni":11,"mesIni":10,"diaFim":31,"mesFim":12,"safraIni":2025,"safraFim":2026,"risco":20,"portaria":"Port. 381 de 26/06/2025"},{"municipio":"ARACATUBA","uf":"SP","cultura":"SOJA","culturaNomeCompleto":"SOJA SEQUEIRO","culturaSafra":"não informado","culturaCultivo":"SEQUEIRO","culturaClima":"Não se aplica","ciclo":"GRUPO II","solo":"AD5","diaIni":11,"mesIni":10,"diaFim":31,"mesFim":12,"safraIni":2025,"safraFim":2026,"risco":20,"portaria":"Port. 381 de 26/06/2025"},{"municipio":"ARACATUBA","uf":"SP","cultura":"SOJA","culturaNomeCompleto":"SOJA SEQUEIRO","culturaSafra":"não informado","culturaCultivo":"SEQUEIRO","culturaClima":"Não se aplica","ciclo":"GRUPO II","solo":"AD6","diaIni":11,"mesIni":10,"diaFim":31,"mesFim":12,"safraIni":2025,"safraFim":2026,"risco":20,"portaria":"Port. 381 de 26/06/2025"},{"municipio":"ARACATUBA","uf":"SP","cultura":"SOJA","culturaNomeCompleto":"SOJA SEQUEIRO","culturaSafra":"não informado","culturaCultivo":"SEQUEIRO","culturaClima":"Não se aplica","ciclo":"GRUPO III","solo":"AD1","diaIni":1,"mesIni":11,"diaFim":30,"mesFim":11,"safraIni":2025,"safraFim":2026,"risco":20,"portaria":"Port. 381 de 26/06/2025"},{"municipio":"ARACATUBA","uf":"SP","cultura":"SOJA","culturaNomeCompleto":"SOJA SEQUEIRO","culturaSafra":"não informado","culturaCultivo":"SEQUEIRO","culturaClima":"Não se aplica","ciclo":"GRUPO III","solo":"AD2","diaIni":21,"mesIni":10,"diaFim":20,"mesFim":12,"safraIni":2025,"safraFim":2026,"risco":20,"portaria":"Port. 381 de 26/06/2025"},{"municipio":"ARACATUBA","uf":"SP","cultura":"SOJA","culturaNomeCompleto":"SOJA SEQUEIRO","culturaSafra":"não informado","culturaCultivo":"SEQUEIRO","culturaClima":"Não se aplica","ciclo":"GRUPO III","solo":"AD3","diaIni":11,"mesIni":10,"diaFim":31,"mesFim":12,"safraIni":2025,"safraFim":2026,"risco":20,"portaria":"Port. 381 de 26/06/2025"},{"municipio":"ARACATUBA","uf":"SP","cultura":"SOJA","culturaNomeCompleto":"SOJA SEQUEIRO","culturaSafra":"não informado","culturaCultivo":"SEQUEIRO","culturaClima":"Não se aplica","ciclo":"GRUPO III","solo":"AD4","diaIni":11,"mesIni":10,"diaFim":31,"mesFim":12,"safraIni":2025,"safraFim":2026,"risco":20,"portaria":"Port. 381 de 26/06/2025"},{"municipio":"ARACATUBA","uf":"SP","cultura":"SOJA","culturaNomeCompleto":"SOJA SEQUEIRO","culturaSafra":"não informado","culturaCultivo":"SEQUEIRO","culturaClima":"Não se aplica","ciclo":"GRUPO III","solo":"AD5","diaIni":11,"mesIni":10,"diaFim":31,"mesFim":12,"safraIni":2025,"safraFim":2026,"risco":20,"portaria":"Port. 381 de 26/06/2025"},{"municipio":"ARACATUBA","uf":"SP","cultura":"SOJA","culturaNomeCompleto":"SOJA SEQUEIRO","culturaSafra":"não informado","culturaCultivo":"SEQUEIRO","culturaClima":"Não se aplica","ciclo":"GRUPO III","solo":"AD6","diaIni":11,"mesIni":10,"diaFim":31,"mesFim":12,"safraIni":2025,"safraFim":2026,"risco":20,"portaria":"Port. 381 de 26/06/2025"}]}}}},"400":{"description":"Requisição inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":{"status":400,"timestamp":"2023-08-10T22:53:15.882848242-03:00","code":"dados-invalidos","summary":"A requisição não pode ser processada.","description":"A requisição não pode ser processada por motivo de validação de atributos.","fieldErrors":[{"field":"idCultura","entity":"cultura","summary":"Identificador da cultura não encontrado.","description":"Identificador da cultura não encontrado, utilize um identificador válido."},{"field":"codigoIBGE","entity":"municipio","summary":"Município não encontrado a partir do Código do IBGE informado.","description":"Município não encontrado a partir do Código do IBGE informado, utilize um Código do IBGE válido."},{"field":"risco","entity":"zoneamento","summary":"Risco de Zoneamento inválido.","description":"Risco de Zoneamento inválido, utilize um percentual de risco válido."}]}}}}},"500":{"description":"Erro interno inesperado no sistema.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":{"status":500,"timestamp":"2023-07-24T18:26:35.147239529-03:00","code":"erro-de-sistema","summary":"Ocorreu um erro interno inesperado no sistema. Tente novamente e se o problema persistir, entre em contato com o administrador do sistema.","description":"Ocorreu um erro interno inesperado no sistema. Tente novamente e se o problema persistir, entre em contato com o administrador do sistema."}}}}}},"x-auth-type":"Application & Application User","x-throttling-tier":"Unlimited"}},"/zoneamento/municipios/{codigoIBGE}/solos":{"get":{"tags":["Zoneamento"],"summary":"Lista de solos disponíveis para consulta dos dados do Zoneamento Agrícola de Risco Climático (Zarc).\n","description":"Lista de solos disponíveis para consulta dos dados do Zoneamento Agrícola de Risco Climático (Zarc).","operationId":"findSoloByMunicipio","parameters":[{"name":"codigoIBGE","in":"path","description":"Código IBGE do município da qual se quer obter informações do Zarc","required":true,"schema":{"type":"integer"},"example":3509502}],"responses":{"200":{"description":"Lista de solos disponíveis para consulta dos dados do Zoneamento Agrícola de Risco Climático (Zarc).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ZoneamentoMunicipioSolo"},"example":{"meta":{"totalCount":9},"data":["AD1","AD2","AD3","AD4","AD5","AD6","ARENOSO","ARGILOSO","TEXTURA MEDIA"]}}}},"400":{"description":"Requisição inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":{"status":400,"timestamp":"2024-07-26T11:43:33.796292434-03:00","code":"parametro-invalido","summary":"O parâmetro de URL: codigoIBGE recebeu o valor: 3509502A, que é de um tipo inválido. Corrija e informe um valor compatível com o tipo Integer.","description":"O parâmetro de URL: codigoIBGE recebeu o valor: 3509502A, que é de um tipo inválido. Corrija e informe um valor compatível com o tipo Integer."}}}}},"500":{"description":"Erro interno inesperado no sistema.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":{"status":500,"timestamp":"2023-07-24T18:26:35.147239529-03:00","code":"erro-de-sistema","summary":"Ocorreu um erro interno inesperado no sistema. Tente novamente e se o problema persistir, entre em contato com o administrador do sistema.","description":"Ocorreu um erro interno inesperado no sistema. Tente novamente e se o problema persistir, entre em contato com o administrador do sistema."}}}}}},"x-auth-type":"Application & Application User","x-throttling-tier":"Unlimited"}},"/zoneamento/municipios/{codigoIBGE}/solos/{solo}":{"get":{"tags":["Zoneamento"],"summary":"Serviço informa a melhor janela de plantio baseado no Zoneamento Agrícola de Risco Climático (Zarc) para riscos de 20%, 30% ou 40%.\nEste valor indica o risco de insucesso do empreendimento pretendido a partir da data indicada.\n","description":"Retorna as datas de plantio com base no Zoneamento Agrícola de Risco Climático (Zarc).","operationId":"findZoneamentoMunicipioBySolo","parameters":[{"name":"codigoIBGE","in":"path","description":"Código IBGE do município da qual se quer obter informações do Zarc","required":true,"schema":{"type":"integer"},"example":3509502},{"name":"solo","in":"path","description":"Tipo de solo da qual se quer obter informações do Zarc.\n","required":true,"schema":{"type":"string","enum":["ARENOSO","ARGILOSO","TEXTURA MEDIA","AD1","AD2","AD3","AD4","AD5","AD6"]},"example":"ARENOSO"}],"responses":{"200":{"description":"Retorna as datas de plantio com base no Zoneamento agrícola de risco climático (Zarc).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ZoneamentoMunicipioResponse"},"example":{"meta":{"totalCount":6},"data":[{"cultura":"ALGODÃO HERBÁCEO","culturaNomeCompleto":"ALGODÃO HERBÁCEO SEQUEIRO","culturaSafra":"não informado","culturaCultivo":"SEQUEIRO","culturaClima":"Não se aplica","solo":"ARENOSO","soloNomeCurto":"1","ciclo":"GRUPO II","cicloNomeCurto":"II","risco":[20,30,40,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,20,20,20,20,20,20,20,20],"portaria":"Port. 189 de 03/06/2026"},{"cultura":"ALGODÃO HERBÁCEO","culturaNomeCompleto":"ALGODÃO HERBÁCEO SEQUEIRO","culturaSafra":"não informado","culturaCultivo":"SEQUEIRO","culturaClima":"Não se aplica","solo":"TEXTURA MEDIA","soloNomeCurto":"2","ciclo":"GRUPO II","cicloNomeCurto":"II","risco":[20,20,20,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,20,20,20,20,20,20,20,20],"portaria":"Port. 189 de 03/06/2026"},{"cultura":"ALGODÃO HERBÁCEO","culturaNomeCompleto":"ALGODÃO HERBÁCEO SEQUEIRO","culturaSafra":"não informado","culturaCultivo":"SEQUEIRO","culturaClima":"Não se aplica","solo":"ARGILOSO","soloNomeCurto":"3","ciclo":"GRUPO II","cicloNomeCurto":"II","risco":[20,20,20,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,20,20,20,20,20,20,20,20],"portaria":"Port. 189 de 03/06/2026"},{"cultura":"ALGODÃO HERBÁCEO","culturaNomeCompleto":"ALGODÃO HERBÁCEO SEQUEIRO","culturaSafra":"não informado","culturaCultivo":"SEQUEIRO","culturaClima":"Não se aplica","solo":"ARENOSO","soloNomeCurto":"1","ciclo":"GRUPO III","cicloNomeCurto":"III","risco":[30,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,20,20,20,20,20,20,20,20],"portaria":"Port. 189 de 03/06/2026"},{"cultura":"ALGODÃO HERBÁCEO","culturaNomeCompleto":"ALGODÃO HERBÁCEO SEQUEIRO","culturaSafra":"não informado","culturaCultivo":"SEQUEIRO","culturaClima":"Não se aplica","solo":"TEXTURA MEDIA","soloNomeCurto":"2","ciclo":"GRUPO III","cicloNomeCurto":"III","risco":[20,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,20,20,20,20,20,20,20,20],"portaria":"Port. 189 de 03/06/2026"},{"cultura":"ALGODÃO HERBÁCEO","culturaNomeCompleto":"ALGODÃO HERBÁCEO SEQUEIRO","culturaSafra":"não informado","culturaCultivo":"SEQUEIRO","culturaClima":"Não se aplica","solo":"ARGILOSO","soloNomeCurto":"3","ciclo":"GRUPO III","cicloNomeCurto":"III","risco":[20,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,20,20,20,20,20,20,20,20],"portaria":"Port. 189 de 03/06/2026"}]}}}},"400":{"description":"Requisição inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":{"status":400,"timestamp":"2024-07-26T11:43:33.796292434-03:00","code":"parametro-invalido","summary":"O parâmetro de URL: codigoIBGE recebeu o valor: 3509502A, que é de um tipo inválido. Corrija e informe um valor compatível com o tipo Integer.","description":"O parâmetro de URL: codigoIBGE recebeu o valor: 3509502A, que é de um tipo inválido. Corrija e informe um valor compatível com o tipo Integer."}}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{}}},"500":{"description":"Erro interno inesperado no sistema.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":{"status":500,"timestamp":"2023-07-24T18:26:35.147239529-03:00","code":"erro-de-sistema","summary":"Ocorreu um erro interno inesperado no sistema. Tente novamente e se o problema persistir, entre em contato com o administrador do sistema.","description":"Ocorreu um erro interno inesperado no sistema. Tente novamente e se o problema persistir, entre em contato com o administrador do sistema."}}}}}},"x-auth-type":"Application & Application User","x-throttling-tier":"Unlimited"}},"/zoneamento/municipios/{codigoIBGE}/culturas/{idCultura}":{"get":{"tags":["Zoneamento"],"summary":"Serviço informa a melhor janela de plantio baseado no Zoneamento Agrícola de Risco Climático (Zarc) para riscos de 20%, 30% ou 40%.\nEste valor indica o risco de insucesso do empreendimento pretendido a partir da data indicada.\n","description":"Retorna as datas de plantio com base no Zoneamento Agrícola de Risco Climático (Zarc).","operationId":"findZoneamentoMunicipioByCultura","parameters":[{"name":"codigoIBGE","in":"path","description":"Código IBGE do município da qual se quer obter informações do Zarc","required":true,"schema":{"type":"integer"},"example":3509502},{"name":"idCultura","in":"path","description":"Identificador da Cultura","required":true,"schema":{"type":"integer"},"example":103}],"responses":{"200":{"description":"Retorna as datas de plantio com base no Zoneamento agrícola de risco climático (Zarc).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ZoneamentoMunicipioResponse"},"example":{"meta":{"totalCount":6},"data":[{"cultura":"ALGODÃO HERBÁCEO","culturaNomeCompleto":"ALGODÃO HERBÁCEO SEQUEIRO","culturaSafra":"não informado","culturaCultivo":"SEQUEIRO","culturaClima":"Não se aplica","solo":"ARENOSO","soloNomeCurto":"1","ciclo":"GRUPO II","cicloNomeCurto":"II","risco":[20,30,40,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,20,20,20,20,20,20,20,20],"portaria":"Port. 189 de 03/06/2026"},{"cultura":"ALGODÃO HERBÁCEO","culturaNomeCompleto":"ALGODÃO HERBÁCEO SEQUEIRO","culturaSafra":"não informado","culturaCultivo":"SEQUEIRO","culturaClima":"Não se aplica","solo":"TEXTURA MEDIA","soloNomeCurto":"2","ciclo":"GRUPO II","cicloNomeCurto":"II","risco":[20,20,20,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,20,20,20,20,20,20,20,20],"portaria":"Port. 189 de 03/06/2026"},{"cultura":"ALGODÃO HERBÁCEO","culturaNomeCompleto":"ALGODÃO HERBÁCEO SEQUEIRO","culturaSafra":"não informado","culturaCultivo":"SEQUEIRO","culturaClima":"Não se aplica","solo":"ARGILOSO","soloNomeCurto":"3","ciclo":"GRUPO II","cicloNomeCurto":"II","risco":[20,20,20,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,20,20,20,20,20,20,20,20],"portaria":"Port. 189 de 03/06/2026"},{"cultura":"ALGODÃO HERBÁCEO","culturaNomeCompleto":"ALGODÃO HERBÁCEO SEQUEIRO","culturaSafra":"não informado","culturaCultivo":"SEQUEIRO","culturaClima":"Não se aplica","solo":"ARENOSO","soloNomeCurto":"1","ciclo":"GRUPO III","cicloNomeCurto":"III","risco":[30,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,20,20,20,20,20,20,20,20],"portaria":"Port. 189 de 03/06/2026"},{"cultura":"ALGODÃO HERBÁCEO","culturaNomeCompleto":"ALGODÃO HERBÁCEO SEQUEIRO","culturaSafra":"não informado","culturaCultivo":"SEQUEIRO","culturaClima":"Não se aplica","solo":"TEXTURA MEDIA","soloNomeCurto":"2","ciclo":"GRUPO III","cicloNomeCurto":"III","risco":[20,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,20,20,20,20,20,20,20,20],"portaria":"Port. 189 de 03/06/2026"},{"cultura":"ALGODÃO HERBÁCEO","culturaNomeCompleto":"ALGODÃO HERBÁCEO SEQUEIRO","culturaSafra":"não informado","culturaCultivo":"SEQUEIRO","culturaClima":"Não se aplica","solo":"ARGILOSO","soloNomeCurto":"3","ciclo":"GRUPO III","cicloNomeCurto":"III","risco":[20,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,20,20,20,20,20,20,20,20],"portaria":"Port. 189 de 03/06/2026"}]}}}},"400":{"description":"Requisição inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":{"status":400,"timestamp":"2024-07-26T11:43:33.796292434-03:00","code":"parametro-invalido","summary":"O parâmetro de URL: codigoIBGE recebeu o valor: 3509502A, que é de um tipo inválido. Corrija e informe um valor compatível com o tipo Integer.","description":"O parâmetro de URL: codigoIBGE recebeu o valor: 3509502A, que é de um tipo inválido. Corrija e informe um valor compatível com o tipo Integer."}}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{}}},"500":{"description":"Erro interno inesperado no sistema.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":{"status":500,"timestamp":"2023-07-24T18:26:35.147239529-03:00","code":"erro-de-sistema","summary":"Ocorreu um erro interno inesperado no sistema. Tente novamente e se o problema persistir, entre em contato com o administrador do sistema.","description":"Ocorreu um erro interno inesperado no sistema. Tente novamente e se o problema persistir, entre em contato com o administrador do sistema."}}}}}},"x-auth-type":"Application & Application User","x-throttling-tier":"Unlimited"}},"/zoneamento/municipios/{codigoIBGE}/culturas/{idCultura}/informacoes-adicionais":{"get":{"tags":["Zoneamento"],"summary":"Retorna a safra atual, a portaria e a descrição dos grupos para a maturação da cultura, a partir do município e da cultura informada.","description":"Retorna a safra atual, a portaria e a descrição dos grupos para a maturação da cultura, a partir do município e da cultura informada.","operationId":"findInformacaoAdicionalByMunicipioAndCultura","parameters":[{"name":"codigoIBGE","in":"path","description":"Código IBGE do município da qual se quer obter informações do Zarc","required":true,"schema":{"type":"integer"},"example":3509502},{"name":"idCultura","in":"path","description":"Identificador da Cultura","required":true,"schema":{"type":"integer"},"example":1262}],"responses":{"200":{"description":"Retorna a safra atual, a portaria e a descrição dos grupos para a maturação da cultura, a partir do município e da cultura informada.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ZoneamentoInformacaoAdicionalResponse"},"example":{"data":{"safra":"2026-2027","portaria":"Port. 46 de 16/03/2026","grupos":"São considerados os seguintes grupos: Perene, Semiperene, I, II, III, IV, V e VI. Os grupos I, II, III, IV, V e VI são diferenciados pelo número de dias para a maturação da cultura, onde I compreende o ciclo mais curto e VI o ciclo mais longo.","solos":"Tipos de solo agrupado em 6 categorias quanto à sua disponibilidade de água no solo: AD1: 0.34 até 0.46 (mm/cm); AD2: 0.46 até 0.61 (mm/cm); AD3: 0.61 até 0.80 (mm/cm); AD4: 0.80 até 1.06 (mm/cm); AD5: 1.06 até 1.40 (mm/cm); AD6: acima de 1.40 (mm/cm)"}}}}},"400":{"description":"Requisição inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":{"status":400,"timestamp":"2023-07-27T09:12:40.626561682-03:00","code":"parametro-invalido","summary":"O parâmetro de URL: id recebeu o valor: 999a, que é de um tipo inválido. Corrija e informe um valor compatível com o tipo Integer.","description":"O parâmetro de URL: id recebeu o valor: 999a, que é de um tipo inválido. Corrija e informe um valor compatível com o tipo Integer."}}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":{"status":404,"timestamp":"2023-07-24T18:22:44.608749247-03:00","code":"recurso-nao-encontrado","summary":"Recurso não encontrado.","description":"O recurso /resourcenotfound, que você tentou acessar, é inexistente."}}}}},"500":{"description":"Erro interno inesperado no sistema.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":{"status":500,"timestamp":"2023-07-24T18:26:35.147239529-03:00","code":"erro-de-sistema","summary":"Ocorreu um erro interno inesperado no sistema. Tente novamente e se o problema persistir, entre em contato com o administrador do sistema.","description":"Ocorreu um erro interno inesperado no sistema. Tente novamente e se o problema persistir, entre em contato com o administrador do sistema."}}}}}},"x-auth-type":"Application & Application User","x-throttling-tier":"Unlimited"}},"/zoneamento/municipios/{codigoIBGE}/culturas/{idCultura}/ciclos":{"get":{"tags":["Zoneamento"],"summary":"Lista de ciclos de desenvolvimento da cultura disponíveis para consulta dos dados do Zoneamento Agrícola de Risco Climático (Zarc).\n","description":"Lista de ciclos de desenvolvimento da cultura disponíveis para consulta dos dados do Zoneamento Agrícola de Risco Climático (Zarc).","operationId":"findCicloByMunicipioAndCultura","parameters":[{"name":"codigoIBGE","in":"path","description":"Código IBGE do município da qual se quer obter informações do Zarc","required":true,"schema":{"type":"integer"},"example":3509502},{"name":"idCultura","in":"path","description":"Identificador da Cultura","required":true,"schema":{"type":"integer"},"example":103}],"responses":{"200":{"description":"Lista de ciclos de desenvolvimento da cultura disponíveis para consulta dos dados do Zoneamento Agrícola de Risco Climático (Zarc).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ZoneamentoMunicipioCiclo"},"example":{"meta":{"totalCount":2},"data":["GRUPO II","GRUPO III"]}}}},"400":{"description":"Requisição inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":{"status":400,"timestamp":"2024-07-26T11:43:33.796292434-03:00","code":"parametro-invalido","summary":"O parâmetro de URL: codigoIBGE recebeu o valor: 3509502A, que é de um tipo inválido. Corrija e informe um valor compatível com o tipo Integer.","description":"O parâmetro de URL: codigoIBGE recebeu o valor: 3509502A, que é de um tipo inválido. Corrija e informe um valor compatível com o tipo Integer."}}}}},"500":{"description":"Erro interno inesperado no sistema.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":{"status":500,"timestamp":"2023-07-24T18:26:35.147239529-03:00","code":"erro-de-sistema","summary":"Ocorreu um erro interno inesperado no sistema. Tente novamente e se o problema persistir, entre em contato com o administrador do sistema.","description":"Ocorreu um erro interno inesperado no sistema. Tente novamente e se o problema persistir, entre em contato com o administrador do sistema."}}}}}},"x-auth-type":"Application & Application User","x-throttling-tier":"Unlimited"}},"/zoneamento/municipios/{codigoIBGE}/culturas/{idCultura}/ciclos/{ciclo}":{"get":{"tags":["Zoneamento"],"summary":"Serviço informa a melhor janela de plantio baseado no Zoneamento Agrícola de Risco Climático (Zarc) para riscos de 20%, 30% ou 40%.\nEste valor indica o risco de insucesso do empreendimento pretendido a partir da data indicada.\n","description":"Retorna as datas de plantio com base no Zoneamento Agrícola de Risco Climático (Zarc).","operationId":"findZoneamentoMunicipioByCultura_1","parameters":[{"name":"codigoIBGE","in":"path","description":"Código IBGE do município da qual se quer obter informações do Zarc","required":true,"schema":{"type":"integer"},"example":3509502},{"name":"idCultura","in":"path","description":"Identificador da Cultura","required":true,"schema":{"type":"integer"},"example":103},{"name":"ciclo","in":"path","description":"Nome do ciclo de desenvolvimento da qual se quer obter informações do Zarc.\n","required":true,"schema":{"type":"string","enum":["GRUPO I","GRUPO II","GRUPO III","GRUPO IV","GRUPO V","GRUPO VI","PERENE","SEMIPERENE"]},"example":"GRUPO II"}],"responses":{"200":{"description":"Retorna as datas de plantio com base no Zoneamento agrícola de risco climático (Zarc).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ZoneamentoMunicipioResponse"},"example":{"meta":{"totalCount":6},"data":[{"cultura":"ALGODÃO HERBÁCEO","culturaNomeCompleto":"ALGODÃO HERBÁCEO SEQUEIRO","culturaSafra":"não informado","culturaCultivo":"SEQUEIRO","culturaClima":"Não se aplica","solo":"ARENOSO","soloNomeCurto":"1","ciclo":"GRUPO II","cicloNomeCurto":"II","risco":[20,30,40,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,20,20,20,20,20,20,20,20],"portaria":"Port. 189 de 03/06/2026"},{"cultura":"ALGODÃO HERBÁCEO","culturaNomeCompleto":"ALGODÃO HERBÁCEO SEQUEIRO","culturaSafra":"não informado","culturaCultivo":"SEQUEIRO","culturaClima":"Não se aplica","solo":"TEXTURA MEDIA","soloNomeCurto":"2","ciclo":"GRUPO II","cicloNomeCurto":"II","risco":[20,20,20,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,20,20,20,20,20,20,20,20],"portaria":"Port. 189 de 03/06/2026"},{"cultura":"ALGODÃO HERBÁCEO","culturaNomeCompleto":"ALGODÃO HERBÁCEO SEQUEIRO","culturaSafra":"não informado","culturaCultivo":"SEQUEIRO","culturaClima":"Não se aplica","solo":"ARGILOSO","soloNomeCurto":"3","ciclo":"GRUPO II","cicloNomeCurto":"II","risco":[20,20,20,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,20,20,20,20,20,20,20,20],"portaria":"Port. 189 de 03/06/2026"},{"cultura":"ALGODÃO HERBÁCEO","culturaNomeCompleto":"ALGODÃO HERBÁCEO SEQUEIRO","culturaSafra":"não informado","culturaCultivo":"SEQUEIRO","culturaClima":"Não se aplica","solo":"ARENOSO","soloNomeCurto":"1","ciclo":"GRUPO III","cicloNomeCurto":"III","risco":[30,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,20,20,20,20,20,20,20,20],"portaria":"Port. 189 de 03/06/2026"},{"cultura":"ALGODÃO HERBÁCEO","culturaNomeCompleto":"ALGODÃO HERBÁCEO SEQUEIRO","culturaSafra":"não informado","culturaCultivo":"SEQUEIRO","culturaClima":"Não se aplica","solo":"TEXTURA MEDIA","soloNomeCurto":"2","ciclo":"GRUPO III","cicloNomeCurto":"III","risco":[20,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,20,20,20,20,20,20,20,20],"portaria":"Port. 189 de 03/06/2026"},{"cultura":"ALGODÃO HERBÁCEO","culturaNomeCompleto":"ALGODÃO HERBÁCEO SEQUEIRO","culturaSafra":"não informado","culturaCultivo":"SEQUEIRO","culturaClima":"Não se aplica","solo":"ARGILOSO","soloNomeCurto":"3","ciclo":"GRUPO III","cicloNomeCurto":"III","risco":[20,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,20,20,20,20,20,20,20,20],"portaria":"Port. 189 de 03/06/2026"}]}}}},"400":{"description":"Requisição inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":{"status":400,"timestamp":"2024-07-26T11:43:33.796292434-03:00","code":"parametro-invalido","summary":"O parâmetro de URL: codigoIBGE recebeu o valor: 3509502A, que é de um tipo inválido. Corrija e informe um valor compatível com o tipo Integer.","description":"O parâmetro de URL: codigoIBGE recebeu o valor: 3509502A, que é de um tipo inválido. Corrija e informe um valor compatível com o tipo Integer."}}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{}}},"500":{"description":"Erro interno inesperado no sistema.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":{"status":500,"timestamp":"2023-07-24T18:26:35.147239529-03:00","code":"erro-de-sistema","summary":"Ocorreu um erro interno inesperado no sistema. Tente novamente e se o problema persistir, entre em contato com o administrador do sistema.","description":"Ocorreu um erro interno inesperado no sistema. Tente novamente e se o problema persistir, entre em contato com o administrador do sistema."}}}}}},"x-auth-type":"Application & Application User","x-throttling-tier":"Unlimited"}},"/zoneamento/municipios/{codigoIBGE}/culturas/{idCultura}/ciclos/{ciclo}/solos":{"get":{"tags":["Zoneamento"],"summary":"Lista de solos disponíveis para consulta dos dados do Zoneamento Agrícola de Risco Climático (Zarc).\n","description":"Lista de solos disponíveis para consulta dos dados do Zoneamento Agrícola de Risco Climático (Zarc).","operationId":"findSoloByMunicipioAndCulturaAndCiclo","parameters":[{"name":"codigoIBGE","in":"path","description":"Código IBGE do município da qual se quer obter informações do Zarc","required":true,"schema":{"type":"integer"},"example":3509502},{"name":"idCultura","in":"path","description":"Identificador da Cultura","required":true,"schema":{"type":"integer"},"example":103},{"name":"ciclo","in":"path","description":"Nome do ciclo de desenvolvimento da qual se quer obter informações do Zarc.\n","required":true,"schema":{"type":"string","enum":["GRUPO I","GRUPO II","GRUPO III","GRUPO IV","GRUPO V","GRUPO VI","PERENE","SEMIPERENE"]},"example":"GRUPO II"}],"responses":{"200":{"description":"Lista de solos disponíveis para consulta dos dados do Zoneamento Agrícola de Risco Climático (Zarc).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ZoneamentoMunicipioSolo"},"example":{"meta":{"totalCount":3},"data":["ARENOSO","ARGILOSO","TEXTURA MEDIA"]}}}},"400":{"description":"Requisição inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":{"status":400,"timestamp":"2024-07-26T11:43:33.796292434-03:00","code":"parametro-invalido","summary":"O parâmetro de URL: codigoIBGE recebeu o valor: 3509502A, que é de um tipo inválido. Corrija e informe um valor compatível com o tipo Integer.","description":"O parâmetro de URL: codigoIBGE recebeu o valor: 3509502A, que é de um tipo inválido. Corrija e informe um valor compatível com o tipo Integer."}}}}},"500":{"description":"Erro interno inesperado no sistema.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":{"status":500,"timestamp":"2023-07-24T18:26:35.147239529-03:00","code":"erro-de-sistema","summary":"Ocorreu um erro interno inesperado no sistema. Tente novamente e se o problema persistir, entre em contato com o administrador do sistema.","description":"Ocorreu um erro interno inesperado no sistema. Tente novamente e se o problema persistir, entre em contato com o administrador do sistema."}}}}}},"x-auth-type":"Application & Application User","x-throttling-tier":"Unlimited"}},"/zoneamento/informacoes-adicionais":{"get":{"tags":["Zoneamento"],"summary":"Retorna a safra atual, a portaria e a descrição dos grupos para a maturação da cultura.\n","description":"Retorna a safra atual, a portaria que estabelece as regras de participação na formulação ou aperfeiçoamento do Zoneamento Agrícola de Risco Climático (Zarc) e a forma de divulgação, bem como a\ndescrição dos grupos para a maturação da cultura.\n","operationId":"findInformacaoAdicional","responses":{"200":{"description":"Retorna as informações adicionais do Zoneamento Agrícola de Risco Climático (Zarc).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ZoneamentoInformacaoAdicionalResponse"},"example":{"data":{"safra":"2026-2027","portaria":"Port. 412 de 30/12/2020","grupos":"São considerados os seguintes grupos: Perene, Semiperene, I, II, III, IV, V e VI. Os grupos I, II, III, IV, V e VI são diferenciados pelo número de dias para a maturação da cultura, onde I compreende o ciclo mais curto e VI o ciclo mais longo.","solos":"Tipos de solos agrupados em categorias, quanto à sua capacidade de disponibilidade de água no solo."}}}}},"500":{"description":"Erro interno inesperado no sistema.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":{"status":500,"timestamp":"2023-07-24T18:26:35.147239529-03:00","code":"erro-de-sistema","summary":"Ocorreu um erro interno inesperado no sistema. Tente novamente e se o problema persistir, entre em contato com o administrador do sistema.","description":"Ocorreu um erro interno inesperado no sistema. Tente novamente e se o problema persistir, entre em contato com o administrador do sistema."}}}}}},"x-auth-type":"Application & Application User","x-throttling-tier":"Unlimited"}},"/solos":{"get":{"tags":["Solos"],"summary":"Retorna a lista completa de solos.","description":"Retorna a lista de solos.","operationId":"find_1","responses":{"200":{"description":"Lista de solos","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SoloResponse"},"example":{"meta":{"totalCount":9},"data":[{"tipo":"AD1","descricao":"AD1: 0.34 até 0.46 (mm/cm)"},{"tipo":"AD2","descricao":"AD2: 0.46 até 0.61 (mm/cm)"},{"tipo":"AD3","descricao":"AD3: 0.61 até 0.80 (mm/cm)"},{"tipo":"AD4","descricao":"AD4: 0.80 até 1.06 (mm/cm)"},{"tipo":"AD5","descricao":"AD5: 1.06 até 1.40 (mm/cm)"},{"tipo":"AD6","descricao":"AD6: acima de 1.40 (mm/cm)"},{"tipo":"ARENOSO","descricao":"Solos de textura arenosa, com teor mínimo de 10% de argila e menor do que 15% ou com teor de argila igual ou maior do que 15%, nos quais a diferença entre o percentual de areia e o percentual de argila seja maior ou igual a 50. Assim, adotando-se o percentual de argila = A, e a diferença entre os percentuais de area e argila = D, temos para os solos tipo 1: 10% <= A < 15% ou A >= 15% com D >= 50."},{"tipo":"TEXTURA MEDIA","descricao":"Solos de textura média, com teor mínimo de 15% de argila e menor do que 35%, nos quais diferença entre o percentual de argila = A, e a diferença entre os percentuais de area e argila = D, temos para os solos tipo 2: 15% <= A com D < 50."},{"tipo":"ARGILOSO","descricao":"Solos de textura argilosa, com teor de argila maior ou igual a 35%. Assim, adotando-se o percentual de argila = A, temos para os solos tipo 3: A >= 35%."}]}}}},"500":{"description":"Erro interno inesperado no sistema.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":{"status":500,"timestamp":"2023-07-24T18:26:35.147239529-03:00","code":"erro-de-sistema","summary":"Ocorreu um erro interno inesperado no sistema. Tente novamente e se o problema persistir, entre em contato com o administrador do sistema.","description":"Ocorreu um erro interno inesperado no sistema. Tente novamente e se o problema persistir, entre em contato com o administrador do sistema."}}}}}},"x-auth-type":"Application & Application User","x-throttling-tier":"Unlimited"}},"/solos/{tipo}":{"get":{"tags":["Solos"],"summary":"Retorna o solo desejado.","description":"Retorna o solo desejado.","operationId":"findById","parameters":[{"name":"tipo","in":"path","description":"Tipo do solo","required":true,"schema":{"type":"string","enum":["ARENOSO","ARGILOSO","TEXTURA MEDIA","AD1","AD2","AD3","AD4","AD5","AD6"]},"example":"ARENOSO"}],"responses":{"200":{"description":"Dados do solo","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SoloSingleResponse"},"example":{"data":{"tipo":"ARENOSO","descricao":"Solos de textura arenosa, com teor mínimo de 10% de argila e menor do que 15% ou com teor de argila igual ou maior do que 15%, nos quais a diferença entre o percentual de areia e o percentual de argila seja maior ou igual a 50. Assim, adotando-se o percentual de argila = A, e a diferença entre os percentuais de area e argila = D, temos para os solos tipo 1: 10% <= A < 15% ou A >= 15% com D >= 50."}}}}},"400":{"description":"Requisição inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":{"status":400,"timestamp":"2023-07-27T09:12:40.626561682-03:00","code":"parametro-invalido","summary":"O parâmetro de URL: id recebeu o valor: 999a, que é de um tipo inválido. Corrija e informe um valor compatível com o tipo Integer.","description":"O parâmetro de URL: id recebeu o valor: 999a, que é de um tipo inválido. Corrija e informe um valor compatível com o tipo Integer."}}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":{"status":404,"timestamp":"2023-07-24T18:22:44.608749247-03:00","code":"recurso-nao-encontrado","summary":"Recurso não encontrado.","description":"O recurso /resourcenotfound, que você tentou acessar, é inexistente."}}}}},"500":{"description":"Erro interno inesperado no sistema.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":{"status":500,"timestamp":"2023-07-24T18:26:35.147239529-03:00","code":"erro-de-sistema","summary":"Ocorreu um erro interno inesperado no sistema. Tente novamente e se o problema persistir, entre em contato com o administrador do sistema.","description":"Ocorreu um erro interno inesperado no sistema. Tente novamente e se o problema persistir, entre em contato com o administrador do sistema."}}}}}},"x-auth-type":"Application & Application User","x-throttling-tier":"Unlimited"}},"/produtividade":{"get":{"tags":["Produtividade"],"summary":"Serviço que fornece a estimativa de produtividade em função do local, data de plantio e da cultura desejada.\n","description":"Estimativa da produtividade para a cultura desejada.","operationId":"find_2","parameters":[{"name":"idCultura","in":"query","description":"Identificador da cultura da qual se quer estimar a produtividade","required":true,"schema":{"type":"integer"},"example":60},{"name":"idCultivar","in":"query","description":"Identificador da cultivar utilizada no empreendimento. Caso não fornecido, utiliza o coeficiente geral da cultura no cálculo","required":true,"schema":{"type":"integer"},"example":24507},{"name":"codigoIBGE","in":"query","description":"Código IBGE do município onde localiza-se o empreendimento","required":true,"schema":{"type":"integer"},"example":2112001},{"name":"cad","in":"query","description":"Capacidade de armazenamento de água no solo em ml","required":true,"schema":{"type":"integer"},"example":70},{"name":"dataPlantio","in":"query","description":"Data de plantio no formato (yyyy-MM-dd), devendo ser menor ou igual a data de hoje","required":true,"schema":{"type":"string"},"example":"2024-05-01"},{"name":"expectativaProdutividade","in":"query","description":"Produtividade esperada para o empreendimento. Caso não fornecido, utiliza a produtividade média do município para a cultura (ton/ha)","required":true,"schema":{"type":"number"},"example":3},{"name":"latitude","in":"query","description":"Latitude onde localiza-se o empreendimento. Caso fornecida, utiliza os dados da estação meteorológica mais próxima, ao invés da mais próxima à coordenada do município.\nÉ obrigatório informar também o parâmetro \"longitude\". Grau decimal. Projeção - EPG32723.\n","required":false,"schema":{"type":"number"}},{"name":"longitude","in":"query","description":"Longitude onde localiza-se o empreendimento. Caso fornecida, utiliza os dados da estação meteorológica mais próxima, ao invés da mais próxima à coordenada do município.\nÉ obrigatório informar também o parâmetro \"latitude\". Grau decimal. Projeção - EPG32723.\n","required":false,"schema":{"type":"number"}}],"responses":{"200":{"description":"Dados do cálculo de produtividade","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProdutividadeResponse"},"example":{"data":{"produtividadeAlmejada":[2.99213140117078,2.98352296735143,2.97415778906658,2.96407594305557,2.9532919328066,2.94181008549069,2.92973435066173,2.91710198577768,2.90392797260361,2.89030885823788,2.86906670557526,2.84689629019294],"produtividadeMediaMunicipio":[3.23150191326444,3.22220480473954,3.2120904121919,3.20120201850002,3.18955528743113,3.17715489232995,3.16411309871467,3.1504701446399,3.1362422104119,3.12153356689691,3.09859204202128,3.07464799340838],"temperaturaMinima":[18.9,16.2,16.09,17.46,17.05,17.83,19.82,18.13,18.97,20.35,20.41,20.57],"temperaturaMaxima":[34.97,34.56,34.93,35.65,36.77,37.55,36.21,37.84,36.64,36.35,37.86,38.56],"precipitacao":[0,0,0,0,0,0,0,0,0,0,0,0],"grausDia":[12.935,24.315,35.825,48.38,61.29,74.98,88.995,102.98,116.785,131.135,146.27,161.835],"balancoHidrico":[46.9504415939286,44.7334280933737,42.5501437811979,40.517538173144,38.3794017110988,36.3241879762086,34.726054929683,32.8533717070622,31.2883666233411,29.9314408811001,27.7815325728883,25.6986798136591],"deficienciaHidrica":[0.941379675465945,1.16899549172301,1.31936309298474,1.39377626245887,1.6568449232889,1.79737956198455,1.55141804887827,2.00782897766619,1.85155660084166,1.74665674509889,3.06774877919041,3.37237901938269],"excedenteHidrico":[0,0,0,0,0,0,0,0,0,0,0,0],"isna":[0.685256046831278,0.654757121322176,0.623324034545729,0.593222146529084,0.563411580965357,0.533462417784251,0.507416135860676,0.482586608665302,0.458064343106215,0.437212720388826,0.41204476879146,0.38180829775105]}}}}},"400":{"description":"Requisição inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":{"status":400,"timestamp":"2023-08-21T10:31:06.600695485-03:00","code":"dados-invalidos","summary":"A requisição não pode ser processada.","description":"A requisição não pode ser processada por motivo de validação de atributos.","fieldErrors":[{"field":"idCultura","entity":"cultura","summary":"Cultura não possui cálculo de produtividade associado.","description":"Cultura não possui cálculo de produtividade associado, utilize uma cultura com cálculo de produtividade associado."},{"field":"idCultivar","entity":"cultivar","summary":"Identificador da cultivar não encontrado.","description":"Identificador da cultivar não encontrado, utilize um identificador válido."},{"field":"codigoIBGE","entity":"municipio","summary":"Município não encontrado a partir do Código do IBGE informado.","description":"Município não encontrado a partir do Código do IBGE informado, utilize um Código do IBGE válido."},{"field":"dataPlantio","entity":"produtividade","summary":"Data de plantio inválida.","description":"Data de plantio inválida, informe uma data válida no formato (yyyy-MM-dd)."}]}}}}},"500":{"description":"Erro interno inesperado no sistema.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":{"status":500,"timestamp":"2023-07-24T18:26:35.147239529-03:00","code":"erro-de-sistema","summary":"Ocorreu um erro interno inesperado no sistema. Tente novamente e se o problema persistir, entre em contato com o administrador do sistema.","description":"Ocorreu um erro interno inesperado no sistema. Tente novamente e se o problema persistir, entre em contato com o administrador do sistema."}}}}}},"x-auth-type":"Application & Application User","x-throttling-tier":"Unlimited"}},"/obtentores":{"get":{"tags":["Obtentores"],"summary":"Retorna a lista completa de obtentores/mantenedores de cultivares.","description":"Retorna a lista de obtentores/mantenedores de cultivares.","operationId":"find_3","parameters":[{"name":"safra","in":"query","description":"Ano da safra no padrão yyyy-yyyy","required":true,"schema":{"type":"string","enum":["2017-2018","2018-2019","2019-2020","2020-2021","2021-2022","2022-2023","2023-2024","2024-2025","2025-2026","2026-2027"],"default":"2026-2027"},"example":"2026-2027"},{"name":"idCultura","in":"query","description":"Identificador da Cultura","required":false,"schema":{"type":"integer"},"example":1262},{"name":"uf","in":"query","description":"Sigla da Unidade da Federação","required":false,"schema":{"type":"string","enum":["AC","AL","AP","AM","BA","CE","DF","ES","GO","MA","MT","MS","MG","PA","PB","PR","PE","PI","RJ","RN","RS","RO","RR","SC","SP","SE","TO"]},"example":"SP"},{"name":"regiao","in":"query","description":"Região de adaptação, aplicado somente à cultura da Soja e Trigo","required":false,"schema":{"type":"string","enum":["1","2","3","4","5"]}},{"name":"grupo","in":"query","description":"Grupo/ciclo de desenvolvimento","required":false,"schema":{"type":"string","enum":["I","II","III","IV"]}},{"name":"dataAtualizacao","in":"query","description":"Data da última atualização no formato (yyyy-MM-dd), retornando os registros com datas superiores à data indicada","required":false,"schema":{"type":"string"},"example":"2020-01-01"}],"responses":{"200":{"description":"Lista de obtentores/mantenedores de cultivares","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ObtentorMantenedorResponse"},"example":{"meta":{"totalCount":5},"data":[{"obtentorMantenedor":"AGRO NORTE PESQUISA E SEMENTES LTDA","dataAtualizacao":"2026-03-19"},{"obtentorMantenedor":"EMBRAPA ARROZ E FEIJÃO - CNPAF","dataAtualizacao":"2026-03-19"},{"obtentorMantenedor":"FRANCISCO TERASAWA","dataAtualizacao":"2026-03-19"},{"obtentorMantenedor":"IAC","dataAtualizacao":"2026-03-19"},{"obtentorMantenedor":"IDR - PARANÁ","dataAtualizacao":"2026-03-19"}]}}}},"400":{"description":"Requisição inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":{"status":400,"timestamp":"2023-08-10T22:48:45.483079593-03:00","code":"dados-invalidos","summary":"A requisição não pode ser processada.","description":"A requisição não pode ser processada por motivo de validação de atributos.","fieldErrors":[{"field":"dataAtualizacao","entity":"geral","summary":"Data de atualização inválida.","description":"Data de atualização inválida, informe uma data válida no formato (yyyy-MM-dd)."}]}}}}},"500":{"description":"Erro interno inesperado no sistema.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":{"status":500,"timestamp":"2023-07-24T18:26:35.147239529-03:00","code":"erro-de-sistema","summary":"Ocorreu um erro interno inesperado no sistema. Tente novamente e se o problema persistir, entre em contato com o administrador do sistema.","description":"Ocorreu um erro interno inesperado no sistema. Tente novamente e se o problema persistir, entre em contato com o administrador do sistema."}}}}}},"x-auth-type":"Application & Application User","x-throttling-tier":"Unlimited"}},"/municipios":{"get":{"tags":["Municípios"],"summary":"Retorna a lista de municípios brasileiros.","description":"Retorna a lista de municípios brasileiros.","operationId":"find_4","parameters":[{"name":"uf","in":"query","description":"Sigla da Unidade da Federação","required":false,"schema":{"type":"string","enum":["AC","AL","AP","AM","BA","CE","DF","ES","GO","MA","MT","MS","MG","PA","PB","PR","PE","PI","RJ","RN","RS","RO","RR","SC","SP","SE","TO"]},"example":"SP"},{"name":"dataAtualizacao","in":"query","description":"Data da última atualização no formato (yyyy-MM-dd), retornando os registros com datas superiores à data indicada","required":false,"schema":{"type":"string"},"example":"2020-01-01"}],"responses":{"200":{"description":"Lista de municípios","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MunicipioResponse"},"example":{"meta":{"totalCount":5572},"data":[{"codigoIBGE":5200050,"nome":"ABADIA DE GOIAS","uf":"GO","latitude":-16.7845993,"longitude":-49.453701,"dataAtualizacao":"2018-05-02"},{"codigoIBGE":3100104,"nome":"ABADIA DOS DOURADOS","uf":"MG","latitude":-18.3528004,"longitude":-47.4574013,"dataAtualizacao":"2018-05-02"},{"codigoIBGE":5200100,"nome":"ABADIANIA","uf":"GO","latitude":-16.1863003,"longitude":-48.7127991,"dataAtualizacao":"2018-05-02"},{"codigoIBGE":3100203,"nome":"ABAETE","uf":"MG","latitude":-19.1030998,"longitude":-45.3592987,"dataAtualizacao":"2018-05-02"}]}}}},"400":{"description":"Requisição inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":{"status":400,"timestamp":"2023-08-10T22:39:28.433356128-03:00","code":"dados-invalidos","summary":"A requisição não pode ser processada.","description":"A requisição não pode ser processada por motivo de validação de atributos.","fieldErrors":[{"field":"uf","entity":"unidade-da-federacao","summary":"Sigla da Unidade da Federação não encontrada.","description":"Sigla da Unidade da Federação não encontrada, utilize uma sigla válida."}]}}}}},"500":{"description":"Erro interno inesperado no sistema.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":{"status":500,"timestamp":"2023-07-24T18:26:35.147239529-03:00","code":"erro-de-sistema","summary":"Ocorreu um erro interno inesperado no sistema. Tente novamente e se o problema persistir, entre em contato com o administrador do sistema.","description":"Ocorreu um erro interno inesperado no sistema. Tente novamente e se o problema persistir, entre em contato com o administrador do sistema."}}}}}},"x-auth-type":"Application & Application User","x-throttling-tier":"Unlimited"}},"/municipios/{codigoIBGE}":{"get":{"tags":["Municípios"],"summary":"Retorna o município desejado.","description":"Retorna o munícipio desejado.","operationId":"findByCodigoIBGE","parameters":[{"name":"codigoIBGE","in":"path","description":"Código do IBGE","required":true,"schema":{"type":"integer"},"example":3100104}],"responses":{"200":{"description":"Código IBGE do município","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MunicipioSingleResponse"},"example":{"data":{"codigoIBGE":3100104,"nome":"ABADIA DOS DOURADOS","uf":"MG","latitude":-18.3528004,"longitude":-47.4574013,"dataAtualizacao":"2018-05-02"}}}}},"400":{"description":"Requisição inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":{"status":400,"timestamp":"2023-07-27T09:12:40.626561682-03:00","code":"parametro-invalido","summary":"O parâmetro de URL: id recebeu o valor: 999a, que é de um tipo inválido. Corrija e informe um valor compatível com o tipo Integer.","description":"O parâmetro de URL: id recebeu o valor: 999a, que é de um tipo inválido. Corrija e informe um valor compatível com o tipo Integer."}}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":{"status":404,"timestamp":"2023-07-24T18:22:44.608749247-03:00","code":"recurso-nao-encontrado","summary":"Recurso não encontrado.","description":"O recurso /resourcenotfound, que você tentou acessar, é inexistente."}}}}},"500":{"description":"Erro interno inesperado no sistema.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":{"status":500,"timestamp":"2023-07-24T18:26:35.147239529-03:00","code":"erro-de-sistema","summary":"Ocorreu um erro interno inesperado no sistema. Tente novamente e se o problema persistir, entre em contato com o administrador do sistema.","description":"Ocorreu um erro interno inesperado no sistema. Tente novamente e se o problema persistir, entre em contato com o administrador do sistema."}}}}}},"x-auth-type":"Application & Application User","x-throttling-tier":"Unlimited"}},"/municipios/{codigoIBGE}/culturas":{"get":{"tags":["Municípios"],"summary":"Retorna as culturas com base no Zoneamento Agrícola de Risco Climático (Zarc).","description":"Retorna as culturas com base no Zoneamento Agrícola de Risco Climático (Zarc).","operationId":"findCulturaByCodigoIBGE","parameters":[{"name":"codigoIBGE","in":"path","description":"Código do IBGE","required":true,"schema":{"type":"integer"},"example":3100104}],"responses":{"200":{"description":"Código IBGE do município","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CulturaResponse"},"example":{"meta":{"totalCount":111},"data":[{"id":101,"nome":"ABACAXI IRRIGADO","nomeCompleto":"ABACAXI IRRIGADO","safra":"Sem Safra","cultivo":"IRRIGADO","clima":"Não se aplica","hasZoneamento":true,"hasCultivar":false,"hasProdutividade":false,"hasAdubacao":false,"dataAtualizacao":null},{"id":102,"nome":"ABACAXI SEQUEIRO","nomeCompleto":"ABACAXI SEQUEIRO","safra":"Sem Safra","cultivo":"SEQUEIRO","clima":"Não se aplica","hasZoneamento":true,"hasCultivar":false,"hasProdutividade":false,"hasAdubacao":false,"dataAtualizacao":null},{"id":1222,"nome":"AÇAI IMPLANTAÇÃO IRRIGADO","nomeCompleto":"AÇAI IMPLANTAÇÃO IRRIGADO","safra":"Perene","cultivo":"IRRIGADO","clima":"Não se aplica","hasZoneamento":true,"hasCultivar":false,"hasProdutividade":false,"hasAdubacao":false,"dataAtualizacao":null},{"id":1221,"nome":"AÇAI PRODUÇÃO IRRIGADO","nomeCompleto":"AÇAI PRODUÇÃO IRRIGADO","safra":"Perene","cultivo":"IRRIGADO","clima":"Não se aplica","hasZoneamento":true,"hasCultivar":false,"hasProdutividade":false,"hasAdubacao":false,"dataAtualizacao":null}]}}}},"400":{"description":"Requisição inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":{"status":400,"timestamp":"2023-07-27T09:12:40.626561682-03:00","code":"parametro-invalido","summary":"O parâmetro de URL: id recebeu o valor: 999a, que é de um tipo inválido. Corrija e informe um valor compatível com o tipo Integer.","description":"O parâmetro de URL: id recebeu o valor: 999a, que é de um tipo inválido. Corrija e informe um valor compatível com o tipo Integer."}}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":{"status":404,"timestamp":"2023-07-24T18:22:44.608749247-03:00","code":"recurso-nao-encontrado","summary":"Recurso não encontrado.","description":"O recurso /resourcenotfound, que você tentou acessar, é inexistente."}}}}},"500":{"description":"Erro interno inesperado no sistema.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":{"status":500,"timestamp":"2023-07-24T18:26:35.147239529-03:00","code":"erro-de-sistema","summary":"Ocorreu um erro interno inesperado no sistema. Tente novamente e se o problema persistir, entre em contato com o administrador do sistema.","description":"Ocorreu um erro interno inesperado no sistema. Tente novamente e se o problema persistir, entre em contato com o administrador do sistema."}}}}}},"x-auth-type":"Application & Application User","x-throttling-tier":"Unlimited"}},"/health":{"get":{"tags":["Health"],"summary":"Resposta sem conteúdo.","description":"Resposta sem conteúdo, apenas para verificar o funcionamento da API.","operationId":"processarHealth","responses":{"204":{"description":"Resposta sem conteúdo, apenas para verificar o funcionamento da API."},"500":{"description":"Erro interno inesperado no sistema.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":{"status":500,"timestamp":"2023-07-24T18:26:35.147239529-03:00","code":"erro-de-sistema","summary":"Ocorreu um erro interno inesperado no sistema. Tente novamente e se o problema persistir, entre em contato com o administrador do sistema.","description":"Ocorreu um erro interno inesperado no sistema. Tente novamente e se o problema persistir, entre em contato com o administrador do sistema."}}}}}},"x-auth-type":"Application & Application User","x-throttling-tier":"Unlimited"}},"/culturas":{"get":{"tags":["Culturas"],"summary":"Retorna a lista completa de culturas.","description":"Retorna a lista de culturas.","operationId":"find_6","responses":{"200":{"description":"Lista de culturas","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CulturaResponse"},"example":{"meta":{"totalCount":165},"data":[{"id":101,"nome":"ABACAXI IRRIGADO","safra":"Sem Safra","cultivo":"IRRIGADO","clima":"Não se aplica","hasZoneamento":true,"hasCultivar":false,"hasProdutividade":false,"hasAdubacao":false,"dataAtualizacao":null},{"id":102,"nome":"ABACAXI SEQUEIRO","safra":"Sem Safra","cultivo":"SEQUEIRO","clima":"Não se aplica","hasZoneamento":true,"hasCultivar":false,"hasProdutividade":false,"hasAdubacao":false,"dataAtualizacao":null},{"id":109,"nome":"AÇAI","safra":"Perene","cultivo":"SEQUEIRO","clima":"Não se aplica","hasZoneamento":true,"hasCultivar":false,"hasProdutividade":false,"hasAdubacao":false,"dataAtualizacao":null},{"id":1222,"nome":"AÇAI IMPLANTAÇÃO IRRIGADO","safra":"Perene","cultivo":"IRRIGADO","clima":"Não se aplica","hasZoneamento":true,"hasCultivar":false,"hasProdutividade":false,"hasAdubacao":false,"dataAtualizacao":null},{"id":1221,"nome":"AÇAI PRODUÇÃO IRRIGADO","safra":"Perene","cultivo":"IRRIGADO","clima":"Não se aplica","hasZoneamento":true,"hasCultivar":false,"hasProdutividade":false,"hasAdubacao":false,"dataAtualizacao":null}]}}}},"500":{"description":"Erro interno inesperado no sistema.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":{"status":500,"timestamp":"2023-07-24T18:26:35.147239529-03:00","code":"erro-de-sistema","summary":"Ocorreu um erro interno inesperado no sistema. Tente novamente e se o problema persistir, entre em contato com o administrador do sistema.","description":"Ocorreu um erro interno inesperado no sistema. Tente novamente e se o problema persistir, entre em contato com o administrador do sistema."}}}}}},"x-auth-type":"Application & Application User","x-throttling-tier":"Unlimited"}},"/culturas/{id}":{"get":{"tags":["Culturas"],"summary":"Retorna a cultura desejada.","description":"Retorna a cultura desejada.","operationId":"findById_4","parameters":[{"name":"id","in":"path","description":"Identificador da Cultura","required":true,"schema":{"type":"integer"},"example":1262}],"responses":{"200":{"description":"Dados da cultura","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CulturaSingleResponse"},"example":{"data":{"id":1262,"nome":"FEIJÃO IRRIGADO","nomeCompleto":"FEIJÃO IRRIGADO","safra":"NÃO INFORMADO","cultivo":"IRRIGADO","clima":"NÃO SE APLICA","hasZoneamento":true,"hasCultivar":true,"hasProdutividade":false,"hasAdubacao":false,"isSoja":false,"isTrigo":false,"dataAtualizacao":null}}}}},"400":{"description":"Requisição inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":{"status":400,"timestamp":"2023-07-27T09:12:40.626561682-03:00","code":"parametro-invalido","summary":"O parâmetro de URL: id recebeu o valor: 999a, que é de um tipo inválido. Corrija e informe um valor compatível com o tipo Integer.","description":"O parâmetro de URL: id recebeu o valor: 999a, que é de um tipo inválido. Corrija e informe um valor compatível com o tipo Integer."}}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":{"status":404,"timestamp":"2023-07-24T18:22:44.608749247-03:00","code":"recurso-nao-encontrado","summary":"Recurso não encontrado.","description":"O recurso /resourcenotfound, que você tentou acessar, é inexistente."}}}}},"500":{"description":"Erro interno inesperado no sistema.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":{"status":500,"timestamp":"2023-07-24T18:26:35.147239529-03:00","code":"erro-de-sistema","summary":"Ocorreu um erro interno inesperado no sistema. Tente novamente e se o problema persistir, entre em contato com o administrador do sistema.","description":"Ocorreu um erro interno inesperado no sistema. Tente novamente e se o problema persistir, entre em contato com o administrador do sistema."}}}}}},"x-auth-type":"Application & Application User","x-throttling-tier":"Unlimited"}},"/culturas/{id}/informacoes-adicionais":{"get":{"tags":["Culturas"],"summary":"Retorna a safra atual, a portaria e a descrição dos grupos para a maturação da cultura, a partir da cultura informada.","description":"Retorna a safra atual, a portaria e a descrição dos grupos para a maturação da cultura, a partir da cultura informada.","operationId":"findSafraAtual","parameters":[{"name":"id","in":"path","description":"Identificador da Cultura","required":true,"schema":{"type":"integer"},"example":1262}],"responses":{"200":{"description":"Retorna a safra atual, a portaria e a descrição dos grupos para a maturação da cultura, a partir do município e da cultura informada.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ZoneamentoInformacaoAdicionalResponse"},"example":{"data":{"safra":"2026-2027","portaria":"Port. 412 de 30/12/2020","grupos":"São considerados os seguintes grupos: Perene, Semiperene, I, II, III, IV, V e VI. Os grupos I, II, III, IV, V e VI são diferenciados pelo número de dias para a maturação da cultura, onde I compreende o ciclo mais curto e VI o ciclo mais longo.","solos":"Tipos de solos agrupados em categorias, quanto à sua capacidade de disponibilidade de água no solo."}}}}},"400":{"description":"Requisição inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":{"status":400,"timestamp":"2023-07-27T09:12:40.626561682-03:00","code":"parametro-invalido","summary":"O parâmetro de URL: id recebeu o valor: 999a, que é de um tipo inválido. Corrija e informe um valor compatível com o tipo Integer.","description":"O parâmetro de URL: id recebeu o valor: 999a, que é de um tipo inválido. Corrija e informe um valor compatível com o tipo Integer."}}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":{"status":404,"timestamp":"2023-07-24T18:22:44.608749247-03:00","code":"recurso-nao-encontrado","summary":"Recurso não encontrado.","description":"O recurso /resourcenotfound, que você tentou acessar, é inexistente."}}}}},"500":{"description":"Erro interno inesperado no sistema.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":{"status":500,"timestamp":"2023-07-24T18:26:35.147239529-03:00","code":"erro-de-sistema","summary":"Ocorreu um erro interno inesperado no sistema. Tente novamente e se o problema persistir, entre em contato com o administrador do sistema.","description":"Ocorreu um erro interno inesperado no sistema. Tente novamente e se o problema persistir, entre em contato com o administrador do sistema."}}}}}},"x-auth-type":"Application & Application User","x-throttling-tier":"Unlimited"}},"/cultivares":{"get":{"tags":["Cultivares"],"summary":"Retorna a lista completa de cultivares.","description":"Retorna a lista de cultivares.","operationId":"find_7","parameters":[{"name":"safra","in":"query","description":"Ano da safra no padrão yyyy-yyyy","required":true,"schema":{"type":"string","enum":["2017-2018","2018-2019","2019-2020","2020-2021","2021-2022","2022-2023","2023-2024","2024-2025","2025-2026","2026-2027"],"default":"2026-2027"},"example":"2026-2027"},{"name":"idCultura","in":"query","description":"Identificador da Cultura","required":true,"schema":{"type":"integer"},"example":1262},{"name":"uf","in":"query","description":"Sigla da Unidade da Federação","required":true,"schema":{"type":"string","enum":["AC","AL","AP","AM","BA","CE","DF","ES","GO","MA","MT","MS","MG","PA","PB","PR","PE","PI","RJ","RN","RS","RO","RR","SC","SP","SE","TO"]},"example":"SP"},{"name":"regiao","in":"query","description":"Região de adaptação, aplicado somente à cultura da Soja e Trigo","required":false,"schema":{"type":"string","enum":["1","2","3","4","5"]}},{"name":"grupo","in":"query","description":"Grupo/ciclo de desenvolvimento","required":false,"schema":{"type":"string","enum":["I","II","III","IV"]}},{"name":"cultivar","in":"query","description":"Nome da cultivar","required":false,"schema":{"type":"string"},"example":"BRS FC402"},{"name":"obtentorMantenedor","in":"query","description":"Nome da organização obtentora/mantenedora da cultivar","required":false,"schema":{"type":"string"},"example":"EMBRAPA ARROZ E FEIJÃO - CNPAF"},{"name":"dataAtualizacao","in":"query","description":"Data da última atualização no formato (yyyy-MM-dd), retornando os registros com datas superiores à data indicada","required":false,"schema":{"type":"string"},"example":"2020-01-01"}],"responses":{"200":{"description":"Lista de cultivares","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CultivarResponse"},"example":{"meta":{"totalCount":1},"data":[{"idCultivar":1125830,"idCultura":1262,"safra":"2026-2027","numeroRnc":"34531","obtentorMantenedor":"EMBRAPA ARROZ E FEIJÃO - CNPAF","cultivar":"BRS FC402","cultura":"FEIJÃO IRRIGADO","potencialProdutivo":4013,"duracaoCiclo":85,"uf":"SP","grupo":"II","maturacaoFisiologica":91,"floracao":37,"enchimentoGraos":null,"sistemaCultivo":".","genetica":null,"regiao":"Não se aplica","grupoBioClimatico":null,"observacao":null,"dataAtualizacao":"2026-03-19"}]}}}},"400":{"description":"Requisição inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":{"status":400,"timestamp":"2023-08-10T22:29:39.518386937-03:00","code":"dados-invalidos","summary":"A requisição não pode ser processada.","description":"A requisição não pode ser processada por motivo de validação de atributos.","fieldErrors":[{"field":"idCultura","entity":"cultura","summary":"Preenchimento é obrigatório.","description":"Preenchimento é obrigatório."}]}}}}},"500":{"description":"Erro interno inesperado no sistema.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":{"status":500,"timestamp":"2023-07-24T18:26:35.147239529-03:00","code":"erro-de-sistema","summary":"Ocorreu um erro interno inesperado no sistema. Tente novamente e se o problema persistir, entre em contato com o administrador do sistema.","description":"Ocorreu um erro interno inesperado no sistema. Tente novamente e se o problema persistir, entre em contato com o administrador do sistema."}}}}}},"x-auth-type":"Application & Application User","x-throttling-tier":"Unlimited"}},"/cultivares/{id}":{"get":{"tags":["Cultivares"],"summary":"Retorna a cultivar desejada.","description":"Retorna a cultivar desejada.","operationId":"findById_5","parameters":[{"name":"id","in":"path","description":"Identificador da Cultivar","required":true,"schema":{"type":"integer"},"example":365295}],"responses":{"200":{"description":"Identicador da Cultivar","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CultivarSingleResponse"},"example":{"data":{"idCultivar":365295,"idCultura":60,"safra":"2021-2022","numeroRnc":"40254","obtentorMantenedor":"AVANTI SEEDS","cultivar":"AV DIGNA RR","cultura":"SOJA","potencialProdutivo":5500,"duracaoCiclo":100,"uf":"SP","grupo":"I","maturacaoFisiologica":100,"floracao":35,"enchimentoGraos":null,"sistemaCultivo":null,"genetica":null,"regiao":"3","grupoBioClimatico":"6,6","observacao":null,"dataAtualizacao":"2021-04-23"}}}}},"400":{"description":"Requisição inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":{"status":400,"timestamp":"2023-07-27T09:12:40.626561682-03:00","code":"parametro-invalido","summary":"O parâmetro de URL: id recebeu o valor: 999a, que é de um tipo inválido. Corrija e informe um valor compatível com o tipo Integer.","description":"O parâmetro de URL: id recebeu o valor: 999a, que é de um tipo inválido. Corrija e informe um valor compatível com o tipo Integer."}}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":{"status":404,"timestamp":"2023-07-24T18:22:44.608749247-03:00","code":"recurso-nao-encontrado","summary":"Recurso não encontrado.","description":"O recurso /resourcenotfound, que você tentou acessar, é inexistente."}}}}},"500":{"description":"Erro interno inesperado no sistema.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":{"status":500,"timestamp":"2023-07-24T18:26:35.147239529-03:00","code":"erro-de-sistema","summary":"Ocorreu um erro interno inesperado no sistema. Tente novamente e se o problema persistir, entre em contato com o administrador do sistema.","description":"Ocorreu um erro interno inesperado no sistema. Tente novamente e se o problema persistir, entre em contato com o administrador do sistema."}}}}}},"x-auth-type":"Application & Application User","x-throttling-tier":"Unlimited"}}},"components":{"schemas":{"Cultivar":{"type":"object","properties":{"idCultivar":{"type":"number","description":"Identificador da Cultivar"},"idCultura":{"type":"number","description":"Identificador da Cultura"},"safra":{"type":"string","description":"Ano da safra no formato yyyy-yyyy"},"numeroRnc":{"type":"string","description":"Número RNC (Registro Nacional de Cultivares)"},"obtentorMantenedor":{"type":"string","description":"Obtentor e/ou mantenedor"},"cultivar":{"type":"string","description":"Nome da Cultivar"},"cultura":{"type":"string","description":"Nome da Cultura"},"potencialProdutivo":{"type":"number","description":"Potencial produtivo","format":"double"},"duracaoCiclo":{"type":"integer","description":"Duração do ciclo","format":"int32"},"uf":{"type":"string","description":"Sigla da Unidade da Federação"},"grupo":{"type":"string","description":"<p>Grupo I - Ciclo de Desenvolvimento Precoce</p>\n<p>Grupo II - Ciclo de Desenvolvimento Médio</p>\n<p>Grupo III - Ciclo de Desenvolvimento Tardio</p>\n"},"maturacaoFisiologica":{"type":"number","description":"Maturação fisiológica","format":"double"},"floracao":{"type":"number","description":"Floração","format":"double"},"enchimentoGraos":{"type":"number","description":"Enchimento de grãos","format":"double"},"sistemaCultivo":{"type":"string","description":"<p>sequeiro - sem irrigação</p>\n<p>irrigado - com irrigação</p>\n<p>sequeiro/irrigado - com ou sem irrigação</p>\n"},"genetica":{"type":"string","description":"<p>híbrido simples - cruzamento de duas linhagens puras</p>\n<p>híbrido duplo - cruzamento entre dois híbridos simples</p>\n<p>híbrido triplo - cruzamento entre uma linha pura e um híbrido simples</p>\n<p>variedade - cruzamento natural entre plantas da mesma linhagem</p>\n"},"regiao":{"type":"string","description":"Região de adaptação, aplicado somente à cultura da Soja e Trigo"},"grupoBioClimatico":{"type":"string","description":"Classificação do ciclo da soja baseado no grupo de maturidade relativa"},"observacao":{"type":"string","description":"Informações gerais como, por exemplo, transformação genética"},"dataAtualizacao":{"type":"string","description":"Data da última atualização no formato (yyyy-MM-dd), se informada"}},"description":"Dados da cultivar"},"CultivarResponse":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/Meta"},"data":{"type":"array","description":"Um objeto do tipo data que encapsula um array de objetos com o resultado da consulta","items":{"$ref":"#/components/schemas/Cultivar"}}}},"CultivarSingleResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Cultivar"}}},"Cultura":{"type":"object","properties":{"id":{"type":"number","description":"Identificador da cultura"},"nome":{"type":"string","description":"Nome da cultura"},"nomeCompleto":{"type":"string","description":"Nome completo da cultura, incluindo informações do cultivo e clima"},"safra":{"type":"string","description":"Tipo de safra"},"cultivo":{"type":"string","description":"Tipo de cultivo"},"clima":{"type":"string","description":"Tipo de clima"},"hasZoneamento":{"type":"boolean","description":"Cultura possui Zoneamento Agrícola associado"},"hasCultivar":{"type":"boolean","description":"Cultura possui Cultivar associada"},"hasProdutividade":{"type":"boolean","description":"Cultura possui Cálculo de Produtividade associado"},"hasAdubacao":{"type":"boolean","description":"Cultura possui Cálculo de Adubação associado"},"isSoja":{"type":"boolean","description":"Indica se a cultura é soja ou não"},"isTrigo":{"type":"boolean","description":"Indica se a cultura é trigo ou não"},"dataAtualizacao":{"type":"string","description":"Data da última atualização no formato (yyyy-MM-dd), se informada"}},"description":"Dados da cultura"},"CulturaResponse":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/Meta"},"data":{"type":"array","description":"Um objeto do tipo data que encapsula um array de objetos com o resultado da consulta","items":{"$ref":"#/components/schemas/Cultura"}}}},"CulturaSingleResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Cultura"}}},"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"status":{"type":"integer","description":"Código de status do erro","format":"int32"},"timestamp":{"type":"string","description":"Data e hora do erro","format":"date-time"},"code":{"type":"string","description":"Código do erro"},"summary":{"type":"string","description":"Descrição resumida do erro"},"description":{"type":"string","description":"Descrição detalhada do erro"},"fieldErrors":{"type":"array","description":"Lista opcional de atributo(s)/campo(s) com erro","items":{"$ref":"#/components/schemas/FieldError"}}}}}},"FieldError":{"type":"object","properties":{"code":{"type":"string","description":"Código do erro"},"field":{"type":"string","description":"Atributo/Campo com erro"},"entity":{"type":"string","description":"Entidade do erro"},"summary":{"type":"string","description":"Descrição resumida do erro"},"description":{"type":"string","description":"Descrição detalhada do erro"}},"description":"Atributos do campo com erro"},"Meta":{"type":"object","properties":{"totalCount":{"type":"integer","description":"Total de registros retornados","format":"int32"}},"description":"Metadados de informações sobre o resultado da consulta"},"Municipio":{"type":"object","properties":{"codigoIBGE":{"type":"number","description":"Código IBGE do município"},"nome":{"type":"string","description":"Nome do município"},"uf":{"type":"string","description":"Sigla da Unidade da Federação"},"latitude":{"type":"number","description":"Latitude do munícipio","format":"double"},"longitude":{"type":"number","description":"Latitude do munícipio","format":"double"},"regiaoSoja":{"type":"string","description":"Região da soja"},"regiaoTrigo":{"type":"string","description":"Região do trigo"},"dataAtualizacao":{"type":"string","description":"Data da última atualização no formato (yyyy-MM-dd), se informada"}},"description":"Dados de municípios brasileiros"},"MunicipioResponse":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/Meta"},"data":{"type":"array","description":"Um objeto do tipo data que encapsula um array de objetos com o resultado da consulta","items":{"$ref":"#/components/schemas/Municipio"}}}},"MunicipioSingleResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Municipio"}}},"ObtentorMantenedor":{"type":"object","properties":{"obtentorMantenedor":{"type":"string","description":"Nome da organização obtentora/mantenedora de cultivares"},"dataAtualizacao":{"type":"string","description":"Data da última atualização no formato (yyyy-MM-dd), se informada"}},"description":"Dados da organização obtentora/mantenedora de cultivares"},"ObtentorMantenedorResponse":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/Meta"},"data":{"type":"array","description":"Um objeto do tipo data que encapsula um array de objetos com o resultado da consulta","items":{"$ref":"#/components/schemas/ObtentorMantenedor"}}}},"Produtividade":{"type":"object","properties":{"produtividadeAlmejada":{"type":"array","description":"Produtividade estimada pelo modelo agrometeorológico (dia 1 ao dia N).","items":{"type":"number","description":"Produtividade estimada pelo modelo agrometeorológico (dia 1 ao dia N).","format":"double"}},"produtividadeMediaMunicipio":{"type":"array","description":"Produtividade média do município (dia 1 ao dia N).","items":{"type":"number","description":"Produtividade média do município (dia 1 ao dia N).","format":"double"}},"temperaturaMinima":{"type":"array","description":"Temperatura mínima do dia 1 ao dia N.","items":{"type":"number","description":"Temperatura mínima do dia 1 ao dia N.","format":"double"}},"temperaturaMaxima":{"type":"array","description":"Temperatura máxima do dia 1 ao dia N.","items":{"type":"number","description":"Temperatura máxima do dia 1 ao dia N.","format":"double"}},"precipitacao":{"type":"array","description":"Precipitação diária do dia 1 ao dia N.","items":{"type":"number","description":"Precipitação diária do dia 1 ao dia N.","format":"double"}},"grausDia":{"type":"array","description":"Graus dia acumulado do dia 1 ao dia N.","items":{"type":"number","description":"Graus dia acumulado do dia 1 ao dia N.","format":"double"}},"balancoHidrico":{"type":"array","description":"Água disponível no solo (mm/m2) do dia 1 ao dia N.","items":{"type":"number","description":"Água disponível no solo (mm/m2) do dia 1 ao dia N.","format":"double"}},"deficienciaHidrica":{"type":"array","description":"Quantidade de água disponível para uma determinada cultura é insuficiente para suprir as necessidades hídricas desta cultura (dia 1 ao dia N).","items":{"type":"number","description":"Quantidade de água disponível para uma determinada cultura é insuficiente para suprir as necessidades hídricas desta cultura (dia 1 ao dia N).","format":"double"}},"excedenteHidrico":{"type":"array","description":"Quantidade de água disponível é maior do que a necessidade hídrica da cultura (dia 1 ao dia N).","items":{"type":"number","description":"Quantidade de água disponível é maior do que a necessidade hídrica da cultura (dia 1 ao dia N).","format":"double"}},"isna":{"type":"array","description":"ISNA (Índice de Satisfação das Necessidades de Água) é um indicador utilizado para avaliar a disponibilidade de água para atender às demandas de uma cultura (dia 1 ao dia N).","items":{"type":"number","description":"ISNA (Índice de Satisfação das Necessidades de Água) é um indicador utilizado para avaliar a disponibilidade de água para atender às demandas de uma cultura (dia 1 ao dia N).","format":"double"}}},"description":"Dados de Produtividade"},"ProdutividadeResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Produtividade"}}},"Solo":{"type":"object","properties":{"tipo":{"type":"string","description":"Tipo do solo"},"descricao":{"type":"string","description":"Descrição do solo"}},"description":"Dados do solo"},"SoloResponse":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/Meta"},"data":{"type":"array","description":"Um objeto do tipo data que encapsula um array de objetos com o resultado da consulta","items":{"$ref":"#/components/schemas/Solo"}}}},"SoloSingleResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Solo"}}},"Zoneamento":{"type":"object","properties":{"municipio":{"type":"string","description":"Nome do município"},"uf":{"type":"string","description":"Sigla da Unidade da Federação"},"cultura":{"type":"string","description":"Nome da cultura"},"culturaNomeCompleto":{"type":"string","description":"Nome completo da cultura, incluindo informações do cultivo e clima"},"culturaSafra":{"type":"string","description":"Tipo de safra da cultura"},"culturaCultivo":{"type":"string","description":"Tipo de cultivo da cultura"},"culturaClima":{"type":"string","description":"Tipo de clima da cultura"},"ciclo":{"type":"string","description":"Nome do ciclo"},"solo":{"type":"string","description":"Nome do solo"},"diaIni":{"type":"integer","description":"Dia de início","format":"int32"},"mesIni":{"type":"integer","description":"Mês de início","format":"int32"},"diaFim":{"type":"integer","description":"Dia final","format":"int32"},"mesFim":{"type":"integer","description":"Mês final","format":"int32"},"safraIni":{"type":"integer","description":"Ano de início da safra no formato (YYYY)","format":"int32"},"safraFim":{"type":"integer","description":"Ano final da safra no formato (YYYY)","format":"int32"},"risco":{"type":"integer","description":"Risco máximo","format":"int32"},"portaria":{"type":"string","description":"Portaria e data da publicação"}},"description":"Dados do Zoneamento Agrícola de Risco Climático (Zarc)"},"ZoneamentoInformacaoAdicional":{"type":"object","properties":{"safra":{"type":"string","description":"Safra atual no formato yyyy-yyyy"},"portaria":{"type":"string","description":"Portaria e data da publicação"},"grupos":{"type":"string","description":"Informações de grupos para a maturação da cultura"},"solos":{"type":"string","description":"Informações de solos quanto à sua capacidade de retenção de água"}},"description":"Informações adicionais do Zoneamento Agrícola de Risco Climático (Zarc)"},"ZoneamentoInformacaoAdicionalResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/ZoneamentoInformacaoAdicional"}}},"ZoneamentoMunicipio":{"type":"object","properties":{"cultura":{"type":"string","description":"Nome da cultura"},"culturaNomeCompleto":{"type":"string","description":"Nome completo da cultura, incluindo informações do cultivo e clima"},"culturaSafra":{"type":"string","description":"Tipo de safra da cultura"},"culturaCultivo":{"type":"string","description":"Tipo de cultivo da cultura"},"culturaClima":{"type":"string","description":"Tipo de clima da cultura"},"solo":{"type":"string","description":"Nome do solo"},"soloNomeCurto":{"type":"string","description":"Nome curto do solo"},"ciclo":{"type":"string","description":"Nome do ciclo"},"cicloNomeCurto":{"type":"string","description":"Nome curto do ciclo"},"risco":{"type":"array","description":"Risco máximo com 36 posições, compreendo o intervalo e os decêndios entre os meses de Janeiro e Dezembro","items":{"type":"integer","description":"Risco máximo com 36 posições, compreendo o intervalo e os decêndios entre os meses de Janeiro e Dezembro","format":"int32"}},"portaria":{"type":"string","description":"Portaria e data da publicação"}},"description":"Dados do Zoneamento Agrícola de Risco Climático (Zarc) do Município"},"ZoneamentoMunicipioCiclo":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/Meta"},"data":{"type":"array","description":"Lista de ciclos de desenvolvimento da cultura disponíveis para consulta dos dados do Zoneamento Agrícola de Risco Climático (Zarc)","items":{"type":"string","description":"Lista de ciclos de desenvolvimento da cultura disponíveis para consulta dos dados do Zoneamento Agrícola de Risco Climático (Zarc)"}}},"description":"Lista de ciclos de desenvolvimento da cultura disponíveis para consulta dos dados do Zoneamento Agrícola de Risco Climático (Zarc)"},"ZoneamentoMunicipioResponse":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/Meta"},"data":{"type":"array","description":"Um objeto do tipo data que encapsula um array de objetos com o resultado da consulta","items":{"$ref":"#/components/schemas/ZoneamentoMunicipio"}}}},"ZoneamentoMunicipioSolo":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/Meta"},"data":{"type":"array","description":"Lista de solos disponíveis para consulta dos dados do Zoneamento Agrícola de Risco Climático (Zarc)","items":{"type":"string","description":"Lista de solos disponíveis para consulta dos dados do Zoneamento Agrícola de Risco Climático (Zarc)"}}},"description":"Lista de solos disponíveis para consulta dos dados do Zoneamento Agrícola de Risco Climático (Zarc)"},"ZoneamentoResponse":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/Meta"},"data":{"type":"array","description":"Um objeto do tipo data que encapsula um array de objetos com o resultado da consulta","items":{"$ref":"#/components/schemas/Zoneamento"}}}}},"securitySchemes":{"default":{"type":"oauth2","flows":{"implicit":{"authorizationUrl":"https://api.cnptia.embrapa.br/authorize","scopes":{}}}}}},"servers":[{"url":"https://api.cnptia.embrapa.br/agritec/v2"},{"url":"http://api.cnptia.embrapa.br/agritec/v2"}]}