Troubleshooting & Checklists
Your item is not being exported or synchronization isn't working? Here you will find checklists, pre-check tools, and troubleshooting tips.
-
Why does the Shopify export fail for an item or variant?
If an item or variant cannot be exported to Shopify, even though the general export conditions appear to be met, this is often due to the availability and stock settings of the variant.CauseThe option Automatically unavailable when no net stock is enabled for the affected items or variants. If an item or variant with this setting has no stock, the export to Shopify will be blocked.As soon as stock is entered for the variant, the export resumes and the update to Shopify is carried out.Step-by-step guide to fix the issueTo resolve the problem, you can either adjust the stock of the variant or change the automatic setting of the variant:Navigate in your PlentyONE system to: Items » Items and open the affected item or variant.Switch to the Availability tab (or Visibility).Make one of the following adjustments:Solution A: Enter a positive stock quantity for the variant.Solution B: Disable the option Automatically unavailable when no net stock if the item should be exported to Shopify even without stock.Save the settings.
Weiterlesen → -
What role do the client and the Shopify shop play in the export of variants and stock levels?
When exporting stock levels to Shopify, the shop selected in the system or the stored client (tenant) must exactly match the availability settings of the affected variant.Correct selection when exporting stockIf a variant is enabled in PlentyONE for a specific Shopify shop, the stock level can only be successfully exported via the corresponding account.Check in the variant under Availability which Shopify shop is stored.When executing the stock export, ensure that the identical client or the correct account is selected.If no availability is set for the selected shop on the variant, the export will be aborted because no exportable variant can be found.
Weiterlesen → -
Why is an item created twice when exporting from PlentyONE to Shopify?
An item is created as a duplicate when exporting from PlentyONE to Shopify if the item was previously manually created directly in Shopify and there is no internal system linkage (mapping) between the variants.Cause of the duplicate item creationPlentyONE uses an internal database linkage (plenty_shopify_variants) for synchronising items with Shopify, which assigns PlentyONE variant IDs to the respective Shopify variant IDs.If an item is manually created in Shopify, this system linkage is missing. During the automatic item export, PlentyONE does not subsequently link solely via the SKU. Since the system cannot find the variant in its own assignment register, it creates the item anew in Shopify, which leads to two identical items with the same SKU.Step-by-step guide to resolve the issueProcedure for existing items in ShopifyDelete the manually created and unlinked item in the Shopify backend.If items have been created in Shopify and are to be merged with PlentyONE, first perform an item import from Shopify to PlentyONE. This will co...
Weiterlesen → -
Why are my product images from PlentyONE not transferring to Shopify?
If product images from PlentyONE are not displayed in your Shopify store, this is usually due to a missing origin on the image or a missing link to the variant.Cause of the missing image transferFor images to be processed during the product export by the Shopify app, two conditions must be met: The images must be explicitly assigned the marketplace Shopify and the images must be linked to the respective variants. If the origin is missing on the image, it will be skipped during export.Step-by-step guide to resolve the issueNavigate in your PlentyONE system to: Products » Products and open the affected product.Switch to the Images tab.Ensure that for each image in the Markets section, the origin Shopify is activated.Check in the Availability section whether the image is assigned to the desired variant.Save the changes to the product.Tip: If the origin is missing for multiple products, you can update the image availabilities collectively via a data import (FormatDesigner / Import).
Weiterlesen → -
Why are categories not transferred to Shopify after changing the client?
If categories are no longer transferred to Shopify after changing the client, this is usually because the category settings have not yet been explicitly applied for the new client.Cause of the faulty transferWhen changing the assigned client, the category settings often remain in the system on the original client. Since the client linked to Shopify is therefore not actively assigned to the categories, no category data is transferred to Shopify during the automated export process.Step-by-step guide to resolveNavigate in your PlentyONE system to: Items » Categories.Open the affected category.Click the button Apply category settings.Select the correct client that is connected to your Shopify shop.Click again on Apply category settings to save the assignment.Perform these steps for all categories that should be transferred to Shopify..
Weiterlesen → -
Why does the PlentyONE App in Shopify only show a white screen?
A white screen in the PlentyONE App within Shopify usually indicates an incorrect DNS configuration of your domain.Cause of the errorFor the PlentyONE App to load correctly in the Shopify backend, the app's requests must reach the PlentyONE system. If the domain used is not configured correctly or redirects to an external shop domain are set up, the requests do not reach the PlentyONE system and the app remains white.Step-by-step guide to fixLog in to your domain provider or DNS manager.Open the DNS settings for the affected domain.Create a CNAME record that points from your domain to your personal PlentyONE shop address (e.g. your-domain.co.uk must point to pXXXXX.my.plentysystems.com).After making the changes, clear your browser cache.Open the PlentyONE App again in the Shopify backend.
Weiterlesen → -
Why is the stock level of a bundle item not correctly transferred to Shopify?
An item exported as a bundle is displayed in Shopify like a regular item, since Shopify does not natively support bundles directly without an external app. For the stock level of the main item and its individual components to be correctly calculated and synchronised, specific requirements must be met.Requirements for synchronising bundle itemsTo keep the bundle and its individual components synchronised, the following conditions must be met:Separate export of all components: In addition to the main item (bundle), all included bundle components must also be exported separately to Shopify .Assigned SKUs: Both the main item and all bundle components must have their own SKU for the marketplace Shopify .Step-by-step guide to troubleshootingEnsure that a SKU for Shopify is assigned to both the main item and all bundled components.Check that all individual bundle components have a positive stock level in the linked warehouses.Export the main item as well as all bundle components to Shopify.Create a test order in Shopify and carry out the ...
Weiterlesen → -
Why are my properties / metafields not transferred to Shopify?
The export of your properties to Shopify only works reliably if the configuration in Shopify exactly matches the officially supported specifications.Supported configuration in ShopifyFor your metafields to be exported correctly from PlentyONE, you must use the following configuration in Shopify:Type: SingleFormat: Single-line textNotes on unsupported formatsPlease note that other settings (such as the type List) are not officially supported. Although such configurations may work in individual cases, this can lead to a missing transfer. We cannot guarantee functionality for configurations that deviate from the standard. Update timestamps for marketplace exportsOnce an input field mapping for metafields was created in the wizard, or a property was created or modified, any changes to the relevant items must be saved so that the metafields are transferred during the next export.The easiest way to do this is to use the variation group function: Update timestamps for marketplace exports. Product changes are imported once an hour. Once th...
Weiterlesen → -
How do I fix errors with Shopify image synchronisation?
As a rule, PlentyONE automatically synchronises product images with Shopify. twice, the order is incorrect, or old images continue to be displayed in Shopify even though they have been deleted in PlentyONE, you can trigger a manual clean-up.When is a clean-up useful?Use this function only if one of the following errors occurs:Duplicate images: Images are displayed multiple times in Shopify.Incorrect order: The image positions in Shopify do not match those in PlentyONE.Missing images: Images are not fully transferred after more than 24 hours despite correct settings.Outdated images: Images that have been deleted in PlentyONE are still visible in Shopify.[!CAUTION] Important note on the process: The clean-up first deletes all images of the affected products in Shopify and then transfers them again from PlentyONE. During this process, the products in your shop will temporarily be displayed without images.Carrying out the clean-upIn your PlentyONE system, navigate to: Setup » Markets » Shopify App » Help.Go to the Product Image Clean-u...
Weiterlesen → -
How do I import Fulfilled by TikTok (FBT) orders via Shopify into PlentyONE?
The automatic import of orders processed via TikTok Fulfillment (FBT) and handed over via Shopify to PlentyONE currently does not work smoothly. This is because TikTok blocks the order data in Shopify for about an hour to allow cancellations. As a result, the orders fall outside the regular automatic import time window of PlentyONE.Current Workaround (Manual Solution)Since an automatic adjustment of the import timeframe (cron job) is not planned in order to avoid performance degradation for all users, you currently need to trigger the import of the FBT orders manually.How to trigger the import manually:Navigate in your PlentyONE system to: Setup » Markets » Shopify » Settings.Select the corresponding Shopify market.Switch to the Settings tab or the corresponding tab for order import (the exact path may vary depending on the plugin version, see attached screenshot in the original conversation).Find the option to manually trigger the order import (e.g. a button labelled Trigger Import).Perform the import.Important: The manual import ...
Weiterlesen → -
Is there a tool that automatically checks if my variant is ready for the Shopify export?
Yes, PlentyONE offers a very practical diagnostic tool that allows you to specifically check a single variant for all necessary export conditions for Shopify. This is the quickest way to find errors in a particular variant.How to use the export check:Open the menu Setup > Markets > Shopify App > Help > Export Conditions.Select the webshop (client) at the top for which you want to perform the check.Enter the ID of the variant you want to check.Click on Check.You will then receive a detailed list of all export requirements. Fulfilled conditions are marked in green with a OK, while missing or incorrect settings are marked in red with a X.Important: A variant is only exported to Shopify if all conditions on this list are met without errors. Among other things, the tool checks whether the variant is active, has a Shopify SKU and a valid price, all texts and translations are present, and the Shopify limit of 100 variants per item is not exceeded.Note: Shopify itself does not necessarily require a sales price for a valid export. This is s...
Weiterlesen → -
My variant is not being exported to Shopify. Is there a checklist I can go through?
Yes. If a variant does not appear as expected in your Shopify store, it is usually due to one of the following settings in PlentyONE. Go through this checklist point by point to find the cause. Checklist for variant export1. Is the variant itself active?Where? Items > Items > [Open variant] in the Availability and visibility section.What? The checkbox for Active must be checked.2. Is the sales channel "Shopify" assigned?Where? Items > Items > [Open variant] in the Sales channels section.What? The sales channel Shopify must be added.3. Is the correct client (store) activated?Where? Items > Items > [Open variant] in the Availability tab.What? The checkbox for the client connected to Shopify must be checked.4. Is a Shopify SKU stored?Where? Items > Items > [Open variant] in the Availability tab, SKU section.What? There must be a SKU specifically for the origin Shopify.5. Is the sales price set up correctly?Where? Items > Items > [Open variant] in the Sales prices section.What? A price must be stored in a sales price that is activated ...
Weiterlesen → -
Why is my product not being exported to Shopify even though it is active and enabled for the sales channel?
A common reason for this is that the correct tenant (shop) is not activated for the variant. PlentyONE only exports variants for which the tenant assigned is the one connected to your Shopify store.Here’s how to ensure the correct tenant is activated:Open the corresponding variant in the menu Products > Products.Switch to the Availability tab.In the Tenant (shop) section, check the box for the tenant you use for your Shopify sales.Save the setting.After you have activated the tenant, the variant will be considered for the next export to Shopify.
Weiterlesen →