More doc updates

Author: sunilwadhwa

docs/README.md

@@ -60,9 +60,91 @@ steps for each consumer.
 
 ## 4. Consuming the wsl4cc service
 
-With a valid OAuth token, the client may finally invoke the wsl4cc service to interact with the SAP ERP backend system through the Cloud Connector. There is really only one endpoint to call.
-
-POST https://hostname/wsl4cc/destinations/{dest}/rfc
-BODY
-
+With a valid OAuth token, the client may finally invoke the wsl4cc service to interact with the SAP ERP backend system through the Cloud Connector.
+
+The main REST endpoint is the following:
+
+POST https://<hostname>/wsl4cc/destinations/<dest>/rfc
+
+where <hostname> is your application URL hostname and <dest> is your RFC destination name.
+
+HEADERS
+-------
+Content-Type: application/json
+Accept: application/json
+Authorization: Bearer token generated by OAuth
+
+INPUT BODY
+----------
+
+Here are some sample inputs to this endpoint:
+
+1. Input JSON to execute STFC_CONNECTION:
+
+```javascript
+{
+  "name": "STFC_CONNECTION",
+  "input": {
+    "REQUTEXT": "Request Text"
+  }
+}
+```
+
+2. Input JSON to get list of employees whose last name is Smith:
+
+```javascript
+{
+  "name": "BAPI_EMPLOYEE_GETDATA",
+  "input": {
+    "DATE": "2018-05-21",
+    "LASTNAME_M": "Smith"
+  }
+}
+```
+
+EXPECTED OUTPUT
+---------------
+
+1. The expected output for STFC_CONNECTION invocation is an HTTP 200 status and the following body:
+
+```javascript
+{
+    "status": "OK",
+    "message": null,
+    "output": {
+        "ECHOTEXT": "Request Text",
+        "RESPTEXT": "SAP R/3 Rel. 740   Sysid: ABA      Date: 20180521   Time: 235932   Logon_Data: 800/IDADMIN/E"
+    },
+    "tables": null
+}
+```
+
+2. The expected output for employee data is an HTTP 200 status and the following body (truncated for brevity):
+
+```javascript
+{
+    "status": "OK",
+    "message": null,
+    "output": {
+        "RETURN": {
+            "TYPE": "",
+            "CODE": "",
+            "MESSAGE": "",
+            "LOG_NO": "",
+            "LOG_MSG_NO": "000000",
+            "MESSAGE_V1": "",
+            "MESSAGE_V2": "",
+            "MESSAGE_V3": "",
+            "MESSAGE_V4": ""
+        }
+    },
+    "tables": {
+        "ARCHIVELINK": [ ... ],
+        "INTERNAL_CONTROL": [ ... ],
+        "PERSONAL_DATA": [ ... ],
+        "ORG_ASSIGNMENT": [ ... ],
+        "COMMUNICATION": [ ... ]
+    }
+}
+```