BOPS Bag

Description

The following document outlines a sample of how to make changes to BOPS (Buy Online - Pickup in Store) items in your shopping bag.  In the following example we are going to add, delete and edit a BOPS item in your shopping bag.

1. Add BOPS Item to Shopping Bag:

If no user or bag is specified when adding an item, a guest bag/user is created. If you want to merge your guest bag with a specific user account, use Merge Bag. This sample is adding a MCM Satchel Bag to a new bag.

Sample Request

POST

https://api.bloomingdales.com/order/v1/bags?storeLocNumber=2371

Header:

X-Macys-Webservice-Client-Id: xmj9js4jkdpe1983fmwu98gh
Accept: application/json
Content-type: application/json

Request Body

{

    "item": 
    {
       "quantity": 1, 

        "upcId": 2058750
     }
}

Response

{
    "bag": {
        "bagId": 138943020,
        "bagGUID": "43121a65-d99a-4808-a8ab-0989458ae8ec",
        "storeLocationNumber": 2371,
        "owner": {
            "userId": 2196969155,
            "userGuid": "4fa813d8-2fd0-4d6b-82b8-ed8ac9f33160",
            "bccUser": false,
            "userRegistryId": 0
        },
        "shippingSummary": {
            "discount": 24.95,
            "method": "G",
            "standardCharges": 0,
            "standardChargesBeforeDicsount": 24.95,
            "surcharges": 0,
            "total": 0
        },
        "bagSummary": {
            "estimatedTax": 53.4,
            "itemCount": 1,
            "grandTotal": 943.4,
            "merchandiseTotal": 890,
            "totalPersonalizationFee": 0,
            "totalSaved": 0,
            "yaqAmount": 0
        },
        "promotions": [
            {
                "desc": "Free Shipping on orders of $150 or more",
                "originalPrice": 24.95,
                "promotionId": 8712,
                "scope": "ORDER",
                "target": "SHIPPING",
                "type": "Free Shipping",
                "amountDiscounted": 24.95,
                "adjustedCost": 0,
                "operationDesc": "Free Shipping on orders of $150 or more",
                "expirationDate": "2037-12-31 23.59.59.000",
                "itemSequenceNumber": 0,
                "requiredBCCCard": false,
                "loyaltyAddSavings": false,
                "loyaltyIncreaseSavings": false,
                "propCardAddSavings": false,
                "propCardIncreaseSavings": false
            }
        ],
        "items": [
            {
                "autoAddChoice": "ADD",
                "discount": 0,
                "giftCardAmount": 0,
                "giftId": 0,
                "personalizationFlag": false,
                "gwpItemFlag": false,
                "isItemFromWishList": false,
                "pwpItemFlag": false,
                "specialItemFlag": false,
                "itemTotal": 890,
                "mergeRequiredFlag": false,
                "originalPrice": 890,
                "personalizationFee": 0,
                "pickupRegistryApplicable": true,
                "pickUpFromStore": false,
                "promotionId": 0,
                "wishListId": 0,
                "quantity": 1,
                "retailPrice": 890,
                "sequenceNumber": 1,
                "siteAvailablilityFlag": true,
                "storeAvailability": "AVAILABLE",
                "surcharges": 0,
                "productId": 1199626,
                "upcId": 2058750,
                "upcNumber": "7630015643089",
                "uycTotalDiscountedPrice": 0,
                "uycDiscountedPercentage": 0,
                "uycPercentDiscount": 0
            }
        ],
        "promotionOffers": [],
        "uycApplicable": false
    }
}

Note: The "StoreAvailability" field will read "AVAILABLE" if both of the following conditions have been met:

1. The store specified is participating in the BOPS program.

2. The item is available.

If these conditions are not met the "StoreAvailability" field will return "UNAVAILABLE".

back to top

2. Retrieve BOPS Item From Shopping Bag:

In the last example above we added aMCM Satchel Bag and chose to have it picked up at a store in CA that offers BOPS.  In the next example we have selected a different store location number to see if the item is available for BOPS pick up at a different store: Store Location number 6086 (Note:  If the store number is not specified when retreiving the bag, the BOPS service is removed from the item and the item will be ordered online.) Additionally any storelocation number can be entered to check product availablity. You can view the list of current BOPS stores by clicking here.

