Flexible Discounts

The Flexible Discount feature allows partners to adjust product prices making them more attractive to different customer segments. There are two types of flexible discounts:

  • Percentage Discount: A percentage reduction (e.g., 10% off) is applied to the product's base price.

  • Fixed Discount: A fixed monetary reduction (e.g., $20 off) is applied to the product's base price.

Feature Activation and Configuration

Distributors can manage the Flexible Discounts functionality using specific configuration parameters within CloudBlue Connect, which are set at the Marketplace level.

Parameter ID Parameter Name Scope / Phase Description
flex_fixed_promotions_available Flexible fixed promotions available Marketplace/Configuration Allows distributors to activate fixed flexible discounts per marketplace.
flex_percent_promotions_available Flexible percentage promotions available Marketplace/Configuration Allows distributors to activate percentage flexible discounts per marketplace.
allow_auto_apply_flex_discounts Allow auto apply flexible discounts Marketplace/Configuration If activated, the connector will automatically discover and apply flexible discounts.
flex_disc_console_available_tiers Flexible Discounts Available Tiers Marketplace/Configuration

Enables distributors to authorize specific resellers to view flexible discount information in the Adobe Reseller Console. Enter a comma-separated list of Tier Account IDs, or use the value 'ALL' to grant access to all resellers.

Eligibility

Flexible discounts are offered to all VIP Marketplace customers, even if they already benefit from other price adjustments (e.g., volume discounts or Linked Memberships). Eligibility is still subject to other factors, such as the market segment and country.

Important: On this initial release, CloudBlue will only apply flexible discounts to the direct-bill partner cost.

Discount Application Methods

Discovering and Applying Discounts Automatically

When an order is placed, and the feature is enabled via the configuration parameters above:

  1. The connector calls the Adobe API to retrieve all available flexible discounts for the order items.

  2. If multiple discount codes are returned for the same base Offer ID, the connector performs an order preview with each code to determine the value.

  3. The connector automatically selects and applies the most favorable discount to the corresponding Offer ID in the order.

Note on visibility: The flex_disc_console_available_tiers parameter controls which resellers can view flexible discount information in the Adobe Reseller Management Console. If a reseller's Tier ID is not authorized by the distributor, this information will be hidden.

Specifying Flexible Discounts Manually (API Only)

Distributors can bypass the auto-discovery process and explicitly define which flexible discounts to apply using an ordering parameter when submitting an order via the API.

Parameter ID Parameter Name Scope/Phase Description
flex_discounts_selected Flexible Discounts Selected Ordering/Subscription This parameter is used to explicitly define the flexible discounts to apply to specific offers within an order.
Key Behavior:
  • Disables Auto-Discovery: Using this parameter always overrides and disables the automatic discount discovery process, even if the allow_auto_apply_flex_discounts parameter is active.

  • API Only: This parameter can only be used when submitting an order via the API.

Parameter Structure and Validation
  • Structure: The parameter accepts an object where the key is the MPN ID, and the value is an array of zero, one, or multiple discount codes to apply to that MPN.

    	{
    		    "65304768CA": ["ADOBE_ALL_PROMOTION", "EASTER_26"],
    		    "65304520CA": ["ADOBE_ALL_PROMOTION", "BLACK_FRIDAY_20_FAILURE_1"]
    	}
  • Validation: The connector uses the Adobe Order Preview API to confirm the validity of all Base Offer IDs and their associated discount codes.

  • Application Scope: Discounts are only applied to products corresponding to the MPN IDs explicitly listed in this parameter. Any valid discount found by the validation service for a product not included in the flex_discounts_selected parameter will be ignored.

Tracking Parameters in CloudBlue Connect

Parameter ID Parameter Name Scope Phase Description
cb_flex_discount_draft Flexible discounts Final Ordering Subscription

Parameter used to generate a preselected list of available discounts. For example:

{ "key": "cb_flex_discount_draft",
  "structured_value": 
  {
    "discounts":
    [
      {
        "mpn": "65304768CA",
        "id": "55555555-8768-4e8a-9a2f-fb6a6b08f563",
        "code": "EASTER_26",
        "application_type": "FULL_CHAIN",
        "discounts": [
          {
            "type": "FIXED_DISCOUNT",
            "values": [
              {
                "discountValue": 26,
                "discountCurrency": "USD"
              }
            ]
          ]
        }
      },
      {
        "mpn": "65304768CB",
        "id": "55555555-8768-4e8a-9a2f-fb6a6b08f564",
        "code": "ADOBE_ALL_PROMOTION",
        "application_type": "FULL_CHAIN",
        "discounts": [
          {
            "type": "PERCENTAGE_DISCOUNT",
            "values": [
              {
                "discountValue": 5
              }
            ]
          ]
        }
      },
    ...
    ]
  }
}

Below is a description of the fields in the JSON object:

  • MPN: The Adobe Manufacturer Product Number to which the discount applies.

  • id: The unique identifier for the discount.

  • code: The specific discount code to be applied.

  • Application type: Defines who receives the discount. Defaults to FULL_CHAIN.

    Important: On this initial release, CloudBlue will only apply flexible discounts to the direct-bill partner cost.

  • Discount type: Must be either PERCENTAGE_DISCOUNT or FIXED_DISCOUNT.

  • Discount value: The numerical value of the discount (either a percentage or a flat amount).

  • Discount currency: The ISO currency code. Required if discountType is set to FIXED_DISCOUNT.

cb_flex_discount_final Flexible discounts Final Fulfillment Subscription

Provides a detailed breakdown of the applied discounts for each MPN (Manufacturer Part Number) within the order.

For additional details on the fields in the JSON object, see the description of the cb_flex_discount_draft parameter above.

Example:

{ "key": "cb_flex_discount_final",
  "structured_value": 
  {
    "discounts":
    [
      {
        "mpn": "65304768CA",
        "id": "55555555-8768-4e8a-9a2f-fb6a6b08f563",
        "code": "EASTER_26",
        "application_type": "FULL_CHAIN",
        "discounts": [
          {
            "type": "FIXED_DISCOUNT",
            "values": [
              {
                "discountValue": 26,
                "discountCurrency": "USD"
              }
            ]
          ]
        }
      },
      {
        "mpn": "65304768CB",
        "id": "55555555-8768-4e8a-9a2f-fb6a6b08f564",
        "code": "ADOBE_ALL_PROMOTION",
        "application_type": "FULL_CHAIN",
        "discounts": [
          {
            "type": "PERCENTAGE_DISCOUNT",
            "values": [
              {
                "discountValue": 5
              }
            ]
          ]
        }
      },
    ...
    ]
  }
}
flex_discounts_auto_applied Flexible discounts auto-applied Fulfillment Subscription
  • True indicates discounts were automatically discovered and applied by CloudBlue.

  • False indicates the discounts specified in the cb_flex_discounts_selected parameter were used instead.