Import products from xtCommerce
Learn how to import products from an xtCommerce shop into the Productsup platform, including multi-language attributes.
Introduction
xtCommerce is an open-source eCommerce platform popular in the German-speaking market. The xtCommerce Products data source pulls your full product catalog from an xtCommerce shop into Productsup, including base attributes (SKU, price, stock, status, weight, image) and language-specific attributes (name, description, short description, URL) for every language you configure.
To import products from xtCommerce to Productsup, you need to add and set up the xtCommerce Products data source in Data Sources.
Prerequisites
To use xtCommerce as a data source in Productsup, you need:
- The base URL of your xtCommerce shop, for example
https://shop.example.com. - An API username and password configured in the shop admin under Settings → API. The xtCommerce API plugin must be active.
- The list of language codes you want to import, for example
de, orde,en,frfor multilingual catalogs.
xtCommerce uses a function-based JSON API. Authentication credentials are passed in every request, so the credentials you enter in Productsup must remain valid for the duration of the import.
Add the data source xtCommerce Products
Go to Data Sources from your site's main menu and select ADD DATA SOURCE.
Search for xtCommerce Products, select Add, give it a name as desired, and then select Continue. The custom name replaces the data source name on the Data Sources Overview page.
In Shop URL, enter the base URL of your xtCommerce shop, without a trailing slash. For example, https://shop.example.com.
In API Username, enter the API username configured in your xtCommerce shop admin under Settings → API.
In API Password, enter the password for that API user.
In Languages, enter a comma-separated list of language codes to import, for example de,en,fr. Leave it as de to import only the default language.
Each language adds one extra API request per product page. For every language you list, the platform creates language-specific columns in the feed using the pattern <field>_<lang> — for example, products_name_de, products_description_en.
Optionally, enter a custom name in Description (optional).
Select Save and then Import at the top of the page.
Imported attributes
The data source returns the following attributes for each product:
| Attribute | Description |
|---|---|
products_id | Unique product ID from xtCommerce. |
products_model | SKU or article number. |
products_price | Product price. |
products_quantity | Stock quantity. |
products_status | 1 if active, 0 if inactive. |
products_image | Relative path to the product image. |
products_weight | Product weight. |
products_name_<lang> | Product name per language. |
products_description_<lang> | Product description per language. |
products_short_description_<lang> | Short description per language. |
products_url_<lang> | Product URL per language. |
If the import returns zero products even though credentials are accepted, check that the xtCommerce API plugin is active in your shop admin.
How is this guide?