> ## Documentation Index
> Fetch the complete documentation index at: https://enterprise-docs.bglobale.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Merchandising

## Global‑e Promotions

Global‑e has added and configured the following conditions to Hybris:

* Set the Global‑e shipping country as a condition
* Set the country-specific exclusion condition
* Apply the currency conversion to a fixed discount
* Apply the free shipping coupon

**To create a new promotion:**

1. Log in to Backoffice.
2. Go to **Marketing Promotion Rules > Create New Promotion Rule**.
3. Select the **Conditions and Actions** tab.

   <Frame>
     <img src="https://mintcdn.com/globale-enterprise/j_QcUA5HG17m29tL/images/uuid-fc553c81-7ecf-cb99-788f-f88b9d287fa0.jpg?fit=max&auto=format&n=j_QcUA5HG17m29tL&q=85&s=15d4d998fca4d0a2b3d63e9ce29b9f47" width="1911" height="758" data-path="images/uuid-fc553c81-7ecf-cb99-788f-f88b9d287fa0.jpg" />
   </Frame>
4. Add the details of the promotions: Code, Name, and Description.

   <Frame>
     <img src="https://mintcdn.com/globale-enterprise/vhiwVFSofQQTfWIF/images/uuid-97510758-4319-2cf3-d515-21f16a71fbc7.jpg?fit=max&auto=format&n=vhiwVFSofQQTfWIF&q=85&s=909b4bed3bf7e3ac576be775dc9f2a14" width="1249" height="120" data-path="images/uuid-97510758-4319-2cf3-d515-21f16a71fbc7.jpg" />
   </Frame>

### Example of Promotion #1

**10% off all products excluding Global-e operated countries**

1. Under the **Conditions and Actions** tab, expand the **Condition** section.

   1. Under **Available Conditions** (right menu), select **Operated by Global-E**.
   2. Under Operated by Global-e, select **false**.

      <Frame>
        <img src="https://mintcdn.com/globale-enterprise/m-danU3qGDNcAi-V/images/uuid-21622fc3-a07c-f615-86b5-43e05b7bf667.jpg?fit=max&auto=format&n=m-danU3qGDNcAi-V&q=85&s=3000379da10a9a41216e1b358f262beb" width="1652" height="448" data-path="images/uuid-21622fc3-a07c-f615-86b5-43e05b7bf667.jpg" />
      </Frame>
2. Go to the **Actions** section.

   1. Select the action '**Percentage discount on cart**'.
   2. Under Percentage discount value, specify % off.

      <Frame>
        <img src="https://mintcdn.com/globale-enterprise/m-danU3qGDNcAi-V/images/uuid-2827b68b-bb38-e1ec-9529-aa4f583ac22a.jpg?fit=max&auto=format&n=m-danU3qGDNcAi-V&q=85&s=c99fa7177e8f57ad84e0bb0f76a12c53" width="1647" height="442" data-path="images/uuid-2827b68b-bb38-e1ec-9529-aa4f583ac22a.jpg" />
      </Frame>
   3. Click **Save**.
3. To set a promotion live, click the **Publish** icon (on the right).

   To stop or deactivate the promotion click the 'Archive' button next to the bin.

   <Frame>
     <img src="https://mintcdn.com/globale-enterprise/4kLlWOCKssl9AEZa/images/uuid-c14a7c43-d586-0f13-1a6d-5643248ea560.jpg?fit=max&auto=format&n=4kLlWOCKssl9AEZa&q=85&s=79dd386ae09108296497bf223780d206" width="296" height="94" data-path="images/uuid-c14a7c43-d586-0f13-1a6d-5643248ea560.jpg" />
   </Frame>
4. Refresh your website.

   The messaging should appear in the cart.

   You can also see the adjustment of the total price.

### Example of Promotion #2

**10EUR off 100EUR minimum spent on all products in Germany**

1. Select the **Conditions and Actions** tab.

   <Frame>
     <img src="https://mintcdn.com/globale-enterprise/SJpQAWts8R8ncyo4/images/uuid-0689c863-74e3-cdb7-6696-1ffdb5df2fbc.jpg?fit=max&auto=format&n=SJpQAWts8R8ncyo4&q=85&s=201e98d37ce1e369bb23f0a6f3a3acce" width="1664" height="786" data-path="images/uuid-0689c863-74e3-cdb7-6696-1ffdb5df2fbc.jpg" />
   </Frame>
