Galaxus

Swiss online market leader Galaxus specializes in IT, consumer electronics and telecommunications. As the largest online department store in Switzerland, Galaxus has a steadily growing product range. Reliable, fast delivery and reasonable prices.

1. Registering with Galaxus

Register online for the Digitec Galaxus Merchant Program or contact Galaxus using the email address anmelden@digitecgalaxus.ch.

2. Orders if you are based in Germany

Your company is based in Germany and you deliver to Galaxus end customers in Switzerland. Here, two scenarios are possible:

  1. You send the order directly to the address of the end customer in Switzerland.

  2. You use the Galaxus EU Hub.

What is the EU Hub?

The EU Hub is a cross border customs clearance solution offered by Galaxus. It provides easy access to the Swiss market. The Digitec Galaxus AG acts as a service provider to handle logistics to Switzerland including declaration, customs clearance and VAT payment.

Additional information and requirements for using the EU Hub are provided by Galaxus.

How do orders via the EU hub work?

When you use the EU hub, orders work like so:

  1. A customer in Switzerland orders and pays for a product on Galaxus.

  2. You confirm receipt of the order to Galaxus.

  3. You ship the package to the EU Hub.

  4. You inform Galaxus that the package is on its way.

  5. In the EU hub, the package is processed according to Swiss customs laws:

    • Package is labelled with shipping labels for Swiss Post.

    • The export steps that are legally required are carried out.

  6. The package is transported to the Swiss central warehouse.

  7. The central warehouse handles the steps necessary for import.

  8. The package is handed over to Swiss Post.

  9. Customer receives the package.

Additional information and requirements for using the EU Hub are provided by Galaxus.

How do returns via the EU hub work?

When you use the EU hub, returns work like so:

  1. Customer announces that they want a return in the Galaxus shop.

  2. Galaxus informs you about the return.

  3. Customer sends the return to Digitec Galaxus AG in Switzerland.

  4. In the Swiss central warehouse, the package is processed according to Swiss customs laws:

    • Package is labelled with shipping labels for DHL.

    • The export steps that are legally required are carried out.

  5. The package is transported to the EU hub.

  6. The EU hub handles the steps necessary for import.

  7. The package is handed over to DHL.

  8. You receive the return.

  9. You inform Galaxus that you accepted the return.

Additional information and requirements for using the EU Hub are provided by Galaxus.

2.1. Automatically creating delivery orders for EU Hub orders

For correct billing, Galaxus orders that are shipped to the EU Hub and from there onward to Switzerland must have a delivery address outside the EU. To ensure correct shipping, orders that are processed via the EU Hub still need a German delivery address — the address of the EU Hub. In PlentyONE, you therefore have the option of automatically creating delivery orders with the address of the EU Hub for Galaxus orders that are shipped via the EU Hub, in addition to the main order.

Automatically creating delivery orders with the address of the EU Hub:

  1. Go to Setup » Markets » Galaxus » Order import.

  2. Activate the option EU-Hub order handling.
    → To ensure correct shipping, a delivery order with the delivery address of the EU Hub is automatically created for the main order to be delivered to Switzerland via the EU Hub.

  3. Save () the settings.

An order generated on Galaxus.ch and to be shipped to Switzerland via the EU Hub will then proceed as follows:

  • Customers from Switzerland place an order via Galaxus.ch.

  • The order is imported into PlentyONE with the Swiss address, i.e., an address outside the EU.

  • In PlentyONE, a delivery order is created for the main order with the delivery address of the EU Hub, i.e., an address within the EU.

  • You send the order to the EU Hub, and from there the order is delivered to Switzerland.

  • This means that if you ship your Galaxus.ch orders to Switzerland via the EU Hub, you must activate the option EU-Hub order handling so that delivery orders with an address within the EU (EU Hub warehouse) are created automatically.

3. Installing the plugins

To export item data to Galaxus using the Elastic Export, you need the following plugins:

You can download the plugins in the plentyMarketplace.

Important: Install the plugin in the plugin set of the main client.

Elastic Export: Adding and installing the plugin

Adding plugin to the system:

  1. Go to Plugins » plentyMarketplace.
    → The marketplace opens in a new tab.

  2. Navigate to the plugin Elastic Export.
    Tip: Either use the search function or open the category Plugins » Sales » Marketplaces.

  3. Open the detail view of the plugin.

  4. In the column to the right, click on Go to checkout.
    → The Checkout window opens.

  5. Read and accept the General Terms and Conditions.

  6. Click on Order now.
    → Wait a few minutes before installing the plugin.

Installing plugins:

  1. Go to Plugins » Plugin set overview.

  2. Click on the plugin set of your main client.
    Important: In other words: The plugin set must be linked to the main client.
    → The plugin set opens.

  3. Click on Add plugin.

  4. Select Elastic Export from the plugin list.

  5. Click on Install.
    → The plugin is installed.
    → The plugin set is shown.

  6. Switch the plugin to active ().

  7. Save () the plugin set.
    Tip: Problems saving the plugin set? Click on Open details to show additional information.

Important: Install the plugin in the plugin set of the main client.

Galaxus: Adding and installing the plugin

Adding plugin to the system:

  1. Go to Plugins » plentyMarketplace.
    → The marketplace opens in a new tab.

  2. Navigate to the plugin Galaxus.
    Tip: Either use the search function or open the category Plugins » Sales » Marketplaces.

  3. Open the detail view of the plugin.

  4. In the column to the right, click on Go to checkout.
    → The Checkout window opens.

  5. Read and accept the General Terms and Conditions.

  6. Click on Order now.
    → Wait a few minutes before installing the plugin.

