Shopware is an open-source e-commerce platform known for its flexibility and scalability, allowing businesses to create customized online stores tailored to their specific needs.

<aside> ❗ IMPORTANT: you must have at least Shopware 5.6.6 version.

All the versions older than 5.6.6 are not supported and we suggest you upgrading to at least version 5.7

</aside>

Configuring the integration

<aside> 💡 Please make sure to download the ZIP-File below (Plugin). The person conducting the integration has to have access to the charles universe and has to be logged in

charles-0.0.11.zip

</aside>

In Shopware 5:

  1. Log into your Shopware 5 backend (e.g: https://my-shop.com/backend). Go to Configurations → Plugin Manager:

    Bildschirmfoto 2021-11-29 um 13.36.02.png

  2. In the Installed section, upload the plugin you downloaded from above 👆

  3. After the upload is done, the plugin will be under Uninstalled as shown below:

    Bildschirmfoto 2021-11-29 um 13.42.25.png

  4. Select the green + next to the HelloCharles extension to install the plugin:

    Bildschirmfoto 2021-11-29 um 13.42.25.png

  5. A modal with the plugin details will pop up. Select Activate → Connect to universe:

    Bildschirmfoto 2021-11-29 um 13.44.20.png

    Bildschirmfoto 2021-11-29 um 13.46.37.png

  6. Once done, a pop up will appear. Select Install:

    Bildschirmfoto 2021-11-29 um 13.47.46.png

  7. Choose your charles instance to continue with the integration:

Untitled

  1. You’ll be redirected back to the Shopware backend. Check that the instance is correct by selecting on Show Settings

  2. You should see Charles Key and Charles Universe

    <aside> ⚠️ These fields should be filled automatically during the connection process and don’t need to be filled in manually.

    </aside>

In charles:

  1. Go to Settings → Integrations → Connected apps. You should now see Shopware 5

  2. Select the ⚙️ to open settings. A pop-up will appear:

    Screenshot 2022-02-22 at 12.29.49.png

  3. Click on

    1. Fetch product categories

      <aside> 🚨 Important: This has to be done before synching products in order to correctly show up in the UI

      </aside>

    2. Wait about 5 minutes and then click on Sync products

      <aside> 🚨 The product import will now require some time to finish (approx 2-3s / product) depending on the clients server speed and size of catalogue

      </aside>

      After all products have synced, all agents must log out and in again.

    3. Sync orders

      • This will import all historical orders from the store
      • We will also create contacts in the process so if there’s a phone number in the order you can get a better overview of all your customers’ purchase history.

      <aside> 🚨 Please note that the import could take up to a few days to complete depending on the number of orders

      </aside>

FAQ