Why two versions coexist

OData v2 is the mature, widely supported protocol used by SAP Gateway and most of the classic Fiori Elements apps on ECC/S4 On-Premise. OData v4 is the OASIS standard version, leaner and more expressive, and it's the one RAP generates by default for new S/4HANA developments.

Batch requests

v2 groups several operations into a single HTTP request using $batch with a verbose multipart format. v4 simplifies this with a JSON-based batch format that is easier to read and debug in the browser network tab.

HTTPbatch-v4.json
{
  "requests": [
    {
      "id": "1",
      "method": "GET",
      "url": "Contracts('4500001234')"
    },
    {
      "id": "2",
      "method": "PATCH",
      "url": "Contracts('4500001235')",
      "body": { "ContractManager1": "DOLL" },
      "headers": { "Content-Type": "application/json" }
    }
  ]
}

Deep create / deep update

v4 supports creating a header and its child items in a single request (deep insert), something v2 handled more awkwardly through navigation properties. This maps directly to RAP's composition model, where a root entity and its child entities are saved together in one transaction.

HTTPdeep-create-v4.json
POST /Contracts
{
  "ContractManager1": "DOLL",
  "_Items": [
    { "Description": "Network infrastructure", "Amount": 12000 },
    { "Description": "Substation maintenance", "Amount": 4800 }
  ]
}

Draft handling

Draft (the "save your progress without committing" pattern behind every modern Fiori app) is a v4-only concept, tightly integrated with RAP's with draft clause. There is no equivalent standard mechanism in v2 — draft-enabled apps on ECC typically simulate it with custom Z-tables.

Practical rule: for new S/4HANA/RAP developments, always go v4 — it's what Fiori Elements and the Business Application Studio expect by default. Stick to v2 only when integrating with an existing ECC service or a consumer that doesn't yet support v4.

Quick comparison

← ABAP Previous