Installing plugins:

  1. Go to Plugins » Plugin set overview.

  2. Click on the plugin set of your main client.
    Important: In other words: The plugin set must be linked to the main client.
    → The plugin set opens.

  3. Click on Add plugin.

  4. Select Galaxus from the plugin list.

  5. Click on Install.
    → The plugin is installed.
    → The plugin set is shown.

  6. Switch the plugin to active ().

  7. Save () the plugin set.
    Tip: Problems saving the plugin set? Click on Open details to show additional information.

4. Activating the order referrer

Go to Setup » Orders » Order referrer to activate the order referrer. This ensures that orders are assigned to the correct sales channel.

What is an order referrer?

An order referrer tags an order with the sales channel on which the order was generated. Sales channels can be e.g. your online shop or markets on which you sell your items. Each sales channel has an individual order referrer. Some order referrers are available by default in your PlentyONE system. Further order referrers are added e.g. if you install a new plugin. For further information about the order referrer, see the page Order referrer of the PlentyONE manual.

Activating the order referrer for Galaxus:

  1. Go to Setup » Orders » Order referrer.

  2. Click Search (search).

  3. In the list, navigate to the option Galaxus.
    Tip: The order referrer is not in the list? Then you probably have not installed the plugin yet.

  4. On the right of the referrer’s line, click on Edit (edit).
    → The window Edit referrer opens.

  5. Activate the option Visible in selection (toggle_on).

  6. Click on Save (save).
    → The referrer is active.

5. Setting up the order interface in PlentyONE

Carry out the following settings in PlentyONE in order to set up the order interface to Galaxus. Keep the FTP connection details ready that Galaxus emails you after your registration.

Galaxus is not shown in the menu Setup » Markets?

The menu Setup » Markets » Galaxus is only shown after you carry out the following steps:

  • The plugin is installed in the plugin set in which the default client is linked.

  • The plugin was provisioned.

  • The order referrer Galaxus is active in the menu Setup » Orders » Order referrer.

Setting up the order interface to Galaxus:

  1. Go to Setup » Markets » Galaxus » Order import.

  2. Carry out the settings. Note the explanations in Table 1.

  3. Save () the settings.

Table 1. Galaxus settings
Setting Explanation

Activate Order Interface

Activate to enable data exchange with Galaxus for orders.

*Add '

customer reference number' after externalorder number*

Activate if you need the customer reference number for customs documents (EU-HUB USER).

Note: When this option is active, you can only search order numbers by entering the complete string *GalaxusOrderNumber

GalaxusCustomerReferenceNumber*.

FTP configuration

Host

Enter the host name based on the pattern ftp.dg.ch.

User
Password

Enter the user name and password that you received from Galaxus.

Port number

Enter the port number.

partner2dg

Select the partner2dg folder for the selected host.
→ On this FTP-path the plugin responds back to Galaxus.

dg2partner

Select the dg2partner folder for the selected host.
→ From this FTP path, the plugin will read new orders and requests from Galaxus.
Important: The specified folder paths begin with (/…​ /…​), only if the hostname submitted on Step 4 does not end with ( / ).

Order status configuration

Order status for cancellation requests

Which order status do you want to assign to new cancellation requests during import?

Order status for return requests

Which order status do you want to assign to new return requests during import?

Automatically reject cancellation requests for orders from this status

From which order status do you want to reject cancellation requests automatically?

Important: If you do not select a status, the status [5] Cleared for shipping is used.

6. Setting up the item export

The following Elastic Export formats are used for the item export. When you provision the plugin, these formats are installed automatically.

  • GalaxusProductDataExport

  • GalaxusProductPropertiesExport

  • GalaxusProductStockPricingExport

For format relevant setup options, go to Setup » Markets » Galaxus » Item export.

Setting up the item export to Galaxus:

  1. Go to Setup » Markets » Galaxus » Item export » Product data.

  2. Carry out the settings. Note the explanations in Table 2.

  3. Save () the settings.

Table 2. Settings for the item export
Setting Explanation

Product Data (Format GalaxusProductDataExport)

Description

Possible options:

  • Product Description

  • Technical data

  • Preview text

  • Free text field 1 to Free text field 20

Export Customs tariff number as

Possible options:

  • TARES

  • TARIC

Composition

Select a description of a product’s composition or ingredients. This compliance-relevant description is required by law for specific product groups.
Examples:
- List of ingredients (all ingredients contained in a grocery must be listed)
- Allergy declaration (ingredients and the products produced from them, that may cause allergies or other adverse reactions must specifically be identified)
- Ingredients (e.g. perfume)

Application

Select an application description for a product. This compliance-relevant description is required by law for specific product groups.
Applicable product groups:
- Medical devices
- Medicine

WEEE number

Select a WEEE number. This manufacturer number is assigned to the first distributors of electrical and electronic equipment following successful registration with EAR foundation. It consists of a country code and an eight-characters-long sequence of digits.
Example:
“DE12345678"

Product Properties » Item Characteristics (Format GalaxusProductPropertiesExport)

Export activated characteristics

Possible options:

  • All

  • Only selected

Whitelist

Creating a whitelist element:

  1. Go to Setup » Markets » Galaxus » Item export » Item Characteristics / Variation Properties.

  2. Click on Add.

  3. Select a characteristic / a property.

  4. Save the settings.

Product Properties » Variation Properties (Format GalaxusProductPropertiesExport)

Export activated properties

Possible options:

  • All

  • Only selected properties

  • None

Whitelist

Creating a whitelist element:

  1. Go to Setup » Markets » Galaxus » Item export » Item Characteristics / Variation Properties.

  2. Click on Add.

  3. Select a characteristic / a property.

  4. Save the settings.

