Storefront Configuration
This page describes the following elements:
Global-e Module Javascript
Below is a suggested way of loading the Bespoke JavaScript library asynchronously on your site:
Integration Environment
<script id="globaleScript"> (function () { var s = document.createElement('script'); s.type = 'text/javascript'; s.async = true; s.src = '//intgepi.bglobale.com/includes/js/{merchant id}'; document.getElementsByTagName('head')[0].appendChild(s); })(); </script>
Production Environment
<script id="globaleScript"> (function () { var s = document.createElement('script'); s.type = 'text/javascript'; s.async = true; s.src = '//gepi.global-e.com/includes/js/{merchant id}'; document.getElementsByTagName('head')[0].appendChild(s); })(); </script>
The above snippets will ensure that the Bespoke JavaScript module will load asynchronously and not block your current page rendering.
Note
Replace {merchant id} at the end of the URL with the merchant ID provided to you by Global-e.
The Global-e Module CSS
You must place the Bespoke CSS on your site’s header.
The following example is the Bespoke CSS you must use in your Integration environment:
<link id="GEPIStyles" rel="stylesheet" href="//intgepi.bglobale.com/includes/css/{merchant id}" />
The following example is the Bespoke CSS you must use in your Production environment:
<link id="GEPIStyles" rel="stylesheet" href="//gepi.global-e.com/includes/css/{merchant id}" />
Note
Replace {merchant id} at the end of the URL with the merchant ID that Global-e gave you.
Mandatory Developments
The following table shows the mandatory developments:
Feature | Description |
---|---|
Pricelist | You must be able to retrieve the country from the Global-e Module cookie to use the relevant pricelist on the front-end |
My account currency conversion | The following parameters are required to correctly convert currencies in the My Account or My Orders sections:
|
Client analytics | See the GEM client snippet. |
Google Shopping feed | |
Cookies | The following cookies are required:
|
Browsing
This section describes Centra's browsing elements.
Global-e Browsing Elements
Global-e supports the following browsing elements:
Welcome pop-up
Country switcher
Free shipping banner
For more information, see Site Customization.
Global-e Storefront Attributes
The Global-e storefront attributes are described on the Storefront Attributes page.
Calculating Prices
Global-e supports calculating both dynamic prices and fixed prices.
Dynamic price calculations are based on pricelists created by merchants using Centra's back-office.
You must use this set of configurations to properly support price conversions:
All Global-e markets must be assigned to a pricelist. Global-e automatically assigns Centra's default pricelist for unassigned markets.
All pricelists used for Global-e markets must be set in your base currency.
Fixed price calculations are supported per country and is based on Centra's native pricelist creation.
You must follow these rules when setting their fixed prices:
Each country's fixed prices must be set with its respective currency as configured by Global-e.
The geolocation must be set according to the country's fixed prices.
All fixed prices must be set on the country's catalog.
Products
Product Restrictions
As with other Global-e Module (GEM) integrations, we support merchants restricting purchases of checkout items to specific countries based on regulations or commercial restrictions. We support restrictions at the Checkout level.
For more information on product restrictions, see. Restricted Products
Pre-Ordering Items
You can sell pre-order items if needed, and can enable them by selecting the stock section checkbox for the required item.
Merchants must pass the pre-order attribute indication for the relevant products.
Note the following:
We do not validate stock in the order stock validation phase for items identified as pre-order.
Items identified as pre-order must be marked in Centra as PreOrder. Items not marked as PreOrder will be a Failed Transfer to Merchant (FTM). Merchants must mark pre-order items in both Global-e and Centra.
Product Attributes
Global-e supports the following product attributes:
Product name
HS code
Country of origin
Weight
Brand
Description
Note
We do not support custom fields.
Cart
Sending Language to Checkout
Global-e supports sending language to Checkout with GEM capabilities. For more information, see Global-e Checkout Language.
Clearing Your Cart
Global-e supports clearing your cart with GEM capabilities. For more information, see Clearing your Cart.
Applying Discounts
Centra supports several discount types that may include multiple rules and dependencies. You can specify these conditions while creating both vouchers and campaigns.
Checkout
Stock Validation
When you place an order in Checkout, the Global-e plug-in runs a stock validation based on Centra's stock to see if the item is available. This process does not occur for pre-order items.
Discounts
The supported discount types described in Applying Discounts apply to the Checkout capabilities as well. Only voucher code discounts are available, and consumers use these codes during Checkout, and discounts are applied when the checkout is complete.