Integrações
OData V4 lado a lado com V2
Lefia detecta automaticamente OData V2 ou V4 por URL. 4 services com V4 disponível (Billing, Sales Order, Purchase Order, Product). Catálogos separados, mapping editor mostra fields da versão correta. V4 expõe header pricing populado, descriptions humanas e rollups Net/Gross/Profit.
Atualizado em 8/6/2026
O Lefia agora trabalha com OData V2 e V4 simultaneamente. Você não precisa escolher um — pode ter integrações V2 antigas funcionando enquanto cria novas em V4.
Connection: ao criar nova, a lista de sugestões mostra os 4 services com versão V4 disponível (Billing Document, Sales Order, Purchase Order, Material/Product) como recomendação default. As versões V2 ficam disponíveis com label "(V2 legacy)" pra clientes em S/4HANA on-prem antigo. Outbound Delivery e Business Partner ficam só em V2 — V4 desses dois não existe no sandbox SAP API Hub.
Detecção automática: o Lefia identifica V2 ou V4 pela URL — não precisa configurar nada. URLs com
Mapping editor: cada Message Type tem catálogo correspondente à versão. V2 mostra fields com prefix
Payload viewer: badge mostra "OData V2" ou "OData V4" automaticamente. Os toggles disponíveis também mudam por versão — V2 tem 3 (esconder __metadata, datas humanizadas, achatar results[]); V4 tem 1 (esconder @odata.*).
V4 traz informação que V2 não expõe pra Billing Document:
Decisão de migrar é sua. Connections existentes continuam funcionando em V2 sem nenhuma ação. Pra começar a usar V4, crie uma connection nova apontando pra URL V4.
O que muda na prática
Connection: ao criar nova, a lista de sugestões mostra os 4 services com versão V4 disponível (Billing Document, Sales Order, Purchase Order, Material/Product) como recomendação default. As versões V2 ficam disponíveis com label "(V2 legacy)" pra clientes em S/4HANA on-prem antigo. Outbound Delivery e Business Partner ficam só em V2 — V4 desses dois não existe no sandbox SAP API Hub.
Detecção automática: o Lefia identifica V2 ou V4 pela URL — não precisa configurar nada. URLs com
/odata/sap/API__SRV = V2; URLs com /odata4/sap/api_/srvd_a2x/sap/*/0001 = V4.Mapping editor: cada Message Type tem catálogo correspondente à versão. V2 mostra fields com prefix
to_ (ex: to_Item.Material); V4 mostra com prefix _ (ex: _Item.Material). Não dá pra misturar paths V2 e V4 dentro do mesmo mapping.Payload viewer: badge mostra "OData V2" ou "OData V4" automaticamente. Os toggles disponíveis também mudam por versão — V2 tem 3 (esconder __metadata, datas humanizadas, achatar results[]); V4 tem 1 (esconder @odata.*).
Por que migrar pra V4?
V4 traz informação que V2 não expõe pra Billing Document:
- Header pricing populado (V2 vinha sempre vazio — limitação SAP)
- PriceElementDescription humana ("Price", "Gross Value", "Net Value", "Profit Margin") em vez de só código
- Rollups calculados (Net Value 1, Net Value 2, Total Value, Profit Margin) que V2 nem expõe
- Datas ISO reais (sem
/Date(1234567890)/)
Decisão de migrar é sua. Connections existentes continuam funcionando em V2 sem nenhuma ação. Pra começar a usar V4, crie uma connection nova apontando pra URL V4.