XOMNI: Experience Omni-Channel

Last Updated: February 19, 2016

This API updates the quantity of an existing shopping cart item based on its unique key.

Request

HTTP Method Resource URI
PUT https://{tenantName}.api.xomni.com/pii/shoppingcartitem?shoppingCartItemUniqueKey={shoppingCartItemUniqueKey}&quantity={quantity}&longitude={longitude}&latitude={latitude}

URI Parameters

Parameter Name Description Type Conditions
shoppingCartItemUniqueKey The unique key of the shopping cart item. string
quantity New quantity of the shopping cart item. number
latitude Latitude value of the location where the shopping cart item is updated at. number
longitude Longitude value of the location where the shopping cart item is updated at. number

Request Headers

Header Field Name Description
Content-Type
Content type of the response entity. The value of this header is always application/json.
PIIToken
Includes the base64-encoded “Personally Identifiable Information” data.
Sample: dXNlcm5hbWU6SW5uQXBwc1VzZXI7cGFzc3dvcmQ6SW5uQXBwc1Bhc3M=
Accept
Includes minor version header.
Sample: application/vnd.xomni.api-v4-0, */*
Authorization
Access or identity token taken from oauth APIs.
Sample: Bearer dc8f1dcdbe454da8a25621839a93569337522968019e4bd7becd6e01285444da

PIIToken is optional.

Response

{
    "Data": {
        "ItemId": 2,
        "Quantity": 2,
        "BluetoothId": "BluetoothId",
        "LastSeenLocation": {
            "Longitude": -122.335197,
            "Latitude": 47.646711
        },
        "DateAdded": "2013-03-12T14:13:07.7543788+02:00",
        "UniqueKey": "942653b2-88e9-43fc-a336-c720d0c1ee76"
    }
}

Response Body Description

Parameter Name Description Type
Data.Quantity Quantity of the added item(s). Quantity
Data.ItemId The unique ID of the item added to the shopping cart. ItemId
Data.BluetoothId Bluetooth sensor ID. BluetoothId
Data.DateAdded The date when the item is added into the shopping cart. DateAdded
Data.UniqueKey The unique key of the shopping cart item. UniqueKey
Data.LastSeenLocation.Longitude Longitude value of the location. Number
Data.LastSeenLocation.Latitude Latitude value of the location. Number

Response Headers

Header Field Name Description
Content-Type
Content type of the response entity. The value of this header is always application/json.

Status Codes

A successful operation returns status code 200 (OK) for PUT operations. Possible response status codes are as listed below:

Status Code Description
403 (Forbidden) This shopping cart is private or not accessible to specified PII User.
404 (Not Found) The shopping cart you are trying to update an item is not found.