Order Processing

Open

The Below Table explains the description of each Block present in Sequence Diagram

Step1. Make a Real-Time POST API with endpoint path "orders/processing" which will receive a request to process the order(RTD) along with a request body.

EndPoint:

Success Response from Endpoint:

Step2. Extract key "connectionId" from the request body. Using externalWmsChannelId extract locationId from DB.
Table: external_wms_channels

Step3. Using connectionId fetch "tenant name" and "accessToken" from cache if not present then extract it from DB.

Database: prod_integration_engine

Table: ie_appinstall_connection

Query:

Step4. Extract key "thirdPartyShipping" from the request body.

Step5. If "thirdPartyShipping" == "true" then fetch invoice and label from unicommerce

Step5.1  Extract customerOrderNumber from the request body

Step5.2  Prepare the Request body and URL to fetch invoice and label

URL:

Request Body:

RESPONSE:

Success Response from Endpoint:

Step5.3  Make a POST request on the above prepared URL.

Step5.4 If we receive a Success response from Unicommerce then upload the invoice and label on the GCloud and return the URL in response from this endpoint. Else in case of an error response throw the same error.

Step6. If "thirdPartyShipping" == "false" then fetch only invoice unicommerce

Step6.1 In this case we just need to get invoice from unicommerce.

Step6.2 Prepare the Request body and URL to fetch invoice from unicommerce

URL:

Request Body:

Step6.3 Make a POST request on the URL

Step6.4 In case of Success reponse from Unicommerce, Upload the invoice on GCloud and return the invoice URL in response. In case of error throw the error.

Success Response:

Error Response:

Uniware/courier/assign

=====================================================================

Two Way to process orders:

1. Eshopbox uniware request for RTD :
   
   

   1. If thirdPartyShipping : true (INVOICE /LABEL to be fetch from uniware ) :
      REQUEST FROM ESB TO JAVA :
      {     "vendorOrderNumber" : "31435",     "customerOrderNumber" : "345346456",     "locationId" : "test",     "connectionId" : "123",
      “externalShipmentID” :””,
          "thirdPartyShipping": true }

       

      1. Call uniware API : get invoice and label both
         curl -X POST \
           https://varad.unicommerce.com/services/rest/v1/oms/shippingPackage/createInvoiceAndGenerateLabel \
           -H 'authorization: Bearer 2ecda948-5605-42de-964b-063c2b420da1' \
           -H 'cache-control: no-cache' \
           -H 'content-type: application/json' \
           -H 'facility: POSTEST' \
           -H 'postman-token: 57098575-b893-3b8e-8fc4-afeb4c802229' \
           -d '{
          "shippingPackageCode": "POST00099",
         "generateUniwareShippingLabel": true
         }'
         Success : Save both in Eshopbox.
         Fail : Return same error response received from uniware
         
         customerOrderNumber = shippingPackageCode

   2. If thirdParty Shipping : false (INVOICE TO BE FETCH FROM UNIWARE/ courier detail to be pushed by ESB to uniware)
      {     "vendorOrderNumber" : "31435",     "customerOrderNumber" : "345346456",     "locationId" : "test",     "connectionId" : "123",     "thirdPartyShipping": false,     "CourierName":  "Eshopbox",
      ”externalShipmentID”:””,
          "TrackingId": "ShipmentTabel primary Key" }
      To create invoice:
      curl -X POST \
        https://varad.unicommerce.com/services/rest/v1/oms/shippingPackage/createInvoice \
        -H 'authorization: bearer cacc2bf3-0fe1-498d-995c-36b3c4b19b81' \
        -H 'cache-control: no-cache' \
        -H 'content-type: application/json' \
        -H 'facility: varad' \
        -H 'postman-token: cdb88875-f58d-3927-f464-0cab203a3e52' \
        -d '{
          "shippingPackageCode": "VARAAA06578"
      }' Once invoice generate save in Eshopbox
      To assign courier :

      curl -X POST \
        https://varad.unicommerce.com/services/rest/v1/oms/shippingPackage/allocateShippingProvider \
        -H 'authorization: Bearer 8efba777-72dd-47fe-84e5-575d8ca8cff3' \ // Access token
        -H 'content-type: application/json' \
        -H 'facility: 3454' \ // UC's warehouse code
        -d '{
          "shippingPackageCode" :"345400081", // Shipping Package code as you'll receive from searchShippingPackage API
          "shippingProviderCode" : "akshatdemo", // Predefined code in UC for the aggregator (Shiprocket)
          "shippingCourier" : "Eshopbox", // Actual courier code, like fedex, bluedart etc
          "trackingNumber" : "ShipmentTabel primary Key" // Assiged AWB number
         
      }'