Manage market segments

Market segmentation is an internal convention used to inform the internal stakeholders about the product or business intent, to have one or more of the following differentiations:

These are the three market segments available for Adobe products:

Value
Description
COM
Commercial <br /> (default)
EDU
Education
GOV
Government

The education market segment mentioned in the above table is further divided into K-12, higher education, and non-profit, as listed in the following table:

Value
Description
Offers available to purchase
K_12
K-12 School (Primary or Secondary School)
- EDU offers without a sub-segment. <br /> - EDU offers with K-12 sub-segment.
HIGHER_ED
Higher Education Institution
- EDU offers without a sub-segment. <br /> - EDU offers with HED sub-segment.
NON_PROFIT
Non-profit Organization
- EDU offers without a sub-segment.

Note: The Additional Detail (Column P) in the price list file contains information on the sub-segment of an offer as well as the minimum purchase quantity, if applicable.

Example Additional Detail: K-12 Shared Device Site Education License Lab and Classroom (100+)

Market segment workflows

The following market segment workflows are available:

  1. Set market segments for resellers

    • Reseller market segments can be set as part of a create or update request.

    • A reseller’s market segments may be changed at any point, but removing a market segment may cause future orders or renewals to fail.

    • All existing resellers with no market segment can be initialized with only the COM market segment.

    • API endpoints for managing this workflow:

  2. Set market segment for customers

    • Customer market segment can be set as part of a create or update request.

    • A customer’s market segments can only be changed if the customer has no active subscriptions.

    • All existing customers with no market segment will be initialized to COM.

    • API endpoints for managing this workflow:

  3. Set market sub-segment for customers

    • A customer’s market sub-segment can only be set by the customer in the Adobe Admin Console.
    • Sandbox for testing the sub-segment can be set in the sandbox partner portal. Read more about Sandbox user guide.
    • API endpoints avaialable to manage this workflow: GET Customer API.
  4. Transfer customers to your marketplace (Customer only)

    • Customers with any market segment can be transferred as long as the new reseller is enabled to sell into the customer’s market segment. API endpoints available to manage this workflow:

  5. Purchase offers for a market segment or sub-segment

    • Customers may only purchase offers in their market segment or subsegment.
    • Resellers may only purchase offers in a market segment they are enabled for.
    • Requests to purchase offers in a different segment returns the error 2129 – Reason Code: INELIGIBLE_MARKET_SEGMENT.
    • API endpoint to manage this workflow: POST Create/Preview Order API

New or updated error codes are listed in the following table:

Error Code
Error Message
Applicable APIs
Change Details
2135 <br /> (new error code)
Invalid market segment is used for the customer.
Create Customer, Update Customer
New Error Code
2129 <br /> (existing error code)
Customer is not eligible to purchase an offer.
Preview Order, Create Order
New Additional Details Reason Code: INELIGIBLE_MARKET_SEGMENT

Market segment API changes

Changes to Reseller Resource

Changes to Customer Resource