Managing guest carts
Edit on GitHubThis endpoint lets you manage guest carts.
Installation
For detailed information about the modules that provide the API functionality and related installation instructions, see:
- Install the Cart Glue API
- Install the Promotions & Discounts feature Glue API
- Install the Product Options Glue API
- Install the Product Labels Glue API
- Install the Marketplace Poruduct Offer Glue API
- Install the Marketplace Product Offer Prices Glue API
- Install the Marketplace Product Offer Volume Prices Glue API
Create a guest cart
To create a guest cart as an unauthenticated user, add items to a guest cart.
Retrieve a guest cart
To retrieve a guest cart, send the request:
GET
/guest-carts
Guest users have one guest cart by default. If you already have a guest cart, you can optionally specify its ID when adding items. To do that, use the following endpoint. The information in this section is valid for both of the endpoints.
GET
/guest-carts/{{guestCartId}}
PATH PARAMETER | DESCRIPTION |
---|---|
{{guestCartId}} | Unique identifier of the guest cart. To get it, retrieve a guest cart. |
When retrieving the cart with guestCartId
, the response includes a single object, and when retrieving the resource without specifying it, you get an array containing a single object.
Request
HEADER KEY | HEADER VALUE EXAMPLE | REQUIRED | DESCRIPTION |
---|---|---|---|
X-Anonymous-Customer-Unique-Id | 164b-5708-8530 | ✓ | Guest user’s unique identifier. For security purposes, we recommend passing a hyphenated alphanumeric value, but you can pass any. If you are sending automated requests, you can configure your API client to generate this value. |
PATH PARAMETER | DESCRIPTION | POSSIBLE ERRORS |
---|---|---|
include | Adds resource relationships to the request. |
|
- To retrieve product options, include
guest-cart-items
,concrete-products
, andproduct-options
. - To retrieve product measurement units, include
sales-units
andproduct-measurement-units
. - To retrieve product labels assigned to the products in a cart, include
concrete-products
andproduct-labels
. - To retrieve product offers, include
items
andconcrete-products
. - To retrieve product offer availabilities, include
items
,concrete-products
, andproduct-offer-availabilities
. - To retrieve product offer prices, include
items
,concrete-products
, andproduct-offer-prices
.
REQUEST | USAGE |
---|---|
GET https://glue.mysprykershop.com/guest-carts |
Retrieve a guest cart. |
GET https://glue.mysprykershop.com/guest-carts?include=guest-cart-items |
Retrieve information about a guest cart with its items included. |
GET https://glue.mysprykershop.com/guest-carts?include=cart-rules |
Retrieve a guest cart with information about the cart rules. |
GET https://glue.mysprykershop.com/guest-carts?include=gift-cards,vouchers |
Retrieve a guest cart with information about the gift cards applied. |
GET https://glue.mysprykershop.com/guest-carts?include=guest-cart-items,concrete-products,product-options |
Retrieve a guest cart with information about its items, respective concrete products, and product options included. |
GET https://glue.mysprykershop.com/guest-carts?include=sales-units,product-measurement-units |
Retrieve a guest cart with information about its items, sales units, and product measurement units. |
GET https://glue.mysprykershop.com/guest-carts?include=vouchers |
Retrieve a guest cart with information about vouchers. |
GET https://glue.mysprykershop.com/guest-carts?include=concrete-products,product-labels |
Retrieve a guest cart with information about concrete products and the product labels assigned. |
GET https://glue.mysprykershop.com/guest-carts?include=promotional-items,abstract-products,concrete-product |
Retrieve detailed information on the promotional items for the guest cart. |
GET https://glue.mysprykershop.com/guest-carts?include=items,concrete-products,product-offers |
Retrieve a guest cart with information about product offers included. |
GET https://glue.mysprykershop.com/guest-carts?include=items,concrete-products,product-offers,product-offer-availabilities |
Retrieve a guest cart with product offer availabilities information included. |
GET https://glue.mysprykershop.com/guest-carts?include=items,concrete-products,product-offers,product-offer-prices |
Retrieve a guest cart with product offer prices information included. |
GET https://glue.mysprykershop.com/guest-carts/f0d01709-4dea-5ac3-8ceb-873875446ab0?include=guest-cart-items,merchants |
Retrieve a guest cart with items and information about merchants included. |
Response
Response sample: retrieve a guest cart
{
"data": [
{
"type": "guest-carts",
"id": "f8782b6c-848d-595e-b3f7-57374f1ff6d7",
"attributes": {
"priceMode": "GROSS_MODE",
"currency": "EUR",
"store": "DE",
"name": "Shopping cart",
"isDefault": true,
"totals": {
"expenseTotal": 0,
"discountTotal": 10689,
"taxTotal": 15360,
"subtotal": 106892,
"grandTotal": 96203,
"priceToPay": 93203
},
"discounts": [
{
"displayName": "10% Discount for all orders above",
"amount": 10689,
"code": null
}
]
},
"links": {
"self": "https://glue.mysprykershop.com/guest-carts/f8782b6c-848d-595e-b3f7-57374f1ff6d7"
}
}
],
"links": {
"self": "https://glue.mysprykershop.com/cart-codes"
}
}
Response sample: retrieve information about a guest cart with its items included
{
"data": [
{
"type": "guest-carts",
"id": "f8782b6c-848d-595e-b3f7-57374f1ff6d7",
"attributes": {
"priceMode": "GROSS_MODE",
"currency": "EUR",
"store": "DE",
"name": "Shopping cart",
"isDefault": true,
"totals": {
"expenseTotal": 0,
"discountTotal": 10689,
"taxTotal": 15360,
"subtotal": 106892,
"grandTotal": 96203,
"priceToPay": 96203
},
"discounts": [
{
"displayName": "10% Discount for all orders above",
"amount": 10689,
"code": null
}
]
},
"links": {
"self": "https://glue.mysprykershop.com/guest-carts/f8782b6c-848d-595e-b3f7-57374f1ff6d7"
},
"relationships": {
"guest-cart-items": {
"data": [
{
"type": "guest-cart-items",
"id": "023_21758366"
}
]
}
}
}
],
"links": {
"self": "https://glue.mysprykershop.com/cart-codes?include=guest-cart-items"
},
"included": [
{
"type": "guest-cart-items",
"id": "023_21758366",
"attributes": {
"sku": "023_21758366",
"quantity": "4",
"groupKey": "023_21758366",
"abstractSku": "023",
"amount": null,
"productOfferReference": null,
"merchantReference": null,
"calculations": {
"unitPrice": 26723,
"sumPrice": 106892,
"taxRate": 19,
"unitNetPrice": 0,
"sumNetPrice": 0,
"unitGrossPrice": 26723,
"sumGrossPrice": 106892,
"unitTaxAmountFullAggregation": 3840,
"sumTaxAmountFullAggregation": 15360,
"sumSubtotalAggregation": 106892,
"unitSubtotalAggregation": 26723,
"unitProductOptionPriceAggregation": 0,
"sumProductOptionPriceAggregation": 0,
"unitDiscountAmountAggregation": 2672,
"sumDiscountAmountAggregation": 10689,
"unitDiscountAmountFullAggregation": 2672,
"sumDiscountAmountFullAggregation": 10689,
"unitPriceToPayAggregation": 24051,
"sumPriceToPayAggregation": 96203
},
"salesUnit": null,
"selectedProductOptions": []
},
"links": {
"self": "https://glue.mysprykershop.com/guest-carts/f8782b6c-848d-595e-b3f7-57374f1ff6d7/guest-cart-items/023_21758366"
}
}
]
}
Response sample: retrieve a guest cart with information about the cart rules
{
"data": [
{
"type": "guest-carts",
"id": "f8782b6c-848d-595e-b3f7-57374f1ff6d7",
"attributes": {
"priceMode": "GROSS_MODE",
"currency": "EUR",
"store": "DE",
"name": "Shopping cart",
"isDefault": true,
"totals": {
"expenseTotal": 0,
"discountTotal": 10689,
"taxTotal": 15360,
"subtotal": 106892,
"grandTotal": 96203,
"priceToPay": 96203
},
"discounts": [
{
"displayName": "10% Discount for all orders above",
"amount": 10689,
"code": null
}
]
},
"links": {
"self": "https://glue.mysprykershop.com/guest-carts/f8782b6c-848d-595e-b3f7-57374f1ff6d7"
},
"relationships": {
"cart-rules": {
"data": [
{
"type": "cart-rules",
"id": "1"
}
]
}
}
}
],
"links": {
"self": "https://glue.mysprykershop.com/cart-codes?include=cart-rules"
},
"included": [
{
"type": "cart-rules",
"id": "1",
"attributes": {
"amount": 10689,
"code": null,
"discountType": "cart_rule",
"displayName": "10% Discount for all orders above",
"isExclusive": false,
"expirationDateTime": "2020-12-31 00:00:00.000000",
"discountPromotionAbstractSku": null,
"discountPromotionQuantity": null
},
"links": {
"self": "https://glue.mysprykershop.com/cart-rules/1"
}
}
]
}
Response sample: retrieve a guest cart with information about the gift cards applied
{
"data": [
{
"type": "guest-carts",
"id": "f8782b6c-848d-595e-b3f7-57374f1ff6d7",
"attributes": {
"priceMode": "GROSS_MODE",
"currency": "EUR",
"store": "DE",
"name": "Shopping cart",
"isDefault": true,
"totals": {
"expenseTotal": 0,
"discountTotal": 10689,
"taxTotal": 15360,
"subtotal": 106892,
"grandTotal": 96203,
"priceToPay": 93203
},
"discounts": [
{
"displayName": "10% Discount for all orders above",
"amount": 10689,
"code": null
}
]
},
"links": {
"self": "https://glue.mysprykershop.com/guest-carts/f8782b6c-848d-595e-b3f7-57374f1ff6d7"
},
"relationships": {
"gift-cards": {
"data": [
{
"type": "gift-cards",
"id": "GC-Z9FYJRK3-20"
}
]
}
}
}
],
"links": {
"self": "https://glue.mysprykershop.com/cart-codes?include=gift-cards"
},
"included": [
{
"type": "gift-cards",
"id": "GC-Z9FYJRK3-20",
"attributes": {
"code": "GC-Z9FYJRK3-20",
"name": "Gift Card 30",
"value": 3000,
"currencyIsoCode": "EUR",
"actualValue": 3000,
"isActive": true
},
"links": {
"self": "https://glue.mysprykershop.com/guest-carts/f8782b6c-848d-595e-b3f7-57374f1ff6d7/cart-codes/GC-Z9FYJRK3-20"
}
}
]
}
Response sample: retrieve a guest cart with information about its items, respective concrete products, and product options included
{
"data": [
{
"type": "guest-carts",
"id": "7e42298e-9f15-5105-a192-96726a2b9da8",
"attributes": {
"priceMode": "GROSS_MODE",
"currency": "EUR",
"store": "DE",
"name": "Shopping cart",
"isDefault": true,
"totals": {
"expenseTotal": 0,
"discountTotal": 13301,
"taxTotal": 20711,
"subtotal": 143012,
"grandTotal": 129711,
"priceToPay": 129711
},
"discounts": [
{
"displayName": "10% Discount for all orders above",
"amount": 13301,
"code": null
}
]
},
"links": {
"self": "https://glue.mysprykershop.com.com/guest-carts/7e42298e-9f15-5105-a192-96726a2b9da8"
},
"relationships": {
"guest-cart-items": {
"data": [
{
"type": "guest-cart-items",
"id": "181_31995510-3-5"
}
]
}
}
}
],
"links": {
"self": "https://glue.mysprykershop.com.com/guest-cart-items?include=guest-cart-items,concrete-products,product-options"
},
"included": [
{
"type": "product-options",
"id": "OP_1_year_waranty",
"attributes": {
"optionGroupName": "Warranty",
"sku": "OP_1_year_waranty",
"optionName": "One (1) year limited warranty",
"price": 0,
"currencyIsoCode": "EUR"
},
"links": {
"self": "https://glue.mysprykershop.com.com/concrete-products/181_31995510/product-options/OP_1_year_waranty"
}
},
{
"type": "product-options",
"id": "OP_2_year_waranty",
"attributes": {
"optionGroupName": "Warranty",
"sku": "OP_2_year_waranty",
"optionName": "Two (2) year limited warranty",
"price": 1000,
"currencyIsoCode": "EUR"
},
"links": {
"self": "https://glue.mysprykershop.com.com/concrete-products/181_31995510/product-options/OP_2_year_waranty"
}
},
{
"type": "product-options",
"id": "OP_3_year_waranty",
"attributes": {
"optionGroupName": "Warranty",
"sku": "OP_3_year_waranty",
"optionName": "Three (3) year limited warranty",
"price": 2000,
"currencyIsoCode": "EUR"
},
"links": {
"self": "https://glue.mysprykershop.com.com/concrete-products/181_31995510/product-options/OP_3_year_waranty"
}
},
{
"type": "product-options",
"id": "OP_insurance",
"attributes": {
"optionGroupName": "Insurance",
"sku": "OP_insurance",
"optionName": "Two (2) year insurance coverage",
"price": 10000,
"currencyIsoCode": "EUR"
},
"links": {
"self": "https://glue.mysprykershop.com.com/concrete-products/181_31995510/product-options/OP_insurance"
}
},
{
"type": "product-options",
"id": "OP_gift_wrapping",
"attributes": {
"optionGroupName": "Gift wrapping",
"sku": "OP_gift_wrapping",
"optionName": "Gift wrapping",
"price": 500,
"currencyIsoCode": "EUR"
},
"links": {
"self": "https://glue.mysprykershop.com.com/concrete-products/181_31995510/product-options/OP_gift_wrapping"
}
},
{
"type": "concrete-products",
"id": "181_31995510",
"attributes": {
"sku": "181_31995510",
"isDiscontinued": false,
"discontinuedNote": null,
"averageRating": null,
"reviewCount": 0,
"productAbstractSku": "181",
"name": "Samsung Galaxy Tab S2 SM-T813",
"description": "Enjoy greater flexibility ...than ever before with the Galaxy Tab S2. Remarkably slim and ultra-lightweight, use this device to take your e-books, photos, videos and work-related files with you wherever you need to go. The Galaxy Tab S2’s 4:3 ratio display is optimised for magazine reading and web use. Switch to Reading Mode to adjust screen brightness and change wallpaper—create an ideal eBook reading environment designed to reduce the strain on your eyes. Get greater security with convenient and accurate fingerprint functionality. Activate fingerprint lock by pressing the home button. Use fingerprint verification to restrict / allow access to your web browser, screen lock mode and your Samsung account.",
"attributes": {
"internal_memory": "3 GB",
"processor_model": "APQ8076",
"digital_zoom": "4 x",
"storage_media": "flash",
"brand": "Samsung",
"color": "Pink"
},
"superAttributesDefinition": [
"internal_memory",
"storage_media",
"color"
],
"metaTitle": "Samsung Galaxy Tab S2 SM-T813",
"metaKeywords": "Samsung,Communication Electronics",
"metaDescription": "Enjoy greater flexibility ...than ever before with the Galaxy Tab S2. Remarkably slim and ultra-lightweight, use this device to take your e-books, photos,",
"attributeNames": {
"internal_memory": "Max internal memory",
"processor_model": "Processor model",
"digital_zoom": "Digital zoom",
"storage_media": "Storage media",
"brand": "Brand",
"color": "Color"
}
},
"links": {
"self": "https://glue.mysprykershop.com.com/concrete-products/181_31995510"
},
"relationships": {
"product-options": {
"data": [
{
"type": "product-options",
"id": "OP_1_year_waranty"
},
{
"type": "product-options",
"id": "OP_2_year_waranty"
},
{
"type": "product-options",
"id": "OP_3_year_waranty"
},
{
"type": "product-options",
"id": "OP_insurance"
},
{
"type": "product-options",
"id": "OP_gift_wrapping"
}
]
}
}
},
{
"type": "guest-cart-items",
"id": "181_31995510-3-5",
"attributes": {
"sku": "181_31995510",
"quantity": "4",
"groupKey": "181_31995510-3-5",
"abstractSku": "181",
"amount": null,
"productOfferReference": null,
"merchantReference": null,
"calculations": {
"unitPrice": 33253,
"sumPrice": 133012,
"taxRate": 19,
"unitNetPrice": 0,
"sumNetPrice": 0,
"unitGrossPrice": 33253,
"sumGrossPrice": 133012,
"unitTaxAmountFullAggregation": 5177,
"sumTaxAmountFullAggregation": 20711,
"sumSubtotalAggregation": 143012,
"unitSubtotalAggregation": 35753,
"unitProductOptionPriceAggregation": 2500,
"sumProductOptionPriceAggregation": 10000,
"unitDiscountAmountAggregation": 3325,
"sumDiscountAmountAggregation": 13301,
"unitDiscountAmountFullAggregation": 3325,
"sumDiscountAmountFullAggregation": 13301,
"unitPriceToPayAggregation": 32428,
"sumPriceToPayAggregation": 129711
},
"configuredBundle": null,
"configuredBundleItem": null,
"salesUnit": null,
"selectedProductOptions": [
{
"optionGroupName": "Gift wrapping",
"sku": "OP_gift_wrapping",
"optionName": "Gift wrapping",
"price": 2000
},
{
"optionGroupName": "Warranty",
"sku": "OP_3_year_waranty",
"optionName": "Three (3) year limited warranty",
"price": 8000
}
]
},
"links": {
"self": "https://glue.mysprykershop.com.com/guest-carts/7e42298e-9f15-5105-a192-96726a2b9da8/guest-cart-items/181_31995510-3-5"
},
"relationships": {
"concrete-products": {
"data": [
{
"type": "concrete-products",
"id": "181_31995510"
}
]
}
}
}
]
}
Response sample: retrieve a guest cart with information about its items, sales units, and product measurement units
{
"data": [
{
"type": "guest-carts",
"id": "5cc8c1ad-a12a-5a93-9c6e-fd4bc546c81c",
"attributes": {
"priceMode": "GROSS_MODE",
"currency": "EUR",
"store": "DE",
"name": "Shopping cart",
"isDefault": true,
"totals": {
"expenseTotal": 0,
"discountTotal": 0,
"taxTotal": 718,
"subtotal": 4500,
"grandTotal": 4500,
"priceToPay": 4500
},
"discounts": []
},
"links": {
"self": "https://glue.mysprykershop.com/guest-carts/5cc8c1ad-a12a-5a93-9c6e-fd4bc546c81c"
}
}
],
"links": {
"self": "https://glue.mysprykershop.com/guest-cart-items?include=sales-units,product-measurement-units"
},
"included": [
{
"type": "product-measurement-units",
"id": "METR",
"attributes": {
"name": "Meter",
"defaultPrecision": 100
},
"links": {
"self": "https://glue.mysprykershop.com/product-measurement-units/METR"
}
},
{
"type": "sales-units",
"id": "33",
"attributes": {
"conversion": 1,
"precision": 100,
"isDisplayed": true,
"isDefault": true,
"productMeasurementUnitCode": "METR"
},
"links": {
"self": "https://glue.mysprykershop.com/concrete-products/cable-vga-1-2/sales-units/33"
},
"relationships": {
"product-measurement-units": {
"data": [
{
"type": "product-measurement-units",
"id": "METR"
}
]
}
}
},
{
"type": "guest-cart-items",
"id": "cable-vga-1-2_quantity_sales_unit_id_33_amount_1.5_sales_unit_id_33",
"attributes": {
"sku": "cable-vga-1-2",
"quantity": 3,
"groupKey": "cable-vga-1-2_quantity_sales_unit_id_33_amount_1.5_sales_unit_id_33",
"abstractSku": "cable-vga-1",
"amount": "4.5",
"productOfferReference": null,
"merchantReference": null,
"calculations": {
"unitPrice": 1500,
"sumPrice": 4500,
"taxRate": 19,
"unitNetPrice": 0,
"sumNetPrice": 0,
"unitGrossPrice": 1500,
"sumGrossPrice": 4500,
"unitTaxAmountFullAggregation": 239,
"sumTaxAmountFullAggregation": 718,
"sumSubtotalAggregation": 4500,
"unitSubtotalAggregation": 1500,
"unitProductOptionPriceAggregation": 0,
"sumProductOptionPriceAggregation": 0,
"unitDiscountAmountAggregation": 0,
"sumDiscountAmountAggregation": 0,
"unitDiscountAmountFullAggregation": 0,
"sumDiscountAmountFullAggregation": 0,
"unitPriceToPayAggregation": 1500,
"sumPriceToPayAggregation": 4500
},
"configuredBundle": null,
"configuredBundleItem": null,
"salesUnit": {
"id": 33,
"amount": "4.5"
},
"selectedProductOptions": []
},
"links": {
"self": "https://glue.mysprykershop.com/guest-carts/5cc8c1ad-a12a-5a93-9c6e-fd4bc546c81c/guest-cart-items/cable-vga-1-2_quantity_sales_unit_id_33_amount_1.5_sales_unit_id_33"
},
"relationships": {
"sales-units": {
"data": [
{
"type": "sales-units",
"id": "33"
}
]
}
}
}
]
}
Response sample: retrieve a guest cart with information about vouchers
{
"data": {
"type": "guest-carts",
"id": "1ce91011-8d60-59ef-9fe0-4493ef3628b2",
"attributes": {...},
"links": {...},
"relationships": {
"vouchers": {
"data": [
{
"type": "vouchers",
"id": "mydiscount-yu8je"
}
]
},
"cart-rules": {
"data": [
{
"type": "cart-rules",
"id": "1"
}
]
}
}
},
"included": [
{
"type": "vouchers",
"id": "mydiscount-yu8je",
"attributes": {
"amount": 49898,
"code": "mydiscount-yu8je",
"discountType": "voucher",
"displayName": "My Discount",
"isExclusive": false,
"expirationDateTime": "2020-02-29 00:00:00.000000",
"discountPromotionAbstractSku": null,
"discountPromotionQuantity": null
},
"links": {
"self": "https://glue.mysprykershop.com/vouchers/mydiscount-yu8je"
}
},
{
"type": "cart-rules",
"id": "1",
"attributes": {
"amount": 19959,
"code": null,
"discountType": "cart_rule",
"displayName": "10% Discount for all orders above",
"isExclusive": false,
"expirationDateTime": "2020-12-31 00:00:00.000000",
"discountPromotionAbstractSku": null,
"discountPromotionQuantity": null
},
"links": {
"self": "https://glue.mysprykershop.com/cart-rules/1"
}
}
]
}
Response sample: retrieve a guest cart with information about concrete products and the product labels assigned
{
"data": [
{
"type": "guest-carts",
"id": "4f3e67f7-f18c-55ad-8297-2e09b80cf3ff",
"attributes": {
"priceMode": "GROSS_MODE",
"currency": "EUR",
"store": "DE",
"totals": {
"expenseTotal": 0,
"discountTotal": 0,
"taxTotal": 6244,
"subtotal": 39107,
"grandTotal": 39107,
"priceToPay": 39107
},
"discounts": []
},
"links": {
"self": "https://glue.mysprykershop.com/guest-carts/4f3e67f7-f18c-55ad-8297-2e09b80cf3ff"
}
}
],
"links": {
"self": "https://glue.mysprykershop.com/guest-cart-items?include=concrete-products,product-labels"
},
"included": [
{
"type": "product-labels",
"id": "5",
"attributes": {
"name": "SALE %",
"isExclusive": false,
"position": 3,
"frontEndReference": "highlight"
},
"links": {
"self": "https://glue.mysprykershop.com/product-labels/5"
}
},
{
"type": "concrete-products",
"id": "179_29658416",
"attributes": {
"sku": "179_29658416",
"isDiscontinued": false,
"discontinuedNote": null,
"averageRating": null,
"reviewCount": 0,
"name": "Samsung Galaxy Tab S2 SM-T715",
"description": "Enjoy greater flexibility ...than ever before with the Galaxy Tab S2. Remarkably slim and ultra-lightweight, use this device to take your e-books, photos, videos and work-related files with you wherever you need to go. The Galaxy Tab S2’s 4:3 ratio display is optimised for magazine reading and web use. Switch to Reading Mode to adjust screen brightness and change wallpaper—create an ideal eBook reading environment designed to reduce the strain on your eyes. Get greater security with convenient and accurate fingerprint functionality. Activate fingerprint lock by pressing the home button. Use fingerprint verification to restrict / allow access to your web browser, screen lock mode and your Samsung account.",
"attributes": {
"storage_media": "flash",
"touch_technology": "Multi-touch",
"max_memory_card_size": "128 GB",
"internal_storage_capacity": "32 GB",
"brand": "Samsung",
"color": "Black"
},
"superAttributesDefinition": [
"storage_media",
"internal_storage_capacity",
"color"
],
"metaTitle": "Samsung Galaxy Tab S2 SM-T715",
"metaKeywords": "Samsung,Communication Electronics",
"metaDescription": "Enjoy greater flexibility ...than ever before with the Galaxy Tab S2. Remarkably slim and ultra-lightweight, use this device to take your e-books, photos,",
"attributeNames": {
"storage_media": "Storage media",
"touch_technology": "Touch Technology",
"max_memory_card_size": "Max memory card size",
"internal_storage_capacity": "Internal storage capacity",
"brand": "Brand",
"color": "Color"
}
},
"links": {
"self": "https://glue.mysprykershop.com/concrete-products/179_29658416"
},
"relationships": {
"product-labels": {
"data": [
{
"type": "product-labels",
"id": "5"
}
]
}
}
},
{
"type": "guest-cart-items",
"id": "179_29658416",
"attributes": {
"sku": "179_29658416",
"quantity": 1,
"groupKey": "179_29658416",
"abstractSku": "179",
"amount": null,
"calculations": {
"unitPrice": 39107,
"sumPrice": 39107,
"taxRate": 19,
"unitNetPrice": 0,
"sumNetPrice": 0,
"unitGrossPrice": 39107,
"sumGrossPrice": 39107,
"unitTaxAmountFullAggregation": 6244,
"sumTaxAmountFullAggregation": 6244,
"sumSubtotalAggregation": 39107,
"unitSubtotalAggregation": 39107,
"unitProductOptionPriceAggregation": 0,
"sumProductOptionPriceAggregation": 0,
"unitDiscountAmountAggregation": 0,
"sumDiscountAmountAggregation": 0,
"unitDiscountAmountFullAggregation": 0,
"sumDiscountAmountFullAggregation": 0,
"unitPriceToPayAggregation": 39107,
"sumPriceToPayAggregation": 39107
},
"selectedProductOptions": []
},
"links": {
"self": "https://glue.mysprykershop.com/guest-carts/4f3e67f7-f18c-55ad-8297-2e09b80cf3ff/guest-cart-items/179_29658416"
},
"relationships": {
"concrete-products": {
"data": [
{
"type": "concrete-products",
"id": "179_29658416"
}
]
}
}
}
]
}
Response sample: retrieve detailed information on the promotional items for the guest cart
{
"data": [
{
"type": "guest-carts",
"id": "1ce91011-8d60-59ef-9fe0-4493ef3628b2",
"attributes": {...},
"links": {...},
"relationships": {
"promotional-items": {
"data": [
{
"type": "promotional-items",
"id": "bfc600e1-5bf1-50eb-a9f5-a37deb796f8a"
}
]
}
}
},
{
"type": "guest-carts",
"id": "1f1662c4-01e1-50d1-877d-95534d1b1833",
"attributes": {...},
"links": {...}
}
],
"links": {...},
"included": [
{
"type": "concrete-products",
"id": "112_312526171",
"attributes": {...}
},
"links": {...}
},
{
"type": "concrete-products",
"id": "112_306918001",
"attributes": {...},
"links": {...},
{
"type": "concrete-products",
"id": "112_312526191",
"attributes": {...},
"links": {...},
{
"type": "concrete-products",
"id": "112_312526172",
"attributes": {....},
"links": {...},
{
"type": "concrete-products",
"id": "112_306918002",
"attributes": {...},
"links": {...},
{
"type": "concrete-products",
"id": "112_312526192",
"attributes": {...},
"links": {...},
{
"type": "concrete-products",
"id": "112_306918003",
"attributes": {...},
"links": {...},
{
"type": "concrete-products",
"id": "112_312526193",
"attributes": {...},
"links": {...},
{
"type": "abstract-products",
"id": "112",
"attributes": {...},
"links": {...},
"relationships": {
"concrete-products": {
"data": [
{
"type": "concrete-products",
"id": "112_312526171"
},
{
"type": "concrete-products",
"id": "112_306918001"
},
{
"type": "concrete-products",
"id": "112_312526191"
},
{
"type": "concrete-products",
"id": "112_312526172"
},
{
"type": "concrete-products",
"id": "112_306918002"
},
{
"type": "concrete-products",
"id": "112_312526192"
},
{
"type": "concrete-products",
"id": "112_306918003"
},
{
"type": "concrete-products",
"id": "112_312526193"
}
]
}
}
},
{
"type": "promotional-items",
"id": "bfc600e1-5bf1-50eb-a9f5-a37deb796f8a",
"attributes": {
"sku": "112",
"quantity": 2
},
"links": {
"self": "https://glue.mysprykershop.com/promotional-items/bfc600e1-5bf1-50eb-a9f5-a37deb796f8a"
},
"relationships": {
"abstract-products": {
"data": [
{
"type": "abstract-products",
"id": "112"
}
]
}
}
}
]
}
Response sample: retrieve a guest cart with information about product offers included
{
"data": {
"type": "guest-carts",
"id": "6851dc6a-ebed-52ed-b229-81a35fe94c49",
"attributes": {
"priceMode": "GROSS_MODE",
"currency": "EUR",
"store": "DE",
"name": "Shopping cart",
"isDefault": true,
"totals": {
"expenseTotal": 0,
"discountTotal": 0,
"taxTotal": 35273,
"subtotal": 220920,
"grandTotal": 220920,
"priceToPay": 220920
},
"discounts": []
},
"links": {
"self": "https://glue.mysprykershop.com/guest-carts/6851dc6a-ebed-52ed-b229-81a35fe94c49"
}
},
"included": [
{
"type": "product-offers",
"id": "offer89",
"attributes": {
"merchantSku": null,
"merchantReference": "MER000005",
"isDefault": true
},
"links": {
"self": "https://glue.mysprykershop.com/product-offers/offer89"
}
},
{
"type": "product-offers",
"id": "offer48",
"attributes": {
"merchantSku": null,
"merchantReference": "MER000002",
"isDefault": false
},
"links": {
"self": "https://glue.mysprykershop.com/product-offers/offer48"
}
},
{
"type": "concrete-products",
"id": "041_25904691",
"attributes": {
"sku": "041_25904691",
"isDiscontinued": false,
"discontinuedNote": null,
"averageRating": null,
"reviewCount": 0,
"productAbstractSku": "041",
"name": "Canon PowerShot SX610",
"description": "Optical Quality Capture quality images from a distance with a 20.2 MP, 25mm wide, 18x optical zoom lens. Hybrid Auto mode records 4 seconds of video before each shot then compiles them all into a single video. With built in NFC and Wi-Fi its so easy to share your happy snaps to your favourite social media platforms. Expand your creative photography skills through applying a range of artistic presets such as toy camera or fish eye effect. Capture images remotely and view live images from the camera via your phone and the Camera Connect app. Bring your memories to life as you experience videos on Full HD quality in 30p/MP4 recording.",
"attributes": {
"hd_type": "Full HD",
"megapixel": "20.2 MP",
"optical_zoom": "18 x",
"display": "LCD",
"brand": "Canon",
"color": "White"
},
"superAttributesDefinition": [
"color"
],
"metaTitle": "Canon PowerShot SX610",
"metaKeywords": "Canon,Entertainment Electronics",
"metaDescription": "Optical Quality Capture quality images from a distance with a 20.2 MP, 25mm wide, 18x optical zoom lens. Hybrid Auto mode records 4 seconds of video before",
"attributeNames": {
"hd_type": "HD type",
"megapixel": "Megapixel",
"optical_zoom": "Optical zoom",
"display": "Display",
"brand": "Brand",
"color": "Color"
},
"productConfigurationInstance": null
},
"links": {
"self": "https://glue.mysprykershop.com/concrete-products/041_25904691"
},
"relationships": {
"product-offers": {
"data": [
{
"type": "product-offers",
"id": "offer89"
},
{
"type": "product-offers",
"id": "offer48"
}
]
}
}
},
{
"type": "guest-cart-items",
"id": "041_25904691_offer48",
"attributes": {
"sku": "041_25904691",
"quantity": 21,
"groupKey": "041_25904691_offer48",
"abstractSku": "041",
"amount": null,
"productOfferReference": "offer48",
"merchantReference": "MER000002",
"calculations": {
"unitPrice": 10520,
"sumPrice": 220920,
"taxRate": 19,
"unitNetPrice": 0,
"sumNetPrice": 0,
"unitGrossPrice": 10520,
"sumGrossPrice": 220920,
"unitTaxAmountFullAggregation": 1680,
"sumTaxAmountFullAggregation": 35273,
"sumSubtotalAggregation": 220920,
"unitSubtotalAggregation": 10520,
"unitProductOptionPriceAggregation": 0,
"sumProductOptionPriceAggregation": 0,
"unitDiscountAmountAggregation": 0,
"sumDiscountAmountAggregation": 0,
"unitDiscountAmountFullAggregation": 0,
"sumDiscountAmountFullAggregation": 0,
"unitPriceToPayAggregation": 10520,
"sumPriceToPayAggregation": 220920
},
"configuredBundle": null,
"configuredBundleItem": null,
"productConfigurationInstance": null,
"salesUnit": null,
"selectedProductOptions": []
},
"links": {
"self": "https://glue.mysprykershop.com/guest-carts/6851dc6a-ebed-52ed-b229-81a35fe94c49/guest-cart-items/041_25904691_offer48"
},
"relationships": {
"concrete-products": {
"data": [
{
"type": "concrete-products",
"id": "041_25904691"
}
]
}
}
}
]
}
Response sample: Retrieve a guest cart with product offer availabilities information included
{
"data": {
"type": "guest-carts",
"id": "6851dc6a-ebed-52ed-b229-81a35fe94c49",
"attributes": {
"priceMode": "GROSS_MODE",
"currency": "EUR",
"store": "DE",
"name": "Shopping cart",
"isDefault": true,
"totals": {
"expenseTotal": 0,
"discountTotal": 0,
"taxTotal": 35273,
"subtotal": 220920,
"grandTotal": 220920,
"priceToPay": 220920
},
"discounts": []
},
"links": {
"self": "https://glue.mysprykershop.com/guest-carts/6851dc6a-ebed-52ed-b229-81a35fe94c49"
}
},
"included": [
{
"type": "product-offer-availabilities",
"id": "offer89",
"attributes": {
"isNeverOutOfStock": true,
"availability": true,
"quantity": "0.0000000000"
},
"links": {
"self": "https://glue.mysprykershop.com/product-offers/offer89/product-offer-availabilities"
}
},
{
"type": "product-offers",
"id": "offer89",
"attributes": {
"merchantSku": null,
"merchantReference": "MER000005",
"isDefault": true
},
"links": {
"self": "https://glue.mysprykershop.com/product-offers/offer89"
},
"relationships": {
"product-offer-availabilities": {
"data": [
{
"type": "product-offer-availabilities",
"id": "offer89"
}
]
}
}
},
{
"type": "product-offer-availabilities",
"id": "offer48",
"attributes": {
"isNeverOutOfStock": true,
"availability": true,
"quantity": "20.0000000000"
},
"links": {
"self": "https://glue.mysprykershop.com/product-offers/offer48/product-offer-availabilities"
}
},
{
"type": "product-offers",
"id": "offer48",
"attributes": {
"merchantSku": null,
"merchantReference": "MER000002",
"isDefault": false
},
"links": {
"self": "https://glue.mysprykershop.com/product-offers/offer48"
},
"relationships": {
"product-offer-availabilities": {
"data": [
{
"type": "product-offer-availabilities",
"id": "offer48"
}
]
}
}
},
{
"type": "concrete-products",
"id": "041_25904691",
"attributes": {
"sku": "041_25904691",
"isDiscontinued": false,
"discontinuedNote": null,
"averageRating": null,
"reviewCount": 0,
"productAbstractSku": "041",
"name": "Canon PowerShot SX610",
"description": "Optical Quality Capture quality images from a distance with a 20.2 MP, 25mm wide, 18x optical zoom lens. Hybrid Auto mode records 4 seconds of video before each shot then compiles them all into a single video. With built in NFC and Wi-Fi its so easy to share your happy snaps to your favourite social media platforms. Expand your creative photography skills through applying a range of artistic presets such as toy camera or fish eye effect. Capture images remotely and view live images from the camera via your phone and the Camera Connect app. Bring your memories to life as you experience videos on Full HD quality in 30p/MP4 recording.",
"attributes": {
"hd_type": "Full HD",
"megapixel": "20.2 MP",
"optical_zoom": "18 x",
"display": "LCD",
"brand": "Canon",
"color": "White"
},
"superAttributesDefinition": [
"color"
],
"metaTitle": "Canon PowerShot SX610",
"metaKeywords": "Canon,Entertainment Electronics",
"metaDescription": "Optical Quality Capture quality images from a distance with a 20.2 MP, 25mm wide, 18x optical zoom lens. Hybrid Auto mode records 4 seconds of video before",
"attributeNames": {
"hd_type": "HD type",
"megapixel": "Megapixel",
"optical_zoom": "Optical zoom",
"display": "Display",
"brand": "Brand",
"color": "Color"
},
"productConfigurationInstance": null
},
"links": {
"self": "https://glue.mysprykershop.com/concrete-products/041_25904691"
},
"relationships": {
"product-offers": {
"data": [
{
"type": "product-offers",
"id": "offer89"
},
{
"type": "product-offers",
"id": "offer48"
}
]
}
}
},
{
"type": "guest-cart-items",
"id": "041_25904691_offer48",
"attributes": {
"sku": "041_25904691",
"quantity": 21,
"groupKey": "041_25904691_offer48",
"abstractSku": "041",
"amount": null,
"productOfferReference": "offer48",
"merchantReference": "MER000002",
"calculations": {
"unitPrice": 10520,
"sumPrice": 220920,
"taxRate": 19,
"unitNetPrice": 0,
"sumNetPrice": 0,
"unitGrossPrice": 10520,
"sumGrossPrice": 220920,
"unitTaxAmountFullAggregation": 1680,
"sumTaxAmountFullAggregation": 35273,
"sumSubtotalAggregation": 220920,
"unitSubtotalAggregation": 10520,
"unitProductOptionPriceAggregation": 0,
"sumProductOptionPriceAggregation": 0,
"unitDiscountAmountAggregation": 0,
"sumDiscountAmountAggregation": 0,
"unitDiscountAmountFullAggregation": 0,
"sumDiscountAmountFullAggregation": 0,
"unitPriceToPayAggregation": 10520,
"sumPriceToPayAggregation": 220920
},
"configuredBundle": null,
"configuredBundleItem": null,
"productConfigurationInstance": null,
"salesUnit": null,
"selectedProductOptions": []
},
"links": {
"self": "https://glue.mysprykershop.com/guest-carts/6851dc6a-ebed-52ed-b229-81a35fe94c49/guest-cart-items/041_25904691_offer48"
},
"relationships": {
"concrete-products": {
"data": [
{
"type": "concrete-products",
"id": "041_25904691"
}
]
}
}
}
]
}
Response sample: retrieve a guest cart with product offer prices information included
{
"data": {
"type": "guest-carts",
"id": "6851dc6a-ebed-52ed-b229-81a35fe94c49",
"attributes": {
"priceMode": "GROSS_MODE",
"currency": "EUR",
"store": "DE",
"name": "Shopping cart",
"isDefault": true,
"totals": {
"expenseTotal": 0,
"discountTotal": 0,
"taxTotal": 35273,
"subtotal": 220920,
"grandTotal": 220920,
"priceToPay": 220920
},
"discounts": []
},
"links": {
"self": "https://glue.mysprykershop.com/guest-carts/6851dc6a-ebed-52ed-b229-81a35fe94c49"
}
},
"included": [
{
"type": "product-offer-prices",
"id": "offer89",
"attributes": {
"price": 9342,
"prices": [
{
"priceTypeName": "DEFAULT",
"netAmount": null,
"grossAmount": 9342,
"currency": {
"code": "EUR",
"name": "Euro",
"symbol": "€"
},
"volumePrices": [
{
"grossAmount": 10065,
"netAmount": 10050,
"quantity": 2
},
{
"grossAmount": 10058,
"netAmount": 10045,
"quantity": 7
},
{
"grossAmount": 10052,
"netAmount": 10040,
"quantity": 18
}
]
}
]
},
"links": {
"self": "https://glue.mysprykershop.com/product-offers/offer89/product-offer-prices"
}
},
{
"type": "product-offers",
"id": "offer89",
"attributes": {
"merchantSku": null,
"merchantReference": "MER000005",
"isDefault": true
},
"links": {
"self": "https://glue.mysprykershop.com/product-offers/offer89"
},
"relationships": {
"product-offer-prices": {
"data": [
{
"type": "product-offer-prices",
"id": "offer89"
}
]
}
}
},
{
"type": "product-offer-prices",
"id": "offer48",
"attributes": {
"price": 9861,
"prices": [
{
"priceTypeName": "DEFAULT",
"netAmount": null,
"grossAmount": 9861,
"currency": {
"code": "EUR",
"name": "Euro",
"symbol": "€"
},
"volumePrices": [
{
"grossAmount": 10650,
"netAmount": 10500,
"quantity": 3
},
{
"grossAmount": 10580,
"netAmount": 10450,
"quantity": 9
},
{
"grossAmount": 10520,
"netAmount": 10400,
"quantity": 17
}
]
}
]
},
"links": {
"self": "https://glue.mysprykershop.com/product-offers/offer48/product-offer-prices"
}
},
{
"type": "product-offers",
"id": "offer48",
"attributes": {
"merchantSku": null,
"merchantReference": "MER000002",
"isDefault": false
},
"links": {
"self": "https://glue.mysprykershop.com/product-offers/offer48"
},
"relationships": {
"product-offer-prices": {
"data": [
{
"type": "product-offer-prices",
"id": "offer48"
}
]
}
}
},
{
"type": "concrete-products",
"id": "041_25904691",
"attributes": {
"sku": "041_25904691",
"isDiscontinued": false,
"discontinuedNote": null,
"averageRating": null,
"reviewCount": 0,
"productAbstractSku": "041",
"name": "Canon PowerShot SX610",
"description": "Optical Quality Capture quality images from a distance with a 20.2 MP, 25mm wide, 18x optical zoom lens. Hybrid Auto mode records 4 seconds of video before each shot then compiles them all into a single video. With built in NFC and Wi-Fi its so easy to share your happy snaps to your favourite social media platforms. Expand your creative photography skills through applying a range of artistic presets such as toy camera or fish eye effect. Capture images remotely and view live images from the camera via your phone and the Camera Connect app. Bring your memories to life as you experience videos on Full HD quality in 30p/MP4 recording.",
"attributes": {
"hd_type": "Full HD",
"megapixel": "20.2 MP",
"optical_zoom": "18 x",
"display": "LCD",
"brand": "Canon",
"color": "White"
},
"superAttributesDefinition": [
"color"
],
"metaTitle": "Canon PowerShot SX610",
"metaKeywords": "Canon,Entertainment Electronics",
"metaDescription": "Optical Quality Capture quality images from a distance with a 20.2 MP, 25mm wide, 18x optical zoom lens. Hybrid Auto mode records 4 seconds of video before",
"attributeNames": {
"hd_type": "HD type",
"megapixel": "Megapixel",
"optical_zoom": "Optical zoom",
"display": "Display",
"brand": "Brand",
"color": "Color"
},
"productConfigurationInstance": null
},
"links": {
"self": "https://glue.mysprykershop.com/concrete-products/041_25904691"
},
"relationships": {
"product-offers": {
"data": [
{
"type": "product-offers",
"id": "offer89"
},
{
"type": "product-offers",
"id": "offer48"
}
]
}
}
},
{
"type": "guest-cart-items",
"id": "041_25904691_offer48",
"attributes": {
"sku": "041_25904691",
"quantity": 21,
"groupKey": "041_25904691_offer48",
"abstractSku": "041",
"amount": null,
"productOfferReference": "offer48",
"merchantReference": "MER000002",
"calculations": {
"unitPrice": 10520,
"sumPrice": 220920,
"taxRate": 19,
"unitNetPrice": 0,
"sumNetPrice": 0,
"unitGrossPrice": 10520,
"sumGrossPrice": 220920,
"unitTaxAmountFullAggregation": 1680,
"sumTaxAmountFullAggregation": 35273,
"sumSubtotalAggregation": 220920,
"unitSubtotalAggregation": 10520,
"unitProductOptionPriceAggregation": 0,
"sumProductOptionPriceAggregation": 0,
"unitDiscountAmountAggregation": 0,
"sumDiscountAmountAggregation": 0,
"unitDiscountAmountFullAggregation": 0,
"sumDiscountAmountFullAggregation": 0,
"unitPriceToPayAggregation": 10520,
"sumPriceToPayAggregation": 220920
},
"configuredBundle": null,
"configuredBundleItem": null,
"productConfigurationInstance": null,
"salesUnit": null,
"selectedProductOptions": []
},
"links": {
"self": "https://glue.mysprykershop.com/guest-carts/6851dc6a-ebed-52ed-b229-81a35fe94c49/guest-cart-items/041_25904691_offer48"
},
"relationships": {
"concrete-products": {
"data": [
{
"type": "concrete-products",
"id": "041_25904691"
}
]
}
}
}
]
}
Response sample: retrieve a guest cart with items and information about merchants included
{
"data": {
"type": "guest-carts",
"id": "f0d01709-4dea-5ac3-8ceb-873875446ab0",
"attributes": {
"priceMode": "GROSS_MODE",
"currency": "EUR",
"store": "DE",
"name": "Shopping cart",
"isDefault": true,
"totals": {
"expenseTotal": 0,
"discountTotal": 0,
"taxTotal": 822,
"subtotal": 12572,
"grandTotal": 12572,
"priceToPay": 12572
},
"discounts": []
},
"links": {
"self": "https://glue.mysprykershop.com/guest-carts/f0d01709-4dea-5ac3-8ceb-873875446ab0"
}
},
"included": [
{
"type": "merchants",
"id": "MER000001",
"attributes": {
"merchantName": "Spryker",
"merchantUrl": "/en/merchant/spryker",
"contactPersonRole": "E-Commerce Manager",
"contactPersonTitle": "Mr",
"contactPersonFirstName": "Harald",
"contactPersonLastName": "Schmidt",
"contactPersonPhone": "+49 30 208498350",
"logoUrl": "https://d2s0ynfc62ej12.cloudfront.net/merchant/spryker-logo.png",
"publicEmail": "info@spryker.com",
"publicPhone": "+49 30 234567891",
"description": "Spryker is the main merchant at the Demo Marketplace.",
"bannerUrl": "https://d2s0ynfc62ej12.cloudfront.net/merchant/spryker-banner.png",
"deliveryTime": "1-3 days",
"latitude": "13.384458",
"longitude": "52.534105",
"faxNumber": "+49 30 234567800",
"legalInformation": {
"terms": "<p><span style=\"font-weight: bold;\">General Terms</span><br><br>(1) This privacy policy has been compiled to better serve those who are concerned with how their 'Personally identifiable information' (PII) is being used online. PII, as used in US privacy law and information security, is information that can be used on its own or with other information to identify, contact, or locate a single person, or to identify an individual in context. Please read our privacy policy carefully to get a clear understanding of how we collect, use, protect or otherwise handle your Personally Identifiable Information in accordance with our website. <br><br>(2) We do not collect information from visitors of our site or other details to help you with your experience.<br><br><span style=\"font-weight: bold;\">Using your Information</span><br><br>We may use the information we collect from you when you register, make a purchase, sign up for our newsletter, respond to a survey or marketing communication, surf the website, or use certain other site features in the following ways: <br><br>To personalize user's experience and to let us deliver the type of content and product offerings in which you are most interested.<br><br><span style=\"font-weight: bold;\">Protecting visitor information</span><br><br>Our website is scanned on a regular basis for security holes and known vulnerabilities in order to make your visit to our site as safe as possible. Your personal information is contained behind secured networks and is only accessible by a limited number of persons who have special access rights to such systems, and are required to keep the information confidential. In addition, all sensitive/credit information you supply is encrypted via Secure Socket Layer (SSL) technology.</p>",
"cancellationPolicy": "You have the right to withdraw from this contract within 14 days without giving any reason. The withdrawal period will expire after 14 days from the day on which you acquire, or a third party other than the carrier and indicated by you acquires, physical possession of the last good. You may use the attached model withdrawal form, but it is not obligatory. To meet the withdrawal deadline, it is sufficient for you to send your communication concerning your exercise of the right of withdrawal before the withdrawal period has expired.",
"imprint": "<p>Spryker Systems GmbH<br><br>Julie-Wolfthorn-Straße 1<br>10115 Berlin<br>DE<br><br>Phone: +49 (30) 2084983 50<br>Email: info@spryker.com<br><br>Represented by<br>Managing Directors: Alexander Graf, Boris Lokschin<br>Register Court: Hamburg<br>Register Number: HRB 134310<br></p>",
"dataPrivacy": "Spryker Systems GmbH values the privacy of your personal data."
},
"categories": []
},
"links": {
"self": "https://glue.mysprykershop.com/merchants/MER000001"
}
},
{
"type": "guest-cart-items",
"id": "109_19416433",
"attributes": {
"sku": "109_19416433",
"quantity": "1",
"groupKey": "109_19416433",
"abstractSku": "109",
"amount": null,
"productOfferReference": null,
"merchantReference": "MER000001",
"calculations": {
"unitPrice": 12572,
"sumPrice": 12572,
"taxRate": 7,
"unitNetPrice": 0,
"sumNetPrice": 0,
"unitGrossPrice": 12572,
"sumGrossPrice": 12572,
"unitTaxAmountFullAggregation": 822,
"sumTaxAmountFullAggregation": 822,
"sumSubtotalAggregation": 12572,
"unitSubtotalAggregation": 12572,
"unitProductOptionPriceAggregation": 0,
"sumProductOptionPriceAggregation": 0,
"unitDiscountAmountAggregation": 0,
"sumDiscountAmountAggregation": 0,
"unitDiscountAmountFullAggregation": 0,
"sumDiscountAmountFullAggregation": 0,
"unitPriceToPayAggregation": 12572,
"sumPriceToPayAggregation": 12572
},
"configuredBundle": null,
"configuredBundleItem": null,
"salesUnit": null,
"selectedProductOptions": []
},
"links": {
"self": "https://glue.mysprykershop.com/guest-carts/f0d01709-4dea-5ac3-8ceb-873875446ab0/guest-cart-items/109_19416433"
},
"relationships": {
"merchants": {
"data": [
{
"type": "merchants",
"id": "MER000001"
}
]
}
}
}
]
}
General cart information
ATTRIBUTE | TYPE | DESCRIPTION |
---|---|---|
priceMode | String | Price mode that was active when the cart was created. |
currency | String | Currency that was selected when the cart was created. |
store | String | Store for which the cart was created. |
name | String | Name of the shopping cart. |
isDefault | Boolean | Defines whether the cart is default or not. |
Totals information
ATTRIBUTE | TYPE | DESCRIPTION |
---|---|---|
expenseTotal | String | Total amount of expenses (including, for example, shipping costs). |
discountTotal | Integer | Total amount of discounts applied to the cart. |
taxTotal | Integer | Total amount of taxes to be paid. |
subTotal | Integer | Subtotal of the cart. |
grandTotal | Integer | Grand total of the cart. |
Discount information
ATTRIBUTE | TYPE | DESCRIPTION |
---|---|---|
displayName | String | Discount name. |
code | String | Discount code applied to the cart. |
amount | Integer | Discount amount applied to the cart. |
Included resource attributes
INCLUDED RESOURCE | ATTRIBUTE | TYPE | DESCRIPTION |
---|---|---|---|
product-options | optionGroupName | String | Name of the group to which the option belongs. |
product-options | sku | String | SKU of the product option. |
product-options | optionName | String | Product option name. |
product-options | price | Integer | Product option price in cents. |
product-options | currencyIsoCode | String | ISO 4217 code of the currency in which the product option price is specified. |
vouchers, cart-rules | displayName | String | Discount name displayed on the Storefront. |
vouchers, cart-rules | amount | Integer | Amount of the provided discount. |
vouchers, cart-rules | code | String | Discount code. |
vouchers, cart-rules | discountType | String | Discount type. |
vouchers, cart-rules | isExclusive | Boolean | Discount exclusivity. |
vouchers, cart-rules | expirationDateTime | DateTimeUtc | Date and time on which the discount expires. |
vouchers, cart-rules | discountPromotionAbstractSku | String | SKU of the products to which the discount applies. If the discount can be applied to any product, the value is null . |
vouchers, cart-rules | discountPromotionQuantity | Integer | Specifies the amount of the product required to be able to apply the discount. If the minimum number is 0 , the value is null . |
promotional-items | id | String | Unique identifier of the promotional item. The ID can be used to apply the promotion to the given purchase. |
promotional-items | quantity | Integer | Specifies how many promotions can be applied to the given purchase. |
promotional-items | sku | String | SKU of the promoted abstract product. |
product-offers | merchantSku | String | SKU of the Merchant the product offer belongs to. |
product-offers | merchantReference | String | Merchant Reference assigned to every Merchant. |
product-offers | isDefault | Boolean | Defines whether the Product Offer is default or not. |
ATTRIBUTE | TYPE | DESCRIPTION |
---|---|---|
isNeverOutOfStock | Boolean | Shows if the product offer is never out of stock. |
availability | Boolean | Defines if the product offer is available. |
quantity | Integer | Stock of the product offer. |
RESOURCE | ATTRIBUTE | TYPE | DESCRIPTION |
---|---|---|---|
product-measurement-units | name | string | Name of the product measurement unit. |
product-measurement-units | defaultPrecision | integer | Default ratio between a sales unit and a base unit. It is used when precision for a related sales unit is not specified. |
product-measurement-units | measurementUnitCode | string | Code of the measurement unit. |
For the attributes of other included resources, see:
- Manage guest cart items
- Retrieve measurement units
- Retrieve concrete products
- Retrieve gift cards of guest users
- Retrieve product labels
- Retrieving merchants
- Retrieving product offers
- Retrieving product offers
Assign a guest cart to a registered customer
Guest carts are anonymous as they are not related to any user. If a user registers or logs in, the guest cart can be automatically assigned to their account.
To assign a guest cart to a customer, that is, merge the carts, include the unique identifier associated with the customer in the X-Anonymous-Customer-Unique-Id
header of the authentication request if it is an existing customer, or request to create a customer account if it is a new one. Adjust the configuration constant to create a cart for the newly authenticated customer while merging the guest cart with the customer cart:
src/Pyz/Zed/CartsRestApi/CartsRestApiConfig.php
<?php
namespace Pyz\Zed\CartsRestApi;
use Spryker\Zed\CartsRestApi\CartsRestApiConfig as SprykerCartsRestApiConfig;
class CartsRestApiConfig extends SprykerCartsRestApiConfig
{
protected const IS_QUOTE_CREATION_WHILE_QUOTE_MERGING_ENABLED = true;
}
Upon login, the behavior depends on whether your project is a single cart or multiple cart environment:
- In a single cart environment, the products in the guest cart are added to the customers’ own cart.
- In a multiple cart environment, the guest cart is converted to a regular user cart and added to the list of the customers’ own carts.
The workflow is displayed in the following diagram:
The following is an exemplary workflow of converting a guest cart into a regular cart:
- The customer adds items to a guest cart.
Request sample:
POST https://glue.myspsrykershop.com/guest-cart-items
{
"data": {
"type": "guest-cart-items",
"attributes": {
"sku": "022_21994751",
"quantity": 5
}
}
}
HEADER KEY | HEADER VALUE | DESCRIPTION |
---|---|---|
X-Anonymous-Customer-Unique-Id | guest-user-001 | Guest user’s unique identifier. For security purposes, we recommend passing a hyphenated alphanumeric value, but you can pass any. If you are sending automated requests, you can configure your API client to generate this value.. |
Response sample:
{
"data": {
"type": "guest-carts",
"id": "9183f604-9b2c-53d9-acbf-cf59b9b2ff9f",
"attributes": {...},
"links": {...}
},
"included": [...]
}
- The customer logs in.
Request sample: POST https://glue.myspsrykershop.com/access-tokens
{
"data": {
"type": "access-tokens",
"attributes": {
"username": "john.doe@example.com",
"password": "qwerty"
}
}
}
HEADER KEY | HEADER VALUE | DESCRIPTION |
---|---|---|
X-Anonymous-Customer-Unique-Id | guest-user-001 | Guest user’s unique identifier. For security purposes, we recommend passing a hyphenated alphanumeric value, but you can pass any. If you are sending automated requests, you can configure your API client to generate this value. |
Response sample:
{
"data": {
"type": "access-tokens",
"id": null,
"attributes": {
"tokenType": "Bearer",
"expiresIn": 28800,
"accessToken": "eyJ0eXAiOiJKV1QiLC...",
"refreshToken": "def50200ae2d0...",
"idCompanyUser": "94d58692-c117-5466-8b9f-2ba32dd87c43"
},
"links": {...}
}
}
- The customer requests a list of his own carts.
Request sample:
GET https://glue.myspsrykershop.com/carts
HEADER KEY | HEADER VALUE | REQUIRED | DESCRIPTION |
---|---|---|---|
Authorization | string | ✓ | Alphanumeric string that authenticates the customer you want to change the password of. Get it by authenticating as a customer. |
In the multi-cart environment, the guest cart has been converted to a regular cart. You can see it in the list of carts with the ID 9183f604-9b2c-53d9-acbf-cf59b9b2ff9f
.
Response sample:
{
"data": [
{
"type": "guest-carts",
"id": "1ce91011-8d60-59ef-9fe0-4493ef3628b2",
"attributes": {...},
"links": {...}
},
{
"type": "carts",
"id": "9183f604-9b2c-53d9-acbf-cf59b9b2ff9f",
"attributes": {...},
"links": {...}
}
],
"links": {...}
}
In a single cart environment, items from the guest cart have been added to the user’s own cart.
Response body
{
"data": [
{
"type": "guest-carts",
"id": "1ce91011-8d60-59ef-9fe0-4493ef3628b2",
"attributes": {
"priceMode": "GROSS_MODE",
"currency": "EUR",
"store": "DE",
"isDefault": true,
"totals": {
"expenseTotal": 0,
"discountTotal": 13000,
"taxTotal": 18681,
"subtotal": 130000,
"grandTotal": 117000
},
"discounts": [...]
},
"links": {...}
},
Possible errors
CODE | REASON |
---|---|
101 | Cart with given uuid not found. |
102 | Failed to add an item to cart. |
103 | Item with the given group key not found in the cart. |
104 | Cart uuid is missing. |
105 | Cart could not be deleted. |
106 | Cart item could not be deleted. |
107 | Failed to create a cart. |
109 | Anonymous customer unique ID is empty. |
111 | Can’t switch price mode when there are items in the cart. |
112 | Store data is invalid. |
113 | Cart item could not be added. |
114 | Cart item could not be updated. |
115 | Unauthorized cart action. |
116 | Currency is missing. |
117 | Currency is incorrect. |
118 | Price mode is missing. |
119 | Price mode is incorrect. |
To view generic errors that originate from the Glue Application, see Reference information: GlueApplication errors.
Thank you!
For submitting the form