Ir para o conteúdo

API DERAL

O módulo DERAL fornece dados de condição de lavouras, progresso de plantio e colheita do Departamento de Economia Rural do Parana.

Funções

condicao_lavouras

Condição semanal das lavouras paranaenses.

async def condicao_lavouras(
    produto: str | None = None,
    *,
    as_polars: bool = False,
    return_meta: bool = False,
) -> pd.DataFrame | tuple[pd.DataFrame, MetaInfo]

Parâmetros:

Parâmetro Tipo Descrição
produto str \| None Filtrar por produto: "cafe", "cevada", "feijao", "feijao_1", "feijao_2", "milho", "milho_1", "milho_2", "soja" ou "trigo", com os sinônimos do agrobr. None retorna todos; outro nome levanta InvalidParameterError antes da rede
as_polars bool Retorna polars DataFrame
return_meta bool Se True, retorna tupla (DataFrame, MetaInfo)

Retorno:

DataFrame com colunas: produto, data (datetime64[ns]), condicao, pct, plantio_pct, colheita_pct

Exemplo:

from agrobr import deral

# Todas as lavouras
df = await deral.condicao_lavouras()

# Apenas soja
df = await deral.condicao_lavouras("soja")

# Com metadados
df, meta = await deral.condicao_lavouras("milho", return_meta=True)

Versão Síncrona

from agrobr.sync import deral

df = deral.condicao_lavouras("soja")

Notas

  • Fonte: DERAL/SEAB-PR — licença livre
  • Dados exclusivos do Parana
  • Publicado em Excel (PC.xls) — layout pode variar entre safras

Leitura da planilha PC.xls

O PC.xls publicado em fevereiro e em setembro de 2026 é BIFF/XLS: 26 abas, 438 registros de condição e 730 células numéricas de condição, plantio e colheita. A extensão .xlsx de um arquivo antigo não indica o formato real.

Os percentuais publicados nessas edições estão em pontos percentuais (0–100), sem conversão de frações formatadas como porcentagem. As colunas de fase fenológica e comercialização, as linhas de batata e de soja de segunda safra ficam fora do contrato atual. Uma aba que informa feriado sem observações não produz registros ou zeros. O nome 18-12-2017 contém referência publicada de 08/01/2018; a data vem da célula, conforme a publicação.

O parser 2 exige os cabeçalhos Ruim, Média, Boa, Plantada e Colhida nas tabelas com várias culturas. Se faltar um deles, a fonte levanta ParseError e o dataset também levanta ParseError ("Todas as fontes falharam por layout", com o motivo da fonte em errors), evitando sucesso parcial com apenas as abas históricas. O contrato é a versão 2.0: data passou de texto dd/mm/yyyy a datetime64[ns].