Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Next »

Fenix Unified Shipping API combines three important aspects of post purchase journey into a single API. This API includes the following functionality.

  • Cartonization

  • Order Sourcing

  • Rate Shopping

Fenix Order Sourcing is basically a means to route the order to a fulfillment location that can deliver the order to the customer as fast as possible in a cost effective way. Fenix Order Sourcing rules can be prioritized and can be chosen which rule should be applied before another. A user friendly rules screen will help the business user to change the rules, prioritize and add/remove them with ease and any change that is made to the rules will effect immediately.

Fenix Rate Shopping provides the retailers the ability to show the optimal rates on the checkout page to the consumer by comparing the rates across multiple carrier services. At the time of Label printing, it combines the power of its Rate Shopping engine with the Transit Time Models of various carrier services and helps the retailers in scheduling the shipping while still satisfying the customers delivery expectations.

Flow

Integration Touchpoints

Sample API Request and Response

Attribute

Description

Endpoint

https://postpurchase.fenixcommerce.com/fenix/oms/crs/v1/rateshopping/get-shipping-info

Method

POST

Headers

tenant_id

auth_token

Request Sample

{
  "request_id": "4ba0d463-6476-47f8-b67a-5c8c4bbcf3da",
  "shipment_id": "b7866a89-8dc1-4bac-8c4b-be1fabb56cb7",
  "to": {
    "fname": "",
    "lname": "",
    "address1": "4320 Stevens Creek Blvd",
    "address2": "",
    "city": "San Jose",
    "country": "US",
    "state": "CA",
    "zipcode": "95129",
    "residential": true,
    "po_box": false
  },
  "from": {
    "fname": "",
    "lname": "",
    "address1": "2325 Enborg Ln",
    "address2": "",
    "city": "San Jose",
    "country": "US",
    "state": "CA",
    "zipcode": "95128",
    "residential": false,
    "po_box": false
  },
  "warehouse_id": "3bcde514-c7d7-40d5-9e41-2d0c1303810f",
  "product_infos": [
    {
      "sku": "abc",
      "quantity": 1,
      "variant_id": 123,
      "product_id": 123,
      "dimensions": {
        "length": 6,
        "width": 8,
        "height": 6,
        "units": "IN"
      },
      "weight": {
        "value": 1,
        "units": "LB"
      }
    }
  ],
  "shipment_info": {
    "package_name": null,
    "dimensions": {
      "length": 6,
      "width": 8,
      "height": 6,
      "units": "IN"
    },
    "weight": {
      "value": 1,
      "units": "LB"
    },
    "product_infos": [
      {
        "sku": "abc",
        "quantity": 1,
        "variant_id": 123,
        "product_id": 123,
        "dimensions": {
          "length": 6,
          "width": 8,
          "height": 6,
          "units": "IN"
        },
        "weight": {
          "value": 1,
          "units": "LB"
        }
      }
    ]
  },
  "expected_delivery_date": "2023-10-31T01:30+01:00",
  "expected_shipping_date": "2023-10-31T01:30+01:00",
  "deliver_within_days": 10
}

Response

{
  "request_id": "4ba0d463-6476-47f8-b67a-5c8c4bbcf3da",
  "shipment_id": "b7866a89-8dc1-4bac-8c4b-be1fabb56cb7",
  "to": {
    "fname": "",
    "lname": "",
    "address1": "4320 Stevens Creek Blvd",
    "address2": "",
    "city": "San Jose",
    "country": "US",
    "state": "CA",
    "zipcode": "95129",
    "residential": true,
    "po_box": false
  },
  "expected_delivery_date": "2023-10-31T01:30+01:00",
  "expected_shipping_date": "2023-10-31T01:30+01:00",
  "deliver_within_days": 10,
  "error_info": {
    "error_code": "123",
    "error_message": "error message",
    "description": "message description"
  },
  "shipment_infos": [
    {
      "fulfillment_info": {
        "loc_id": "54862250135",
        "address": {
          "fname": "",
          "lname": "",
          "address1": "4320 Stevens Creek Blvd",
          "address2": "",
          "city": "San Jose",
          "country": "US",
          "state": "CA",
          "zipcode": "95129",
          "residential": true,
          "po_box": false
        }
      },
      "shipment_info": [
        {
          "shipment_id": "abc",
          "sourcing_info": [
            {
              "sku_id": "black-leather-bag-12",
              "product_id": "7106172944535",
              "variant_id": "42499122102423",
              "line_item_id": null,
              "requested_quantity": 1,
              "allocated_quantity": 1
            }
          ],
          "cartonization_info": {
            "length": {
              "value": 10,
              "units": "IN"
            },
            "width": {
              "value": 10,
              "units": "IN"
            },
            "height": {
              "value": 10,
              "units": "IN"
            },
            "weight": {
              "value": 1,
              "units": "LB"
            }
          },
          "rate_shopping_info": [
            {
              "recommended_service": {
                "carrier": "UPS",
                "service": {
                  "code": "04",
                  "name": null
                },
                "ship_cost": {
                  "amount": 6.74,
                  "currency": "USD"
                },
                "transit_info": {
                  "delivery_date": "2023-10-31T01:30+01:00",
                  "transit_time": 2
                },
                "ship_by_date": "2023-10-31T01:30+01:00",
                "delivery_accuracy_percent": 0.0,
                "metainfo": {
                  "included": true,
                  "exclusion_code": null,
                  "exclude_message": null
                }
              },
              "services_excluded": [
                {
                  "carrier": "UPS",
                  "service": {
                    "code": "04",
                    "name": null
                  },
                  "ship_cost": {
                    "amount": 6.74,
                    "currency": "USD"
                  },
                  "transit_info": {
                    "delivery_date": "2023-10-31T01:30+01:00",
                    "transit_time": 2
                  },
                  "ship_by_date": "2023-10-31T01:30+01:00",
                  "delivery_accuracy_percent": 0.0,
                  "metainfo": {
                    "included": true,
                    "exclusion_code": null,
                    "exclude_message": null
                  }
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}

  • No labels