BOPS Product Availability (Using UPC ID) V4

Description
Request URL
Path and Query Parameters
Sample Requests and Responses
Error Codes

Description

The V4 BOPS (Buy Online Pick-up in Store) Product Availability service allows you specify a Product ID and return the products BOPS availability at a nearby store using zipcode, city-state, or locationnumber.

HTTP Method and Request URL

GET

https://api.bloomingdales.com/v4/catalog/bops/product/[ProductID](object(nestedobject))

Path and Query Parameters

HTTP Header Parameters

Parameter

Description

Mandatory

Sample Value

Specifies the output format. Can be application/json or application/xml.

Yes

application/json

application/xml

x-macys-webservice-client-id

Pass the apikey as a header value which is called x-macys-webservice-client-id. The api key is the 24 character alphanumeric string assigned to your application when you registered it. Click here for a list of your API keys.

Yes

xmj9js4jkdpe1983fmwu98gh

Path Parameters

Parameter	Description	Mandatory	Sample Value
productID	Unique ID for each product. Multiple UPC IDs can be sent in one call by using a comma	optional, but you need at least upcNumber or productId.	50946872827,50946872831

Object Parameters

Object	Nested Object	Description	Mandatory	Sample Value
upcs	upcdetails, storedata	Returns UPC details	No	(upcs(upcdetails))
stores			No	(stores)

Query Parameters

Parameter	Description	Mandatory	Sample Value
locationNumber	Location number of the area you are trying to locate a BOPS product	No	2371
latitude	latitude of area you are trying to locate a BOPS product.	No	37.355965
longitude	longitude of area you are trying to locate a BOPS product.	No	-122.01318
zipCode	Zip code of area you are trying to locate a BOPS product	No	94105
city	City code of area you are trying to locate a BOPS product. "state" parameter is needed if specifying the "city" parameter.	No	San Francisco
state	City code of area you are trying to locate a BOPS product "city" parameter is needed ifspecifying the "state" parameter.	No


distance	Default is 200 (miles). Can be a number between 1-200	No	50
numberOfStores	Default is 15. Can be a number between 1-15	No	5


callback	If sent, the format is JSONP (JSON with Padding) with the callback returned with the JSON response. You can put anything in the callback parameter and whatever you send is returned.	No	magicofbloomingdalesap

Sample Requests and Responses

Sample Requests

Request URL:

GET

http://api.bloomingdales.com/v4/catalog/bops/upc/50946872827(upcs(upcdetails,storedata),stores)?city=San+Francisco&state=CA&distance=50&numberOfStores=1

HTTP Header:

x-macys-webservice-client-id: xmj9js4jkdpe1983fmwu98gh

Accept: application/json

Sample Response

