Skip to main content

Documentation Portal

Configuring the Centra Platform

This page describes the following elements:

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.

Validating Cart Currency

Global-e supports validating cart currency with GEM capabilities.

Clearing Your Cart

Global-e supports clearing your cart with GEM capabilities.

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.

Order Management

Configuring Local Tax Groups

Centra tax groups may consist of one or more tax rules, which set how much tax to apply to orders on the market level. While each store can have only one default tax group, merchants can configure as many as they want.

During integration, a local tax group must be made on the merchant's platform to ensure that all markets operated by Global-e include relevant VAT in orders.

Creating local tax groups

  1. Navigate to System > Tax Groups.

  2. Click Create tax group.

    The New tax group screen is displayed.

  3. Configure the following settings:

    • Status: Active

    • Name: GE Local VAT

    • Default in stores: <relevant default store>

  4. Click Save.

    The new tax group configuration page is displayed.

  5. Click Add tax rule and set the following configurations:

    • Name: GE Local VAT

    • Tax display name: GE Local VAT

    • Tax code: VAT

    • Apply tax per: Select Ship-to country

    • Geolocation: Select ALL and unselect markets operate by the merchant

    • Include tax: Select In prices displayed before and in the checkout

    • Apply tax to shipping fees: Yes

    • Apply tax to handling fees: Yes

    • Tax rate: Merchant Local VAT (for example, UK = 20%)

    • Include shipping cost to order total: Yes

  6. Click Save.

    The tax is displayed in Global-e orders.

Creating Orders

When Global-e uses the SendOrderToMerchant API, Centra's Order API is used to create the order in Centra. During this stage we include the relevant order data natively (when available in the API) or as an extra attribute.

Native Order Data

Natively added order data takes precedence and is classified along with the merchant's domestic orders. This data is only transmitted if the Order API supports the relevant fields.

The following order details are supported according to the method above:

  • Order date and time

  • Shipping address

  • Billing address

  • Customer information

  • Product information:

    • Product list price

    • Product price

  • Product Discounts (sum of all discounts)

  • Shipping method

  • Order transaction - When created, order payments are stored in the payment history only with the Auth indication. In this stage orders are unpaid before passing fraud validation.

The following figure shows the Order payment history:

Order_Payment_History.png
Extra Attributes

The data included in the Extra Attributes section must be preconfigured as described in the Integration Guide. The same Custom attribute (same name and structure) is implemented during each the QA/Staging phase of each merchant's integration, and deployed to Production by Centra developers. For any additional attributes that we add we must add a change in the configuration. This information is visible in the Other Information section of the order.

Global-e supports the following fields:

  • Global-e order ID

  • Global-e order total in the consumer's currency

  • Global-e order shipping cost in the customer's currency

  • Delivery days (from-to)

  • Code vouchers

  • Automatic vouchers

  • Cart item ID mapping (storing data used in webhooks)

  • Centra to Global-e order item mapping (storing date used in webhooks)

  • Order Duties and Taxes in the consumer's currency

Static Information

Static information is information that includes the same values for all orders belonging to a specific merchant:

  • Tax (Global-e local VAT) - a tax group set up in Centra according to the base country

  • Pricelist - always the default pricelist

Shipping Methods

During integration, our Solutions Engineer identifies the required shipping methods. Global-e uses the shipping code to display these shipping methods on your order form:

Mapping_Shipping_Methods.png

To correctly map your shipping methods to Global-e's, create your shipping methods using the values in Configuring Local Tax Groups.

Validating Payments

When an order is created in Centra, Global-e does the following:

  1. Validates that payment has been received for the order.

  2. Notifies the platform when the fraud check passes. Failed fraud checks cancel the order.

  3. Adds a new row in the Order payment history region:

    Validating_Payments.png
Cancelling Orders

Orders can be cancelled from Global-e to Centra, or from Centra to Global-e. When an order is cancelled Global-e restocks the inventory. Note that refunds are only created in Global-e and not in Centra.

When orders are cancelled from Centra to Global-e, you can restock items using native functionality without Global-e's assistance, and a refund is created in Global-e for the entire order amount.

Amending Items

You can cancel single products from orders by removing them from the order, or by reducing their quantity.