Retrieving the Selected Items From Guided Buying
Use this procedure to retrieve the selected items from guided buying using the Catalog Connectivity Service API.
Context
The catalog connectivity service API enables you to retrieve the selected items after punching in to guided buying from the Plant Maintenance module in an SAP S/4HANA system.
Procedure
- A user adds the required items to the cart in guided buying and clicks Check out to return to the SAP S/4HANA system.
Guided buying sends the ShoppingCartID parameter value to the connectivity service.
The connectivity service persists the ShoppingCartID corresponding to the SessionId and notifies the SAP S/4HANA system.
The client application sends a backend call to the connectivity service to retrieve the items from guided buying.
The connectivity service processes the request and retrieves the shopping cart data from guided buying and sends it to the SAP S/4HANA system.
- The connectivity service persists the ShoppingCartID corresponding to the SessionId and notifies the SAP S/4HANA system.
- The client application sends a backend call to the connectivity service to retrieve the items from guided buying using the POST {{runtime_URL}}/secureOci/{PunchinId} endpoint.
A sample request is as follows:
POST {{runtime_URL}}/secureOci/{PunchinId}The backend call contains the following parameters:Parameter
Mandatory?
Description
Value
SessionTransmissionId
Yes
The session transmission ID generated by the connectivity service for the current punchin session.
SessionTransmissionId
FUNCTION
Yes
Indicates the action to be taken by the connectivity service.
The value RETRIEVEOCI indicates that guided buying must send the shopping cart contents associated with the specified SessionTransmissionId to the SAP S/4HANA system.
RETRIEVEOCI
SessionTransmissionId=c8c3444ae27f421087d50a42ed24b1d2 FUNCTION=RETRIEVEOCI
The connectivity service processes the request and retrieves the shopping cart data from guided buying and sends it to the SAP S/4HANA system.
A sampe response is as follows:<?xml version="1.0"?> <ocisecurity> <OCIField>NEW_ITEM-ShoppingCartID[1]</OCIField> <OCIValue>SH73</OCIValue> <OCIField>NEW_ITEM-DESCRIPTION[1]</OCIField> <OCIValue>SSP-3793 Catalog-Item For JCN</OCIValue> <OCIField>NEW_ITEM-MATGROUP[1]</OCIField> <OCIValue></OCIValue> <OCIField>NEW_ITEM-EXT_CATEGORY[1]</OCIField> <OCIValue>43211800</OCIValue> <OCIField>NEW_ITEM-EXT_SCHEMA_TYPE[1]</OCIField> <OCIValue>unspsc</OCIValue> <OCIField>NEW_ITEM-MATNR[1]</OCIField> <OCIValue></OCIValue> <OCIField>NEW_ITEM-QUANTITY[1]</OCIField> <OCIValue>1.000 </OCIValue> <OCIField>NEW_ITEM-UNIT[1]</OCIField> <OCIValue>EA </OCIValue> <OCIField>NEW_ITEM-PRICE[1]</OCIField> <OCIValue>44.000 </OCIValue> <OCIField>NEW_ITEM-PRICEUNIT[1]</OCIField> <OCIValue>1</OCIValue> <OCIField>NEW_ITEM-CURRENCY[1]</OCIField> <OCIValue>USD </OCIValue> <OCIField>NEW_ITEM-LEADTIME[1]</OCIField> <OCIValue>3</OCIValue> <OCIField>NEW_ITEM-VENDOR[1]</OCIField> <OCIValue>sid496 </OCIValue> <OCIField>NEW_ITEM-VENDORMAT[1]</OCIField> <OCIValue>SSP-3793CAT </OCIValue> <OCIField>NEW_ITEM-MANUFACTCODE[1]</OCIField> <OCIValue>Hallmark Cables </OCIValue> <OCIField>NEW_ITEM-MANUFACTMAT[1]</OCIField> <OCIValue>SSP-3793CAT </OCIValue> <OCIField>NEW_ITEM-CONTRACT[1]</OCIField> <OCIValue></OCIValue> <OCIField>NEW_ITEM-CONTRACT_ITEM[1]</OCIField> <OCIValue></OCIValue> <OCIField>NEW_ITEM-EXT_PRODUCT_ID[1]</OCIField> <OCIValue>sid496|SSP-3793CAT</OCIValue> <OCIField>NEW_ITEM-LONGTEXT_1:132[]</OCIField> <OCIValue>SSP-3793 Catalog-Item For JCN</OCIValue> <OCIField>NEW_ITEM-SERVICE[1]</OCIField> <OCIValue></OCIValue> </ocisecurity>