Product Stock Pricing (Format GalaxusProductStockPricingExport)

Currency

Possible settings for exporting the currency:

  • CHF

  • EUR

Calculate "Sales price excl. VAT" based on Elastic Export setting "Target country"

Activate this option to use Elastic Export setting Target country.

Positive stock quantities are always exported, independent of the average delivery period

Possible options:

  • On

  • Off

Note: To clarify, check the default export matrix for active variations in Table 3.

Sales price that is exported as purchase price excl. VAT

Select a relevant sales price that already exists. This option is also influenced by Calculate "Sales price excl. VAT" based on Elastic Export setting "Target country".

Sales price that is exported as purchase price excl. fees and VAT

Select a relevant sales price that already exists. This option is also influenced by Calculate "Sales price excl. VAT" based on Elastic Export setting "Target country".

Export stock from:

Possible options:

  • All warehouses

  • A warehouse of my choice

List of mapped warehouses

PlentyONE warehouse

The PlentyONE warehouse the products originate from.
During export, the WarehouseCountry column will be transferred to Galaxus. it contains the ISO code of the country in which the exporting warehouse is located.

Galaxus GLN

The GLN provided by Galaxus or the postcode of the respective warehouse.
During export, the WarehouseId column will be transferred to Galaxus. It contains the Galaxus GLN or the postcode of the warehouse from which stock is exported.

6.1. Mapping a PlentyONE warehouse to a Galaxus GLN

In the Product Stock Pricing section of the item export settings, you can map your PlentyONE warehouses to the respective Galaxus GLN. To do so, proceed as follows.

Mapping a PlentyONE warehouse to a Galaxus GLN:

  1. Go to Setup » Markets » Galaxus » Item export » Product Stock Pricing.
    → The settings for the Product Stock Pricing section of the item export open.

  2. At the bottom in the section List of mapped warehouses, click on Create mapping (add).

  3. The window Mapping a PlentyONE warehouse to a Galaxus GLN opens.

  4. In the Warehouse field, select a warehouse from the drop-down list.

  5. In the Galaxus GLN field, enter the GLN for the warehouse that was provided by Galaxus.

  6. Click on Save.
    → The mapping is saved and added to the overview.

6.2. Default export matrix for active variations

The basic logic of Galaxus is like this:

If positive stock is transmitted, Galaxus uses the default delivery time that is saved for the account in the Galaxus back end. If an item does not have positive stock, the reorder time is used instead.

Notes:

  • Galaxus assumes an average delivery time of 2 days for items that are in stock. If an item has stock and an availability that results in a delivery time of 2 or more days, the item is exported with a stock of 0\. The delivery time is exported as the reorder time. For items with 0 or negative stock and an average delivery time of two days or less, the system assumes a configuration error and the item is not exported.

  • Item data is processed irrespective of the stock export conditions for export.

  • Bundles are not exported if one of the items in it are not in stock. Also, the exported stock amount is based on the bundle component with the highest stock.

The following table shows a default export matrix for active variations.

Table 3. Default export matrix for active variations
Net stock Average delivery period Result

Positive stock

Delivery time ⇐ 2

Stock is exported.

Positive stock

Delivery time > 2

Only delivery time is exported.

Positive stock

No Delivery time

Stock is exported.

Stock 0/negative

Delivery time ⇐ 2

No export.

Stock 0/negative

Delivery time > 2

Only delivery time is exported.

Stock 0/negative

No delivery time

No export.

7. Setting up a sales price

Sales prices define the conditions under which a variation is sold at a specific price and on a specific sales channel.

  1. Go to Setup » Item » Sales prices.

  2. Click on [+] New.

  3. Enter a position number.

  4. Enter an Internal and an External name.

  5. Enter a value for Minimum quantity.

  6. Select CHF or EUR as the currency.

  7. Select the Client.

  8. Select the sales countries.

  9. Select the referrer Galaxus.

  10. Save the settings.

Note: Alternatively, you can activate the referrer Galaxus in an existing sales price.

8. Preparing category for the export

On Galaxus, your variations are offered using your default client (store). As such, the category of the variation must be linked to the default client (store).

Linking the default client to the category:

  1. Go to Item » Category.

  2. Click on the category in the directory tree on the left.
    → The category opens and the tab Settings is shown.

  3. Navigate to the setting Client (store).

  4. Activate the option Standard ().

  5. Save () the settings.

checklist category client

9. Preparing variations for the export

Table 4. Preparing variations for the export
Setting Explanation

Choose the default category

The default category of the variation is exported to Galaxus in all cases. As such, define a default variation for the variation. This default category must be linked to the default client (store).

Choosing the default category:

  1. Go to Item » Items » [Open variation] » Element: Categories.

  2. Within the element, click on and then on link Link default category.
    → A pop-up window will open.

  3. Use the drop-down list to select a default category for each client.
    Important: This category must be linked to the default client (store).

  4. Click on Save.
    → The data will be displayed as a table.

  5. Save () the settings.

Activate the variation

The variation must be active:

  1. Go to Item » Edit item » [Open item] » [Open variation] » Variation tab: Settings » Area: Availability.

  2. Activate the checkbox Active.

  3. Save () the settings.

Activate the market availability

The item availability for the market Galaxus must be activated:

  1. Go to Item » Variation » Tab: Availability » Area: Markets.

  2. Activate the market Galaxus.

  3. Save () the settings.

Link sales price and save price

  1. Go to Item » Edit item » [Open item] » [Open variation] » Variation tab: Settings.

  2. In the Sales price area, add the sales price for Galaxus ().

  3. Enter a price.

  4. Save () the settings.

