Forwarding Promotions

Treazure Promo is capable of indicating customers are close to receiving discount. This is useful for e-commerce sites to increase sales.

Quantity increase

Indicates that a provided sale element will receive a discount when quantity is increased.

Conditions:

• Promotion is set up as forwarding enabled
• Promotion is financial
• Promotion has not more than 1 article filter
• Article filter quantity requirement is > 1
• All other promo conditions must match

Example request:

{
    "Request": {
        "CalculationMoment": "2025-06-03T11:30:23.181Z",
        "LanCode": "nl-NL",
        "Sales": [
            {
                "Amount": 5000,
                "ArticleId": "15150033",
                "Count": 2,
                "Uid": "a20f17c95fc5f2766f9e16abb5"
            }
        ],
        "SiteId": "0031"
    }
}

Example response:

{
    "ConfigurationSequenceNumber": 9,
    "Code": "Success",
    "Warnings": [],
    "ForwardingPromotions": [
        {
            "Ref": {
                "Uid": "a20f17c95fc5f2766f9e16abb5",
                "Code": "promo-forward-quantity"
            },
            "RequiresCount": 1,
            "Type": "Percentage",
            "Value": 3000
        }
    ]
}

Properties:

Name	Commentary
Uid	Unique request element id
Code	Promotion code of the forwarding promotion
RequiresCount	The quantity increase that is required to trigger the fowarding promotion
Type	Type of discount, Amount, Value or Percentage
Value	The value of said discount (e.g. 30%)

Minimum transaction amount

Indicates that a provided sale element will receive a discount when transaction amount is increased.

Hint

Note this feature applies to min transaction amount, not min amount configured on article filter

Conditions:

• Promotion is set up as forwarding enabled
• Promotion is financial
• Promotion has not more than 1 article filter
• All other promo conditions must match
• Promo has min transaction amount requirement

Example response:

{
    "ConfigurationSequenceNumber": 22,
    "Code": "Success",
    "Warnings": [],
    "ForwardingPromotions": [
        {
            "Ref": {
                "Uid": "a20f17c95fc5f2766f9e16abb5",
                "Code": "promo-forward-min-receipt-amount"
            },
            "RequiresReceiptAmount": 1000,
            "Type": "Percentage",
            "Value": 3000
        }
    ]
}

Properties:

Name	Commentary
Uid	Unique request element id
Code	Promotion code of the forwarding promotion
RequiresReceiptAmount	The receipt amount increase that is required to trigger the fowarding promotion
Type	Type of discount, Amount, Value or Percentage
Value	The value of said discount (e.g. 30%)

Customer card

Indicates that a provided sale element will receive a discount when a customer card is added.

Conditions:

• Promotion is set up as forwarding enabled
• Promotion is financial
• Promotion has not more than 1 article filter
• All other promo conditions must match
• Promo has customer card requirement

Example response:

{
    "ConfigurationSequenceNumber": 22,
    "Code": "Success",
    "Warnings": [],
    "ForwardingPromotions": [
        {
            "Ref": {
                "Uid": "a20f17c95fc5f2766f9e16abb5",
                "Code": "promo-forward-customer-card"
            },
            "RequiresCustomerCard": true,
            "RequiresCustomerLevelId": "card-level",
            "Type": "Percentage",
            "Value": 3000
        }
    ]
}

Properties:

Name	Commentary
Uid	Unique request element id
Code	Promotion code of the forwarding promotion
RequiresCustomerCard	Whether adding a customer card will trigger the fowarding promotion
RequiresCustomerLevelId	The required customer card level, if specified
Type	Type of discount, Amount, Value or Percentage
Value	The value of said discount (e.g. 30%)

Exclusions

Forwarding promotions are not issued when:

• Sale has received a discount from a different promotion (it will work with replication of same promotion)
• Promotion has stack tiers and tier is above first tier
• Promotion discount amount is calculated based on article set

Calculate over

Issued ForwardingPromotion result will indicate how the promotion issued will calculate discount.

{
    "ConfigurationSequenceNumber": 34,
    "Code": "Success",
    "Warnings": [],
    "ForwardingPromotions": [
        {
            "Ref": {
                "Uid": "a20f17c95fc5f2766f9e16abb5",
                "Code": "promo-forward-calculate-over"
            },
            "RequiresCount": 1,
            "Type": "Percentage",
            "Value": 3000,
            "CalculateOver": "MostCheap",
            "CalculateOverCount": 1
        }
    ]
}

Properties:

Name	Commentary
CalculateOver	How discount is calculated, either All (Proportionally), MostCheap, MostExpensive or AllItemsInTransaction (Financial Transaction promotion)
CalculateOverCount	Number of items discount is calculated over (when MostCheap or MostExpensive)