# OpenAGROs

> A API pública do AGROs: dados agrícolas, financeiros e de pecuária de
> quem produz. Somente leitura, OData v4 e REST sobre o mesmo modelo,
> autenticada por token de integração (`Authorization: Bearer oag_...`).
> Base OData: `https://service.agrosti.com.br/odata/v1/`.

Antes de somar qualquer medida, leia Como modelar sem errar: as decisões
de modelagem desta API não dão erro quando estão erradas — dão um número
plausível. Para o conteúdo inteiro num arquivo só, use
[llms-full.txt](https://docs.agrosti.com.br/llms-full.txt).

## Guias

- [Visão geral](https://docs.agrosti.com.br/): o que a API expõe e por onde começar.
- [Autenticação](https://docs.agrosti.com.br/autenticacao): criar o token, escopos, limites e revogação.
- [Como modelar sem errar](https://docs.agrosti.com.br/modelagem): as armadilhas que produzem número errado com cara de certo.
- [Conectar o Power BI](https://docs.agrosti.com.br/power-bi): conector, credencial, relacionamentos e desempenho.
- [Erros](https://docs.agrosti.com.br/erros): o formato do erro e o que fazer com cada código.
- [Versionamento](https://docs.agrosti.com.br/versionamento): o que a v1 garante e o que pode mudar.
- [Skill para agentes de IA](https://docs.agrosti.com.br/ia): instalar a skill, com a referência e um cliente de linha de comando.

## Consulta

- [OData](https://docs.agrosti.com.br/odata): `$filter`, `$orderby`, `$select`, paginação e `$metadata`.
- [REST](https://docs.agrosti.com.br/rest): as mesmas coleções em JSON paginado.

## Fatos

O que você soma. Uma linha por evento.

- [Activities](https://docs.agrosti.com.br/odata/activities): Apontamentos. O registro de uma operação no campo: quando foi, em que fase e quanto custou. Uma linha por apontamento.
- [ActivityAreas](https://docs.agrosti.com.br/odata/activity-areas): Apontamentos por talhão. Onde cada apontamento aconteceu e quanto produziu. Uma linha por talhão trabalhado.
- [ActivityLabor](https://docs.agrosti.com.br/odata/activity-labor): Mão de obra. Quem trabalhou em cada apontamento, por quantas horas e a que custo.
- [ActivityInputs](https://docs.agrosti.com.br/odata/activity-inputs): Insumos. O que foi aplicado em cada apontamento: produto, quantidade e valor.
- [ActivityMachines](https://docs.agrosti.com.br/odata/activity-machines): Máquinas e implementos. Que equipamento rodou em cada apontamento, por quantas horas e com que telemetria.
- [Harvest](https://docs.agrosti.com.br/odata/harvest): Colheita. A produção colhida por talhão, em quilos e na unidade da fazenda (caixa, saca, tambor).
- [Sales](https://docs.agrosti.com.br/odata/sales): Vendas. As linhas comerciais: cliente, produto, quantidade e faturamento.
- [WeighingTickets](https://docs.agrosti.com.br/odata/weighing-tickets): Pesagens e transporte. Os tickets da balança: pesos, origem, destino, transportador e frete.
- [Payables](https://docs.agrosti.com.br/odata/payables): Contas a pagar. Os títulos a pagar, com emissão, vencimento e sinais de baixa.
- [LivestockActivities](https://docs.agrosti.com.br/odata/livestock-activities): Manejos pecuários. O registro de um manejo do rebanho: quando, em que fase e quanto custou.
- [LivestockActivityCosts](https://docs.agrosti.com.br/odata/livestock-activity-costs): Custo por animal. O custo de cada manejo aberto por animal e por território.
- [LedgerEntries](https://docs.agrosti.com.br/odata/ledger-entries): Lançamentos. O espelho detalhado dos lançamentos: conta, contraparte, quantidade e valor.
- [PestScoutings](https://docs.agrosti.com.br/odata/pest-scoutings): Monitoramento de pragas. As amostragens de MIP: praga encontrada, resultado e quem monitorou.
- [WeatherReadings](https://docs.agrosti.com.br/odata/weather-readings): Leituras de estação. As leituras das estações meteorológicas por fazenda.
- [Receivables](https://docs.agrosti.com.br/odata/receivables): Contas a receber. Os títulos a receber, com emissão, vencimento e sinais de baixa.
- [Budgets](https://docs.agrosti.com.br/odata/budgets): Orçamentos. O planejamento de cada ordem de produção: área, custo orçado e produtividade estimada.
- [BudgetAreas](https://docs.agrosti.com.br/odata/budget-areas): Orçamento por talhão. O orçamento aberto por talhão. A área aqui é a planejada — a física vive em Subareas.
- [ActivityPauses](https://docs.agrosti.com.br/odata/activity-pauses): Pausas. As paradas dentro de um apontamento, com motivo e duração.
- [ActivityIssues](https://docs.agrosti.com.br/odata/activity-issues): Ocorrências. Os problemas reportados durante um apontamento, com prioridade e resolução.
- [HarvestPoints](https://docs.agrosti.com.br/odata/harvest-points): Colheita por ponto. Cada quantidade colhida por uma pessoa, com coordenada — o detalhe fino da mão de obra.
- [WorkOrders](https://docs.agrosti.com.br/odata/work-orders): Ordens de serviço. O planejamento da aplicação: alvo, calda, bico, velocidade e equipamento previstos.
- [WorkOrderHeaders](https://docs.agrosti.com.br/odata/work-order-headers): Cabeçalho da ordem de serviço. Uma linha por O.S., com os prazos, a situação e o alvo. É onde vivem as datas planejadas que a coleção por talhão não carrega.
- [WorkOrderInputs](https://docs.agrosti.com.br/odata/work-order-inputs): Receita da ordem de serviço. O insumo PLANEJADO: dose por bomba e capacidade da bomba. Não confunda com os insumos do apontamento, que são o consumo real.
- [WorkOrderTargets](https://docs.agrosti.com.br/odata/work-order-targets): Alvos da ordem de serviço. Os alvos declarados na O.S., com tolerância. Coleção separada porque uma O.S. pode ter vários alvos.
- [SprayReconciliation](https://docs.agrosti.com.br/odata/spray-reconciliation): Conciliação da pulverização. Planejado × aplicado por O.S. e subárea, com rateio de custo e equivalência em bombas já resolvidos. Some as colunas à vontade: só as terminadas em razão (por hectare, percentual) devem ser recalculadas.
- [InventoryMovements](https://docs.agrosti.com.br/odata/inventory-movements): Movimentação de estoque. Entradas e saídas de insumo. É fluxo do período, não posição de estoque.
- [Timesheets](https://docs.agrosti.com.br/odata/timesheets): Ponto. A jornada por pessoa e dia, com horas normais e extras.
- [BankEntries](https://docs.agrosti.com.br/odata/bank-entries): Movimentação bancária. Os lançamentos de tesouraria: débito, crédito, conta e conciliação.
- [CashPlanEntries](https://docs.agrosti.com.br/odata/cash-plan-entries): Plano de caixa. Os lançamentos planejados, com valor previsto, pago e em aberto.
- [MarketQuotes](https://docs.agrosti.com.br/odata/market-quotes): Cotações. As séries de índices de mercado. Exige escolher a série no filtro.
- [WaterReadings](https://docs.agrosti.com.br/odata/water-readings): Leituras de hidrômetro. O consumo de água medido por canal, em metros cúbicos.
- [TrapReadings](https://docs.agrosti.com.br/odata/trap-readings): Leituras de armadilha. O que foi capturado em cada armadilha, por praga e data.
- [FeedIngredients](https://docs.agrosti.com.br/odata/feed-ingredients): Ingredientes da ração. O que entrou em cada batida, com quantidade planejada e efetiva — a diferença é o desvio da fórmula.
- [FeedProducts](https://docs.agrosti.com.br/odata/feed-products): Produtos da ração. O que saiu de cada batida, com quantidade e custo.
- [BreedingProtocols](https://docs.agrosti.com.br/odata/breeding-protocols): Protocolos reprodutivos. Os protocolos por animal: inseminação, prenhez, nascimento e custo.
- [AnimalSales](https://docs.agrosti.com.br/odata/animal-sales): Histórico comercial. Compras e vendas do rebanho, com valores e proprietários.
- [AnimalValuations](https://docs.agrosti.com.br/odata/animal-valuations): Valores por animal. A posição de valor de cada animal. Inicial e final descrevem o mesmo animal em momentos diferentes.
- [LivestockInputs](https://docs.agrosti.com.br/odata/livestock-inputs): Insumos do manejo. O que foi aplicado em cada manejo pecuário.
- [ResinRamals](https://docs.agrosti.com.br/odata/resin-ramals): Ramais de resina. Os ramais planejados. As faces são posição, não quantidade — só o total soma.

## Dimensões

Por onde você fatia. Uma linha por entidade do cadastro — por isso área em hectares se soma aqui, nunca no fato.

- [Farms](https://docs.agrosti.com.br/odata/farms): Fazendas. O primeiro nível do território.
- [Areas](https://docs.agrosti.com.br/odata/areas): Áreas. O nível intermediário: cada fazenda tem várias áreas.
- [Subareas](https://docs.agrosti.com.br/odata/subareas): Subáreas. O talhão, nível mais fino do território — e onde vive a área física em hectares.
- [AnimalRegistry](https://docs.agrosti.com.br/odata/animal-registry): Cadastro de animais. Os animais do rebanho, com identificação, aptidão e datas.
- [Workers](https://docs.agrosti.com.br/odata/workers): Funcionários. As pessoas que aparecem nos apontamentos de mão de obra.
- [Teams](https://docs.agrosti.com.br/odata/teams): Equipes. As equipes cadastradas.
- [Crops](https://docs.agrosti.com.br/odata/crops): Culturas. As culturas que aparecem nos apontamentos.
- [Units](https://docs.agrosti.com.br/odata/units): Unidades. As unidades de medida cadastradas, com fator de conversão.
- [CostCenters](https://docs.agrosti.com.br/odata/cost-centers): Centros de custo. Os centros de custo, com as áreas própria e arrendada.
- [WeatherStations](https://docs.agrosti.com.br/odata/weather-stations): Estações meteorológicas. O cadastro das estações. As leituras estão em WeatherReadings.
- [Traps](https://docs.agrosti.com.br/odata/traps): Armadilhas. O cadastro das armadilhas instaladas, com posição e quadrante.
- [AnimalLineage](https://docs.agrosti.com.br/odata/animal-lineage): Genealogia. Pai e mãe de cada animal. Para subir gerações, relacione de volta ao próprio identificador.

## Legado

Anteriores ao modelo em estrela, com campos em português. Não filtram nem ordenam.

- [Employees](https://docs.agrosti.com.br/odata/employees): Funcionários (legado). Cadastro compartilhado com os aplicativos de campo. Campos em português.
- [Operations](https://docs.agrosti.com.br/odata/operations): Operações (legado). Cadastro compartilhado com os aplicativos de campo. Campos em português.
- [Animals](https://docs.agrosti.com.br/odata/animals): Animais (legado). Cadastro compartilhado com os aplicativos de campo. Para o modelo em estrela, use AnimalRegistry.