Skip to main content

Documentation Portal

Replacements in Shopify
Overview

Global-e‑ supports product replacements directly through the Shopify Admin.

Prerequisites

Update the Global-e Crossborder application.

  1. Navigate to the Global-e CrossBorder App

  2. Go to Settings > Update Global-e Scopes.

    update_globale_scopes.png
  3. Click Update Access Scope.

    The Update page opens.

    Update_screen.png
  4. Click Update App.

  5. Wait 10-15 minutes for the application to update before starting to create Shopify replacements.

    A message under the Update Access Scope button confirms that the app has been successfully updated.

    app_updated_successfully.png

Note

Global‑e’s responsibility does not involve validating orders when creating replacement orders.

Performing a Replacement in Shopify

To perform a replacement in Shopify:

  1. Go to the Shopify Admin screen.

    shopify_admin_screen.png
  2. In the left navigation bar, click Orders.

    click_orders.png

    The list of orders is displayed. See Step 3, below.

  3. Select the order that you want to replace.

    pick_order.png

    The original order opens.

    shopify_order_page.jpg
  4. At the top-right, select More actions > Start Global‑e Replacement.

    start_replacement.png

    An instruction page opens, explaining the process for replacing an order.

    replacement_instructions.png
  5. At the top of the Replacement Instructions page, select Click Here.

    The draft order opens.

    image7.png

    Note

    Global‑e uses Shopify’s Draft Order feature to generate replacement orders. As part of the process, a placeholder product with a $0 value is automatically added to the draft order. This product is deleted before the finalization of the replacement order.

  6. Under Products, in the Search bar, type the replacement item's name. - OR -

    Click Browse to search through all the products.

    browse_products.png

    You can use the filter to search for a product by a barcode, SKU, ID, or title.

    image9.png
  7. Select one or more replacement products and at the bottom-right click Add.

    replacement_item.png

    The product/s are added to the draft order.

    The order screen displays:

    • The placeholder product

    • The replacement product

    order_screen_updated.png
  8. Click the Trash icon to delete the placeholder product.

    discrad_placeholder_updated.png

    Now, the draft order only includes the replacement product.

    performing_a_replacement_in_shopify_updated.png
  9. On the right side of the draft order, ensure the customer's shipping address and contact details are correct.

    confirm_details_updated.png
  10. At the bottom of the Payment section, select Collect payment > Mark as paid

    payment_section_updated.png

    A pop-up appears confirming that an order is created and no payment is required.

    mark_as_paid.png

    Note

    • The draft order automatically inputs the same shipping method used for the original order and a zero-value shipping fee.

    • A 100% order discount is automatically applied to the order, bringing the order total to zero. We recommend not changing these settings because it will affect the order's total.

    • The only time you may need to edit the shipping option is if you use a shipping line Code or Source as an identifier instead of the Title. In this situation, manually edit the shipping information, as detailed below.

    To edit the shipping rates:

    1. Click Edit shipping or delivery.

      The Shipping and delivery options opens and the ustom rates option is selected by default.

      adding_a_shipping_method_2.png
    2. Select Shipping rates.

    3. Choose a shipping method and click Apply.

      edit_shipping.png

      The new shipping rate is added to the order total.

      shipping_total.png
    4. Click Collect payment > Mark as paid.

      The Mark as paid window opens.

    5. Input a shipping rate of $1.00 (or more) and click Create order.

      mark_as_paid_one_dollar.png

      A new order for the replacement item (Replacement order) is created.

  11. In the pop-up, click Create Order.

    A new order for the replacement item (Replacement order) is created.

    image18.png
  12. On the Global‑e Merchant Portal, view the Replacement order.

    a. From the Global‑e Merchant Portal, go to Orders > View Orders.

    b. Open the original order.

    globale_order_details.png

    The newly replaced order is added to your ecommerce platform as a new order.

    At the top of the order screen, the newly replaced order is flagged as a replacement order.

    replacement_tag2.png

    If you do not wish to include replacement orders in your sales reports, you may need to perform modifications on your ecommerce platform to make sure that they are not included in the sales reports.