Contact Us 1-800-596-4880
  1. Homepage
  2. Release Notes

  3. SAP S/4HANA OData Connector Release Notes - Mule 4

SAP S/4HANA OData Connector Release Notes - Mule 4

Support Category: Premium

Anypoint Connector for SAP S/4HANA OData Connector provides full support to query, create, update, and delete entities, and execute remote functions using the SAP S/4HANA API.

Guide: SAP S/4HANA OData Connector
Reference: SAP S/4HANA OData Connector Reference

2.9.0

May 1, 2025

Compatibility

Software Version

Mule

4.2.0 and later

SAP S/4HANA API

v1

OData API

v2 and v4

OpenJDK

8, 11, and 17

Fixed Issues

Issue Resolution ID

The Batch update entity operation now uses the correct syntax for the OData v4 URI for fields that have the EDM type as GUID.

W-18213819

The connector now proactively re-triggers service discovery before each operation if the service list is empty.

W-18344579

The connector now throws the correct error types:

  • When there is an invalid filter provided in the operation, the connector now throws S4HANA:INVALID_FILTER instead of S4HANA:INVALID_ENTITY.

  • When there are authentication issues (such as an incorrect username, password, or URL), the connector now throws S4HANA:UNAUTHORIZED instead of S4HANA:NO_SUCH_SERVICE.

    This means a 403 Forbidden error received during the service discovery calls now explicitly causes the connector to throw S4HANA:UNAUTHORIZED. This indicates that the user’s SAP permissions for the service discovery URL are insufficient.

    To fix this, you can either:

    • Check permissions in the SAP server for the service discovery URL that is throwing the 403 Forbidden error.

    • Disable service discovery if you are not using it.

W-18169170, W-18516707, W-18723610

2.8.0

April 8, 2025

Compatibility

Software Version

Mule

4.2.1 and later

SAP S/4HANA API

v1

OData API

v2 and v4

OpenJDK

8, 11, and 17

Fixed Issues

Issue Resolution ID

The connector now supports pagination logic of version 2.6.2 and earlier in the Query operation with the new Legacy Pagination checkbox.

W-18183205

2.7.1

March 11, 2025

Compatibility

Software Version

Mule

4.2.1 and later

SAP S/4HANA API

v1

OData API

v2 and v4

OpenJDK

8, 11, and 17

Fixed Issues

Issue Resolution ID

The connector check no longer throws exceptions during app initialization.

W-17427764

The logic to identify Custom Business Objects is changed. All entities starting with YY1 and ZZ1 are now considered as Custom Business Object entities.

W-17522361

The OData v4 service catalog now displays all service types except the UI service type.

W-17522361

2.7.0

November 10, 2024

What’s New

  • SAP S/4HANA OData Connector now provides support for OData API v4.

  • To support OData API v4, the connector now includes the new OData v4 service discovery relative path field in the connection types. For information about the OData v4 service discovery relative path field, see SAP S/4HANA OData Connector Reference.

  • The Execute Function operation now includes the new S4HANA:INVALID_ENTITY error type.

  • The connector now includes additional classifications for specific exceptions in certain scenarios.

Compatibility

Software Version

Mule

4.2.1 and later

SAP S/4HANA API

v1

OData API

v2 and v4

OpenJDK

8, 11, and 17

2.6.4

October 8, 2024

Compatibility

Software Version

Mule

4.2.1 and later

SAP S/4HANA API

v1

OData API

v2

OpenJDK

8, 11, and 17

Fixed Issues

Issue Resolution ID

The connector now has additional checks during app disposal to prevent exceptions.

W-16876722

2.6.3

June 18, 2024

Compatibility

Software Version

Mule

4.2.1 and later

SAP S/4HANA API

v1

OData API

v2

OpenJDK

8, 11, and 17

Fixed Issues

Issue Resolution ID

Pagination in the Query operation now prevents redundant next calls when the maximum number of returned elements is reached.

W-16032742

2.6.2

June 12, 2024

Compatibility

Software Version

Mule

4.2.1 and later

SAP S/4HANA API

v1

OData API

v2

OpenJDK

8, 11, and 17

Fixed Issues

Issue Resolution ID

The connector now correctly processes custom services with different URLs.

W-15457838

2.6.1

