SAP Knowledge Base Article - Public

3658729 - Freight orders not retrieved by freight order (A2X) API in SAP s/4HANA Cloud Public Edition

Symptom

  • Some Freight Orders are not being collected by the Freight Order (A2X) API, preventing them from reaching an external platform used to manage Freight Order data.
  • Freight Orders created manually in the system are not retrieved when using filters such as ChangeDateTime.
  • Freight Orders are retrieved using the Freight Order number filter but not with the ChangeDateTime filter.
  • No specific error messages are encountered when running the API.

Environment

  • SAP S/4HANA Cloud Public Edition

Reproducing the Issue

  1. Create Freight Orders manually in the SAP S/4HANA Cloud Public Edition system.
  2. Run the Freight Order (A2X) API through the Business Accelerator Hub using filters such as Freight Order number or ChangeDateTime.
  3. Observe that some Freight Orders are not retrieved by the API when using the ChangeDateTime filter.

Cause

Not using standard API parameters effectively, such as the `$top` parameter, which limits the response to 100 entries by default.

Resolution

  1. Use the `$top` parameter in the API request to retrieve more entries beyond the default limit of 100. Example:`/sap/opu/odata4/sap/api_freightorder/srvd_a2x/sap/freightorder/0001/FreightOrder?$filter=ChangedDateTime ge 2025-09-18T14:25:51Z&$top=1000`
  2. Use the Freight Order number filter if specific Freight Orders need to be retrieved. Example: `/sap/opu/odata4/sap/api_freightorder/srvd_a2x/sap/freightorder/0001/FreightOrder?$filter=TransportationOrder eq '660000xxxx'`
  3. Ensure the API configuration aligns with the documentation for filtering by non-key attributes. Refer to the OData documentation for additional details:`OData Filtering Documentation`

See Also

Keywords

freight order api, sap s/4hana cloud, freight order retrieval, a2x api, changedatetime filter, $top parameter, odata filtering, sap transportation management, freight order not found, api troubleshooting, sap public cloud. , KBA , TM-FRM-FRO-2CL , Freight Order (Public Cloud) , Problem

Product

SAP S/4HANA Cloud Public Edition all versions