/
Tracking updates unicommerce

Objective

The object of this article is to provide the tracking updates for the requested tracking ids to unicommerce platform. this will help them track the shipments after they have already been packed.

To provide shipment tracking updates, a GET api needs to be developed will be exposed which unicommerce. unicommerce will send tracking ids list in request (maximum 50 tracking ids) of this API and in response, it will return the tracking details for all these requested tracking ids.

What are the Steps to achieve this task ?

  1. We will need to share all our all tracking statuses list or tracking statuses code with unicommerce so that they can map them.

  2. Develop a Get API inshippingAppEndpoint of GCP Project - ESB integration Engine and esb wms API service
    Api details :-

    1Endpoint: /waybillDetails 2Request Type: GET 3Scheme: HTTPS 4Header (Content-Type): application/json 5Header (Authorization): token (got from SP Authentication)

  3. Request body from unicommerce hits the GEP API /waybillDetails . Request will be in params

    1waybills: "123,ABC,ORD123"

  4. Get waybills from request body params and store them in a List<String> trackingIds.

  5. Query from DB to fetch all the shipment details required for response from shipments and shipment status logs table from DB for all tracking ids

    1

  6. Prepare and return the response

    1. Success Response

      1{ 2 "Status": "SUCCESS", 3 "waybillDetails": [ 4 { 5 "waybill": "80224636450", 6 "currentStatus": "PICKUP_PENDING",----------Most recent courier status of AWB, statuscode or status 7 "current_sub_status": "out for pickup",-----to be discussed 8 "statusDate": "05-Aug-2023 03:52:09"--------Last status date 9 }, 10 { 11 "waybill": "12345678", 12 "currentStatus": "PICKUP_PENDING", 13 "current_sub_status": "out for pickup", 14 "statusDate": "05-Aug-2023 03:52:09" 15 } 16 ] 17 "message": "String"-----------------------------to be discussed 18}

    2. Error Response

      1{ 2 "status":"FAILED", 3 "message":"failure reason", ------e.g.,Connect to Shipping Provider (to be disccsed) 4 "waybillDetails":[] 5}

Open Point :-

  1. If out of 10 requested tracking ids, we get data for only 8 tracking ids, then for rest two tracking ids how can we notify that these two tracking ids were not a success