January 16, 2024

What’s New

  • This connector is now compatible with Java 17.

Compatibility

Software Version

Mule

4.2.1 and later

SAP S/4HANA API

v1

OData API

v2

OpenJDK

8, 11, and 17

Fixed Issues

Issue Resolution ID

The connector now correctly filters conditional headers when fetching metadata.

W-14773734

2.6.0

September 18, 2023

What’s New

  • The connector now supports custom namespaces. To support custom namespaces, the connector now includes the new Scoped service discovery relative path and Services attributes fields in the connection types and the new Service Attribute type.

    Use custom namespaces to define and organize custom objects and developments, such as programs, function modules, or tables. The naming convention for a custom namespace is Z or Y followed by an identifier. For example, if there are custom programs that manage customer data, you can create a custom namespace called ZCUST to organize all custom programs related to customer data.

    Custom namespaces enable you to maintain better control over your custom objects and developments and avoid naming conflicts with SAP standard objects or custom objects by other organizations, as well as improve the maintainability and upgradability of the system.

Compatibility

Software Version

Mule

4.2.1 and later

SAP S/4HANA API

v1

OData API

v2

OpenJDK

8 and 11

2.5.4

March 6, 2023

Compatibility

Software Version

Mule

4.2.1 and later

SAP S/4HANA API

v1

OData API

v2

OpenJDK

8 and 11

Fixed Issues

Issue Resolution ID

The connector now correctly processes items of the Datetimeoffset and Guid data types.

W-12534658

2.5.3

January 26, 2023

Compatibility

Software Version

Mule

4.2.1 and later

SAP S/4HANA API

v1

OData API

v2

OpenJDK

8 and 11

Fixed Issues

Issue Resolution ID

In case of error, the connector now responds to the original error response received from SAP.

W-12064688

2.5.2

January 13, 2023

Compatibility

Software Version

Mule

4.2.1 and later

SAP S/4HANA API

v1

OData API

v2

OpenJDK

8 and 11

Fixed Issues

Issue Resolution ID

Pagination now returns the correct number of items in the payload.

W-12284444

2.5.1

October 24, 2022

Compatibility

Software Version

Mule

4.2.1 and later

SAP S/4HANA API

v1

OData API

v2

OpenJDK

8 and 11

Fixed Issues

Issue ID

The Jackson Databind library is upgraded from com.fasterxml.jackson.core:jackson-databind:2.12.6.1 to com.fasterxml.jackson.core:jackson-databind:2.14.0-rc1 to fix reported security vulnerabilities.

W-11853424

2.5.0

October 6, 2022

What’s New

  • You can now use the new Batch Upsert Custom Business Object operation and the modified Batch update entity operation to support custom business objects.

Compatibility

Software Version

Mule

4.2.1 and later

SAP S/4HANA SOAP API

v1

OpenJDK

8 and 11

2.4.5

September 13, 2022

Compatibility

Software Version

Mule

4.2.1 and later

SAP S/4HANA API

v1

OData API

v2

OpenJDK

8 and 11

Fixed Issues

Issue ID

The connector now correctly parses input parameters of type Number.

W-11719254

2.4.4

September 9, 2022

Compatibility

Software Version

Mule

4.2.1 and later

SAP S/4HANA API

v1

OData API

v2

OpenJDK

8 and 11

Fixed Issues

Issue ID

The OAuth 2.0 access token now refreshes after expiry.

W-11686820

2.4.3

July 11, 2022

Compatibility

Software Version

Mule

4.2.1 and later

SAP S/4HANA API

v1

OData API

v2

OpenJDK

8 and 11

Fixed Issues

Issue ID

The cache now works for multiple entities from the same service used in one application.

W-11362347

2.4.2

April 18, 2022

Compatibility

Software Version

Mule

4.2.1 and later

SAP S/4HANA API

v1

OData API

v2

OpenJDK

8 and 11

Fixed Issues

Issue ID

The Batch Create Entity operation now returns the Bulk Item ID.

W-10885701

2.4.1

April 4, 2022

Compatibility

Software Version

Mule

4.2.1 and later

SAP S/4HANA API

v1

OData API

v2

OpenJDK

8 and 11

Fixed Issues

Issue ID

