Versions Compared

Old Version 34

changes.mady.by.user Vemulapalli Lahari

Saved on

compared with

New Version 35

changes.mady.by.user Vemulapalli Lahari

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Section 1: Delivery Status

...

  1. The Delivery Status section depends on TrackingStatus API Response.

  2. This section consists of:

    1. Progress Bar Menu

      1. Progress Bar menu names come from the selected_shipment_activities list. Progress Bar menu names can be configured as per your needs. The bar moves by considering a concise info list.

    2. Delivery Date (delivery_date field from edd_info object)

    3. Delivery Status (latest event from concise info list)

    4. Order Number and Placed on date ( from order_info)

    5. Tracking Number (taking from tracking_number field)

 Section 2: Important Updates

...

  1. Important updates: Considering the important_updates field from TrackingStatus API Response.

  2. It's easily configurable from the backend.

Section 3: Track Event History

...

  1. Tracking page API response provides the track events.

  2. We are considering events from the shipment_activities list.

Section 4: Order Line Items in the Package

...

  1. Fenix will enable the boolean flag display_line_items from the backend configuration if you want to display the order line items on the tracking page

  2. We are considering line items from line_items list from the TrackingStatus API Response.

Section 5: Digital Assets (2-Vertical images)

...

  1. Fenix UI team will integrate the Digital Assets (2-Vertical images) that you provide. It's a static configuration.

Section 6: Promotional Video & Digital Assets (1-Horizontal image)

...

  1. Fenix UI team will integrate the Promotional video (Youtube) & Digital Asset (1-Horizontal image) that you provide. It's a static configuration.

Section 7: Product Recommendations

...

  1. RecommendedProducts API  response provides the recommended product information.

  2. Fenix team uses Shopify Algorithm to display recommended products. 

  3. Fenix team will enable the boolean flag display_recommended_products from the backend configuration if you want to showcase the recommended products on the tracking page.

Note: If you have your own Algorithm or Recommendation engine to retrieve recommended products, you can utilize it to show recommended products.

Section 8: Multi-Shipment View

...

  1. Fenix provides flexibility to track different shipments of the same order through the multi-shipments view.

  2. MultiShipment View API  Response API provides multi-shipments information.

  3. See Full Order link is enabled only if the order contains multiple shipments.

Section 9: Feedback Rating & Comments

...

  1. We are capturing Feedback Ratings and Comments provided by shoppers through Feedback API.

  2. We will store this information in the Fenix data warehouse.

Section 10: Delivery Status updates subscription

...

  1. To get the subscriptions from the shoppers either via email id or phone number to get automatic notifications on different shipment status from fenix.

  2. Currently, Fenix supports two channels for sending delivery status notifications to subscribers:

    1. Email 

    2. SMS

Section 11: Headers & Footers

...

  1. Fenix UI team will integrate the Headers & Footers that you provide.

Track Status API Details:

...

Resource Name

getTrackHistory

Resource URL

api/v1/{identifier-name}/track-status?tracking_number=123&notification_id=undefined

Method

GET

Params (query/path)

PathVariable:

Identifier-name

RequestParam:

tracking_number

order_number

notification_id

Headers

Request Payload

Response Payload