Sample Request

GET

https://api.bloomingdales.com/order/v1/bags?userId=2196969155&storeLocNumber=6086&show=product

Header:

X-Macys-Webservice-Client-Id: xmj9js4jkdpe1983fmwu98gh
Accept: application/json

Sample Response

{
    "bag": {
        "bagId": 138943020,
        "bagGUID": "43121a65-d99a-4808-a8ab-0989458ae8ec",
        "storeLocationNumber": 6086,
        "owner": {
            "userId": 2196969155,
            "bccUser": false,
            "userRegistryId": 0
        },
        "shippingSummary": {
            "discount": 24.95,
            "method": "G",
            "standardCharges": 0,
            "standardChargesBeforeDicsount": 24.95,
            "surcharges": 0,
            "total": 0
        },
        "bagSummary": {
            "estimatedTax": 53.4,
            "itemCount": 1,
            "grandTotal": 943.4,
            "merchandiseTotal": 890,
            "totalPersonalizationFee": 0,
            "totalSaved": 0,
            "yaqAmount": 0
        },
        "promotions": [
            {
                "desc": "Free Shipping on orders of $150 or more",
                "originalPrice": 24.95,
                "promotionId": 8712,
                "scope": "ORDER",
                "target": "SHIPPING",
                "type": "Free Shipping",
                "amountDiscounted": 24.95,
                "adjustedCost": 0,
                "operationDesc": "Free Shipping on orders of $150 or more",
                "expirationDate": "2037-12-31 23.59.59.000",
                "itemSequenceNumber": 0,
                "requiredBCCCard": false,
                "loyaltyAddSavings": false,
                "loyaltyIncreaseSavings": false,
                "propCardAddSavings": false,
                "propCardIncreaseSavings": false
            }
        ],
        "items": [
            {
                "autoAddChoice": "ADD",
                "discount": 0,
                "giftCardAmount": 0,
                "giftId": 0,
                "personalizationFlag": false,
                "gwpItemFlag": false,
                "isItemFromWishList": false,
                "pwpItemFlag": false,
                "specialItemFlag": false,
                "itemTotal": 890,
                "mergeRequiredFlag": false,
                "originalPrice": 890,
                "personalizationFee": 0,
                "pickupRegistryApplicable": true,
                "pickUpFromStore": false,
                "promotionId": 0,
                "wishListId": 0,
                "quantity": 1,
                "retailPrice": 890,
                "sequenceNumber": 1,
                "siteAvailablilityFlag": true,
                "storeAvailability": "UNAVAILABLE",
                "surcharges": 0,
                "productId": 1199626,
                "upcId": 2058750,
                "upcNumber": "7630015643089",
                "uycTotalDiscountedPrice": 0,
                "uycDiscountedPercentage": 0,
                "uycPercentDiscount": 0
            }
        ],
        "promotionOffers": [],
        "uycApplicable": false
    }
}

Note: The "StoreAvailability" field will read "AVAILABLE" if both of the following conditions have been met.

1. The store specified is participating in the BOPS program

2. the item is available.

If these conditions are not met the "StoreAvailability" field will return "UNAVAILABLE".

back to top

3. Update BOPS Item From Shopping bag:

In this example we want to add another brewer, because two MCM Satchel Bags are better than one. When changing quantity, if the "storeAvailability" field changes to "UNAVAILABLE" the store does not currently have the quantity requested in stock.

Sample Request

PATCH

http://api.bloomingdales.com/order/v1/bags/43121a65-d99a-4808-a8ab-0989458ae8ec/items

Header:

X-Macys-Webservice-Client-Id: xmj9js4jkdpe1983fmwu98gh
Accept: application/json
Content-type: application/json

Request Body

{  
 "item": {    
 "quantity": "2",    
 "upcId": "2058750",    
 "itemTrackInfo": "XxxxxxxxXXXXXxxxxxXXXX"  
  }
 }

