YOM Docs

• Integration guides
  • Integration methods
    • API integration
    • File integration
  • Entities
    • Categories
    • Distribution Center
    • Commerces
    • Loaned Equipment
    • Delivery cost
    • Credit
    • Tax Documents
    • Discount limit
    • Payments
    • Products
    • Promotions
    • Segments
    • Overrides
    • Stock
    • Supervisors
    • Transactions
    • Sellers
  • Webhooks
    • Technical requirements
    • Customer-to-YOM Webhooks
      • Order modification
      • Bulk stock upload
      • Bulk order modification
    • YOM-to-customer Webhooks
      • Orders
      • Payments
      • Minimum order
      • Delivery price
      • Returns
      • Loaned Equipment
      • Commerce creation
  • Changelog
  • Recommendations Extraction API
    • Authentication
    • Recommendations
    • Best practices
• Settings

Promotions

Promotions in YOM represent the pricing strategies applied to the Products of a specific Segment in order to drive sales. This model lets you define discounts, gifts, and other promotional rules associated with Commerces, Segments or groups of Products.

What is the purpose of a Promotion?

It is a way to promote and encourage the consumption of certain Products. It is also a way to reward Commerces.

Endpoint

GET /api/promotion

FILE <fecha>_<hora>_promotion.csv

Duration

Each Promotion has a validity period defined by a date range. This lets you control when the Promotion will be active on the platform according to your commercial strategies.

Scope

Promotions can target different groups of Products or commercial Segments, depending on the needs of the business. Their different objectives are explained below.

<aside> <img src="/icons/hair-care_gray.svg" alt="/icons/hair-care_gray.svg" width="40px" />

Products

Applies to a Product or set of Products by its unique identifier or SKU.

Example → Discounts on the Product Milk PROD006 and Detergent PROD124

</aside>

<aside> <img src="/icons/circle-five-eighths_gray.svg" alt="/icons/circle-five-eighths_gray.svg" width="40px" />

Segments

Lets you target Promotions to a defined Segment of Commerces that share specific characteristics.

Example → Discounts on the Segment Bakeries SEG001 or Wholesalers SEG100.

</aside>

We can also think of this scope as filters: a filter by commerce (Segmentos) and a filter by products (Productos, Categorías and Marcas). Within the product filters you can combine criteria to narrow the promotion's scope, for example:

<aside> ⚠️

</aside>

<aside> ⚠️

</aside>

Types