--- schema_version: "1" id: c4ee5e9d69a8f8ebbad9229d42105ee0c2c0d5edc315edf47d704bbd3ce34108 title: SAP S/4HANA OData Connector Release Notes collection: mulesoft version: current locale: ja-jp portal_url: https://docs.salesforce.com/mulesoft/current/ja-jp/release-notes/connector/sap-s4-hana-connector-release-notes-mule-4.md canonical_url: https://docs.mulesoft.com/jp/release-notes/connector/sap-s4-hana-connector-release-notes-mule-4 source_site: docs.mulesoft.com content_type: documentation content_hash: 99cb41ef1deacaed4eb49b579f169d5c2b165c38777e8318f2db95e86aa51ccd description: MuleSoft Documentation Site latest: true --- # SAP S/4HANA OData Connector Release Notes Support Category: [Premium](https://www.salesforce.com/en-us/wp-content/uploads/sites/4/documents/legal/Agreements/versioning-back-support-policy.pdf) 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](https://docs.mulesoft.com/jp/sap-s4hana-cloud-connector/latest/) Reference: [SAP S/4HANA OData Connector Reference](https://docs.mulesoft.com/jp/sap-s4hana-cloud-connector/latest/sap-s4hana-cloud-connector-reference) ## [](#2-9-6)2.9.6 **September 4, 2026** ### What’s New - This release includes general security fixes. ### Compatibility
Software Version

Mule

4.2.0 and later

SAP S/4HANA API

v1

OData API

v2 and v4

OpenJDK

8, 11, and 17
## [](#2-9-5)2.9.5 **August 31, 2026** ### What’s New - This connector version requires Mule runtime 4.6.22 or later if you’re using Mule 4.6.x, or Mule runtime 4.9.9 or later if you’re using Mule 4.9.x. If you prefer not to upgrade your Mule runtime, use the connector version released immediately after this one. ### 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

These libraries are upgraded to address reported security vulnerabilities:

  • The gson library is upgraded to version 2.14.0.

  • The jackson library is upgraded to version 2.22.2.

  • The commons-codec library is upgraded to version 1.22.1.

  • The commons-io library is upgraded to version 2.22.0.

  • The commons-lang3 library is upgraded to version 3.20.0.

  • The woodstox library is upgraded to version 7.2.2.

  • The guava library is upgraded to version 33.7.1-jre.

W-23840766
## [](#2-9-4)2.9.4 **July 1, 2026** ### 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 com.google.guava:guava library is upgraded to version 33.6.0-jre to address a reported security vulnerability (CVE-2023-2976).

W-22996181

The org.apache.commons:commons-text library is upgraded to version 1.15.0 to address a reported security vulnerability (CVE-2025-46295).

W-22996180
## [](#2-9-3)2.9.3 **August 27, 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

FileAlreadyExistsException errors no longer occur when multiple users trigger the same Mule flow with dynamic configurations, due to improved concurrency handling.

W-18459988
## [](#2-9-2)2.9.2 **August 9, 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

These libraries are upgraded to address reported security vulnerabilities:

  • The com.google.code.gson:gson library is upgraded to version 2.13.1.

  • The commons-io::commons-io library is upgraded to version 2.20.0.

  • The org.apache.commons::commons-lang3 library is upgraded to version 3.18.0.

W-18986663
## [](#2-9-1)2.9.1 **July 20, 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

You can now configure setters in HTTP headers when using the connector in Java 17 and Mule 4.9.x.

W-18625117
## [](#2-9-0)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)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)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)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](https://docs.mulesoft.com/jp/sap-s4hana-cloud-connector/latest/sap-s4hana-cloud-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)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)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)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)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)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)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)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)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)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)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)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)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)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)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)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)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)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)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)2.3.6 **July 16, 2021** ### [](#compatibility-29)Compatibility
Software Version

Mule

4.2.1 and later

SAP S/4HANA API

v1

OData API

v2

OpenJDK

8 and 11
### [](#fixed-issues-24)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)2.3.5 **June 29, 2021** ### [](#compatibility-30)Compatibility
Software Version

Mule

4.2.1 and later

SAP S/4HANA API

v1

OData API

v2

OpenJDK

8 and 11
### [](#fixed-issues-25)Fixed Issues A precondition failed error was thrown using conditional headers. (SE-21532) ## [](#2-3-4)2.3.4 **May 11, 2021** ### [](#compatibility-31)Compatibility
Software Version

Mule

4.2.1 and later

SAP S/4HANA API

v1

OData API

v2

OpenJDK

8 and 11
### [](#fixed-issues-26)Fixed Issues The connector was making multiple requests to fetch metadata in each invocation of the **Query** operation. (CONN-7964) ## [](#2-3-3)2.3.3 **May 3, 2021** ### [](#compatibility-32)Compatibility
Software Version

Mule

4.2.1 and later

SAP S/4HANA API

v1

OData API

v2

