Pular para o conteúdo

Versões

Nomes de tabelas e de colunas e os tipos são o contrato da v2. O seu modelo no Power BI depende deles, então eles não mudam dentro da v2.

O que pode mudar na v2 é só o que não quebra um modelo pronto:

  • tabelas novas;
  • colunas novas numa tabela existente;
  • descrições mais claras.

Renomear ou remover uma tabela ou uma coluna só numa versão nova (/v3), com as duas no ar durante a troca.

A v1 (https://service.agrosti.com.br/odata/v1) continua no ar para quem já usa, com a documentação dela. As diferenças:

v1 v2
Endereço service.agrosti.com.br/odata/v1 platform.agrosti.com.br/v2/
Nomes Inglês (Activities, grossWeightKg) Português (apontamentos, peso_bruto_kg)
Tabelas Projeções e coleções prontas Uma linha por registro, com colunas de apoio para somar certo, e relatórios prontos por mês
Token oag_… O mesmo token, com os mesmos escopos

O mesmo token vale nas duas. Para migrar um relatório, troque a fonte para a v2 e refaça as colunas pelos nomes novos. As páginas das tabelas trazem cada coluna.

Coleção da v1 Na v2
Activities apontamentos; custo em custos_apontamentos
ActivityAreas apontamentos_talhoes
ActivityInputs apontamentos_insumos; valor em custos_insumos
ActivityLabor apontamentos_equipes; valor em custos_mao_obra
ActivityMachines apontamentos_maquinas; valor em custos_maquinas
ActivityPauses apontamentos_pausas
ActivityIssues ocorrencias
AgriculturalCostRows custos_talhoes
Harvest apontamentos_talhoes com eh_carga_colheita; resumo em resumo_colheita
HarvestPlantPeriods resumo_produtividade (kg por planta e por hectare)
HarvestPoints pontos_colheita
Sales vendas; valor em vendas_valores; desconto, Funrural e valor líquido no cabeçalho, lancamentos_vendas
SalesPerformancePeriods vendas_valores somado por mês; receita classificada em resultados_competencia
WeighingTickets pesagens_balanca; frete em fretes
Farms fazendas; sócios em fazendas_socios
Areas setores
Subareas talhoes
Budgets ordens_producao
BudgetAreas ordens_producao_talhoes
PlantingCharacteristics plantios
ResinRamals ramais_resina
WorkOrderHeaders ordens_servico
WorkOrders ordens_servico_talhoes
WorkOrderInputs ordens_servico_insumos
WorkOrderTargets ordens_servico_alvos
PestScoutings inspecoes_mip; resumo em resumo_mip
Traps, TrapReadings armadilhas, verificacoes_armadilhas
WeatherStations, WeatherReadings estacoes_meteorologicas, leituras_meteorologicas
WaterReadings leituras_agua
MarketQuotes cotacoes
InventoryMovements movimentos_estoque; compras em entradas_estoque; saldo de hoje em saldos_estoque, com o valor em saldos_estoque_valores
InventoryTransfers transferencias_estoque
Assets maquinas
MaintenanceEntries lancamentos_servicos; a manutenção apontada por bem em apontamentos_bens, com o valor em custos_bens
Operations operacoes
Units unidades
CostCenters centros_custo
Crops a coluna cultura das tabelas
Employees, Workers funcionarios
Teams equipes
Timesheets ponto
Payables, Receivables contas_pagar, contas_receber
LedgerEntries rateios_pagar, rateios_receber; por OP e talhão em rateios_producao
LedgerDocuments lancamentos
ChartAccounts contas_gerenciais; dados bancários em contas_bancarias
BankEntries movimentos_bancarios
CashBalancePeriods saldos_bancarios_mensais
CashPlanEntries previsoes_caixa
Animals, AnimalRegistry animais
AnimalLineage genealogia_animais
AnimalSales vendas_animais
AnimalValuations avaliacoes_animais
BreedingProtocols protocolos_animais
LivestockActivities manejos
LivestockActivityCosts custos_animais
LivestockInputs insumos_rebanho
FeedIngredients, FeedProducts batidas_racao, produtos_racao
SprayReconciliation ordens_servico_talhoes com apontamentos_talhoes pela OS

A v2 também traz tabelas que a v1 não tinha: o cadastro de defensivos, a análise de solo, os polígonos dos talhões, os orçamentos, a folha, as notas fiscais e os MDF-e, o LCPR e os relatórios prontos.