Code Block
languagejson
{
    "fenixShipping": true, 
    "tracking_number": "123", 
    "carrier_name": "UPS", 
    "important_updates": "Please note that carrier delays can occur due to weather or COVID-19. Many carrier hubs have had to adjust to ensure the health + safety of their employees and it may impact transit times. Please reach out to <a href =\"https://www.yourstore.com/pages/contact-us\">yourstore.com</a> with any questions you have about your order.", 
    "display_emoji": false, 
    "fulfillment_status": "PARTIALLY_FILLED",
    "emoji_on": null, 
    "edd_info": {
        "delivery_date": "Friday, September 09 2022", 
        "promised_date": "Monday, September 12 2022", 
        "delivery_message": "Yay, it\"s early...", 
        "expected_shipment_date": "Wednesday, September 07 2022", 
        "split_delivery_date": {
            "day": "Friday", 
            "month": "September", 
            "date": "09", 
            "year": "2022"
        }, 
        "header_name": "Expected Delivery Date"
    }, 
    "display_order_info": true, 
    "order_info": {
        "number": "AAA", 
        "placed_dtm": "2022-09-07T10:55:11-05:00", 
        "formatted_dttm": "Wednesday, September 07 2022"
    }, 
    "concise_infos": [
        {
            "description": "SHIPPED", 
            "event_date": "Wednesday, September 07 2022", 
            "event_code": "SH", 
            "event_message": "Order Confirmed"
        }, 
        {
            "description": "PICKED", 
            "event_date": "Wednesday, September 07 2022", 
            "event_code": "PU", 
            "event_message": "Left Warehouse"
        }
    ], 
    "order_status_url": "https://bombas.com/11195850/orders/039e8db6b55a95f50e877bd132294d6e/authenticate?key=5ef056b7832752052aebe458a4ac18df",
    "shipment_activities": [
        {
            "day": "Sep 07, 2022", 
            "time": "12:09 PM", 
            "desc": "Shipper created a label, UPS has not received the package yet.", 
            "address": {
                "first_name": null, 
                "last_name": null, 
                "name": null, 
                "company": null, 
                "address1": null, 
                "address2": null, 
                "country": "US", 
                "country_code": "US", 
                "province": null, 
                "province_code": null, 
                "city": null, 
                "zip_code": null, 
                "latitude": null, 
                "longitude": null,
                "zipcode_populate_code": null
            }, 
            "event_code": "MP", 
            "fenix_code": "IT",
            "offset": null
        }, 
        {
            "day": "Sep 07, 2022", 
            "time": "06:43 PM", 
            "descoffset": "Origin null,
            "desc": "Origin Scan", 
            "address": {
                "first_name": null, 
                "last_name": null, 
                "name": null, 
                "company": null, 
                "address1": null, 
                "address2": null, 
                "country": "US", 
                "country_code": "US", 
                "province": "FL", 
                "province_code": "FL", 
                "city": "Orlando", 
                "zip_code": null, 
                "latitude": null, 
                "longitude": null,
                "zipcode_populate_code": null
            }, 
            "event_code": "OR", 
            "fenix_code": "IT"
        }, 
        {
            "day": "Sep 08, 2022", 
            "time": "12:49 PM",
            "offset": null, 
            "desc": "Received by the local post office", 
            "address": {
                "first_name": null, 
                "last_name": null, 
                "name": null, 
                "company": null, 
                "address1": null, 
                "address2": null, 
                "country": null, 
                "country_code": null, 
                "province": null, 
                "province_code": null, 
                "city": null, 
                "zip_code": null, 
                "latitude": null, 
                "longitude": null,
                "zipcode_populate_code": null
            }, 
            "event_code": "YH", 
            "fenix_code": "IT"
        }
    ], 
    "recent_shipment_info": {
        "day": "Sep 08, 2022", 
        "time": "12:49 PM",
         "descoffset": "Receivednull, by
the local post office",      "desc": "Received by the local post office", 
        "address": {
            "first_name": null, 
            "last_name": null, 
            "name": null, 
            "company": null, 
            "address1": null, 
            "address2": null, 
            "country": null, 
            "country_code": null, 
            "province": null, 
            "province_code": null, 
            "city": null, 
            "zip_code": null, 
            "latitude": null, 
            "longitude": null,                
            "zipcode_populate_code": null
        }, 
        "event_code": "YH", 
        "fenix_code": "IT"
    }, 
    "selected_shipment_activities": [
        {
            "event_code": "SH", 
            "display_message": "Order Confirmed"
        }, 
        {
            "event_code": "PU", 
            "display_message": "Left Warehouse"
        }, 
        {
            "event_code": "OFD", 
            "display_message": "Out for delivery"
        }, 
        {
            "event_code": "DL", 
            "display_message": "Delivered"
        }
    ], 
    "line_items": [
        {
            "sku": "101102", 
            "quantity": 1, 
             "nameprice": "special cleansing gel - travel - 1.7 oz",{
                 "titlecurrency": "specialUSD",
cleansing gel - travel",              "variantIdvalue": "123",60.8
              "},
            "name": "special cleansing gel - travel - 1.7 oz", 
            "title": "special cleansing gel - travel", 
            "variantId": "123", 
            "image_url": "https://cdn.shopify.com/s/files/1/0420/7683/1896/products/specialcleansinggel_1.7oz_98dee553-f068-43c8-a94b-5cb93e84d0c1.jpg?v=164764199788", 
            "product_id": "123", 
            "routing_url": "https://www.yourstore.com/products/special-cleansing-gel-travel",
        },          {"refunded_item": false,
            "skurefunded_quantity": "111249"0,
             "quantityrequires_shipping": 1,true
        }, 
   "name": "daily microfoliant exfoliator - 2.6 oz", {
             "titlesku": "daily microfoliant exfoliator111249", 
            "variantIdquantity": "123"1, 
             "image_urlprice": "https://cdn.shopify.com/s/files/1/0420/7683/1896/products/daily-microfoliant_main-with-benefits.jpg?v=16600853368",{
              "product_id  "currency": "123USD",
                "routing_urlvalue": "https://www.yourstore.com/products/daily-microfoliant"
70.8
       }     ]},
     "display_lineitems": true,      "item_countname": {"daily microfoliant exfoliator -   2.6 oz", 
 "total_ordered": 3,          "total_filledtitle": 2 "daily microfoliant exfoliator", 
        "current_packaged    "variantId": 2"123", 
      },      "remaning_days_to_delivery_info": "Your Order is Going to Deliver Today",image_url": "https://cdn.shopify.com/s/files/1/0420/7683/1896/products/daily-microfoliant_main-with-benefits.jpg?v=16600853368", 
            "product_id": "123", 
            "routing_url": "https://www.yourstore.com/products/daily-microfoliant",
            "refunded_item": false,
            "refunded_quantity": 0,
            "requires_shipping": true
        }
    ], 
    "display_lineitems": true, 
    "item_count": {
        "total_ordered": 3, 
        "total_filled": 2, 
        "current_packaged": 2
    }, 
    "remaning_days_to_delivery_info": "Your Order is Going to Deliver Today", 
    "display_recommended_products": true,
    "order_status_url": "https://bombas.com/11195850/orders/039e8db6b55a95f50e877bd132294d6e/authenticate?key=5ef056b7832752052aebe458a4ac18df",
    "page_by_ordernumber": true,
    "split_shipment": true,
    "subscribed_for_delivery_notifications": false,    
    "display_recommended_products": trueedd_source": "CARRIER_EXPECTED"

}

