Administration & Troubleshooting

/IWFND/GW_CLIENT

/IWFND/GW_CLIENT is the transaction for the SAP Gateway Client, an HTTP test tool inside SAP Gateway that sends OData requests directly to a service, without the SAP Fiori app. /IWFND/GW_CLIENT shows the raw response, replays failed requests from the error log and stores repeatable test cases, which separates service problems from app problems.

Quick facts

Type
SAP Gateway test and troubleshooting transaction
Full name
SAP Gateway Client
Layer
Services & APIs
Run on
SAP Gateway hub system (the backend itself in embedded deployment)
Key features
Any HTTP method, headers, payloads, test cases, metadata cache cleanup
Who uses it
ABAP and SAP Fiori developers, SAP Fiori support teams, basis administrators
Applies to
SAP S/4HANA on-premise and Private Edition, SAP ERP (ECC)
Layer: Services & APIsWhere it sits ▾
Where it sits: L4 · Services & APIsLayer: Services & APIs.L1L2L3L4L5L6BTP

Layer: Services & APIs

Open the architecture map →

What does /IWFND/GW_CLIENT do?

/IWFND/GW_CLIENT acts as an HTTP client inside the SAP Gateway system. You choose a method (GET, POST, PUT, PATCH, MERGE, DELETE or HEAD), enter a request URI, add headers and a payload, and execute. The response appears next to the request with its HTTP status, headers and body. From the same screen you can:

  • add URI options such as $count or $format=json;
  • jump to the error log, to service maintenance or to the service implementation;
  • turn a response into the next request with Use as Request;
  • clean up or rebuild the metadata cache on the hub, the backend or both.

/IWFND/GW_CLIENT answers the question an SAP Fiori app hides: what does the service itself return?

How do you use /IWFND/GW_CLIENT step by step?

A buyer at Alder Manufacturing reports that the supplier list shows no entry for Cedar Office Supply:

  1. Copy the failing request URI from the browser developer tools, for example /sap/opu/odata/sap/ZALDER_SUPPLIER_SRV/SupplierSet with its filter.
  2. Start /IWFND/GW_CLIENT, select GET and paste the URI.
  3. Execute and read the HTTP status and the response body.
  4. Change one thing at a time: remove the filter, add $format=json, request the single entity by key.
  5. For a failed save, rebuild the request with the same method, headers and payload; SAP Gateway expects a valid X-CSRF-Token, fetched with a preceding GET, on modifying requests.
  6. If the error came from a user report, open the entry in /IWFND/ERROR_LOG and replay it from there instead of retyping it.

A request that fails in /IWFND/GW_CLIENT is a service problem; a request that succeeds there points back to the app or its parameters.

What do common /IWFND/GW_CLIENT results mean?

ResultLikely causeNext step
HTTP 200 with the expected dataService is fineCompare the app's actual request, filters and user
HTTP 200 with an empty feedFilter, key or business authorization removes the dataTest without the filter; check the business role
HTTP 403Missing start or business authorizationSU53 for the affected user
HTTP 404Wrong entity set, key or service pathCompare the URI with the service metadata
HTTP 500Exception in the service implementation/IWBEP/ERROR_LOG for the call stack
Old properties in metadataStale metadata cacheMetadata menu: clean up or rebuild

/IWFND/GW_CLIENT turns a vague app symptom into an HTTP status that points to one layer.

How do test cases in /IWFND/GW_CLIENT help?

/IWFND/GW_CLIENT can save a request as a test case in a test group, either in the database or as a file on your PC. A test case keeps the method, URI, headers, payload and an expected HTTP status; response validation compares a new response with a stored one.

SAP delivers example groups, CORE_SAMPLES for OData V2 and V4_TEST for OData V4, which work only when the services they call are active. For a custom service, a small test group run after each transport catches regressions before users do. Test cases make /IWFND/GW_CLIENT a lightweight regression tool, not only a debugging screen.

  • /IWFND/ERROR_LOG and /IWBEP/ERROR_LOG: find the failed request and replay it in /IWFND/GW_CLIENT.
  • /IWFND/TRACES: records payload and performance traces when the request succeeds but the data looks wrong.
  • /IWFND/MAINT_SERVICE: checks registration and system alias when the service is not found.
  • SU53: confirms an authorization failure behind a 403.

Keep in mind that the result reflects the user and authorizations the test request runs with, which are usually not those of the user who reported the problem. /IWFND/GW_CLIENT reproduces the request; the related transactions explain the result.

/IWFND/GW_CLIENT vs. /IWFND/ERROR_LOG: what is the difference?

/IWFND/GW_CLIENT/IWFND/ERROR_LOG
PurposeSend and replay requestsRecord failed requests
Works withRequests you build or copyRequests that users already sent
Question it answersWhat does the service return right now?Which request failed, when and why?
Typical useReproduce, isolate and test a fixFirst look after a user report

The error log finds the failed request; /IWFND/GW_CLIENT reproduces it under controlled conditions.

FAQ

Is /IWFND/GW_CLIENT the same as the SAP Gateway Client?

Yes. /IWFND/GW_CLIENT is the transaction code that starts the SAP Gateway Client. It runs in the SAP Gateway system, which is the SAP S/4HANA system itself in an embedded deployment and the hub system in a hub deployment.

Can I test OData V4 services in /IWFND/GW_CLIENT?

Yes. The SAP Gateway Client tests OData V2 and V4 services, and SAP delivers the test group V4_TEST as an example for V4. For V4 request URIs, the tool also offers basic code completion through the context menu of the Request URI field.

Why does a request work in /IWFND/GW_CLIENT but fail in the app?

The app sends a different request or runs under a different user. Compare the exact URI, filters, headers and payload from the browser developer tools, and check the affected user's authorizations before changing the service.

Can I use /IWFND/GW_CLIENT in SAP S/4HANA Cloud Public Edition?

No customer use is documented for SAP S/4HANA Cloud Public Edition; check the SAP Help Portal for the testing options available there. The SAP Gateway Client is documented for on-premise, Private Edition and SAP ERP systems.

Sources

Applies to
SAP S/4HANA on-premise · SAP S/4HANA Cloud Private Edition · SAP ERP (ECC)
Last reviewed

SAP, SAP Fiori, SAPUI5, SAP S/4HANA, SAP BTP and other SAP products and services mentioned are trademarks or registered trademarks of SAP SE (or an SAP affiliate company) in Germany and other countries. This guide is independent and is not affiliated with, sponsored or endorsed by SAP SE.