Link characteristics/properties

  • Permitted characteristics and/or properties must be linked to the variations.

    1. Go to Item » Characteristics » Galaxus characteristics.

    2. Link the relevant elements.
      Or: Go to Setup » Settings » Properties.

    3. Link the relevant elements.

Save availability

The Availabilities 1-10 must be saved for the variation.

  1. Go to Setup » Item » Availability.

  2. Save business relevant Average delivery times.

  3. Ensure that variations activated for Galaxus are linked to the relevant Availability 1-10.
    Important: The setting Positive stock quantities are always exported, independent of the average delivery period does not work if no Availability 1-10 is set.

10. Exporting items to Galaxus

The Galaxus plugin exports the item data using the Elastic Export plugin. For more information on the Elastic Export Plugin, visit the Elastic Export page.

10.1. Setting up Elastic Export formats

The following Elastic Export formats are used for the item export. When you provision the plugin, these formats are installed automatically:

  • GalaxusProductDataExport

  • GalaxusProductPropertiesExport

  • GalaxusProductStockPricingExport

Setting up Elastic Export formats:

  1. Go to Data » Elastic Export » New export [+].
    → Each format works for a specific part of the item export.

  2. Select a Galaxus format:

    • GalaxusProductDataExport

    • GalaxusProductPropertiesExport

    • GalaxusProductStockPricingExport

  3. Set up the export formats.

  4. Save the settings.

Input fields export format GalaxusProductDataExport
Table 5. The GalaxusProductData export format
Galaxus output PlentyONE input field

ProductKey, Mandatory, string(100)

Item » Edit item » [Open item] » [Open variation] »Variation-ID

GTIN, mandatory, integer (8-14)

Item » Edit item » [Open item] » [Open variation] » Barcode

Corresponds to barcode type Selection in the elastic export filter of this format

ManufacturerKey, string(200)

Item » Edit item » [Open item] » [Open variation]» Model

BrandName, mandatory, string(100)

Item » Edit Item » [Open item] » Tab: Global » Manufacturer

ProductTypeIdDigitecGalaxus, Integer(200)

-

Category, mandatory, string(200)

Item » Edit Item » [Open item] » [Open variation] » Tab: Categories » Standard category

CategoryGroup_1, string(200)

-

CategoryGroup_2, string(200)

-

CategoryGroup_3, string(200)

-

CategoryGroup_4, string(200)

-

TARESCode, string(20)

Item » Edit Item » [Open item] » Tab: Basic Settings » Customs tariff number

TARICCode, string(20)

Item » Edit Item » [Open item] » Tab: Basic Settings » Customs tariff number

This information is recommended when using the EU Hub.

CountryOfOrigin, string(20)

Item » Edit Item » [Open item] » Tab: Basic Settings » Manufacturing country

This information is recommended when using the EU Hub.

SuggestedRetailPriceIncludingVat, Mandatory, float(14,4)

Item » Edit item » [Open item] » Open variation » Tab: Settings » Sales prices

PPP Galaxus Salesprice

Note: For the SuggestedRetailPriceIncludingVat the same currency is used as for the GalaxusProductStockPricingExport format. You can specify the currency (EUR / CHF) in the menu Setup » Item » Sales Price » [Open Galaxus sales price] » Section: Currency.

VatRatePercentage, mandatory, float(2.4)

Item » Edit item » [Open item] » [Open variation] » Tab: Settings

ImageURL (1 to 10), mandatory, text(300)

Item » Edit item » [Open item] » Tab: Images

VideoURL (1 to 3), string(300)

-

ProductLink (1 to 3), string(300)

-

WeightG, EU-Hub mandatory, integer(10)

Item » Edit item » [Open item] » [Open variation] » Tab: Settings » Measurements: Gross weight

WidthM, float(14,4)

Item » Edit item » [Open item] » [Open variation] » Tab: Settings » Measurements: Length/Width/Height

HeightM, float(14,4)

Item » Edit item » [Open item] » [Open variation] » Tab: Settings » Measurements: Length/Width/Height

LengthM, float(14,4)

Item » Edit item » [Open item] » [Open variation] » Tab: Settings » Measurements: Length/Width/Height

ReleaseDate, Format (YYYY-MM-DD)

-

GlobalSalesRank_integer(10)_

-

MinimumAge, integer(10)

Item » Edit Item » [Open item] » Tab: Global » Ager rating

ProductTitle_DE, Mandatory (at least one of four languages), (Text100)

Item » Edit Item » [Open item] » Tab: Texts » Name 1 (de) or Name 2,3
Can be selected in the Elastic Export configuration for this format.

ProductTitle_EN, (Text100)

Item » Edit Item » [Open item] » Tab: Texts » Name 1 (en) or Name 2,3
Can be selected in the Elastic Export configuration for this format.

ProductTitle_FR, (Text100)

Item » Edit Item » [Open item] » Tab: Texts » Name 1 (fr) or Name 2,3
Can be selected in the Elastic Export configuration for this format.

ProductTitle_IT, (Text100)

Item » Edit Item » [Open item] » Tab: Texts » Name 1 (it) or Name 2,3
Can be selected in the Elastic Export configuration for this format.

ProductTitleTagLine_DE, Text

-

ProductTitleTagLine_EN, Text

-

ProductTitleTagLine_FR, Text

-

ProductTitleTagLine_IT, Text

-

ProductDescription_DE, mandatory (at least one of four languages), Text

Standard: Item » Edit item » [Open item] » Tab: Texts » Item text (de)
or input field selection under: Setup » Markets » Galaxus » Item export » Product Data » input field mappings