NOTE: "BOPS Pickup Instructions" intended for the purchaser are available in the "BOPS_PICKUP_INSTRUCTIONS" field.

Sample Response

{
    "bag": {
        "bagId": 138943020,
        "bagGUID": "43121a65-d99a-4808-a8ab-0989458ae8ec",
        "storeLocationNumber": 0,
        "owner": {
            "userId": 2196969155,
            "bccUser": false,
            "userRegistryId": 0
        },
        "shippingSummary": {
            "discount": 24.95,
            "method": "G",
            "standardCharges": 0,
            "standardChargesBeforeDicsount": 24.95,
            "surcharges": 0,
            "total": 0
        },
        "bagSummary": {
            "estimatedTax": 53.4,
            "itemCount": 1,
            "grandTotal": 943.4,
            "merchandiseTotal": 890,
            "totalPersonalizationFee": 0,
            "totalSaved": 0,
            "yaqAmount": 0
        },
        "promotions": [
            {
                "desc": "Free Shipping on orders of $150 or more",
                "originalPrice": 24.95,
                "promotionId": 8712,
                "scope": "ORDER",
                "target": "SHIPPING",
                "type": "Free Shipping",
                "amountDiscounted": 24.95,
                "adjustedCost": 0,
                "operationDesc": "Free Shipping on orders of $150 or more",
                "expirationDate": "2037-12-31 23.59.59.000",
                "itemSequenceNumber": 0,
                "requiredBCCCard": false,
                "loyaltyAddSavings": false,
                "loyaltyIncreaseSavings": false,
                "propCardAddSavings": false,
                "propCardIncreaseSavings": false
            }
        ],
        "items": [
            {
                "autoAddChoice": "ADD",
                "discount": 0,
                "giftCardAmount": 0,
                "giftId": 0,
                "personalizationFlag": false,
                "gwpItemFlag": false,
                "isItemFromWishList": false,
                "pwpItemFlag": false,
                "specialItemFlag": false,
                "itemTotal": 890,
                "mergeRequiredFlag": false,
                "originalPrice": 890,
                "personalizationFee": 0,
                "pickupRegistryApplicable": true,
                "pickUpFromStore": false,
                "promotionId": 0,
                "wishListId": 0,
                "quantity": 1,
                "retailPrice": 890,
                "sequenceNumber": 1,
                "siteAvailablilityFlag": true,
                "surcharges": 0,
                "productId": 1199626,
                "upcId": 2058750,
                "upcNumber": "7630015643089",
                "uycTotalDiscountedPrice": 0,
                "uycDiscountedPercentage": 0,
                "uycPercentDiscount": 0
            }
        ],
        "promotionOffers": [],
        "uycApplicable": false
    }
}

 

4. Delete from BOPS Item from Shopping Bag:

Delete is used to completely remove the item from the shopping bag. If you want to change quanity to a lesser amount use Update BOPS Item and specify the desired quantity in your call.

Sample Request

Request URL:

DELETE

https://api.bloomingdales.com/order/v1/bags/43121a65-d99a-4808-a8ab-0989458ae8ec/items/1

Header:

X-Macys-Webservice-Client-Id: xmj9js4jkdpe1983fmwu98gh
Accept: application/json

Request Body

{
    "deleteitemsrequest": {
        "upcid": 2058750
    }
}

Sample Response

{
    "bag": {
        "bagId": 138943020,
        "storeLocationNumber": 0,
        "owner": {
            "userId": 2196969155,
            "bccUser": false,
            "userRegistryId": 0
        },
        "shippingSummary": {
            "discount": 0,
            "standardCharges": 0,
            "standardChargesBeforeDicsount": 0,
            "surcharges": 0,
            "total": 0
        },
        "bagSummary": {
            "estimatedTax": 0,
            "itemCount": 0,
            "grandTotal": 0,
            "merchandiseTotal": 0,
            "totalPersonalizationFee": 0,
            "totalSaved": 0,
            "yaqAmount": 0
        },
        "items": [],
        "uycApplicable": false
    }
}

 

 

back to top

Docs Navigation