Todos os artigos
Integrações

Como o wizard filtra entities OData V2 vs V4

O dropdown de formato de origem agora mostra só entities compatíveis com a versão da URL da conexão (V2 ou V4).

Atualizado em 5/25/2026

Comportamento



Ao criar uma integração OData, o wizard detecta automaticamente a versão da API (V2 ou V4) pela URL da conexão:

  • V2 (URLs com /sap/opu/odata/sap/): mostra entities com prefixo A_* (A_SalesOrder, A_BillingDocument, A_PurchaseOrder, etc.)
  • V4 (URLs com /sap/opu/odata4/sap/ ou similar): mostra entities sem prefixo (BillingDocument, SalesOrder, PurchaseOrder, Product)


Por que separar?



Antes o dropdown listava união V2+V4. Resultado: ao criar integração com URL V4 (ex: api_billingdocument), apareciam 8 entities V2 (A_*) misturadas com 4 V4 — operador confundido. Agora a lista é contextual: só vê o que faz sentido pra URL escolhida.

Comportamento sem baseUrl preenchida



Se a URL ainda não está preenchida no wizard, o dropdown mostra união V2+V4 como fallback (preserva compat). Assim que você cola a URL, a lista filtra automaticamente.

Onde isso aparece



  • Wizard de nova integração (passo 2)
  • Botão "Nova Integração" em /admin
  • Card de integração existente (edit)
  • Modal "Derivar mapping da integração"