ProductDescription_EN, Text

Standard: Item » Edit item » [Open item] » Tab: Texts » Item text (en)
or input field selection under: Setup » Markets » Galaxus » Item export » Product Data » input field mappings

ProductDescription_FR, Text

Standard: Item » Edit item » [Open item] » Tab: Texts » Item text (fr)
or input field selection under: Setup » Markets » Galaxus » Item export » Product Data » input field mappings

ProductDescription_IT, Text

Standard: Item » Edit item » [Open item] » Tab: Texts » Item text (it)
or input field selection under: Setup » Markets » Galaxus » Item export » Product Data » input field mappings

MinimumOrderQuantity, mandatory, integer(10)

Item » Edit item » [Open item] » [Open variation] » Tab: Settings » Availability: Min. order quantity

RetailUnitQuantityInPackingUnit, integer(10)

-

RetailUnitQuantityOnPallet, integer(10)

-

RetailUnitQuantity, mandatory, integer(10)

Item » Edit item » Open item » Open variation » Tab: Settings » Shipping: Packing units

ProductSuperType

Item » Item ID

WEEE number

This manufacturer number is assigned to the first distributors of electrical and electronic equipment following successful registration with EAR foundation. It consists of a country code and an eight-characters-long sequence of digits.
Example:
“DE12345678"

Composition

Describes a product’s composition or ingredients. This compliance-relevant description is required by law for specific product groups.
Examples:
- List of ingredients (all ingredients contained in a grocery must be listed)
- Allergy declaration (ingredients and the products produced from them, that may cause allergies or other adverse reactions must specifically be identified)
- Ingredients (e.g. perfume)

Application

Describes a product’s application. These are compliance-relevant descriptions that are by law required for specific product groups.
Applicable product groups:
- Medical devices
- Medicine
Input fields export format GalaxusProductStockPricingExport
Table 6. The GalaxusProductStockPricingExport export format
Galaxus output PlentyONE input field

ProductKey, Mandatory, string(100)

Item » Edit item » [Open item] » [Open variation] »Variation-ID

QuantityOnStock, mandatory, integer(10)

Item » Edit item » [Open item] » Tab: Stock » Tab: Stock » Net

IsOnStock, mandatory, boolean(0/1)

Item » Edit item » [Open item] » Tab: Stock » Tab: Stock » Net

DeliveryDate, integer(10)

Item » Variant » Tab: Settings » Section: Availability » Checkmark selection from 1 to 10

This selection is equivalent to the settings in the menu Setup » Item » Availability » Average delivery time.

PurchasePriceExcludingVat, mandatory, float(14,4)

Settings » Markets » Galaxus » Item Export » Product Stock Pricing » Choose Sales Price to export as Purchase Price Excluding Vat

SalesPriceExcludingVat, mandatory, float(14,4)

Item » Edit Item » [Open item] » [Open variation] » Tab: Settings » Sales prices: Net price

Note: The exported sales price uses the VAT.rate of the selected export currency only if the Target country is specified in the Elastic Export format.

Currency, mandatory, string(3)

Setup » Item » Sales prices » [Open Galaxus sales price] » Currency EUR / CHF

PurchasePriceExcludingFee, decimal number(14,4)

Settings » Markets » Galaxus » Item Export » Product Stock Pricing » Choose Sales Price to export as Purchase Price Excluding Vat

WarehouseCountry, string(2)

Setup » Stock » Warehouse » [Open warehouse] » Settings » Location

WarehouseId, mandatory, integer(1)

The identification number of the warehouse at Galaxus. Galaxus uses a GLN (Global Location Number) or the postcode of the warehouse.

ExpectedRestockQuantity, mandatory, integer(10)

Stock » Reorder management » Reorder » [Open reorder] » Ordered items

Note: If you don’t use reorders, the value 0 is transferred.
Input fields export format GalaxusProductPropertiesExport
Table 7. The GalaxusProductPropertiesExport export format
Galaxus output PlentyONE input field

ProductKey, Mandatory, string(100)

Item » Edit item » Variation ID

SpecificationKey, mandatory, string(80)

-

SpecificationGroup_DE, string(80)

Characteristic group name / Attribute (DE)

Note: The plugin selects the first group from the list of property groups in the order in which they were added to the property.

The following workaround should set GroupWeWantExported as the first in the list for the export:

For example, the property Property1 is to exist in the 3 groups GroupA, GroupWeWantExported and GroupB

  • Step 1: Unlink all groups from the property.

  • Step 2: Link GroupWeWantExported with Property1 and save the setting.

  • Step 3: Link all other groups with Property1 and save the setting.

SpecificationGroup_EN, string(80)

Characteristic group name / Attribute (EN)

SpecificationGroup_FR, string(80)

Characteristic group name / Attribute (FR)

SpecificationGroup_IT, string(80)

Characteristic group name / Attribute (IT)

SpecificationKey_DE, mandatory, string(80)

Characteristic designation / Attribute (DE)

SpecificationKey_EN, mandatory, string(80)

Characteristic designation / Attribute (EN)

SpecificationKey_FR, mandatory, string(80)

Characteristic designation / Attribute (FR)

SpecificationKey_IT, mandatory, string(80)

Characteristic designation / Attribute (IT)

SpecificationValue_DE, mandatory, string(80)

Characteristic value / Attribute (DE)

SpecificationValue_EN, mandatory, string(80)

Characteristic value / Attribute (EN)

SpecificationValue_FR, mandatory, string(80)

Characteristic value / Attribute (FR)

SpecificationValue_IT, mandatory, string(80)

Characteristic value / Attribute (IT)
Fields for item data export

