Offer

Request

Fields when send to the api inside a request.

Field Type Description
shops [Int] Offers are valid for certain shop ids
name String A String value
from_date Date Date in YYYY-MM-DD
until_date Date Date in YYYY-MM-DD
valid_for String Offers are valid on either order date or acquire date.
recurring Bool Offers can be recurring within from_date and until_date
recurring_on String Optional. Offers can be recurring on a day of the week.

Response

Fields when returned by the api in a response.

Field Type Description
id Int An integer value
shops [Int] Offers are valid for certain shop ids
name String A String value
from_date Date Date in YYYY-MM-DD
until_date Date Date in YYYY-MM-DD
valid_for String Offers are valid on either order date or acquire date.
recurring Bool Offers can be recurring within from_date and until_date
recurring_on String Optional. Offers can be recurring on a day of the week.
items [OfferItem] Optional. Offers are applicable to categories, products or product prices

Examples

Request

When used inside a request.

Example 1

{
    "shops": [
        11,
        14,
        12
    ],
    "name": "...",
    "from_date": "2019-01-31",
    "until_date": "2019-01-31",
    "valid_for": "order",
    "recurring": true,
    "recurring_on": "monday"
}

Response

When returned in a response.

Example 1

{
    "id": 17,
    "shops": [
        19,
        17,
        11
    ],
    "name": "...",
    "from_date": "2019-01-31",
    "until_date": "2019-01-31",
    "valid_for": "order",
    "recurring": true,
    "recurring_on": "monday",
    "items": [
        {
            "applies_to": "category",
            "item_id": 11,
            "type": "percentage",
            "id": 18,
            "percentage": 11,
            "minimum_amount": 16,
            "free_amount": 15
        },
        {
            "applies_to": "category",
            "item_id": 12,
            "type": "percentage",
            "id": 19,
            "percentage": 13,
            "minimum_amount": 13,
            "free_amount": 11
        },
        {
            "applies_to": "category",
            "item_id": 18,
            "type": "percentage",
            "id": 17,
            "percentage": 18,
            "minimum_amount": 19,
            "free_amount": 10
        }
    ]
}
Version update available Please adjust your integration to the latest stable version (1.9.0)
1.8.0 stable