Versões
O que não muda na v2
Seção intitulada “O que não muda na v2”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.
Da v1 para a v2
Seção intitulada “Da v1 para a v2”| 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.