Fixed reported security vulnerabilities by upgrading the Jackson Databind library from com.fasterxml.jackson.core:jackson-databind:2.12.6 to com.fasterxml.jackson.core:jackson-databind:2.12.6.1.

W-10920476

2.4.0

January 18, 2022

What’s New

  • Added support for a configurable cache of metadata for S/4HANA services to improve performance by not executing a metadata request in every operation call.

Compatibility

App/Service Version

Mule

4.2.1 and later

SAP S/4HANA API

v1

OData API

v2

OpenJDK

8 and 11

2.3.8

January 3, 2022

Compatibility

Software Version

Mule

4.2.1 and later

SAP S/4HANA API

v1

OData API

v2

OpenJDK

8 and 11

Fixed Issues

Issue ID

Upgraded library dependencies.

CONN-9290

Upgraded the com.fasterxml.jackson.core:jackson-databind dependency.

CONN-9838

2.3.7

October 26, 2021

Compatibility

Software Version

Mule

4.2.1 and later

SAP S/4HANA API

v1

OData API

v2

OpenJDK

8 and 11

Fixed Issues

Issue ID

The $count endpoint sometimes did not accept the application/json content-type. Now, the connector accepts the text/plain content-type when requesting the $count endpoint.

SE-23027

2.3.6

July 16, 2021

Compatibility

Software Version

Mule

4.2.1 and later

SAP S/4HANA API

v1

OData API

v2

OpenJDK

8 and 11

Fixed Issues

  • The service used for requests is now used also for fetching the CSRF token. (SE-21821)

  • Improved the speed of retrieving metadata by using partial fetching. (SE-21443)

2.3.5

June 29, 2021

Compatibility

Software Version

Mule

4.2.1 and later

SAP S/4HANA API

v1

OData API

v2

OpenJDK

8 and 11

Fixed Issues

A precondition failed error was thrown using conditional headers. (SE-21532)

2.3.4

May 11, 2021

Compatibility

Software Version

Mule

4.2.1 and later

SAP S/4HANA API

v1

OData API

v2

OpenJDK

8 and 11

Fixed Issues

The connector was making multiple requests to fetch metadata in each invocation of the Query operation. (CONN-7964)

2.3.3

May 3, 2021

Compatibility

Software Version

Mule

4.2.1 and later

SAP S/4HANA API

v1

OData API

v2

OpenJDK

8 and 11

Fixed Issues

  • Logging a request body using SAP S/4Hana logger with the TRACE level enabled threw an error. Use HttpMessageLogger instead of SAP S/4Hana logger for logging the payload. (SE-20520)

2.3.2

March 8, 2021

Compatibility

Software Version

Mule

4.2.1 and later

SAP S/4HANA API

v1

OData API

v2

OpenJDK

8 and 11

Fixed Issues

  • Improved metadata loading performance (CONN-7658)

2.3.1

February 11, 2021

Compatibility

Software Version

Mule

4.2.1 and later

SAP S/4HANA API

v1

OData API

v2

OpenJDK

8 and 11

Fixed Issues

  • Default HTTP headers were not included in a batch request. (SE-18812)

  • The connector was not returning a complete response. (SE-18902)

2.3.0

January 29, 2021

Compatibility

Software Version

Mule

4.2.1 and later

SAP S/4HANA API

v1

OData API

v2

OpenJDK

8 and 11

Features

Added support to enable or disable the automatic retrieval of a CSFR token before a resource-modifying request, such as a POST request.

2.2.3

December 11, 2020

Compatibility

Software Version

Mule

4.2.1 and later

SAP S/4HANA API

v1

OData API

v2

OpenJDK

8 and 11

Fixed Issues

Custom headers were not included in calls to retrieve the EDM model. (SE-18812)

2.2.2

November 27, 2020

Compatibility

Software Version

Mule

4.2.1 and later

SAP S/4HANA API

v1

OData API

v2

OpenJDK

8 and 11

Features

  • Multiple libraries have been updated to the latest versions.

2.2.1

July 27, 2020

Compatibility

Software Version

Mule

4.2.1 and later

SAP S/4HANA API

v1

OData API

v2

OpenJDK

8 and 11