2. In the **Conditions** area, select a condition:

   1. Under Available Conditions (right menu), select **Qualifying Countries**.
   2. In the main area, set:

      Countries: **Germany**

      Cart total value, in the EUR field: **100**

      Operator: **IN**
3. Select a second condition:

   1. Under Available Conditions, select **Cart Total**.
   2. In the main area, set:

      Cart total value, in the EUR field: **100**

      Operator: **>=**
4. In the **Actions** area, create the action **Absolute Discount Value**:

   1. Go to **Fixed discount on cart** > **Absolute discount value** >
   2. In the **EUR** field, set the value **10**

      <Frame>
        <img src="https://mintcdn.com/globale-enterprise/SJpQAWts8R8ncyo4/images/uuid-0113b051-6419-dbee-7313-8e907ca9c968.jpg?fit=max&auto=format&n=SJpQAWts8R8ncyo4&q=85&s=c239934969327efe203a1e4eb91be051" width="1644" height="437" data-path="images/uuid-0113b051-6419-dbee-7313-8e907ca9c968.jpg" />
      </Frame>

<Note>
  Note that the Promotion feature is country-specific.

  Hence, if the checkout currency is different from the promotion currency,

  Global‑e conversion rates are applied. This rate is rounded to two decimal places.
</Note>

### Example of Promotion #3

**Free Shipping Coupon**

1. In the Conditions area, under Available Conditions (right menu), select the condition **Coupon Code**.
2. Select the trigging coupon name. Example: FREE\_SHIPPING to be filled in between brackets \[]

   <Frame>
     <img src="https://mintcdn.com/globale-enterprise/4kLlWOCKssl9AEZa/images/uuid-df8471a8-586b-bf5c-3c9c-f285bae978ce.jpg?fit=max&auto=format&n=4kLlWOCKssl9AEZa&q=85&s=6667d74d72b1feb10b461a381aca827b" width="1648" height="458" data-path="images/uuid-df8471a8-586b-bf5c-3c9c-f285bae978ce.jpg" />
   </Frame>
3. In the Actions area, under **Change delivery mode**, enter **free-standard-shipping**.

   <Frame>
     <img src="https://mintcdn.com/globale-enterprise/j_QcUA5HG17m29tL/images/uuid-e1f53584-c23e-fa4f-b1e9-354d0e834e78.jpg?fit=max&auto=format&n=j_QcUA5HG17m29tL&q=85&s=ac2c9a003655aa1011c054f3f4500e3e" width="1648" height="449" data-path="images/uuid-e1f53584-c23e-fa4f-b1e9-354d0e834e78.jpg" />
   </Frame>
4. Save and publish the promotion.
5. Add a product to the cart.
6. In the coupon field, enter FREE\_SHIPPING. Against the delivery, cost FREE is indicated.

   <Frame>
     <img src="https://mintcdn.com/globale-enterprise/hjqDl82-X0YUzXdP/images/uuid-88db97f4-e056-c8e7-7d5e-804c0367cd29.jpg?fit=max&auto=format&n=hjqDl82-X0YUzXdP&q=85&s=419c222e5568900dc048f4cc956f32e0" width="1891" height="633" data-path="images/uuid-88db97f4-e056-c8e7-7d5e-804c0367cd29.jpg" />
   </Frame>
7. Go back to the Global‑e iFrame checkout. A Free Delivery option is now available.

### Known Limitations

Care should be taken when creating a promotion where conversions are used.

Actions with fixed discounts will not be applied if neither store’s default currency - nor a promotion’s action currency matches a customer session currency.

For example, a discount is not be applied in the following cases:

* A promotion action with a fixed discount in USD
* The store’s default currency is EUR
* The customer cart currency is PLN

### Cookies Disabled

If customers do not enable cookies, they cannot change the default country and checkout via Global‑e.

Global‑e manages a range of cookies. The Global‑e add-on modifies one cookie to store the selected country, currency, and culture (GlobalE\_Data). This cookie is used in `GlobaleCookieToSessionFilter`.