For the correct export of item data in the Data » Elastic export menu, the following two fields must be included in the CSV file:

  • GPSRNameAddress

  • GPSREmailUrl

10.2. Configuring formats in the elastic export

Configuring the Elastic Export:

  1. Go to Data » Elastic Export.

  2. Click on New export.

  3. Configure the export as described in Table 8.

  4. Save the settings.

Table 8. Plugin relevant Elastic Export setup options
Setting Explanation

Name

Enter a name

  • The export format is listed under this name in the overview of the Exports tab.

Type

Select the type item from the drop-down list.

Format

Select one of the three relevant data export formats.

  • GalaxusProductDataExport

  • GalaxusProductPropertiesExpor

  • GalaxusProductStockPricingExport

Limit

Enter a whole number. This number determines how many items are exported at maximum. Enter an integer between 0 and 9999.

Generate cache file

Place a check mark if you want to export more than 9999 data records to the interface. We recommend that you do not activate this setting for more than 20 export formats. This is to ensure a high performance of the Elastic Export. Depending on the user configuration and amount of data, it can take more than 24 hours to update the cache file.

Provisioning

Privisioning via URL or FTP. If you select the method FTP, the FTP credentials and the export interval Daily/Hourly must be specified

URL

If you select the option URL, click on Generate token to create an access token.

File name

Name your export files as follows:

  • GalaxusProductDataExport = ProductData_Merchantname.csv

  • GalaxusProductStockPricingExport = ProductStockPricing_Merchantname.csv

  • GalaxusProductPropertiesExport = ProductProperties_Merchantname.csv

Item filter

Allow you to set up the export more granularly and thus ensure that only a specific subset of items is exported to Galaxus. Note that the plugin cannot use the following Elastic Export filters:

  • Item creation date

  • Default, Bundle, Bundle component

  • Item type

  • Positive stock for given warehouse

  • Positive physical stock in the selected warehouse

  • Prices

  • Tags AND mode

  • Tags OR mode

  • Item update date

Add item filters

Plugin relevant item filters are Active and Markets » Galaxus

Select an item filter from the drop-down list and click on Add. There are no filters selected by default.

Client

Default client

Order referrer

Select the order referrer that should be assigned during the order import from the drop-down list. In this case, this is: Galaxus

Barcode

Select the ASIN, ISBN or an EAN from the drop-down list. Selection must be linked to the referrer Galaxus. Otherwise, the barcode selection is not exported

Sales price

The exported sales price is always the Sales price net. The select Sales price gross is ignored during export.

11. Preparing order documents

You need the following order documents for Galaxus:

  • Invoice

  • Delivery note

Adjust these order documents to the requirements of Galaxus. Check the following chapters to find out how. This information is structured like this:

Are you new to order documents? Then refer to the Order documents page of the manual before continuing.

11.1. Preparing invoices

In this chapter you will learn which information is required for your invoices.

Important: This information is accurate as of 1st January 2025. Check if these requirements are still up to date in the Galaxus documentation.

Export invoices must contain the following information:

  • Name and address of the invoice issuer in the EU

  • Invoice address of customer in Switzerland

  • Galaxus order number, in other words the purchase order number of Digitec Galaxus AG

  • Net invoice amount, thus without VAT (in EUR or CHF)

  • Legal note that invoice belongs to a tax-free delivery:
    Tax-free export delivery in accordance with § 4 No. 1a) in conjunction with§ 6 UstG

  • Note regarding payment digitec.ch/galaxus.ch:
    Thank you for your order. The invoice amount has already been paid on www.galaxus.ch.
    Orders placed on www.galaxus.ch are subject to the general terms and conditions of Digitec Galaxus AG. In case of a return, please use the guided return process in your customer account on www.galaxus.ch.

The following information is not allowed on invoices:

  • A return address in the EU

  • The delivery address of the EU Hub in Efringen-Kirchen

Below is a sample export invoice:

galaxus export invoice
Figure 1. Sample: Export invoice

To show this information on the invoices, proceed as described below.

Saving VAT rates for Switzerland:

  1. Go to Setup » Client » [Select client] » Locations » Location: Germany » Accounting » Tab: VAT.

  2. Click on New configuration.

  3. Select the country Switzerland.

  4. Enter the VAT rates for Switzerland.
    Important: The VAT configuration cannot be changed in retrospect.
    Additional information

  5. Save the settings.

Uploading PDF template for invoices:

  1. Create a PDF template for invoices based on the requirements of Galaxus.
    Tip: Check the additional settings in Table 9. Can you place any of the notes directly on your PDF template for Galaxus invoices?

  2. Go to Setup » Client » Select client » Locations » Location: Germany » Documents » Invoice.

  3. Click on the tab PDF template.

  4. Click on Add template.
    → The editing window Upload new PDF template opens.

  5. From the drop-down list Payment method, select the option Galaxus Direct Checkout.

  6. Tip: Can’t find the payment method in the drop-down list?

    1. Go to Setup » Orders » Settings.

    2. For the setting Show inactive plugin payment methods, select the option Yes.

    3. Save () the setting.

  7. In the drop-down list Language, select the option de.

  8. In the line Template, click on Choose template file.

  9. Select the PDF template for Galaxus invoices.

  10. Click on Upload template ().
    → The template is uploaded.
    Tip: In the same menu, also carry out the settings for the PlentyONE template for invoices. The next chapter shows you how.