Response Status

200 - Success

400 – Failure

401 - Un-Authentication 

...

Track Status API Components

identifier-name

Unique Name For Retailer

notification_id

We identify the notification from where the tracking page got triggered using notification_id.

important_updates

Message which retailer wants to display in the tracking page.

edd_info

Contains information regarding 

  • Delivery date

  • Delivery message

  • Split delivery date

  • Header name 

Note : Header name refers to whether the delivery date is the promised delivery date which is shown in checkout page or expected delivery date which is provided by the carrier after pickup or delivery date on package delivered to customer.

Code Block
{
    "delivery_date": "Friday, September 09 2022", 
    "promised_date": "Monday, September 12 2022", 
    "delivery_message": "Yay, it\"s early...", 
    "expected_shipment_date": "Wednesday, September 07 2022", 
    "split_delivery_date": {
        "day": "Friday", 
        "month": "September", 
        "date": "09", 
        "year": "2022"
    }, 
    "header_name": "Expected Delivery Date"
}

display_order_info

Refers to whether to display order details(refer to order_info field)  on the page or not.

  • true : display

  • false : not to display

order_info

Contains Order related information such as 

Code Block
{
    "number": "AAA", 
    "placed_dtm": "2022-09-07T10:55:11-05:00", 
    "formatted_dttm": "Wednesday, September 07 2022"
}

concise_infos

Moves the progress bar to the latest status (event). Events that Fenix can track are:

  • Order Confirmed

  • Shipment Confirmed

  • Ready To Ship

  • Shipment Cancelled

  • Left Warehouse

  • Shipment Exception

  • Intransit

  • Out for delivery

  • Delivery Exception

  • Return To Sender

  • Returned To Sender

  • Delivered

Depending on the last tracked event, Fenix shows only 4 events in the progress bar.

For more details refer here.

shipment_activities

To display Shipment Track Event History.

recent_shipment_info

Latest Track Event info which we will show in Latest update in Delivery Status section.

selected_shipment_activities

To build the complete progress bar section with stoppers.

line_items

Contains all the product details which are part of order or shipments. We will display line items information in Section 4.

display_lineitems

Refers to whether to display order line items on the tracking page or not. 

  • true : display

  • false : not to display

item_count

Refer to whether to display a multi shipment section or notRefers to whether Single or MultiShipment package.

Code Block
{
    "total_ordered": 3, 
    "total_filled": 2, 
    "current_packaged": 2
}

  • total_filled: Items shipped by retailer.

  • current_packaged:  Items which exist in the current package.

Note : Based on total ordered and current packaged count “See full Order” will be displayed if order has multiple shipments

  • package.

Note : If totalordered Count equals to currentPackaged then split_shipment flag will disable otherwise flag will be enable.

split_shipment

Refers to whether to display a multi shipment section or not.

  • true : display “See full Order”

  • false : not display ““See full Order”.

display_recommended_products

Refers to whether to call Recommended products API or not.

  • true : call API

  • false : not call API

Note: If ‘false’ then product recommendations section will be hidden.recommendations section will be hidden.

page_by_ordernumber

Whether to trigger tracking page api by providing order_number. 

  • true : both by order_number or tracking_number

  • false : only by tracking_number

order_status_url

subscribed_for_delivery_notifications

Refers to whether to display Subscription section or not.

  • true : display Subscription section

  • false : not display subscription section

RecommendedProducts API Details

...

Resource Name

getTrackHistory

Resource URL

api/v2/{identifier-name}/track-status?order_number=AAA&place_dttm=2022-07-19T14:16:04-05:00

