autorizacoes_defensivos v1.1¶
Relações cadastrais de produtos, culturas e pragas publicadas pelo Agrofit/MAPA
Fonte: MAPA. Registro do contrato: agrofit_autorizacoes.
Schema¶
| Coluna | Tipo | Nulo | Unidade | Descrição |
|---|---|---|---|---|
nr_registro |
str | Não | — | — |
marca_comercial |
str | Sim | — | — |
ingrediente_ativo |
str | Sim | — | — |
titular |
str | Sim | — | — |
classe |
str | Sim | — | — |
cultura |
str | Sim | — | — |
praga |
str | Sim | — | — |
praga_nome_comum |
str | Sim | — | — |
modalidade_de_emprego |
str | Sim | — | — |
situacao |
str | Sim | — | — |
Chave primária: Não definida; repetições da fonte são preservadas.
Todas as colunas estáveis devem existir, inclusive anuláveis e em resultados vazios. Mudanças incompatíveis exigem versão major do contrato.
Semântica e proveniência¶
Preserva cada autorização publicada, inclusive repetições. O registro é texto exato, com zeros iniciais. A ausência de uma chave primária é deliberada: registro, cultura e praga não provam unicidade.
return_meta=True retorna dados e MetaInfo, com fontes tentadas/selecionada, aquisição, versão contratual e diagnósticos da fonte. Estas publicações correntes não permitem selecionar uma revisão histórica via deterministic.
Parâmetros¶
| Parâmetro | Tipo | Padrão |
|---|---|---|
nr_registro |
str \| None |
None |
cultura |
str \| None |
None |
ingrediente_ativo |
str \| None |
None |
classe |
str \| None |
None |
situacao |
str \| None |
None |
use_cache |
bool |
True |
as_polars |
bool |
False |
return_meta |
bool |
False |
Exemplo¶
from agrobr import contracts, datasets
df, meta = await datasets.autorizacoes_defensivos(nr_registro="08725", return_meta=True)
contracts.validate_dataset(df, "agrofit_autorizacoes")
Para chamadas síncronas, use from agrobr.sync import datasets e remova await. as_polars=True requer pip install agrobr[polars].
Schema JSON e licença¶
agrobr/schemas/agrofit_autorizacoes.json · get_contract("agrofit_autorizacoes").
livre — consulte as licenças e os detalhes da API/fonte.
Exportação de 18/09/2026¶
Os dois CSVs da exportação de 18/09/2026 contêm 4.403 produtos formulados, 279.707 ocorrências de autorização e 2.992 produtos técnicos. Duas expressões ambíguas dessa exportação, 1.9 10*10 UFC/g e 200 1x10E10 UFC/g, mantêm o texto e saem com valor e unidade nulos e diagnóstico. A interpretação numérica não é garantida para toda a população de componentes.
O cache preserva valores não nulos, tipos, posição dos componentes e proveniência UTC; None e pd.NA só se equivalem em campos anuláveis. Colunas textuais de composição e situação preservam o literal; outros campos mantêm a limpeza já documentada. Autorizações não são deduplicadas.
Um sufixo publicado nos campos de concentração pode conter expressão ambígua e não certifica, por si, uma unidade ou interpretação numérica. Catálogo, CSV e cache têm a mesma origem: nenhum deles confirma a população histórica.