{
    "upcs": [{
        "upcNumber": 50946872827,
        "upcAvailability": [{
            "locationNumber": 2371,
            "storeAvailabilityStatus": "AVAILABLE",
            "bopsAvailabilityStatus": "NOT_AVAILABLE",
            "bopsEligibilityStatus": "NOT_ELIGIBLE"
        }]
    }],
    "stores": [{
        "storeId": 110039,
        "storeNumber": 22,
        "locationNumber": 2371,
        "divisionId": "1",
        "name": "San Francisco Centre",
        "location": {
            "latitude": "37.7849478",
            "longitude": "-122.4066717"
        },
        "address": {
            "line1": "845 Market Street",
            "line2": "",
            "city": "San Francisco",
            "state": "CA",
            "countryCode": "USA ",
            "zipCode": "94103"
        },
        "phone": "415-856-5300",
        "storeworkinghours": [{
            "storeoperationdate": "2014-03-31",
            "storeopenhour": "10:00",
            "storeclosehour": "21:00"
        }, {
            "storeoperationdate": "2014-04-01",
            "storeopenhour": "10:00",
            "storeclosehour": "21:00"
        }, {
            "storeoperationdate": "2014-04-02",
            "storeopenhour": "10:00",
            "storeclosehour": "22:00"
        }, {
            "storeoperationdate": "2014-04-03",
            "storeopenhour": "10:00",
            "storeclosehour": "22:00"
        }, {
            "storeoperationdate": "2014-04-04",
            "storeopenhour": "10:00",
            "storeclosehour": "22:00"
        }, {
            "storeoperationdate": "2014-04-05",
            "storeopenhour": "10:00",
            "storeclosehour": "22:00"
        }, {
            "storeoperationdate": "2014-04-06",
            "storeopenhour": "11:00",
            "storeclosehour": "20:00"
        }, {
            "storeoperationdate": "2014-04-07",
            "storeopenhour": "10:00",
            "storeclosehour": "21:00"
        }, {
            "storeoperationdate": "2014-04-08",
            "storeopenhour": "10:00",
            "storeclosehour": "21:00"
        }, {
            "storeoperationdate": "2014-04-09",
            "storeopenhour": "10:00",
            "storeclosehour": "21:00"
        }, {
            "storeoperationdate": "2014-04-10",
            "storeopenhour": "10:00",
            "storeclosehour": "21:00"
        }, {
            "storeoperationdate": "2014-04-11",
            "storeopenhour": "10:00",
            "storeclosehour": "21:00"
        }, {
            "storeoperationdate": "2014-04-12",
            "storeopenhour": "10:00",
            "storeclosehour": "21:00"
        }],
        "units": "mi",
        "distance": 0.9815541982039611,
        "order": "0",
        "attributes": [{
            "attributeName": "BOPS_NPD",
            "attributeValue": "25-DEC-13"
        }, {
            "attributeName": "BOPS_STORE_OPEN_BUFFER",
            "attributeValue": "01:00"
        }, {
            "attributeName": "SL_SHOPPER",
            "attributeValue": "FALSE"
        }, {
            "attributeName": "PORTRAIT_IMAGE",
            "attributeValue": "/dyn_img/stores/sanfrancisco.jpg"
        }, {
            "attributeName": "SL_VISITOR",
            "attributeValue": "FALSE"
        }, {
            "attributeName": "TIMEZONE",
            "attributeValue": "PST"
        }, {
            "attributeName": "LATITUDE",
            "attributeValue": "37.7849478"
        }, {
            "attributeName": "BOPS_PICKUP_INSTRUCTIONS",
            "attributeValue": "Concierge on level 1"
        }, {
            "attributeName": "DAYLIGHT_SAVINGS_INDICATOR",
            "attributeValue": "TRUE"
        }, {
            "attributeName": "STORE_TYPE_DESC",
            "attributeValue": "NOF"
        }, {
            "attributeName": "SL_MATTRESS",
            "attributeValue": "FALSE"
        }, {
            "attributeName": "BOPS_SLA_HOURS",
            "attributeValue": "4"
        }, {
            "attributeName": "BOPS_PICKUP_CUTOFF",
            "attributeValue": "01:00"
        }, {
            "attributeName": "SL_MATERNITY",
            "attributeValue": "FALSE"
        }, {
            "attributeName": "BOPS_STORE_PHONE",
            "attributeValue": "4158565402"
        }, {
            "attributeName": "MANAGER_NAME",
            "attributeValue": "Alan Svensen"
        }, {
            "attributeName": "SL_RESTAURANT",
            "attributeValue": "FALSE"
        }, {
            "attributeName": "STORE_REGION_LOCATION",
            "attributeValue": "West"
        }, {
            "attributeName": "SHORT_DESC",
            "attributeValue": "Visit our new store in San Francisco, now open!"
        }, {
            "attributeName": "SL_BRIDAL",
            "attributeValue": "TRUE"
        }, {
            "attributeName": "SL_FURNITURE",
            "attributeValue": "FALSE"
        }, {
            "attributeName": "SERVICES",
            "attributeValue": "Online Order Pickup
Concierge on level 1
415-856-5402

Personal Shopping - At Your Service
415-856-5537

The Registry
415-856-5378

Credit Customer Service
866-593-3927

Visitor Services
415-856-5477

WiFi available at this location."
        }, {
            "attributeName": "STORE_LISTING_ENABLED",
            "attributeValue": "FALSE"
        }, {
            "attributeName": "SL_THISIT",
            "attributeValue": "FALSE"
        }, {
            "attributeName": "LONGITUDE",
            "attributeValue": "-122.4066717"
        }, {
            "attributeName": "SL_DESIGN",
            "attributeValue": "FALSE"
        }, {
            "attributeName": "GMT_OFFSET",
            "attributeValue": "-8"
        }, {
            "attributeName": "BOPS_ELIGIBILITY",
            "attributeValue": "FALSE"
        }]
    }]
}

Error Codes

Call Specific Error Codes:

NONE

General Error Handling Documentation:

Click Here