Adjusting invoice template:

  1. Go to Setup » Client » [Open standard client] » Locations » Location: Germany » Documents » Invoice » Tab: Template.

  2. For the setting Currency of the document, select the option Order currency. Important: This setting is applied to all invoices of the location, not just to Galaxus.

  3. Scroll down to the area Optional elements below stock unit table.

  4. Carry out the settings described in <table-delivery-notes>.
    Tip: Depending on your layout, you might be able to place all notes in just one input field Payment instruction.

  5. Check the Galaxus documentation to see if any other adjustments to your template are required.
    Important: The template is used for all invoices for this country, not just for Galaxus.

  6. Save () the settings.
    → The necessary information is shown on invoices.

Table 9. Settings for invoices
Requirement Settings in the template

Purchase order number of Digitec Galaxus AG

  1. Scroll down to the area Optional elements below stock unit table.

  2. For the setting External order number, select the option Yes from the drop-down list.

mytoys delivery note settings 2

Legal note regarding tax-free delivery

Use the input field Payment instruction.

  1. Scroll down to the area Optional elements below stock unit table.

  2. Find a field that does not contain any payment instructions.

  3. From the drop-down list Payment method of this field, select the option Galaxus Direct Checkout.

  4. Copy the following text into the field:
    Tax-free export delivery in accordance with § 4 No.1a) i.V.m. §6 UStG

Tip: Alternatively, you can place this note directly on your PDF template for Galaxus invoices.

Payment note

Use the input field Payment instruction.

  1. Scroll down to the area Optional elements below stock unit table.

  2. Find a field that does not contain any payment instructions.

  3. From the drop-down list Payment method of this field, select the option Galaxus Direct Checkout.

  4. Copy the return instructions into the input field:

Thank you for your order. The invoice amount has already been paid on www.galaxus.ch.
Orders placed on www.galaxus.ch are subject to the general terms and conditions of Digitec Galaxus AG. In case of a return, please use the guided return process in your customer account on www.galaxus.ch.

Tip: Alternatively, you can place this note directly on your PDF template for Galaxus invoices.

11.2. Preparing delivery notes

Delivery notes for Galaxus orders must contain specific information. These requirements are listed on Galaxus.

Below, we describe how you show the following information on delivery notes for Galaxus:

  • Galaxus order reference

  • Legal information

To make sure that this information is shown on delivery notes, adjust the template for delivery note as described below.

Adjusting template for delivery notes:

  1. Go to Setup » Client » Standard » Locations » Location: Germany » Documents » Delivery note » Tab: Template.

  2. Scroll down to the area Optional elements below stock unit table.

  3. Carry out the settings described in <table-delivery-notes>.

  4. Check the Galaxus documentation to see if any other adjustments to your template are required.
    Important: The template is used for all delivery notes for this country, not just for Galaxus.

  5. Save () the settings.
    → The necessary information is shown on delivery notes.

Table 10. Settings for Galaxus delivery notes
Setting Option

Purchase order number of Digitec Galaxus AG

  1. Scroll down to the area Optional elements below stock unit table.

  2. For the setting External order number, select the option Yes from the drop-down list.

mytoys delivery note settings 2

Payment instruction

  1. Find a field that does not contain any payment instructions.

  2. Click on the drop-down list Payment method of this field.

  3. Select the option Galaxus Direct Checkout.

  4. Copy the following Galaxus return instructions into the input field (correct as of 15th July 2022):

Payment has already been made directly to Digitec Galaxus AG.

In the event of a return, we kindly ask you to use the returns process in your customer account on digitec.ch or www.galaxus.ch.

Orders placed via digitec.ch and galaxus.ch are subject to the General Terms and Conditions of Digitec Galaxus AG. If you have any questions or uncertainties, the customer care team of digitec and Galaxus will be happy to help: merchant@galaxus.de or haendlerprogramm@digitecgalaxus.ch.

12. Automating order processing

Set up event procedures to notify Galaxus about order changes automatically.

12.1. Available event procedures

For Galaxus, the event procedures listed in Table 11 are available.

Table 11. Galaxus event procedures
Event procedure name Recommended event Explanation

Send order confirmation to Galaxus

Any

  • Informs Galaxus about changes made to the PlentyONE order.

  • Important: The default delivery date is the current date + 2 working days. This can differ depending on item availability and item settings.

Send shipping confirmation to Galaxus

Status change

Informs Galaxus that the order is ready for shipping.

'Send a cancel request accepted notification to Galaxus

Status change

Informs Galaxus that the cancellation request was accepted.
Cancellations for individual order items are rejected automatically (Reason given for auto rejection: Non-refundable). Cancellations of complete orders are accepted automatically if the initial order does not yet have the status Shipped.

'Send a cancel request not accepted notification to Galaxus

Status change

Informs Galaxus that the cancellation request was rejected.
A reason for the rejection can be entered in the order note before executing this procedure.
Cancellations for individual order items are rejected automatically (Reason given for auto rejection: Non-refundable). Cancellations of complete orders are accepted automatically if the initial order does not yet have the status Shipped

'Merchant Cancels' notification to Galaxus

Status change

Informs Galaxus that the order was cancelled by the merchant.

'Send a 'return registration accepted' response to Galaxus.

Status change

Informs Galaxus that the return request was accepted.

'Send a 'return registration not accepted' response to Galaxus.

Status change

Informs Galaxus that the return request was rejected.

A reason for the rejection can be entered in the order note before executing this procedure.

'Send a 'Return to merchant accepted' notification to Galaxus

Status change

Informs Galaxus that a return to the merchant was accepted.

'Send a 'Return to merchant denied' notification to Galaxus

Status change

Informs Galaxus that the return request was rejected by the merchant.

A reason for the rejection can be entered in the order note before executing this procedure.

Send invoice to Galaxus

Status change

Sends the invoice PDF of the order to Galaxus.

