CartItem.cart

Request

Fields when send to the api inside a request.

Field Type Description
amount Int An integer value
persons Int An integer value
gram Int An integer value
comment String A String value
product_id Int An integer value
product_price_id Int? Nullable. An integer value
shop_id Int An integer value
options [CartItemOption] Array of CartItemOption

Response

Fields when returned by the api in a response.

Field Type Description
amount Int An integer value
persons Int An integer value
gram Int An integer value
comment String A String value
product Product.simple
product_price ProductPrice.simple? Nullable.
calculated_prices CartItemPrices
discount_prices CartItemPrices? Nullable.
amount_free Int Amount you receive for free on top of the chosen amount. If the price type of the product is in gram or persons, this amount is also in gram or persons.
shop Shop.simple
options [CartItemOption] Array of CartItemOption

Examples

Request

When used inside a request.

Example 1

{
    "amount": 12,
    "persons": 11,
    "gram": 16,
    "comment": "...",
    "product_id": 16,
    "product_price_id": 11,
    "shop_id": 10,
    "options": [
        {
            "option_id": 15,
            "upload_id": 18,
            "amount": 11
        },
        {
            "option_id": 15,
            "upload_id": 15,
            "amount": 17
        },
        {
            "option_id": 15,
            "upload_id": 19,
            "amount": 10
        }
    ]
}

Response

When returned in a response.

Example 1

{
    "amount": 14,
    "persons": 16,
    "gram": 18,
    "comment": "...",
    "product": {
        "id": 10,
        "name": "...",
        "images": [
            {
                "resolutions": [
                    {
                        "src": "https://example.com",
                        "width": 600,
                        "height": 350
                    },
                    {
                        "src": "https://example.com",
                        "width": 600,
                        "height": 350
                    },
                    {
                        "src": "https://example.com",
                        "width": 600,
                        "height": 350
                    }
                ],
                "white_background": false
            },
            {
                "resolutions": [
                    {
                        "src": "https://example.com",
                        "width": 600,
                        "height": 350
                    },
                    {
                        "src": "https://example.com",
                        "width": 600,
                        "height": 350
                    },
                    {
                        "src": "https://example.com",
                        "width": 600,
                        "height": 350
                    }
                ],
                "white_background": false
            },
            {
                "resolutions": [
                    {
                        "src": "https://example.com",
                        "width": 600,
                        "height": 350
                    },
                    {
                        "src": "https://example.com",
                        "width": 600,
                        "height": 350
                    },
                    {
                        "src": "https://example.com",
                        "width": 600,
                        "height": 350
                    }
                ],
                "white_background": false
            }
        ],
        "price_type": "PER_UNIT",
        "target_price": false,
        "price": {
            "value": 12,
            "currency": "EUR"
        },
        "only_order_in_store": true,
        "category": {
            "id": 18,
            "name": "..."
        },
        "origin": "..."
    },
    "product_price": {
        "id": 15,
        "name": "...",
        "price": {
            "value": 14,
            "currency": "EUR"
        }
    },
    "calculated_prices": {
        "unit_price": {
            "value": 14,
            "currency": "EUR"
        },
        "price": {
            "value": 11,
            "currency": "EUR"
        }
    },
    "discount_prices": {
        "unit_price": {
            "value": 12,
            "currency": "EUR"
        },
        "price": {
            "value": 17,
            "currency": "EUR"
        }
    },
    "amount_free": 10,
    "shop": {
        "id": 18,
        "name": "Alejandra Ledner",
        "address": {
            "street": "Sint-Denijslaan",
            "nr": "96",
            "zipcode": "9000",
            "city": "Gent",
            "country": "BE",
            "position": {
                "latitude": 1.54361,
                "longitude": 0.45645
            }
        },
        "allow_comments": false,
        "url": "...",
        "allow_order_comments": true,
        "allow_product_comments": false,
        "allow_order_messages": true,
        "allow_orders": true,
        "currency": "EUR"
    },
    "options": [
        {
            "option": {
                "id": 15,
                "name": "...",
                "price_change": {
                    "value": 11,
                    "currency": "EUR"
                },
                "image": {
                    "resolutions": [
                        {
                            "src": "https://example.com",
                            "width": 600,
                            "height": 350
                        },
                        {
                            "src": "https://example.com",
                            "width": 600,
                            "height": 350
                        },
                        {
                            "src": "https://example.com",
                            "width": 600,
                            "height": 350
                        }
                    ],
                    "white_background": false
                },
                "require_image": false,
                "code": "...",
                "price_calculation": "PER_PIECE",
                "optionset": {
                    "id": 17,
                    "name": "...",
                    "code": "...",
                    "multiple_choice": false,
                    "choose_amount": false,
                    "min_different_options": 18,
                    "max_different_options": 18,
                    "min_amount_options": 15,
                    "max_amount_options": 15
                }
            },
            "upload": {
                "id": 18,
                "url": "https://example.com"
            },
            "amount": 16
        },
        {
            "option": {
                "id": 18,
                "name": "...",
                "price_change": {
                    "value": 15,
                    "currency": "EUR"
                },
                "image": {
                    "resolutions": [
                        {
                            "src": "https://example.com",
                            "width": 600,
                            "height": 350
                        },
                        {
                            "src": "https://example.com",
                            "width": 600,
                            "height": 350
                        },
                        {
                            "src": "https://example.com",
                            "width": 600,
                            "height": 350
                        }
                    ],
                    "white_background": true
                },
                "require_image": false,
                "code": "...",
                "price_calculation": "PER_PIECE",
                "optionset": {
                    "id": 11,
                    "name": "...",
                    "code": "...",
                    "multiple_choice": true,
                    "choose_amount": true,
                    "min_different_options": 16,
                    "max_different_options": 15,
                    "min_amount_options": 10,
                    "max_amount_options": 16
                }
            },
            "upload": {
                "id": 17,
                "url": "https://example.com"
            },
            "amount": 14
        },
        {
            "option": {
                "id": 18,
                "name": "...",
                "price_change": {
                    "value": 12,
                    "currency": "EUR"
                },
                "image": {
                    "resolutions": [
                        {
                            "src": "https://example.com",
                            "width": 600,
                            "height": 350
                        },
                        {
                            "src": "https://example.com",
                            "width": 600,
                            "height": 350
                        },
                        {
                            "src": "https://example.com",
                            "width": 600,
                            "height": 350
                        }
                    ],
                    "white_background": true
                },
                "require_image": false,
                "code": "...",
                "price_calculation": "PER_PIECE",
                "optionset": {
                    "id": 18,
                    "name": "...",
                    "code": "...",
                    "multiple_choice": false,
                    "choose_amount": false,
                    "min_different_options": 17,
                    "max_different_options": 16,
                    "min_amount_options": 18,
                    "max_amount_options": 10
                }
            },
            "upload": {
                "id": 12,
                "url": "https://example.com"
            },
            "amount": 18
        }
    ]
}
Version update available Please adjust your integration to the latest stable version (1.9.0)
1.7.0 stable