Temu Integration for Shopware — Setup Guide

1. Prerequisites

Before you begin, make sure your environment meets these requirements:

• Shopware 6.6 or 6.7
• PHP 8.2 or higher
• Composer and command-line (SSH) access — for the CLI installation method and for running the background worker
• A running message queue worker (Shopware’s native Symfony Messenger)
• An active Temu seller account

2. Install the plugin

Choose your installation method:

Option A — Install from the Administration (ZIP)

If you received the plugin ZIP from StichTech during onboarding:

1. In the Shopware Administration, go to Extensions → My extensions.
2. Click Upload extension and select the StichTech Temu ZIP file.
3. Once it appears in the list, click Install, then toggle it to Active.

Option B — Install from the command line

Install via Composer from your Shopware root directory:

composer require stich/stich-tech-temu-integration

Or, if you received the plugin as a folder, place it in custom/plugins/StichTechTemuCatalog. Then register and activate it:

bin/console plugin:refresh
bin/console plugin:install --activate StichTechTemuIntegration
bin/console cache:clear

If you installed from the command line, rebuild the Administration so the Temu screens appear:

bin/console assets:install
./bin/build-administration.sh

3. Verify the plugin is active

Confirm the plugin installed and activated correctly:

bin/console plugin:list

Stich Temu Marketplace Integration should appear with status Active. After activation you will see:

• A new Stich Temu Marketplace item in the Administration main menu (Categories & Attributes).
• A Temu tab on every product detail page.
• The plugin configuration under Settings → System → Plugins.

4. Run the message consumer

The plugin processes all sync work — categories, attributes, products, inventory, orders, and shipments — through Shopware’s Symfony Messenger queue. Start a worker from your Shopware root:

bin/console messenger:consume async --time-limit=300

5. Configure the plugin

Open the plugin configuration: Settings → System → Plugins → Stich Temu Marketplace Integration → … → Configure. (You can also reach it from Extensions → My extensions → Stich Temu Marketplace Integration → Configure.)

Temu API Configuration

• Region — Select the region that matches your Temu seller account: Europe (EU), United States (US), or Global.
• App Key — From your Temu Seller Center → Developer settings.
• App Secret — From Temu Seller Center. Stored encrypted.
• Access Token — Your OAuth access token from Temu Seller Center. Stored encrypted.
• Test connection — A button that validates your credentials against the Temu API (see Step 6).

Where to find your Temu credentials

1. Log in to Temu Seller Center.
2. Navigate to Developer settings or Manage your apps.
3. Find the StichTech Connector app you authorized.
4. Click View access info.
5. Copy the App Key, App Secret, and Access Token.
6. Paste them into the corresponding fields in Shopware.

Product Sync Settings

• Auto-Sync Enabled — When on, products are automatically queued for sync every time you save a product that has Temu sync configured.
• Fulfillment Type — Choose Merchant Fulfillment (you ship) or Temu Fulfillment (Temu ships).
• Shipment Limit Days — Number of days you have to ship an order. Default is 3. Note: some Temu categories enforce stricter limits (1–2 days).
• Cost Template ID — Optional. The ID of a shipping cost template created in Temu Seller Center.

Order, Inventory & Shipment Sync

• Order Import Enabled — Pull Temu orders into Shopware.
• Inventory Sync Enabled — Push stock-level changes to Temu.
• Shipment Sync Enabled — Send shipment confirmations and tracking back to Temu.
• Default Carrier ID — Carrier used when sending shipment data to Temu.

About the Cost Template ID

The shipping cost template is created in Temu Seller Center. Example:

• Template: “EU Standard Shipping” — ID: 12345
• Germany: €3.99 (free over €30)
• France: €4.99 (free over €40)
• Spain: €5.99 (free over €50)
• Rest of EU: €7.99

Take the resulting Template ID and paste it into the Cost Template ID field, then click Save.

6. Verify your connection

In the plugin configuration, under Temu API Configuration, click the Test connection button.

If the test passes, your Shopware store is connected to Temu. If it fails, double-check your App Key, App Secret, and Access Token, and confirm the Region matches your Temu seller account.

7. Sync Temu categories

Before you can list products on Temu, import the Temu category tree into Shopware.

From the Administration

Go to Stich Temu Marketplace → Categories and click Sync Categories. The sync runs in the background through the message consumer. (The same action is also available as Sync Categories in the plugin configuration under Catalog Sync Actions.)

From the command line

bin/console temu:sync:categories

Sync category attributes

After categories are imported, sync the per-category required attributes. These define what information Temu requires for each leaf category:

bin/console temu:sync:attributes

You only need to do this once, or whenever Temu publishes new categories.

Browse imported categories

View all imported Temu categories and attributes at Stich Temu Marketplace → Categories (and the Attributes tab). Each grid supports search, so you can confirm the tree imported correctly before listing products.

8. List your first product on Temu

1. In the Administration, go to Catalogues → Products and open any product.
2. Open the Temu tab.
3. In the Temu Category field, start typing — the autocomplete searches leaf categories and shows the full path (e.g., Fashion > Women > Apparel > Shirts).
4. Map any required Temu Attributes shown for the selected category to your product’s values.
5. Click Save.

With Auto-Sync enabled, saving queues the product automatically. Otherwise, push it manually from the command line:

bin/console temu:sync:products            # sync all eligible products
bin/console temu:sync:products PRODUCT_ID  # sync a single product

Product requirements

Before listing, make sure your product has:

• Recommended 3 images (maximum 10) — fewer than 3 are padded by duplicating the first image
• A price greater than €0
• A product number
• A Temu category selected on the Temu tab

Checking sync status

After sync, the Temu tab on the product shows:

• Sync Status — pending (queued), syncing (being sent), synced (live on Temu), or error
• Temu Goods ID — Temu’s internal product ID, assigned after a successful sync
• Error Message — Only populated when the status is “error”

Tips for product descriptions

Your Shopware product description is sent to Temu as-is. Make sure it clearly describes the product, includes key features and specifications, and mentions materials, dimensions, or sizes where relevant.

9. Troubleshooting

bin/console assets:install
./bin/build-administration.sh
bin/console cache:clear

bin/console messenger:consume async

bin/console messenger:failed:show

10. Quick reference

11. Console commands

All commands are run from the Shopware root with bin/console. Most queue work to the message consumer, so keep a worker running (Step 4).