Global-e Integration Overview

Julie  Houlton
Julie Houlton
  • Updated

In this article: 

Global-e-1.png

Benefits 

With Whiplash and Global-e working together, you can ship your products internationally as easily as you can ship them locally.

Global-e will: 

  • Take care of currency conversion, import duty, taxes, international fraud, and global logistics.
  • Provide a seamless checkout process for your consumers.
  • Display Global-e’s shipping rates right in your consumers’ shopping carts.

To get started, see a list of Whiplash’s requirements for this integration and next steps on our Global-e Integration Pre-Setup Questionnaire.

How it works

There are two different workflows, depending on how you’re connected to Whiplash:

Global-e integration using the Shopify | Whiplash app connector

Global-e-Shopify.png

1.   An international Global-e order is created in the customer’s e-commerce platform (Shopify).

  • Initial payment status = PENDING
  • Order tag = Globale::Pending

2.   Global-e does its fraud check on the order.

3.   Once the fraud check is successful, the order’s payment status moves to PAID and the Pending order tag is replaced with Globale::Approved

4.   Whiplash imports the Global-e order with PAID status and with the Globale::Approved tag. It’s critical to only import paid Global-e orders for orders to flow correctly.

Warning.png Do not import orders with status of:

  • Any
  • Unpaid
  • Pending
  • Authorized

To view the order payment status(es) that are setup to be imported into Whiplash: 

Go to Preferences (under Customer) > Shops > Settings > Order Item and Property Syncing section. View the highlighted settings under Import orders with payment status.

Import orders with payment status.png

See Shopify Integration - Whiplash Shop Settings for more information.

5.  Whiplash warehouse team identifies the Global-e order via the order name and/or ship method.

6.  Order is batched in Whiplash, and items are picked and packed at the warehouse.

7.  During pack, the warehouse team retrieves the shipping label and paper commercial invoice (if applicable) from Global-e and prints them. Only select countries require paper invoices for shipments.

Whiplash requires ZPL format for shipping labels.

8.  Warehouse team performs end of day manifest process to dispatch the shipment.

9.  Warehouse team sends the shipment using a Global-e arranged driver.

Global-e integration using the Whiplash API

Global-e-API.png

1.   An international Global-e order is created in the customer’s e-commerce platform.

2.   Global-e, e-commerce platform, and the ERP processes the order.

Once processes are complete, the ERP completes its transformation per the Whiplash specifications and sends it to Whiplash via the API.

There are three Global-e-specific attributes in the Whiplash API:

API attribute name Attribute definition

order_orig

string

the order original id (from the shop that sent whiplash the order)

Note: contains the global-e order id for any global-e order.

global_e_ge_order

boolean

is the order a global_e order?

shop_shipping_method_text

string

the order shop shipping method text

ge_standard = order uses global-e standard shipping method

ge_express = order uses global-e express shipping method

Note: These API global-e values will not match the global-e official shipping method mappings set up in the UI.

3.   Whiplash warehouse team identifies the Global-e order via the order name and/or ship method.

4.   Order is batched in Whiplash, and items are picked and packed at the warehouse.

5.   During pack, the warehouse team retrieves the shipping label and paper commercial invoice (if applicable) from Global-e and prints them. Only select countries require paper invoices for shipments.

Whiplash requires ZPL format for shipping labels.

6.   Warehouse team performs end of day manifest process to dispatch the shipment.

7.   Warehouse team sends the shipment using a Global-e arranged driver.

For more information about this integration, reach out to your Whiplash Customer Success Manager for details.

 

Setup instructions

Before starting the setup process, customers must have an active Global-e account. See the Global-e Integration Pre-Setup Questionnaire for more specifics.

These four steps explain how to set up an integration between a customer's online store, Whiplash, and Global-e.

 

Number1.png Customer sends required information to the Whiplash Customer Success team

Technical information

  • Customer's Global-E customer GUID for both the Sandbox environment and Production environment.
  • Confirmation that the customer is connected to the Whiplash platform – either through Shopify or through the Whiplash API.

Warning.pngCustomer's test environment must be connected to the Whiplash sandbox environment.

Shipping-related information

  • Customer’s procedure(s) to handle exceptions:
      • short-pick management
      • insufficient inventory managing
  • List of shipping methods to be used so the proper mapping is set up in Whiplash. Shipping methods include:
      • Global-e Standard
      • Global-e Express
  • Confirmation of who will post fulfillments to e-commerce platform – Whiplash or Global-e?
      • Whiplash: No change needed
      • Global-e: If using Shopify connection, Whiplash will need to suppress fulfillments. If using the Whiplash API, it will vary by customer.

 

Number2.png Set Up on Whiplash

Whiplash team completes the setup on the Whiplash application.

Whiplash team or the customer reviews the defined routing rules to ensure they follow the limited actions that Whiplash allows for Global-e orders – regardless of workflow. It’s recommended to exclude Global-e orders from any rules that add items, split orders, etc.

 

Number3.png Validation and User Acceptance Testing

1.   Whiplash team configures a Global-e connection on the sandbox environment.

2.   Global-e, the customer, and Whiplash will work together to perform end-to-end testing process to ensure the integration works as expected.

Whiplash onboarding team will need to support the validation procedures. Testing requires performing packing, shipping, and creating manifests.

 

Number4.png Go live

1.   Whiplash team aligns with Global-e and the customer on a go-live plan.

2.   Whiplash team and Global-e prepare the production environment based on information received earlier in the Setup process.

3.   Whiplash team performs golden transactions. These are the first set of orders to validate that everything is working as expected.

 

FAQs

Can Global-e orders be manually added within Whiplash? 

No, orders that use Global-e shipping cannot be manually created in Whiplash. Global-e orders must be created in an e-commerce platform (Shopify) first, and then be imported into Whiplash or added through the Whiplash API.

Does Global-e allow for an order to be separated?

Yes, an order can be separated using either Global-e Standard or Global-e Express shipping.

Separating an order means that some of the order’s items are shipped one day, and the remaining items are shipped a different day.

Can Global-e orders be changed within Whiplash?

Only limited editing is available for Global-e orders once they are being processed.

Whiplash team members can change the address – but not the destination country.

Customer can make additional changes to their orders:

      • Cancel an entire order
      • Delete items from the order
      • Decrease the quantity of an ordered item
      • Separate an order for Global-e Standard orders
        Separating an order means that some of the order’s items are shipped one day, and the remaining items are shipped a different day.

Warning.png When customers make any of these changes to an order, they need to make them first in their stores’ e-commerce platform or in the Global-e system directly so that Global-e can make the appropriate shipping label updates, issue refunds, etc.

How are returns handled by Global-e?

At this time, returns must originate outside of Whiplash and be passed into Whiplash via the API or CSV upload.

Are package inserts allowed by Global-e?

Inserts (cards, promo items, gifts, etc) are not allowed for Global-e orders if the inserts are not listed on the original order. Global-e does not allow adding new items to processed orders.

 

Related Questions:

How does Global-e work?

What are the benefits of Global-e?

What are the different workflows for Global-e? 

How do I get started with Global-e?