/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 ▾
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
$countor$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:
- Copy the failing request URI from the browser developer tools, for example
/sap/opu/odata/sap/ZALDER_SUPPLIER_SRV/SupplierSetwith its filter. - Start /IWFND/GW_CLIENT, select GET and paste the URI.
- Execute and read the HTTP status and the response body.
- Change one thing at a time: remove the filter, add
$format=json, request the single entity by key. - 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.
- 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?
| Result | Likely cause | Next step |
|---|---|---|
| HTTP 200 with the expected data | Service is fine | Compare the app's actual request, filters and user |
| HTTP 200 with an empty feed | Filter, key or business authorization removes the data | Test without the filter; check the business role |
| HTTP 403 | Missing start or business authorization | SU53 for the affected user |
| HTTP 404 | Wrong entity set, key or service path | Compare the URI with the service metadata |
| HTTP 500 | Exception in the service implementation | /IWBEP/ERROR_LOG for the call stack |
| Old properties in metadata | Stale metadata cache | Metadata 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.
Which related transactions help?
- /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 | |
|---|---|---|
| Purpose | Send and replay requests | Record failed requests |
| Works with | Requests you build or copy | Requests that users already sent |
| Question it answers | What does the service return right now? | Which request failed, when and why? |
| Typical use | Reproduce, isolate and test a fix | First 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
- SAP Help Portal: SAP Gateway Client (SAP Gateway Foundation)
- SAP Help Portal: Error Log (SAP Gateway Foundation)
- SAP Help Portal: Which Tools Can Be Used for Troubleshooting? (SAP Gateway Foundation)
- SAP Help Portal: Cross-Site Request Forgery Protection (SAP Gateway)
- Applies to
- SAP S/4HANA on-premise · SAP S/4HANA Cloud Private Edition · SAP ERP (ECC)
- Last reviewed