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

  1. 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.

  2. The connectivity service persists the ShoppingCartID corresponding to the SessionId and notifies the SAP S/4HANA system.
  3. 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>