OpenJDK

8 and 11
### [](#fixed-issues-27)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)2.3.2 **March 8, 2021** ### [](#compatibility-33)Compatibility
Software Version

Mule

4.2.1 and later

SAP S/4HANA API

v1

OData API

v2

OpenJDK

8 and 11
### [](#fixed-issues-28)Fixed Issues - Improved metadata loading performance (CONN-7658) ## [](#2-3-1)2.3.1 **February 11, 2021** ### [](#compatibility-34)Compatibility
Software Version

Mule

4.2.1 and later

SAP S/4HANA API

v1

OData API

v2

OpenJDK

8 and 11
### [](#fixed-issues-29)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)2.3.0 **January 29, 2021** ### [](#compatibility-35)Compatibility
Software Version

Mule

4.2.1 and later

SAP S/4HANA API

v1

OData API

v2

OpenJDK

8 and 11
### [](#features)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)2.2.3 **December 11, 2020** ### [](#compatibility-36)Compatibility
Software Version

Mule

4.2.1 and later

SAP S/4HANA API

v1

OData API

v2

OpenJDK

8 and 11
### [](#fixed-issues-30)Fixed Issues Custom headers were not included in calls to retrieve the EDM model. (SE-18812) ## [](#2-2-2)2.2.2 **November 27, 2020** ### [](#compatibility-37)Compatibility
Software Version

Mule

4.2.1 and later

SAP S/4HANA API

v1

OData API

v2

OpenJDK

8 and 11
### [](#features-2)Features - Multiple libraries have been updated to the latest versions. ## [](#2-2-1)2.2.1 **July 27, 2020** ### [](#compatibility-38)Compatibility
Software Version

Mule

4.2.1 and later

SAP S/4HANA API

v1

OData API

v2

OpenJDK

8 and 11
### [](#fixed-issues-31)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)2.2.0 **July 22, 2020** ### [](#compatibility-39)Compatibility
Software Version

Mule

4.2.1 and later

SAP S/4HANA API

v1

OData API

v2
### [](#features-3)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)2.1.0 **May 20, 2020** ### [](#compatibility-40)Compatibility
Software Version

Mule

4.2.1 and later

SAP S/4HANA API

v1

OData API

v2
### [](#features-4)Features Added support for batch processing. (CONN-5488) ## [](#2-0-0)2.0.0 **March 19, 2020** ### [](#compatibility-41)Compatibility
Software Version

Mule

4.2.1 and later

SAP S/4HANA API

v1

OData API

v2
### [](#features-5)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](https://docs.mulesoft.com/jp/sap-s4hana-cloud-connector/latest/sap-s4hana-cloud-connector-upgrade-migrate) for information about how to upgrade to the latest version. ## [](#1-2-2)1.2.2 **June 1, 2020** ### [](#compatibility-42)Compatibility
Software Version

Mule

4.1.1 and later

SAP S/4HANA API

v1

OData API

v2
### [](#fixed-issues-32)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)1.2.1 **January 23, 2020** ### [](#compatibility-43)Compatibility
Software Version

Mule

4.1.1 and later

SAP S/4HANA API

v1

OData API

v2
### [](#fixed-issues-33)Fixed Issues Unable to perform deep inserts. (SE-14296) ## [](#1-2-0)1.2.0 **December 18, 2019** ### [](#compatibility-44)Compatibility
Software Version

Mule

4.1.1 and later

SAP S/4HANA API

v1

OData API

v2
### [](#features-6)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-34)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)1.1.1 **October 25, 2019** ### [](#compatibility-45)Compatibility
Software Version

Mule

4.1.1 and later

SAP S/4HANA API

v1

OData API

v2
### [](#fixed-issues-35)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)1.1.0 **September 27, 2019** ### [](#compatibility-46)Compatibility
Software Version

Mule

4.1.1 and later

SAP S/4HANA API

v1

OData API

v2
### [](#features-7)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-36)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)1.0.2 **August 8, 2019** ### [](#compatibility-47)Compatibility
Software Version

Mule

4.1.1 and later

SAP S/4HANA API

v1

OData API

v2
### [](#features-8)Features Updated connector icons. ## [](#1-0-1)1.0.1 **July 3, 2019** ### [](#compatibility-48)Compatibility
Software Version

Mule

4.1.1 and later

SAP S/4HANA API

v1

OData API

v2
### [](#fixed-issues-37)Fixed Issues Fixed the **Test Connection** issue. ## [](#1-0-0)1.0.0 **June 28, 2019** Mule 4 version of the SAP S/4HANA OData Connector. ### [](#compatibility-49)Compatibility
Software Version

Mule

4.1.1 and later

SAP S/4HANA API

v1

OData API

v2
## [](#see-also)See Also - [Salesforce Help](https://help.salesforce.com) - [MuleSoft Services](https://www.mulesoft.com/support-and-services) - [Known Issues](https://help.salesforce.com/s/issues)