DELETE Marketing/RemovePromotionItem

Removes an existing PromotionItem.

Request Information

URI Parameters

None.

Body Parameters

PromotionItemBinding
NameDescriptionTypeAdditional information
ID

integer

None.

Disabled

date

None.

ValidFrom

date

None.

Expiration

date

None.

PromotionID

integer

None.

Amount

The unitary amount to apply. If null, use DiscountPercent

decimal number

None.

DiscountPercent

decimal number

Range: inclusive between 0 and 1

MinimumOrderAmount

The minimum required order amount to apply this promotion

decimal number

None.

MinimumQuantity

Sets the minimum number of such an item that the discount can be applied to in the same purchase.

decimal number

None.

QuantityStep

Sets the number of items that have to be grouped together to apply the discount

decimal number

None.

MaximumQuantity

Sets the maximum number of products that the discount can be applied to in the same purchase.

decimal number

None.

Cumulative

Set if this promotionItem applies after other main promotion

boolean

None.

AutoAddRemoveQuantity

If the conditions of this promoItem are (not) met, the PromotedEntity(ies) gets automatically added/removed to/from the order

decimal number

None.

PromotionableTypeID

Defines the set of Products included in this promo. The set can be defined at the Store, Classification or Product level

integer

None.

PromotionableID

integer

None.

IncludeDescendants

Includes PromotionableEntity descendants

boolean

None.

Lang

string

None.

StoreID

integer

None.

Request Formats

application/json, text/json

Sample:
{
  "ID": 1,
  "Disabled": "2025-12-06T09:16:22.8451855+01:00",
  "ValidFrom": "2025-12-06T09:16:22.8451855+01:00",
  "Expiration": "2025-12-06T09:16:22.8451855+01:00",
  "PromotionID": 3,
  "Amount": 1.0,
  "DiscountPercent": 1.0,
  "MinimumOrderAmount": 4.0,
  "MinimumQuantity": 5.0,
  "QuantityStep": 6.0,
  "MaximumQuantity": 1.0,
  "Cumulative": true,
  "AutoAddRemoveQuantity": 8.0,
  "PromotionableTypeID": 9,
  "PromotionableID": 10,
  "IncludeDescendants": true,
  "Lang": "sample string 12",
  "StoreID": 13
}

application/xml, text/xml

Sample:
<PromotionItemBinding xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/ShopworldApi.Admin.Models.Binding.Marketing">
  <Lang xmlns="http://schemas.datacontract.org/2004/07/ShopworldApi.Admin.Models.Common.Base">sample string 12</Lang>
  <StoreID xmlns="http://schemas.datacontract.org/2004/07/ShopworldApi.Admin.Models.Common.Base">13</StoreID>
  <Amount>1</Amount>
  <AutoAddRemoveQuantity>8</AutoAddRemoveQuantity>
  <Cumulative>true</Cumulative>
  <Disabled>2025-12-06T09:16:22.8451855+01:00</Disabled>
  <DiscountPercent>1</DiscountPercent>
  <Expiration>2025-12-06T09:16:22.8451855+01:00</Expiration>
  <ID>1</ID>
  <IncludeDescendants>true</IncludeDescendants>
  <MaximumQuantity>1</MaximumQuantity>
  <MinimumOrderAmount>4</MinimumOrderAmount>
  <MinimumQuantity>5</MinimumQuantity>
  <PromotionID>3</PromotionID>
  <PromotionableID>10</PromotionableID>
  <PromotionableTypeID>9</PromotionableTypeID>
  <QuantityStep>6</QuantityStep>
  <ValidFrom>2025-12-06T09:16:22.8451855+01:00</ValidFrom>
</PromotionItemBinding>

application/x-www-form-urlencoded

Sample:

Sample not available.

Response Information

Resource Description

IHttpActionResult

None.

Response Formats

application/json, text/json, application/xml, text/xml

Sample:

Sample not available.