API Documentation

This document is a work in progress and your opinion helps us to improve. Please let us know what we can do better. Thanks! support@procurios.com

Webshop Promotions

A promotion is a special deal or discount designed to convince people to order products.

Accept header for requests to Webshop Promotions

application/vnd.procurios.webshop+json; version=1

Read BOGO promotions GET

URL: /l/webshop2_api/webshops/1/bogo

Scope:

webshop2/promotion/read
Last used: Never

Read multiple "Buy one/get one" promotions

Parameters

Parameter Type Description
page int

The api will provide 100 results per page
ids array of uuid

Ids of bogo promotions to search for
Live testing disabled

Read BOGO promotions

Request

json

Response

jsonStatus: 200
[
    {
        "id": "0116c412-0aef-4a00-bba2-9eb667f38262",
        "title": "Bogo title",
        "titleInWebshop": "Webshop title",
        "validFrom": "1980-01-01 00:00:00",
        "validTo": "1990-12-31 00:00:00",
        "quantityInShoppingCart": 3,
        "quantityDiscounted": 2,
        "articleNumbers": [],
        "modifiedDateTime": "1985-03-04 00:00:00",
        "discountType": "percentage",
        "discountPercentage": {
            "amount": 1250,
            "precision": 2
        }
    },
    {
        "id": "14d38752-5ab7-4497-899a-a1fb492c7bd3",
        "title": "Bogo title",
        "titleInWebshop": "Webshop title",
        "validFrom": "1980-01-01 00:00:00",
        "validTo": "1990-12-31 00:00:00",
        "quantityInShoppingCart": 3,
        "quantityDiscounted": 2,
        "articleNumbers": [],
        "modifiedDateTime": "1985-03-04 00:00:00",
        "discountType": "percentage",
        "discountPercentage": {
            "amount": 1250,
            "precision": 2
        }
    }
]

Read product set promotions GET

URL: /l/webshop2_api/webshops/1/productSet

Scope:

webshop2/promotion/read
Last used: Never

Read multiple "Buy these together for a fixed price" promotions

Parameters

Parameter Type Description
page int

The api will provide 100 results per page
ids array of uuid

Ids of productset promotions to search for
Live testing disabled

Read product set promotions

Request

json

Response

jsonStatus: 200
[
    {
        "id": "4d59a670-2e15-44bb-ba3a-5038392b4d0f",
        "title": "ProductSet title",
        "titleInWebshop": "Webshop title",
        "validFrom": "1980-01-01 00:00:00",
        "validTo": "1990-12-31 00:00:00",
        "price": {
            "amount": 15,
            "precision": 0
        },
        "articleNumberCounts": [],
        "modifiedDateTime": "1985-03-04 00:00:00"
    },
    {
        "id": "be52902c-ab6b-4519-86eb-f804786aa035",
        "title": "ProductSet title",
        "titleInWebshop": "Webshop title",
        "validFrom": "1980-01-01 00:00:00",
        "validTo": "1990-12-31 00:00:00",
        "price": {
            "amount": 15,
            "precision": 0
        },
        "articleNumberCounts": [],
        "modifiedDateTime": "1985-03-04 00:00:00"
    }
]

Read discount promotions GET

URL: /l/webshop2_api/webshops/1/promotion

Scope:

webshop2/promotion/read
Last used: Never

Read multiple "This product is temporarily discounted" promotions

Parameters

Parameter Type Description
page int

The api will provide 100 results per page
ids array of int

Ids of productset promotions to search for
Live testing disabled

Read discount promotions

Request

json

Response

jsonStatus: 200
[
    {
        "id": 123,
        "title": "Promotion Title",
        "titleInWebshop": "Title in webshop",
        "validFrom": "1980-01-01 00:00:00",
        "validTo": "1985-03-03 00:00:00",
        "articleNumbers": [],
        "modifiedDateTime": "1982-02-03 00:00:00",
        "applicationType": "shipping",
        "discountType": "percentage",
        "discountPercentage": {
            "amount": 1250,
            "precision": 2
        }
    },
    {
        "id": 123,
        "title": "Promotion Title",
        "titleInWebshop": "Title in webshop",
        "validFrom": "1980-01-01 00:00:00",
        "validTo": "1985-03-03 00:00:00",
        "articleNumbers": [],
        "modifiedDateTime": "1982-02-03 00:00:00",
        "applicationType": "shipping",
        "discountType": "percentage",
        "discountPercentage": {
            "amount": 1250,
            "precision": 2
        }
    }
]