Fixed Issues

  • Invalid conversion of the date field in the URI (SE-16674)

  • Connector was adding two days to the ValidityStartDate field value (SE-16675)

  • Issues with creating a directory on Anypoint Runtime Fabric runtimes (SE-16669)

2.2.0

July 22, 2020

Compatibility

Software Version

Mule

4.2.1 and later

SAP S/4HANA API

v1

OData API

v2

Features

The ability to configure the response timeout as well as the client and connection timeout for the request has been added. (SE-16430, CONN-5490)

2.1.0

May 20, 2020

Compatibility

Software Version

Mule

4.2.1 and later

SAP S/4HANA API

v1

OData API

v2

Features

Added support for batch processing. (CONN-5488)

2.0.0

March 19, 2020

Compatibility

Software Version

Mule

4.2.1 and later

SAP S/4HANA API

v1

OData API

v2

Features

Added support for OAuth 2.0 client credentials. This new feature breaks backward compatibility. (CONN-2944)

See Upgrade SAP S/4HANA OData Connector to 2.0 - Mule 4 for information about how to upgrade to the latest version.

1.2.2

June 1, 2020

Compatibility

Software Version

Mule

4.1.1 and later

SAP S/4HANA API

v1

OData API

v2

Fixed Issues

The issue where PurchaseOrder entities could not be created after the SAP S/4HANA Cloud 2005 release is fixed. (CONN-6225)

1.2.1

January 23, 2020

Compatibility

Software Version

Mule

4.1.1 and later

SAP S/4HANA API

v1

OData API

v2

Fixed Issues

Unable to perform deep inserts. (SE-14296)

1.2.0

December 18, 2019

Compatibility

Software Version

Mule

4.1.1 and later

SAP S/4HANA API

v1

OData API

v2

Features

  • Returns HTTP response code and response headers as attributes. (CONN-3789)

  • Added parameter to enable or disable the discovery service. (CONN-3783)

Fixed Issues

  • Create Entity operation failed when non-mandatory key fields weren’t set. (CONN-3911)

  • NexusIQ security vulnerability for the connector. (CONN-3733)

  • Removed the default asterisk (*) value for the Select parameter in the Get Entity and Query operations. (CONN-3796)

1.1.1

October 25, 2019

Compatibility

Software Version

Mule

4.1.1 and later

SAP S/4HANA API

v1

OData API

v2

Fixed Issues

Peformance regression and incorrect behavior of the Query operation in SAP S/4HANA OData Connector v1.1.0. (CONN-3794)

1.1.0

September 27, 2019

Compatibility

Software Version

Mule

4.1.1 and later

SAP S/4HANA API

v1

OData API

v2

Features

  • Added new Expanded properties parameter to support entity expansion in the Get Entity by key and Query operations. This parameter enables you to specify a comma-separated list of navigation properties. Each navigation property can be followed by a forward slash and another navigation property to identify a multi-level relationship. Properties of an expanded navigation property are not a part of the payload unless selected.

  • New S4HANA:SERVER_ERROR and S4HANA:NO_SUCH_NAVIGATION_PROPERTY errors are provided.

Fixed Issues

  • Fixed bugs related to creating and updating sales orders and purchase orders when line items were specified. (CONN-2530)

  • Date and time formats were not formatted correctly. (CONN-3075)

  • Connector did not stop the HTTP client when resolving metadata. (CONN-3498)

  • There was no way to specify an entity key when performing an update operation. (SE-13101)

  • The Returned Fields parameter description is revised to be: a comma-separated list of selection clauses. Each selection clause may be a property name, navigation property name, or the asterisk * character. The * syntax causes all properties for an entry to be included without traversing associations. Use forward slash / to select fields of expanded navigation properties. If no field is selected, then all fields are returned.

1.0.2

August 8, 2019

Compatibility

Software Version

Mule

4.1.1 and later

SAP S/4HANA API

v1

OData API

v2

Features

Updated connector icons.

1.0.1

July 3, 2019

Compatibility

Software Version

Mule

4.1.1 and later

SAP S/4HANA API

v1

OData API

v2

Fixed Issues

Fixed the Test Connection issue.

1.0.0

June 28, 2019

Mule 4 version of the SAP S/4HANA OData Connector.

Compatibility

Software Version

Mule

4.1.1 and later

SAP S/4HANA API

v1

OData API

v2

See Also