Cart rules

Summary of cart rule endpoints

GET /admin/api/ecommerce/v1/cart_rules - list all cart_rules.
POST /admin/api/ecommerce/v1/cart_rules - create a new cart rule.
GET /admin/api/ecommerce/v1/cart_rules/1 - list attributes of a cart rule.
PUT /admin/api/ecommerce/v1/cart_rules/1 - update attributes of a cart rule.
DELETE /admin/api/ecommerce/v1/cart_rules/1 - remove a cart rule.

List all cart rules for the current site

Get list of cart rules.

GET /admin/api/ecommerce/v1/cart_rules

Example response:

Status: 200 OK

[
  {
    "id": 1,
    "enabled": true,
    "position": 1,
    "kind": "shipping_cost",
    "target_id": 1,
    "target_kind": "shipping_method",
    "conditions": [
      {
        "value": "10.0",
        "comparator": ">",
        "field": "items_subtotal_amount",
        "value_type": "decimal"
      }
    ],
    "result": {
      "value": "1.0",
      "field": "shipping_subtotal_amount",
      "value_type": "decimal"
    },
    "valid_from": null,
    "valid_to": null,
    "created_at": "2020-05-26T09:34:40.000Z",
    "updated_at": "2020-05-26T09:34:40.000Z"    
  }
]

Filter attributes

List attributes of a cart_rule

GET /admin/api/ecommerce/v1/cart_rules/1

Example request:

GET http://helloworld.voog.com/admin/api/ecommerce/v1/cart_rules/1

Example response:

Status: 200 OK

{
  "id": 1,
  "enabled": true,
  "position": 1,
  "kind": "shipping_cost",
  "target_id": 1,
  "target_kind": "shipping_method",
  "conditions": [
    {
      "value": "10.0",
      "comparator": ">",
      "field": "items_subtotal_amount",
      "value_type": "decimal"
    }
  ],
  "result": {
    "value": "1.0",
    "field": "shipping_subtotal_amount",
    "value_type": "decimal"
  },
  "valid_from": null,
  "valid_to": null,
  "created_at": "2020-05-26T09:34:40.000Z",
  "updated_at": "2020-05-26T09:34:40.000Z"    
}

Create a new cart_rule for the current site

POST /admin/api/ecommerce/v1/cart_rules

Example data:

{
  "kind": "shipping_cost",
  "target_id": 1,
  "target_kind": "shipping_method",
  "conditions": [
    {
      "value": "10.0",
      "comparator": ">",
      "field": "items_subtotal_amount",
      "value_type": "decimal"
    }
  ],
  "result": {
    "value": "1.0",
    "field": "shipping_subtotal_amount",
    "value_type": "decimal"
  }
}

Example response:

Status: 201 Created

{
  "id": 1,
  "enabled": true,
  "position": 1,
  "kind": "shipping_cost",
  "target_id": 1,
  "target_kind": "shipping_method",
  "conditions": [
    {
      "value": "10.0",
      "comparator": ">",
      "field": "items_subtotal_amount",
      "value_type": "decimal"
    }
  ],
  "result": {
    "value": "1.0",
    "field": "shipping_subtotal_amount",
    "value_type": "decimal"
  },
  "valid_from": null,
  "valid_to": null,
  "created_at": "2020-05-26T09:34:40.000Z",
  "updated_at": "2020-05-26T09:34:40.000Z"      
}

Parameters

enabled — Flag switching the cart rule on or off, true by default.
position - An integer determining the cart rule's execution order.
kind - Cart rule type, currently only shipping_cost is supported.
target_id - Rule target ID.
target_kind - Rule target type, currently only shipping_method is supported.
conditions - An array of objects with the following fields. Note that all conditions must match for the rule to take effect.
- field - Name of the cart field to compare against value.
- comparator - Comparison operator, one of <, <=, ==, >=, >.
- value - Comparison value.
- value_type - Comparison value type, currently only decimal is supported.
result - An array of objects with the following fields:
- field - Name of the cart field to modify.
- value - Override value.
- value_type - Override value type, currently only decimal is supported.
valid_from - Currenty unsupported.
valid_to - Currenty unsupported.

Update attributes of a cart_rule

PUT /admin/api/ecommerce/v1/cart_rules/1

This request updates the cart rule with the provided attributes.

Example request:

PUT http://helloworld.voog.com/admin/api/ecommerce/v1/cart_rules/1

Example data:

{
  "kind": "shipping_cost",
  "target_id": 1,
  "target_kind": "shipping_method",
  "conditions": [
    {
      "value": "10.0",
      "comparator": ">",
      "field": "items_subtotal_amount",
      "value_type": "decimal"
    }
  ],
  "result": {
    "value": "1.0",
    "field": "shipping_subtotal_amount",
    "value_type": "decimal"
  }
}

Example response:

Status: 200 OK

{
  "id": 1,
  "enabled": true,
  "position": 1,
  "kind": "shipping_cost",
  "target_id": 1,
  "target_kind": "shipping_method",
  "conditions": [
    {
      "value": "10.0",
      "comparator": ">",
      "field": "items_subtotal_amount",
      "value_type": "decimal"
    }
  ],
  "result": {
    "value": "1.0",
    "field": "shipping_subtotal_amount",
    "value_type": "decimal"
  },
  "valid_from": null,
  "valid_to": null,
  "created_at": "2020-05-26T09:34:40.000Z",
  "updated_at": "2020-05-26T09:34:40.000Z"
}

Parameters

enabled — Flag switching the cart rule on or off, true by default.
position - An integer determining the cart rule's execution order.
kind - Cart rule type, currently only shipping_cost is supported.
target_id - Rule target ID.
target_kind - Rule target type, currently only shipping_method is supported.
conditions - An array of objects with the following fields. Note that all conditions must match for the rule to take effect.
- field - Name of the cart field to compare against value.
- comparator - Comparison operator, one of <, <=, ==, >=, >.
- value - Comparison value.
- value_type - Comparison value type, currently only decimal is supported.
result - An array of objects with the following fields:
- field - Name of the cart field to modify.
- value - Override value.
- value_type - Override value type, currently only decimal is supported.
valid_from - Currenty unsupported.
valid_to - Currenty unsupported.

Remove a cart_rule

DELETE /admin/api/ecommerce/v1/cart_rules/1

This request deletes the given cart_rule.

Example request:

DELETE http://helloworld.voog.com/admin/api/ecommerce/v1/cart_rules/1

Example response:

Status: 204 No Content