Inbound | POST | /shipment/cart-split

Summary

This API can be used by Shopfront platforms or External system (Logistics management system, ERP, External fulfillment systems) to retrieve information of probable order split from Increff OMS system.

Description

• When a customer adds the desired products in the cart page, Shopfront platforms can seamlessly call this API to fetch the information of Probable split of the order.
• Shopfront platform needs to provide the Cart level information like Order item details (channelSkuCode , Qty and orderLineItemId ), Payment type and Destination address details (city, state, country, zipCode)
• Shopfront will receive the probable split of the order from Increff OMS system as per the Splitting-Routing algorithm configured at that point of time.

Request

{
  "cartId": "ABCDEFG-234234-s-3513-4",
  "cartTimer": 600,
  "channelId": "AYX",
  "orderItems": [
    {
      "channelSkuCode": "ABCD",
      "qty": 2,
      "orderLineItemId": "25"
    },
    {
      "channelSkuCode": "ABCD1",
      "qty": 3,
      "orderLineItemId": "24"
    }
  ],
  "isPriority": false,
  "paymentType": "NCOD",
  "destinationAddress": {
    "city": "Indore",
    "state": "MP",
    "country": "India",
    "zipCode": "indore-453"
  }
}

Note: Relevant for future implementation of API at cart level | No | | cartTimer | Integer | Cart timer value in seconds. We should be able to reserve the inventory till this time. | No | | channelId | String | Channel Identifier for respective webshop channel created in Increff system | No | | orderItems.channelSKU | String | SKU identifier of the respective channel | Yes | | orderItems.qty | Integer | Quantity or Stock customer has added in cart | Yes | | orderItems.orderLineItemId | String | Line item identifier for each SKU line in the probable order | No | | isPriority | Boolean | • If the user has selected a priority delivery • If is priority is changed, then Shopfront will need to send a new request with a newcart_id | No Default as false | | paymentType | String | Payment type can be COD or NCOD | Yes | | destinationAddress.city | String | City name of destination address | No | | destinationAddress.state | String | State of destination address | No | | destinationAddress.country | String | Country of destination address | No | | destinationAddress.zipCode | String | Area code of destination address | Yes |

Response

{
  "cartId": "ABCDEFG-234234-s-3513-4",
  "subOrder": [
    {
      "id": 1,
      "location": "fulfilment-location-code",
      "locationAddress": {
        "city": "Indore",
        "state": "MP",
        "country": "India",
        "zipCode": "indore-453"
      },
      "destinationAddress": {
        "city": "Indore",
        "state": "MP",
        "country": "India",
        "zipCode": "indore-453"
      },
      "orderItems": [
        {
          "channelSkuCode": "ABCD1",
          "quantity": 1
        },
        {
          "channelSkuCode": "ABCD",
          "quantity": 1
        }
      ]
    },
    {
      "id": 2,
      "location": "fulfilment-location-cod",
      "locationAddress": {
        "city": "Indore",
        "state": "MP",
        "country": "India",
        "zipCode": "indore-453"
      },
      "destinationAddress": {
        "city": "Indore",
        "state": "MP",
        "country": "India",
        "zipCode": "indore-453"
      },
      "orderItems": [
        {
          "channelSkuCode": "ABCD1",
          "quantity": 2
        },
        {
          "channelSkuCode": "ABCD",
          "quantity": 2
        }
      ]
    }
  ]
}

Note: Relevant for future implementation of API at cart level | Yes | | subOrder | Object | Probable Sub Order details object | Yes | | subOrder.id | Integer | unique identifier for probable sub order | Yes | | subOrder.location | String | Assigned location for fulfilling probable sub order | Yes | | subOrder.orderItems.channelSkuCode | String | Item level idenitifer | Yes | | subOrder.orderItems.quantity | Integer | Stock or Quantity for each item | Yes | | destinationAddress.city | String | City name of destination address | No | | destinationAddress.state | String | State of destination address | No | | destinationAddress.country | String | Country of destination address | No | | destinationAddress.zipCode | String | Area code of destination address | Yes | | location_address.city | String | City name of destination address | No | | location_address.state | String | State of destination address | No | | location_address.country | String | Country of destination address | No | | location_address.zipCode | String | Area code of destination address | Yes |

HTTP status

200