### Solr: Sorting by Price and Price Range Facet

For price sorting and price range facets to work for Global‑e-managed-countries on the product listing and search pages, you must configure indexed currencies and price ranges.

Global‑e recommends configuring solr indexing only for the most frequently used currencies, such as the store’s default currency: EUR and USD.

For other Global‑e-managed currencies, Global‑e converts prices at the search page rendering stage.

The Solr index runs outside of the web session. As a result, Global-e misses the session’s country and falls back to a default shipping country (CMSSite.defaultShipToCountry) because the price conversion uses the default conversion coefficients.

This also affects fixed prices. If you have country-specific product fixed prices, the fixed prices are not indexed, unless the country is the default ship-to country.

To configure indexing. update your SolrFacetSearchConfig and create `SolrValueRangeSet` for the additional currency.

## Restricted & Forbidden Products

The product can either be set to '**Restricted**' or '**Forbidden**' for shipping or importing.

Restrictions concerning countries operated by Global‑e are enabled on the Global‑e side.

When specific products are restricted for shipping based on the customer's shipping country, the product cannot be sold in that particular country.

Products can also be restricted for shipping across all Global‑e managed countries. In that case, these 'forbidden' products are only available for purchase in countries that are not managed by Global‑e.

**Example in SAP Hybris:** **Shipping Restricted Products**

1. Add a restricted product to the cart.

   The following pop-up is displayed stating that the product cannot be added to the cart.

   <Frame>
     <img src="https://mintcdn.com/globale-enterprise/-95KX8vS1vYAnafZ/images/uuid-53c29dbb-dc33-1baf-fcef-76c98253e02f.jpg?fit=max&auto=format&n=-95KX8vS1vYAnafZ&q=85&s=47411d86f63e0c87b83d6fddeeb13fa5" width="864" height="888" data-path="images/uuid-53c29dbb-dc33-1baf-fcef-76c98253e02f.jpg" />
   </Frame>
2. If the customer still tries to click checkout, the empty cart page is displayed.

   <Frame>
     <img src="https://mintcdn.com/globale-enterprise/-95KX8vS1vYAnafZ/images/uuid-585c80ae-f4b3-4b63-ca5b-9eafb79dd0ca.jpg?fit=max&auto=format&n=-95KX8vS1vYAnafZ&q=85&s=3360012a5ead845cd9cb8b4ff4fd3b1e" width="2082" height="504" data-path="images/uuid-585c80ae-f4b3-4b63-ca5b-9eafb79dd0ca.jpg" />
   </Frame>

**Example in SAP Hybris:** **Shipping Forbidden Products**

1. Add a forbidden product to the cart.

   <Frame>
     <img src="https://mintcdn.com/globale-enterprise/SJpQAWts8R8ncyo4/images/uuid-08fffb26-0c77-863e-ad23-c6be760ed9e5.jpg?fit=max&auto=format&n=SJpQAWts8R8ncyo4&q=85&s=196f13fd50c98c2ee344a14f91d3c366" width="1508" height="1130" data-path="images/uuid-08fffb26-0c77-863e-ad23-c6be760ed9e5.jpg" />
   </Frame>
2. Navigate to the checkout page.

   <Frame>
     <img src="https://mintcdn.com/globale-enterprise/j_QcUA5HG17m29tL/images/uuid-e512dd7b-2012-a1ae-3082-fa83502dfb83.jpg?fit=max&auto=format&n=j_QcUA5HG17m29tL&q=85&s=8a2b680c6b94c968d5c8acd06e697bba" width="2558" height="1038" data-path="images/uuid-e512dd7b-2012-a1ae-3082-fa83502dfb83.jpg" />
   </Frame>

   <Frame>
     <img src="https://mintcdn.com/globale-enterprise/-95KX8vS1vYAnafZ/images/uuid-4b62a67f-1d61-d50d-5afe-d191f67babfb.jpg?fit=max&auto=format&n=-95KX8vS1vYAnafZ&q=85&s=3285171f963715aa6bf1b147ef19e1c5" width="2446" height="1116" data-path="images/uuid-4b62a67f-1d61-d50d-5afe-d191f67babfb.jpg" />
   </Frame>

   A forbidden message is displayed on the checkout page.
