Item Update

This webhook is triggered whenever any items are altered on your account.

A JSON, XML, or x-www-form-urlencoded object containing the following export fields can be found in directly in the raw body of the POST request to your server:

Item

Field Type Description
unit string The allocation type for the item.
sku string The item’s SKU
url string The Item’s “More Info URL”
lock integer

If the item has Date Based Inventory control active.

0 means that Date-based inventory is disabled.

visibility string

The visibility of this item on the booking page.

  • * for Everyone
  • S for Staff
  • P for Packages Only
name string The name of the item.
pos integer The sort order integer.
meta object Contains meta details for the item. This changes based on the add-ons and data for the item.
stock integer The item’s inventory.
unlimited integer

This returns if the item’s inventory is unlimited or not.

0 means the inventory is limited.

video object See item.video below.
image object See item.image below.
category_id integer The id of the category this item is in.
rated integer

If this item is simple or not.

0 means the item is simple.

product_group_type string

The type of item this is in a Product Group.

P is for Parent, C is child.

product_group_children object Contains the Item object of the items that are children of the main item.
type string Determines if this is an Item or a Gift Certificate.
status string This is the availability status for the item.
alias_id integer The ID of the item this is aliased too. This will not show the ID of items aliased to this item.
len integer The fixed length of the item.
rules object Contains the item’s parameters, fixed length, and attribute specific rules such as default length start time, etc.
category string The name of the category this item is in.

item.video

Field Type Description
id string This is the identifying string for the Youtube URL.
start integer How many seconds into the video to start.

item.image

Field Type Description
# integer The index of the image. The images are numbered in the order they were uploaded, but are organized in the order they are displayed on the item.

item.image.images

Field Type Description
src string The identifying string for the image.
path string The identifying path to where the image is found relative to your Checkfront Account URL.
url string
The identifying path to where a full sized version
image is found on the server.
url_medium string The identifying path to where a medium version of the image is found on the server.
url_small string The identifying path to where a small version of the image is found on the server.

Sample Item Update Notification

JSON

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
{
    "version": "3.28.0.7",
    "host": "your-company.checkfront.com",
    "type": "item",
    "action": "update",
    "item": {
        "unit": "30M",
        "item_id": "40",
        "url": "",
        "lock": 1,
        "visibility": "*",
        "name": "Test Item",
        "pos": 0,
        "summary": "",
        "details": "",
        "meta": "{\"display_mode\":\"dropdown\",\"Xero_item_account\":\"0\",\"item_package_rate\":\"\",\"delay\":0}",
        "stock": 5,
        "unlimited": 0,
        "video": {
            "id": "",
            "start": 0
        },
        "image": [],
        "category_id": 9,
        "rated": 0,
        "product_group_type": "P",
        "product_group_children": [
            {
                "item_id": "41",
                "sku": "test-item_copy",
                "stock": "1",
                "name": "Test Item Additional Session",
                "category_id": "9",
                "price": "{\"0\":{\"participant\":\"5.00\"}}",
                "price_type": "U",
                "summary": "",
                "url": "",
                "img": "",
                "meta": "{\"display_mode\":\"dropdown\",\"item_package_rate\":\"\",\"delay\":0}",
                "enabled": "1",
                "status": "A",
                "unlimited": "0",
                "alias_id": "40",
                "lock": "1",
                "package": "{\"61\":{\"optin\":\"O\"}}",
                "rated": "1",
                "visible": "1",
                "visibility": "*",
                "taxes": "",
                "video": "{\"id\":\"\",\"start\":0}",
                "rules": "{\"param\":{\"inventorycontro\":{\"MIN\":\"0\",\"MAX\":\"0\"},\"participant\":{\"MIN\":\"1\",\"MAX\":\"10\"}},\"fixed\":{\"start_time\":\"\"}}",
                "unit": "30M",
                "len": "0",
                "param": "{\"inventorycontro\":1,\"participant\":1}",
                "ecom": "1",
                "gprice": "{}",
                "type": "I",
                "price_fixed": "0.00",
                "pos": "0",
                "location": null,
                "details": "",
                "extra_details": "",
                "commission_type": "P",
                "commission_amount": null,
                "product_group_type": "C",
                "product_group_children": ""
            }
        ],
        "type": "I",
        "status": "A",
        "alias_id": 0,
        "len": 0,
        "rules": "{\"param\":{\"inventorycontro\":{\"MIN\":\"4\",\"MAX\":\"4\"},\"participant\":{\"MIN\":\"1\",\"MAX\":\"10\"}},\"fixed\":{\"start_time\":\"\"}}",
        "category": "Programming"
    }
}

XML

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
<?xml version="1.0" encoding="utf-8"?>
<checkfront-notify version="3.29.0.1" host="your-company.checkfront.com">
    <type>item</type>
    <action>update</action>
    <item>
        <unit>30M</unit>
        <item_id>40</item_id>
        <sku>test-item</sku>
        <url></url>
        <lock>1</lock>
        <visibility>*</visibility>
        <name>Test Item</name>
        <pos>0</pos>
        <summary></summary>
        <details></details>
        <meta>{"display_mode":"dropdown","Xero_item_account":"0","item_package_rate":"","delay":0}</meta>
        <stock>5</stock>
        <unlimited>0</unlimited>
        <video>
            <id></id>
            <start>0</start>
        </video>
        <image/>
        <category_id>9</category_id>
        <rated>0</rated>
        <product_group_type>P</product_group_type>
        <product_group_children>
            <item_id>41</item_id>
            <sku>test-item_copy</sku>
            <stock>1</stock>
            <name>Test Item Additional Session</name>
            <category_id>9</category_id>
            <price>{"0":{"participant":"5.00"}}</price>
            <price_type>U</price_type>
            <summary></summary>
            <url></url>
            <img></img>
            <meta>{"display_mode":"dropdown","item_package_rate":"","delay":0}</meta>
            <enabled>1</enabled>
            <status>A</status>
            <unlimited>0</unlimited>
            <alias_id>40</alias_id>
            <lock>1</lock>
            <package>{"61":{"optin":"O"}}</package>
            <rated>1</rated>
            <visible>1</visible>
            <visibility>*</visibility>
            <taxes></taxes>
            <video>{"id":"","start":0}</video>
            <rules>{"param":{"inventorycontro":{"MIN":"0","MAX":"0"},"participant":{"MIN":"1","MAX":"10"}},"fixed":{"start_time":""}}</rules>
            <unit>30M</unit>
            <len>0</len>
            <param>{"inventorycontro":1,"participant":1}</param>
            <ecom>1</ecom>
            <gprice>{}</gprice>
            <type>I</type>
            <price_fixed>0.00</price_fixed>
            <pos>0</pos>
            <location/>
            <details></details>
            <extra_details></extra_details>
            <commission_type>P</commission_type>
            <commission_amount/>
            <product_group_type>C</product_group_type>
            <product_group_children></product_group_children>
            <category/>
        </product_group_children>
        <type>I</type>
        <status>A</status>
        <alias_id>0</alias_id>
        <len>0</len>
        <rules>{"param":{"inventorycontro":{"MIN":"4","MAX":"4"},"participant":{"MIN":"1","MAX":"10"}},"fixed":{"start_time":""}}</rules>
        <category>Programming</category>
    </item>
</checkfront-notify>