12.2. Example: Setting up the event procedure "Send order confirmation to Galaxus"

For example, set up an event procedure to send automatic order confirmations to Galaxus:

  1. Go to Setup » Orders » Events.

  2. Click on Add event procedure.
    → The Create new event procedure window opens.

  3. Enter a name.

  4. Select the order event Order change > Status change.

  5. Save the settings.
    → The settings of the event procedure are shown.

  6. Add a Filter with the selection Order » Order type » Order.

  7. Add a Filter with the selection Order » Referrer » Galaxus.

  8. Add an Action with the selection Plugins » Send order confirmation to Galaxus.

  9. Save the settings.

13. Particularities of the Galaxus order processing

  • Galaxus return requests generate new PlentyONE orders of the type Return. These orders are linked to the initial order. The resulting orders must be processed separately.

  • Go to Order » Overview » Item » Edit » Delivery date to enter the delivery date. If no delivery date is saved, a delivery date is calculated based on the following formula:
    [Day the event procedure "Send Order Confirmation to Galaxus" was triggered] + 2 working days

  • A shipping date is also not set if the item quantity needed to fulfil the order is not available as net stock. The planned delivery date can change based on the plugin option Positive stock quantities are always exported, independent of the average delivery period in the menu Setup » Markets » Galaxus » Tab: Product Stock Price.

  • In all scenarios where only a part of the order is to be processed (return/shipping), the imported order must be split. The resulting orders must be processed separately.
    How to split an order:

    1. Go to Order » [Open order].

    2. Split the order from Order » Overview » Gear (split).
      → The window Split order opens.

    3. Select the item quantities for the new order.
      Important: The shipping costs of the original order will not be changed.
      → After splitting an order, the plugin can inform Galaxus without any additional user input.

  • Orders with an invoice address in Liechtenstein and a delivery address in the EU are imported as net orders.

14. Order data exchange: scenarios

The Galaxus plugin supports the following scenarios.

Important: All scenarios except cancellation requests can be applied to both complete orders and partial orders. As such and to avoid duplicate content, scenarios for complete orders are not described separately.

14.1. The imported order is ready for shipping

The imported order contains all required information and is ready to be shipped:

  1. The order import was automatically reported back to Galaxus by the event procedure Send Order confirmation to Galaxus.

  2. When your order is ready to be shipped, trigger event procedure Send shipping confirmation to Galaxus.

14.2. Only part of the imported order can be fulfilled

Only part of the imported order can be fulfilled at this time. The customer agrees to receive half of the oder now. The other half will be sent at a later date:

  1. Go to Order » [Open order].

  2. Click on Split.

  3. If a later delivery date has been agreed upon with the customer, go to New order » Overview » Item » Edit » Delivery date.

  4. Enter the delivery date.

  5. Save the settings.

  6. Trigger the event procedure Send Order Confirmation to Galaxus to inform Galaxus about the new delivery date.

  7. When finished, trigger event procedure Send Shipping Confirmation to Galaxus.

14.3. Parts of an order cannot be fulfilled

You realised that part of the order cannot be fulfilled, for example because the item is out of stock.

  1. Go to Order » [Open order].

  2. Click on Split.

  3. Trigger the event procedure Send Order Confirmation to Galaxus.

  4. Trigger the event procedure Merchant Cancels notification to Galaxus.

  5. Galaxus automatically replies with a Cancellation request.

  6. The cancellation request can be rejected or accepted by triggering either the event procedure Accept Galaxus cancellation request or Reject Galaxus cancellation request with justification.

14.4. The customer has requested a partial return

The customer wants to return parts of the order.

  1. Galaxus receives the return request.

  2. PlentyONE creates a new order of the type Return that is linked to the initial order.

  3. Trigger the event procedure Accept Galaxus Return Request or Reject Galaxus Return Request with Explanation.

14.5. The customer has rejected the package

The customer did not accept your delivery for an unjustified reason. The package has now been returned to you.

  1. Open the order.

  2. Create a new order of the type Return.

    • Go to Order » Overview.

    • Open the drop-down list Return.

    • Click on Create.

  3. Create a return for the necessary quantity.

  4. Trigger the event Accept cancellation to merchant oder Cancellation to merchant denied with justification.

Note:

  • Partial cancellation requests and cancellation requests for orders with a status higher than [5] In preparation for shipping are automatically rejected with the reason Non-refundable.

  • Go to Setup » Markets » Galaxus » Order status configuration to select a different status for rejecting such requests automatically.

15. FAQ and troubleshooting

Galaxus is not shown in the menu Setup » Markets?

The menu Setup » Markets » Galaxus is only shown after you carry out the following steps:

  • The plugin is installed in the plugin set in which the default client is linked.

  • The plugin was provisioned.

  • The order referrer Galaxus is active in the menu Setup » Orders » Order referrer.

The column Category is empty in the export. No category is exported. What now?

  • On Galaxus, your variations are offered using your default client (store). As such, check that the category is linked to the default client (store).

  • The default category of the variation is exported in all cases. As such, check that the variation has a default category that is linked to the default client (store).

Linking the default client to the category:

  1. Go to Item » Category.

  2. Click on the category in the directory tree on the left.
    → The category opens and the tab Settings is shown.

  3. Navigate to the setting Client (store).

  4. Activate the option Standard ().

  5. Save () the settings.

checklist category client

Choosing the default category:

  1. Go to Item » Items » [Open variation] » Element: Categories.

  2. Within the element, click on and then on link Link default category.
    → A pop-up window will open.

  3. Use the drop-down list to select a default category for each client.

  4. Click on Save.
    → The data will be displayed as a table.

  5. Save () the settings.