Method

GET

Params (query/path)

PathVariable:

Identifier-name

RequestParam:

place_dttm

order_number

Headers

Request Payload

Response Payload

Code Block
languagejson
{
    "order_summary": {
        "number": "AAA", 
        "placed_date": "Wednesday, September 07 2022", 
        "promised_date": "Monday, September 12 2022", 
        "split_delivery_date": {
            "day": "Monday", 
            "month": "September", 
            "date": "12", 
            "year": "2022"
        }, 
        "total_item_quantity": 3, 
        "total_filled_item_quantity": 2, 
        "line_items": [
            {
                "sku": "456", 
                "quantity": 1, 
                "name": "double cleanse full size kit - each", 
                "title": "double cleanse full size kit", 
                "variantId": "41694522802328", 
                "image_url": "https://cdn.shopify.com/s/files/1/0420/7683/1896/products/double-cleanse-set_carton-front.jpg?v=1653587001", 
                "product_id": "7255087710360"": "7255087710360", 
                "routing_url": "https://www.store-us.com/products/double-cleanse-full-size-kit",
                "refunded_item": false,
                "refunded_quantity": 0,
                 "routingrequires_urlshipping": "https://www.store-us.com/products/double-cleanse-full-size-kit"true
            }, 
            {
                "sku": "123", 
                "quantity": 1, 
                "name": "special cleansing gel - travel - 1.7 oz", 
                "title": "special cleansing gel - travel", 
                "variantId": "11123", 
                "image_url": "https://cdn.shopify.com/s/files/1/0420/7683/1896/products/specialcleansinggel_1.7oz_98dee553-f068-43c8-a94b-5cb93e84d0c1.jpg?v=164", 
                "product_id": "5710539751576", 
                "routing_url": "https://www.store-us.com/products/special-cleansing-gel-travel"-cleansing-gel-travel",
                "refunded_item": false,
                "refunded_quantity": 0,
                "requires_shipping": true
            }, 
            {
                "sku": "232", 
                "quantity": 1, 
                "name": "daily microfoliant exfoliator - 2.6 oz", 
                "title": "daily microfoliant exfoliator", 
                "variantId": "126", 
                "image_url": "https://cdn.shopify.com/s/files/1/0420/7683/1896/products/daily-microfoliant_main-with-benefits.jpg?v=166", 
                "product_id": "5710551548056", 
                "routing_url", : "https://www.store-us.com/products/daily-microfoliant",
                "refunded_item": false,
                "refunded_quantity": 0,
                "routingrequires_urlshipping": "https://www.store-us.com/products/daily-microfoliant"true
            }
        ]
    }, 
    "shipment_summaries": [
        {
            "edd_info": {
                "delivery_date": "Friday, September 09 2022", 
                "promised_date": "Monday, September 12 2022", 
                "delivery_message": "Yay, it\"s early...", 
                "expected_shipment_date": "Wednesday, September 07 2022", 
                "split_delivery_date": {
                    "day": "Friday", 
                    "month": "September", 
                    "date": "09", 
                    "year": "2022"
                }, 
                "header_name": "Expected Delivery Date"
            }, 
            "tracking_number": "123", 
            "carrier_name": "UPS", 
            "event_message": "Left Warehouse", 
            "item_quantity": 2, 
            "line_items": [
                {
                    "sku": "123", 
                    "quantity": 1, 
                    "name": "special cleansing gel - travel - 1.7 oz", 
                    "title": "special cleansing gel - travel", 
                    "variantId": "11123", 
                    "image_url": "https://cdn.shopify.com/s/files/1/0420/7683/1896/products/specialcleansinggel_1.7oz_98dee553-f068-43c8-a94b-5cb93e84d0c1.jpg?v=164", 
                    "product_id": "5710539751576", 
                    "routing_url": "https://www.store-us.com/products/special-cleansing-gel-travel"products/special-cleansing-gel-travel",
                    "refunded_item": false,
                    "refunded_quantity": 0,
                   "requires_shipping": true
                }, 
                {
                    "sku": "232", 
                    "quantity": 1, 
                    "name": "daily microfoliant exfoliator - 2.6 oz", 
                    "title": "daily microfoliant exfoliator", 
                    "variantId": "126", 
                    "image_url": "https://cdn.shopify.com/s/files/1/0420/7683/1896/products/daily-microfoliant_main-with-benefits.jpg?v=166", 
                    "product_id": "5710551548056", 
                    "routing_url": "https://www.store-us.com/products/daily-microfoliant",
                    "refunded_item": false,
                    "refunded_quantity": 0,
                    "requires_shipping": true
                }
            ]
        }
    ]
}

Response Status

200 - Success

400 – Failure

401 - Un-Authentication 

...