> ## 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.

# Integration

## Prerequisites

Before getting started, make sure that you have the following:

* An administrator account for your Platform.
* A Global‑e Merchant account.
* Your Global-e Merchant ID and Merchant GUID (provided to you by Global-e).

## Configuration Manual

**Global-E API Settings**

Configure the following settings to ensure seamless communication with Global-e.

| Setting                | Default     | Description                                                                                                                                                                                     |
| ---------------------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Enable integration     | Off         | Allows enabling/disabling integration per sales channel.                                                                                                                                        |
| Enable included js/css | Off         | Allows the enabling/disabling of external Global-e JavaScript and CSS includes. For headless integration, the setting should be disabled.                                                       |
| Merchant ID            |             | The Merchant Identifier which allows identifying JavaScript and CSS includes.                                                                                                                   |
| Merchant GUID          |             | The API key used for communication to and from Global-e.                                                                                                                                        |
| Environment            | Integration | Determines the Global-e environment with which to establish communication. Integration or Staging are usually used for testing purposes. The Production Environment is used for live shop only. |

You can also test your API configuration with the provided button.

**Products**

Configure these settings to synchronize specific product attributes with Global-e

| Setting                     | Default | Description                                                                                               |
| --------------------------- | ------- | --------------------------------------------------------------------------------------------------------- |
| Brand Attribute             |         | A technical name of a product custom field which is used as an extra product brand attribute.             |
| HS Code Attribute           |         | A technical name of a product custom field which is used as an extra product HS Code attribute.           |
| Description Attribute       |         | A technical name of a product custom field which is used as an extra product description attribute.       |
| Country of origin attribute |         | A technical name of a product custom field which is used as an extra product country of origin attribute. |
| Weight Attribute            |         | A technical name of a product custom field which is used as an extra product weight attribute.            |

**Checkout / Order**

| Setting                                               | Default                                                                                                                                                                                                                                                                                                                                                                                                                                                            | Description                                                                                                                                                                                 |
| ----------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| JavaScript code that should run on the checkout page. | var glegem = glegem \|\| function()\{(window\["glegem"].q = window\["glegem"].q \|\| \[]).push(arguments)}; glegem("OnCheckoutStepLoaded",function(data)\{ console.log('OnCheckoutStepLoaded') switch(data.StepId)\{ case data.Steps.LOADED: console.log('OnCheckoutStepLoaded:LOADED') break; case data.Steps.CONFIRMATION: console.log('OnCheckoutStepLoaded:CONFIRMATION') } if (data.IsSuccess \&amp;\&amp; !data.IsPageReload)\{ // send some statistic } }); | JavaScript code snippet used to collect analytics info when Global-e checkout is shown and when a Global-e order is placed.For example snippets, see [Client Analytics](/client-analytics). |
| Skip Cart Validation                                  | Yes                                                                                                                                                                                                                                                                                                                                                                                                                                                                | Enables/disables cart validation on order create notification                                                                                                                               |
| Enable refund request from platform                   | No                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | Allows the enabling/disabling of sending order refunds to Global-e.                                                                                                                         |
| Update Global-E Order Addresses in Address Book       | No                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | Allows the enabling/disabling of saving addresses used in Global-e orders.                                                                                                                  |
| Move International Customer To Group                  | No                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | Allows the enabling/disabling of moving a customer-placed Global-e order to a customer group.                                                                                               |
| International Customer Group name                     |                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | A customer group name used for international customers.                                                                                                                                     |
| Store Code                                            |                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | A store code used by Global-e to distinguish sales channels on own domains and/or subfolders.                                                                                               |
| Store Instance Code                                   |                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | A store instance code used by Global-e to distinguish sales channels on our own domains and/or subfolders.                                                                                  |
| Global-e Cookie Group                                 | Required                                                                                                                                                                                                                                                                                                                                                                                                                                                           | A section of the Shopware cookie contest banner where Global-e cookies are registered.                                                                                                      |

## Shopware Orders List

<Frame>
  <img src="https://mintcdn.com/globale-enterprise/4kLlWOCKssl9AEZa/images/uuid-e030c521-ba5f-f04d-aab1-516a6c2fe3ee.png?fit=max&auto=format&n=4kLlWOCKssl9AEZa&q=85&s=35ff24e76eefafaa76efcfa6c2705850" width="1291" height="617" data-path="images/uuid-e030c521-ba5f-f04d-aab1-516a6c2fe3ee.png" />
</Frame>

## Shopware Order Details

<Frame>
  <img src="https://mintcdn.com/globale-enterprise/X_jditTJssq_GTcj/images/uuid-5f665f7b-57f2-c19a-7315-b671c8a927d4.png?fit=max&auto=format&n=X_jditTJssq_GTcj&q=85&s=e9a0645fd3b4d87e5f08043e3034f2aa" width="1032" height="891" data-path="images/uuid-5f665f7b-57f2-c19a-7315-b671c8a927d4.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/globale-enterprise/X_jditTJssq_GTcj/images/uuid-649b3124-e070-7f17-a9da-50be74c99b47.png?fit=max&auto=format&n=X_jditTJssq_GTcj&q=85&s=5f32fd2b9b6ab5dfa596f46ff26fc5e9" width="942" height="763" data-path="images/uuid-649b3124-e070-7f17-a9da-50be74c99b47.png" />
</Frame>

International details stored on the order details page:

* Global‑e Order ID
* Total price in customer currency
* Order created as **domestic**
* Global‑e **payment** method
* Global‑e **shipping** method
* Customer international **billing** & **shipping** details

<Note>
  The screenshots above are for a transaction in Polish złoty on a Shopware 5 instance using Euro as the base currency.
</Note>
