How to Connect weclapp with Shopware 6: ERP Integration Guide

How to connect weclapp with Shopware 6 for UK merchants: prerequisites, connector plugin, API configuration, synchronisation, testing, troubleshooting and go-live.

Introduction

weclapp is a cloud ERP for inventory management, CRM, invoicing, and projects. Connected to Shopware 6, products, inventory, customers, and orders flow automatically between the store and the ERP, with no duplicate data maintenance. This guide shows store owners, developers, and agencies how the integration works: prerequisites, plugin installation, API configuration, testing, troubleshooting, and go-live. For UK merchants, we also point out where VAT rates, pound sterling and sales into the EU need to be mapped consistently in both systems.

If you are still evaluating which ERP fits your store, our article on cost-efficient ERP integration for Shopware 6 can help. For platform basics, see our page on Shopware development.

What is weclapp?

weclapp is a cloud-based ERP system that combines inventory management, CRM, order processing, invoicing, and project management in one platform. It is attractive for online merchants because it covers warehousing, purchasing, and accounting without the need to run your own server.

Benefits for ecommerce

• Customer, inventory, and sales data live centrally in one place.
• Invoices and bookings are created directly from the order, which reduces administrative work.
• Orders and inventory are reconciled automatically, so availability in the store is accurate.

Why connect it to Shopware 6?

• Data in the store and ERP is consistent at all times.
• Recurring tasks such as transferring orders are eliminated.
• Less manual entry means fewer errors.

Shopware remains the frontend for your customers, and weclapp the backend for fulfilment and finance. For other systems you can connect, see our overview of Shopware ERP and CRM integrations.

Prerequisites

Technical

• Shopware 6.4 or newer, running stably
• PHP 8.1 or newer
• Web server with HTTPS and sufficient PHP memory (at least 512 MB recommended) so sync runs do not abort
• MySQL 8.0 or newer, or MariaDB

weclapp account

• Active weclapp cloud account with administrator rights
• Access to the API details: tenant name, API token, and endpoint URL

Other

• Shopware admin access with rights to install and configure extensions
• Basic knowledge of installing Shopware plugins

Check every prerequisite before you start. It saves time during setup.

Install the connector plugin

To connect the systems, you need a connector plugin. There are two options:

• A commercial plugin from the Shopware Store (search for “weclapp”) that covers the standard use cases.
• A custom plugin built on the weclapp API if you need special processes or field mappings. To learn how we build these, see our page on Shopware plugin development.

Installing from the Store

1. Log in to the Shopware Administration.
2. Open Extensions → Store and search for “weclapp”.
3. Select the right plugin and click Install.
4. Activate the plugin under Extensions → My extensions.
5. Open the connector configuration there.

Make sure the plugin is compatible with your Shopware version. For a custom plugin, follow the developer’s installation instructions, usually via bin/console plugin:install --activate.

Configure the plugin

API access

• Tenant: your weclapp company identifier, found in the account settings.
• API token: generated in the user profile in weclapp. Ideally, create a dedicated technical user with the necessary permissions for this.
• Endpoint: usually https://{tenant}.weclapp.com/webapp/api/v1/.

Synchronisation

• Products: transfer product master data from weclapp to Shopware, including prices and variants.
• Orders: automatically create Shopware orders as sales orders in weclapp.
• Customers: map and reconcile customer accounts and addresses.
• Inventory: write stock levels from weclapp to the store.

Other settings

• Tax mapping between Shopware tax rates and weclapp tax keys
• Currencies and languages matching your sales channels
• Logging and sync interval

Save the configuration and check every mapping before you start the first sync.

Test the integration

Product sync

1. Create a test product in weclapp with a product number, price, and description.
2. Check whether it appears in the Shopware catalogue with the correct data.

Order sync

1. Place a test order in the store.
2. In weclapp, check under Sales → Sales orders whether the order arrived with all line items.

Check the logs

• Review the plugin logs for error messages or confirmations.
• Use the browser’s developer tools and the Shopware logs to find failed calls.

Document any discrepancies and fix them before you go live.

Troubleshooting

Common issues

• Invalid API token: Copy the full token and check that the user has the necessary permissions in weclapp.
• Timeout: Check the firewall and the endpoint URL.
• Orders are not transferred: Check that automatic transfer is enabled and that the Shopware scheduler (bin/console scheduled-task:run) or the cron job is running.
• Inventory discrepancies: Check the sync interval and the overwrite rules in the plugin.

Logs and diagnostics

• Shopware: Settings → System → Logs
• Turn on verbose logging during setup
• Review the API responses and logs in weclapp

Plugin conflicts

• Temporarily deactivate plugins you do not need to narrow down conflicts.
• Check that the plugin version is compatible with your Shopware version.

Go-live

1. Switch the environment in the plugin settings from “Test” to “Live.”
2. Check API credentials and tax mapping one last time.
3. Run a full sync of products, customers, and inventory.
4. Inform your staff and support team about the switch and train them as needed.

Before launch

• Back up the Shopware database and export your weclapp data.
• Place a test order in live mode and check the invoice, inventory, and customer data.
• Verify the mapping of all fields, such as product number, prices, and inventory.

Best practices and security

Security

• Store API tokens in environment variables or a secrets store, not in code.
• Rotate tokens regularly and revoke ones you no longer use.
• Limit the technical user’s permissions to the modules you need.

Performance

• Schedule large syncs for low-traffic hours.
• Batch transfers for large catalogues.
• Set up error notifications and sync reports.

Maintenance

• Install plugin updates promptly.
• Review the logs weekly.
• Retest the sync after major Shopware or weclapp updates.

FAQ

What happens if an order is not transferred?
The plugin logs the error. You can correct the data and trigger the transfer again manually.

Can I sync only certain products?
Yes, most connectors allow filtering by category or tag.

Are payment and shipping statuses carried over?
Statuses can be mapped between the systems; the scope depends on the plugin.

How do I handle multiple sales channels?
Give each sales channel a unique identifier and its own sync configuration in weclapp.

Does weclapp update Shopware inventory automatically?
Yes, if inventory sync is enabled. You set the interval in the plugin settings.

What should UK merchants check before go-live?
Make sure tax rules (20% standard VAT, reduced and zero rates), GBP as currency and any shipments into the EU are mapped identically in weclapp and Shopware, so invoices and order totals match.

If you would rather have inventory management directly in Shopware, read our guide to Pickware in Shopware 6. To connect weclapp or another ERP, get in touch; our store audit gives you a quick overview. We support UK merchants remotely from Bremen and Prishtina.