Starting
Preamble
Compatibility The module has been developed and tested for the following Amazon marketplaces: Amazon France Amazon Italy Amazon Spain Amazon United Kingdom Amazon Germany Amazon Poland Amazon Belgium Amazon Netherlands Amazon Ireland Amazon Sweden Amazon U.S. Amazon Canada Amazon Mexico Amazon Japan Amazon India Amazon Australia Version 5 of the module is compatible with PrestaShop 1.7, PHP 7.4 and higher. Pre-confiSome readersInstalling and upgrading the module
Module Installation Procedure The installation procedure is described on the official PrestaShop website: 🔗 View the documentation here Although this documentation is somewhat old, it remains fully valid. It covers all possible scenarios in detail, which is why we have not found it necessary to rewrite it. If there is a problem with automatic installation If the automatic installation from the back office fails, you can folloSome readersAuthorizing Access to Amazon Seller Central
For the Amazon Prestashop module to work properly (order import, product sync, etc.), you must authorize access to your Amazon account through Amazon Seller Central. When should this authorization be done? During the initial setup of the module. If your authorization has expired or has been revoked by Amazon. Tutorial video ➡️ Click here to watch the step-by-step guideSome readersUnderstanding the difference between an offer and a product
To better understand how marketplaces like Amazon work, let’s take a simple example: Imagine you're looking at a store window. A T-shirt catches your eye. You enter the store, head to the relevant section, and find the T-shirt available in various sizes, colors, and prices. These different options are what we call offers. Product vs Offer On marketplaces, the principle is similar: The product refers to the main listing: images, description, features. The offer refSome readersValidate your catalog structure
It is essential to apply a consistent methodology when creating your products: defining references, assigning EAN codes, etc. This ensures a well-structured catalog for both internal use and external platforms such as marketplaces. On Amazon, the Reference field in PrestaShop is used as the SKU (unique internal identifier). This field is necessary to identify your offers and import orders. ⚠️ If the Reference field is empty, incorrect, or used multiple times in your catalog, sySome readersUnderstanding logging
The Amazon module for PrestaShop uses an internal logging system. Each time a product is updated (price, stock, description, etc.), an event is recorded in the database when you click Save. These updates are then processed during the next export to Amazon. In detail The module relies on PrestaShop Hooks to detect changes: 🔗 PrestaShop Dev Docs – Hooks 🔗 PrestaShop Help Center – Hook System (https://helSome readersEligible products
For a product to be eligible for export or synchronization with Amazon via the module, it must meet all of the following conditions: General Conditions The product belongs to at least one category selected in the module’s Categories tab It has a Reference (SKU) It has a valid barcode (EAN or UPC) It is not excluded by a Manufacturer or Supplier filter (in the Filters tab) The following fields are required: Product name, Quantity, PSome readersWhat is product matching
Case 1: The SKU already exists in your Amazon account If your PrestaShop product SKU exactly matches an existing offer in your Amazon Seller Central account, the module will directly update that offer with the latest quantity, price, and other data. Case 2: The SKU does not exist in your Amazon account If the SKU is not yet present, but the product has a valid EAN/UPC code, the module can send the offer using this code. Amazon will then search for a matching producSome readersTechnical Glossary
Synchronization Field Field used by Amazon to identify a product. Typically EAN for Europe and UPC for the United States. Invoice by Email Sends the PDF invoice generated by PrestaShop to the buyer, according to Amazon’s recommendations. The email is transmitted via the so-called "encrypted" address. Code Exemption Authorization granted by Amazon to sell without an EAN/UPC. This requires specific technical settings provided by Amazon support. FBA (Fulfillment byFew readers
Configuring
Features
PrestaShop Amazon Marketplace Features Feature Management To maintain a clear and accessible interface while addressing a wide range of needs, the module allows you to enable only the features you require. Recommendations: The features enabled by default after installation are sufficient to get started. Do not enable all features unnecessarily, as this would mFew readersMarketplace Configuration
Marketplace Tab The Marketplace tab (or tabs) is represented by a flag, depending on the language used for the marketplace: Marketplace Tab For each language configured in Localization Languages, a new tab will appear. Configure: The Amazon marketplacFew readersParameters
PrestaShop Amazon Marketplace parameters Standard Parameters Discount / Promotion Allows you to export products on sale or with a specific price. 👉 See the documentation on promotions and sales Pre-order Allows you to sell products with a future availability date (AvailabiFew readersProduct Creation Generalities
Profiles Profiles are used to assign common characteristics to your products so that they comply with the structure expected by Amazon. A single profile can be applied to multiple categories in PrestaShop. However, a category can only be associated with one profile. The settings defined in the profile will be used for all prFew readersConfiguring a Profile
PrestaShop Amazon Marketplace Profiles Profiles are used for product creation. They allow you to assign common characteristics to products so they match Amazon’s expected structure. A single profile can apply to multiple categories (https://doc.common-services.com/en/article/categories-amazon-markeSome readersAmazon categorization - Browse Node ID
Recommended Browse Node (Browse Node ID) The Browse Node ID is used for product creation. It is essential for properly classifying your products on Amazon. It is required for Canada, Europe, and Japan. Where to find your Browse Node ID? You can find it by downloading your Amazon product type file (flat file): 👉 Download an Amazon Product Type File (https://sellercentral.amazon.co.uk/product-searchFew readersMappings - Amazon Marketplace
PrestaShop Amazon Marketplace Mappings tab Mappings are used for product creation. Once your profiles are configured, some fields may still require a manual match between your PrestaShop values and the values expected by Amazon. This is what we call mapping.Some readersCategories - Amazon Marketplace
PrestaShop Amazon Marketplace categories tab Products within the selected categories will be considered eligible for synchronization with Amazon. How it works Only eligible products from these categories are included in logging (https://doc.common-services.com/en/article/understanding-loggiFew readersFilters - Amazon Marketplace
PrestaShop Amazon Marketplace - Filters Tab From the Filters tab, you can selectively exclude products from being synchronized/exported to Amazon using several filtering options, such as price range, brand, or supplier. ℹ️ Products excluded via these filters will not be exported. However, existing listings will not be taken offline even if excluded. In this cFew readersTools
PrestaShop Amazon Marketplace – Tools Tab The Tools tab provides several key functions to help manage product identifiers, import valid Amazon values, and review pending synchronization actions. Product Reference File This import/export tool allows you to quickly edit EAN/UPC codes and SKUs (product references) in PrestaShop. ➡️ See the dedicatFew readersProduct references and codes import/export tool
📍 Go to Modules Amazon Tools If your products have missing references or EAN/UPC codes, this tool allows you to update your product listings efficiently in 3 steps: 📤 Export the CSV file ✍️ Edit the file using Excel or OpenOffice 📥 Import the modified file ⚠️ Important: You are fully responsible for your data. Always backup your database before importing any file. This is an internal module file: it does not send any data to Amazon.Few readersShipping - Amazon Marketplace
Modules Amazon Configure Shipping If you have configured Shipping Templates on Amazon, you can use them in the Amazon module for PrestaShop. Prerequisites To ensure feed stability, the module does not allow manual entry of shipping group names. For the module to detect your ShipSome readers
Using
First commissioning
Prerequisites Before you begin, make sure you have: Validated your catalog structure Understood the difference between an offer and a product Verified that your products are eligible for sale on Amazon Catalog AmazonSome readersSending and Syncing Offers
Prerequisites Before starting, make sure you have: Validated your catalog structure Understood the difference between an offer and a product Verified that your products are eligible for sale on Amazon Catalog AmazonSome readersProduct Creation
Prerequisites Before starting, please ensure you have: Validated your catalog structure Clearly understood the difference between an offer and a product Verified your product eligibility Reviewed the Amazon categorization sySome readersReport
Catalog Amazon Report Whatever operation is performed — synchronization (Offers tab) or product creation (Products tab) — you must generate a report. The report provides the submission IDs as well as informational messages, warnings, and errors related to the last feed sent. Generate the Report Select a report, then click the View Report button in the Catalog Amazon Report tab. PrestaShop Amazon Marketplace view report (https://storaSome readersOrder Import
Importing Amazon Orders PrestaShop Amazon Marketplace Orders Import page Manual Import Steps Go to Catalog Amazon Orders. Select the desired dates and statuses. Click Show Orders. A list will appear: you can import orders individually, or select multiple lines and click Import Selected Orders. Automating theFew readersOrder Statuses
Once the orders are imported and shipped, the module must notify Amazon of the status update and tracking number. Amazon will then notify the customer. Automated Process This process can be automated using a scheduled task (cron job). What to Check 1. Module Configuration Make sure you have defined a "shipped/expedited" status in the Parameters tab of the module: PrFew readersProduct Sheet Extension
When you open a product sheet in PrestaShop, a new Amazon tab appears alongside the usual tabs: PrestaShop Amazon Marketplace product sheet module tab PrestaShop Amazon Marketplace product sheet Amazon module Tab Content This tab containsFew readersScheduled tasks
Modules Amazon Scheduled Tasks To ensure the proper functioning of the Amazon Marketplace module, it is essential to correctly configure your scheduled tasks (cronjobs). ⚠️ Important Recommendation We no longer recommend using the "PrestaShop Cronjobs" module available on Addons or GitHub. This module is no longer maintained or supported bSome readersPricing Rules
You can define automatic pricing rules for your Amazon exports. These rules apply to the prices including tax. Where to Set the Rules? Pricing rules can be configured in two places: In the Marketplace tab (applies to all products) In the Profile tab (applies to selected groups of products) 🔸 Priority: Rules set in the Profile tab will override those set in the Marketplace tab. How It Works Pricing rules are defined in price ranges. For eaSome readersSell collectibles, used or reconditioned products
The module allows you to export your products to Amazon with different conditions: new, used, refurbished, etc. Enable the Option Go to the Features tab of the module. Enable the option "Second Hand". Enable the option "Second Hand" Configure the Condition Mapping Once enabled, a new section appears in the Parameters tab: Condition Mapping.Few readersImport existing catalog from Amazon
Save time and simplify product management by importing your existing Amazon catalog directly into your PrestaShop store. No need to manually enter products — this feature helps you quickly sync key product data. How to Enable Go to Modules Amazon Configure Features Activate the option "Import" Enable the import feature Once enabled, a new mFew readersAdditional Languages - Additional Amazon Platforms
Multi-Amazon Platform Configuration If your module is already configured for one marketplace and you want to use other Amazon platforms, here is the procedure to follow. 1. Enable Additional Marketplaces Go to Modules Amazon Configure Features Enable the options you need: Europe, USA, Worldwide, Amazon BE (Belgium) or Amazon ZA (South Africa). Amazon Platforms Activation (https://storage.crisp.chat/users/helpdesk/website/-/3/f/a/8/3fa8ee645cd1Few readersMessaging
The module includes a messaging system that is fully compatible with Amazon, allowing you to communicate with your customers while respecting Amazon’s strict rules (e.g., no links to your store). Prerequisite Activation Before using messaging features, you must activate it via: Modules Amazon Configure Features Messaging Available Functions In the Messaging tab, you will find three main features: Automatic invoice email Seller review request (Few readersFBA
Using the Amazon Module with FBA If you have subscribed to Amazon FBA and already know how it works, the module allows you to take full advantage of it. Configuration Steps Go to the module’s Features tab. Enable the option Amazon FBA. Go to theFew readersAmazon Business
Learn More To learn more about Amazon Business, visit: 👉 https://sell.amazon.com/programs/amazon-business.html Activation Enable Amazon Business in your Amazon Seller Central account. Enable Amazon Business in Modules Amazon Configure Features. Module Features Amazon Business allows you to: Sell to professional customers Apply tax rules based on the buyer’s location Offer volumFew readersOrder Cancelation
This feature allows the module to cancel orders in both directions: If a customer cancels an order on Amazon, the module cancels it in PrestaShop If you cancel an order in PrestaShop, the module cancels it on Amazon How to Enable Go to Modules Amazon Configure Features tab Enable “Order Cancelation” Enable Cancelation (https://storage.crisp.chat/users/helpdesk/website/-/3/f/a/8/3fa8ee645cd13200/prestashop-amazon-marketplace-1n9q6tl.pFew readers“Amazon Remote Cart” Feature
What is it? In multichannel sales, one major risk is selling the same product at the same time on multiple platforms (your store, Amazon, etc.), especially if only one unit is in stock. This can lead to: A cancelled order for a customer — poor experience. A penalty from Amazon for unfulfilled sales. The Solution: Amazon Remote Cart The module introduces a system to reserve products that are in the process of being purchased on Amazon. (https://storage.Few readersManagement of promotions and sales
All of the following indications apply only if the "Sales/Promotions" box is checked in the Parameters tab of the module. Outside the Sales Period If a specific price is defined in PrestaShop, this price will be exported to Amazon as the regular price: Specific price During Sales To mark a product as being on sale, you must check the “OSome readersSelect products
By default, the module exports only products that have been modified, using the logging system. How to add a product to the export queue? Simply modify a product — for example: change the stock quantity update the price This automatically adds the product to the export log. Manual selection from the product sheet You can also manually force a product to be sent to Amazon from the proSome readersCronjobs Parameters
Access: Modules Amazon Scheduled tasks Cronjobs Parameters Each Amazon marketplace has its own cron URLs, allowing you to automate order imports, status updates, or product synchronization. Note – Amazon Marketplace Plus If you are using the Amazon Marketplace Plus (SaaS) version, the scheduled tasks are already configured on our servers. 👉 You only need to activate them in the module’s Scheduled Tasks tab. Here are all the available options in the iFew readersGenerate JSON
Generate JSON and Report for Support For any support request to Amazon or Common-Services, it is essential to provide the generated JSON file and the report. Here are the steps to retrieve them. 1. Clear the Queue Go to Modules Amazon Tools. If there are products pending, they will be listed. ➡️ Select all rows and click Delete. Clear the queue --Some readers
Tutorials
Activate the “DEV_MODE”
⚠️ Important Only follow these steps if you have been instructed to do so by our support team. Temporary Diagnostic Steps Activate Expert Mode 👉 Guide: https://doc.common-services.com/en/article/activate-expert-mode-1wa1807 Enable DEVMODE Go to the module configuration and activate the option as shown below: Activate DEVMODE Amazon module (https://storage.crisp.chat/users/helpFew readersDeleting Products
This guide explains how to delete one or more products on Amazon using the Amazon Marketplace module for PrestaShop. Steps to follow 1. Activate Expert Mode Enable Expert Mode in the Features tab of the module configuration. 2. Select the products to delete Go to this page: Select products Choose the action *DeleteFew readersDebug Express
Activate Expert Mode and Debug Mode (only if instructed) Follow these steps only if support has instructed you to do so. Access the Module Features Go to Modules Amazon Features: PrestaShop Amazon Marketplace Features tab Scroll down to the Expert Mode section and activate it: Activate Expert Mode (https://storage.crisp.chat/users/helpdFew readersTutorial – Creating products of type Games, Toys
1. PrestaShop Product Sheet Example of a product sheet: PrestaShop Amazon Marketplace example product sheet The product has no combinations The reference and EAN code are filled 👉 See: Validate your catalog structure 2. Create an Amazon Profile See: ProfilFew readersTutorial – Creating Products of Clothing Type
1. Product Sheet in PrestaShop Here is an example of a product with combinations: Product with combinations The product has combinations (e.g. size, color) Each combination must have a unique EAN code A main reference + a unique reference per combination must be filled in 👉 See: Validate your catalog structure (https://doc.common-services.com/Few readersTutorial – Creating Products of Jewelry Type
1. Product Sheet in PrestaShop Here is an example product with combinations: PrestaShop Amazon Marketplace example product jewelry The product has combinations (e.g., ring sizes) Each combination must have a unique EAN code Enter a main reference and a unique reference for each combination 👉 See: Validate your catalog structure (https://doc.comFew readersEmpty the Queue
Go to: Modules Amazon Configure Tools If there are products in the queue, they will appear here. Check all the boxes Click Delete PrestaShop Amazon Marketplace empty the queue The queue is now empty.Few readersActivate Expert Mode
⚠️ Warning If you reached this page without direct instructions from our support team, do not follow the steps below. Expert Mode is intended for advanced users. It enables features that, if misused, may lead to complex issues. Please proceed only if you're confident in what you're doing. 1. Open the Features Tab Go to: Modules Amazon Configure Features PrestaShop Amazon Marketplace select Features tab (https://storage.crisp.chat/users/helpdesk/website/-/3/fFew readersAmazon VAT Calculation Service (VCS)
Introduction Amazon’s VAT Calculation Service (VCS) allows sellers to: Display VAT-exclusive prices to business customers Receive the Downloadable VAT Invoice badge Increase customer trust and sales, as buyers can filter out sellers without this badge Sellers have two options: Let Amazon generate the invoices Upload their own invoices (also with the downloadable badge) Prerequisites Register here to activate the VCS service: 👉 https://sellercSome readersAmazon Prime Orders
This page applies if you are an Amazon seller eligible for Amazon Prime Useful links by marketplace: 🇩🇪 Amazon Seller Central DE 🇪🇸 Amazon Seller Central ES 🇫🇷 Amazon Seller Central FR 🇮🇹 Amazon Seller Central IT 🇬🇧 Amazon Seller Central UK (https://sellercentral.Few readersActivate Amazon BE platform support
Activating Amazon Belgium (BE) Marketplace The Belgium platform has its own setup. Follow these steps to activate it correctly. 1. Enable Amazon BE in the Features tab Go to Modules Amazon Configure Features, and activate the BE option: Click Features tab Activate BE option (https://storage.crisp.chat/users/helpdesk/website/-/3/f/a/8/3fa8ee64Few readersPreorder
Enabling Preorder on Amazon Prerequisites Make sure the Preorder option is enabled in the module's Parameters. Preorder Product Configuration In the product page, go to the Quantities tab and set an Availability Date: Availability Date (https://storage.crisp.chat/users/helpdesk/website/-/3/fFew readersConfigure a GCID code exemption
You sell products without EAN codes, and Amazon has granted your brand a GCID exemption. Step 1 – Activate Expert Mode Enable Expert Mode by following this guide: 👉 Activate Expert Mode Then gSome readersUsing inactive languages
In some cases, you may want to connect an Amazon marketplace in a language that is not active on your store. This can be an issue, as PrestaShop only allows active languages by default. The Amazon Marketplace module allows you to use inactive languages without displaying them on the front office. Steps to follow 1. Activate Expert Mode Before proceeding, activate Expert Mode in the module: 👉 How to activate Expert Mode (https://doc.common-services.com/en/article/activaFew readersUsing the "Stock Break-even" Option
The Stock Break-even option allows you to deduct a fixed quantity from your actual stock before exporting it to Amazon. This is useful for keeping a safety stock or avoiding overselling. Example: Real stock: 10 Stock Break-even: 2 → Exported stock: 8 Note: If your real stock is lower than the specified amount, the exported stock will be 0. Steps to Follow 1. Enable Expert Mode First, activate Expert Mode in the module: 👉 How to activate Expert Mode (httpFew readers
Support
Contact
Before contacting support, please read the documentation. We understand it's frustrating to be told to "read the docs", but most answers are already there — and it saves time for everyone. The module exists since 2011. Most issues are known and listed in the frequent issues section or our internal knowledge base. How to contact support Email: support.amazon@common-services.com You can also use the chat icon on the bottom-righFew readersSupport and warranty limits
Support Limits The following are not covered by our support: Store content setup (product quantities, images, categories, etc.) PrestaShop version upgrades Server, hosting provider, or PHP version changes Any modification made to the module (this voids support) Multiple installations or major catalog restructuring Warranty Limitations You may choose from PrestaShop’s list of recommended hosts. If you use a different host, no guarantee of compatibility or perfFew readers
Frequent Issues
Messaging – Customize emails
The Amazon Messaging feature is part of the Amazon Marketplace module for PrestaShop. It enables communication between your store and customers via Amazon’s messaging system, which verifies all emails. If you want to customize the emails sent through this system, follow these simple steps: Steps to Customize Create a folder named amazon Inside your PrestaShop theme folder, for example: pFew readersSSL Issues – Disable SSL Verification
You may encounter one of the following error messages: Cannot ping Amazon, please provide this URL to technical support Warning: filegetcontents(): SSL operation failed with code 1. OpenSSL Error messages: error:14090086:SSL curl: (60) SSL certificate: unable to get local issuer certificate These errors are usually caused by missing or misconfigured SSL certificates on your server. How to check and bypass temporarily Activate Expert Mode (https://doc.common-services.comFew readersImport an order – Out of stock product
Sometimes, you may want to import an Amazon order for a product that is out of stock in your PrestaShop store. No specific configuration is required in the module. The import will follow the stock management strategy defined in the product settings or in PrestaShop's global settings. 1. Check the Product Settings Go to the product page and locate the section "When out of stock": Product Options – Out of Stock (https://storage.crisp.chat/users/helpdesk/website/-/3/f/Few readersProducts with Different Typologies in the Same Category
Having products with different typologies in the same category is a common support topic. This guide explains how to handle such cases. Example: Shirts with Size and Color Let’s say you sell shirts with Size and Color attributes. Your product combinations in PrestaShop would look like this: Combination tab In your profile settings, you map these attributes tFew readersError: Missing Write Permissions
If you see one of the following messages: or This means the Amazon Marketplace module cannot write to certain folders. How to Fix This Connect to your server via FTP using a client like FileZilla. Navigate to the module’s folder: /modules/amazon Module directory (https://storage.crisp.chat/users/helpdesk/website/-/3/fFew readersIncorrect reference
The export log displays the following message: Cause The product reference contains one or more characters that are not accepted by Amazon. Amazon reference requirements: Only displayable ASCII characters Maximum length: 40 characters No spaces at the beginning or end of the string This issue is most often caused by an extra space at the beginning or end of the reference. Solution Use the Import and ExportFew readersUnable to import duplicate product – Please remove the duplicate product in your database
The export log shows a message like: Cause The module has detected that the product reference is used more than once in your database, which is not allowed. What to Do Each product and each combination must have a unique reference. Refer to this guide: Validate your catalog structureFew readersMarketplace self integration, how it works? what is the role of each?
You have been redirected to this page so that concepts of context and principle of catalog self-integration on a marketplace are well understood, how we operate, how to have a successful marketplace integration. Marketplace vs eBay It is often claimed that sending products on eBay is simpler and less burdensome, which is true. Why? Because historically, eBay is not a marketplace but an auction and classified ads website, so a product is not unique. Each offer is a page with a lifespan. ThFew readersMultistore frequent questions and problems
If you’ve been redirected to this page, you are likely using PrestaShop’s multistore mode. Please read this guide to avoid the most common issues. Contexts The module only works in the context of a single store. It does not support: the “All Shops” context shop groups The context is defined using the selector at the top of your PrestaShop back office: Store selector (https://storage.crisp.chat/users/helpdesk/website/-/3/f/a/8/3fa8ee645cd13200/prestashop-Few readersOrder Import – API processing and constraints gaps
The order import script runs automatically if all ideal conditions are met: Order confirmed by Amazon Payment approved Common Exceptions Some orders may not be imported immediately: Amazon requests ID or documentation from the customer FBA orders not shipped with express delivery (Amazon intentionally delays) ➡️ Conclusion: Automation does not replace manual checks. It's recommended to compare daily: Orders imported into PrestaShop Orders listed in Amazon SellerFew readersWeight: The value of this field must be between 0 and 9,999,999,999.99
You send a feed and, on Seller Central in your product sheet, Amazon indicates this error; PrestaShop Amazon Marketplace weight error This diagnosis is incorrect, it is not a weight error. There is an error in the feed that is not diagnosed in the Amazon back-office, the only way to know the nature of the error is to compare the Report and the XML. Refer to these pages:Few readersThe product has several profiles in several categories
Error message: Why this error occurs The module cannot determine which profile to use because: The product is assigned to multiple categories These categories are associated with different profiles in the module The default category of the product is not one of the categories selected in the module configuration Example The product is linked to several categories in PrestaShop: CaFew readersCreating Products – Common issues on profiles
Error message: Why this error appears To create a product on Amazon, the module requires a profile: a product sheet template that structures the data (category mapping, attributes, pricing rules, etc.). This error usually happens when: A category is selected in the module But no profile is assigned to it Example In the Categories tab: Associate a profile to a category – Image (Few readersUnable to import an order of an inactive or unavailable product
You import your orders and you get an error message like this one or or The module is based on PrestaShop classes (the core of PrestaShop) to proceed with importing orders, forcing to stick to PrestaShop operating principles that will prevent importing a producFew readersCarriers Modules
Carriers/Modules are inactive and flagged Inactive carriers – Image Why does this happen? Some carriers like Relais Colis are not standard carriers, but carrier modules. This means they require user interaction (e.g. selecting a pickup point). ⚠️ The marketplace module is an automated system — it cannot handle this interaction. As a result, tFew readersAmazon Attribute is required is required but not supplied
Error Message: Why this error occurs When exporting products in creation mode, some required fields may be missing from the profile. This typically happens when: A field you’ve added (e.g. quantity, weight) requires an additional attribute (e.g. unit of measure) That attribute (like "grams", "kilograms", etc.) appears dynamically after selecting another field A required field is missing or has nFew readersException regarding the image feed
When a product is sent in creation mode, the module does not send images right away. Here’s why: Technical reason Amazon processes feeds on multiple servers in parallel. If product data and images are sent at the same time: The server handling images may not yet recognize the SKU Result: image feed fails This issue was common in older versions of the module. What does the module do? During product creation: The module *flags the productFew readersKeywords
The module automatically sends keywords to Amazon during: Product creation mode Synchronization with the "extended data" option Where are keywords taken from? On recent PrestaShop versions: from Options Keywords (tags) Keywords in the product sheet On older PrestaShop versions: from SEO Meta Keywords Where are the keywords senFew readersFastCGI
Some hosting providers use FastCGI, others use modphp. PrestaShop officially recommends modphp, which is what our modules are built and tested for. Why you’re seeing this You’ve been redirected here because your hosting uses FastCGI. Our modules: Are designed to run on modphp Provide diagnostics and support only for environments based on modphp Are not compatible or supported on FastCGI-based hosting Common problems with FastCGI SomeFew readersPHP configuration limitations
If you’re experiencing technical problems with the module, this guide will help you verify your server settings. Where to find PHP Info Go to the module’s Information tab Click on PHP Info PHP Info tab – Image Required PHP settings 1. memorylimit Minimum: 256M Recommended: 512M if you have over 10,000 products 2. mFew readersA value was not provided for “bullet_point1”
You receive a message like: Cause The "Product Key Features" (also known as Bullet Points) are required in some Amazon categories. They also help improve your product visibility and ranking on Amazon. Solution Add bullet poinFew readersNo language selected, nothing to do
You get this error in your server’s scheduled task manager: Cause The URL used in your cron job is not properly wrapped in double quotes, which prevents the module from retrieving the required parameters (especially the language). Solution Incorrect command: Correct command:Few readersYou cannot change the ‘item_classification’ for SKU ‘XXX-YYY’ by submitting a feed with a new value
You are trying to send your products using product feed (creation), but you get an error in the report like this: Cause This error means that you are trying to change the ProductFew readersThe (EAN/UPC) code seems wrong. Skipping Product.
The export log shows this message: Why this message? The EAN code is required on most marketplaces (unless you're exempt). This means the EAN code for your product is invalid: → It doesn’t match a valid code issued by GS1. Example of valid EAN code: Valid EAN code example (https://storage.crisp.chat/users/helpdesk/website/-/3/f/a/8/3fa8ee645cd1320Few readersSome of the information submitted contradicts information in the Amazon catalog
You get an error like this in the product creation report: Cause of the error This is a matching error with an existing Amazon product. Amazon detects that the submitted EAN already exists... …but the product data conflicts with its database. Common causes Title, brand or manufFew readersAJAX execution failed
You get an error like: or Main Cause The domain you’re using doesn’t match the one set in Preferences SEO & URLs in PrestaShop. This triggers a security restriction in the browser (cross-domain request), which blocks the AJAX call. ExaFew readersSeller is not authorized to list products in this category - Amazon Marketplace
In the product feed report, you see this message: Cause You do not have the necessary permissions to publish in this Amazon category. Solution Log in to your Amazon Seller Central account. Check your account settings here: Settings Account Info If all looks correct but the issue persists, contact Amazon via: Contact Seller Support (https://sellercentraFew readersYour category doesn’t have a selected profile. For creation mode, you must select a profile.
In product creation mode, the following message appears: Cause The category linked to the product has no associated profile. Solution Go to Categories Profile Assignment in the module and assign a profile to the category: PrestaShop Amazon Marketplace associated profile (https://storage.crisp.chat/users/helpdesk/website/-/3/f/a/8/3fa8ee645cd13200/prestashop-amazon-maFew readersUnable to associate the carrier (XXX) to the order
While importing orders, the following message appears: Cause The module does not recognize the shipping method used by Amazon (e.g., "Std UK Dom"). Solution Configure the incoming carrier mapping in the module: Go to Module Configuration Marketplace tab (e.g., "French" for Amazon France). Scroll to the Carrier Mapping section. In Incoming Orders, add the exact name of thFew readersNo product to send on Amazon
By clicking the Send button, you see a message like: Steps to follow Remove all unnecessary filters in the Filters tab of the module configuration. Sending Products (Creation) Check that the product is eligible CheckFew readers“Pending Shipment” Order Status automatically sends an email. This is not allowed by Amazon. Please configure another order status.
Message displayed in the module's Information tab: Problem By default, PrestaShop's "Shipped" status sends an email to the customer. This violates Amazon's rules, so you must create a new custom order status without email notification. Solution 1. Create a new order status Go to Orders Order Statuses, then click AdFew readersRequest is throttled
Module Message or Cause Too many requests have been sent to Amazon, exceeding the API quotas set by Amazon. Solutions Limit module usage Avoid clicking action buttons repeatedly (download, send, etc.). Check scheduled tasks Ensure you don’t have too many scheduleFew readersA value is required for the field “recommended_browse_nodes.”
Message in the product feed report Cause When creating the profile, the Recommended Browse Node was not filled in. This field is mandatory and helps improve the positioning of your products on Amazon. Solution Read the article on Amazon categorization. Open the profile (https://doc.common-seFew readersCannot associate image with an existing product
Error in Image Feed Report Examples of messages: or Cause On Amazon, feeds are sent sequentially but may be processed iFew readersInconsistency for the product (x/y) – The combination/variant has no Main Reference
Error: Missing Master Reference Export log message: Cause The product sheet does not follow the catalog structure recommendations. For a product with combinations, the master reference (field "Reference") is missing in the main product sheet. Solution Open the product sheet in PrestFew readersSkipping product: x/0 has no EAN13
Error: Product without EAN code Message in the export log: Cause On most marketplaces (unless exempt), an EAN code is mandatory. See our article: Prestashop, EAN codes and marketplaces. The EAN code field is empty for this product (and its possible combiFew readersSkipping product: x/0 has no reference
Error: Product without reference Export log message: Cause Your product does not meet the required catalog structure for export. The Reference field (SKU on Amazon) is missing. This field is essential for exporting your products. See: Validate your catalog structure and apply these guidelines to all your products and combinations.Few readersDuplicate entries are not allowed – Product skipped
Error: Duplicate Reference Example log message: Cause The reference shown is used more than once in the database, which is not allowed. Each product and each combination must have a unique reference (see: Validate your catalog structure). How to identify the duFew readersBlank Page
Blank Page When Accessing the Module Clicking on a module tab displays a blank page. After installing the module, clicking Configure displays a blank page or a truncated back-office page. Cause A PHP error may be causing the issue. By default, PrestaShop hides such errors, which is why you see a blank screen. Solution Enable debug mode temporarily to display the error. Official tutorial: Internal Server Error – Explained and SolvedFew readersUnable to find the expected product for order
Error When Importing Orders Example of error message This means the module cannot find the product in your PrestaShop database. Case 1 – First time using the module If you already had an inventory on Amazon with different references: Purge your Amazon inventory. You can only import orders creFew readersThe update for Sku ‘XXX-YYY’ was skipped because it is identical to the update in feed ‘11036967860’
Error 5000 in Amazon Report Example Message Cause Amazon received multiple identical feeds in a short time. The first feed was processed, the following ones were ignored. Common causes: Multiple scheduled tasks triggered at the same time. Export launched several times from Amazon Catalog. Solution Export your feed only once. Once youFew readersMissing attributes product_type (Error 8560)
Error 8560 when sending offers (synchronization) Example message Cause In synchronization mode, the module updates stock if the offer exists on Amazon. If it does not exist, it tries to create an offer based on an identical product already on Amazon. If no such product exists, Amazon returns this error. Solution Use SendingSome readersMissing attributes brand / Missing attributes manufacturer
Example messages Error 8560: SKU XXX-YYY – Missing Attributes: brand, manufacturer Error 8058: SKU XXX-YYY – Missing attributes: manufacturer Ignored: The Manufacturer / Brand field is mandatory Cause On Amazon, the Manufacturer / Brand field is required (exact name depends on the category). In PrestaShop, the field name varies: PrestaShop 1.6: Manufacturer PrestaShop 1.5: Brand Solution Fill in the Manufacturer / Brand field for *allFew readersFeedProcessingResultNotReady
Example message Meaning The file has been received by Amazon, but it was sent recently and has not yet been processed. Solution Wait until Amazon's server finishes processing the file. Then request the report again — it should now be available.Few readersCreatedBefore date or the LastUpdatedBefore date is later than …
Example error message Meaning Your server clock is not correct. Amazon only allows a maximum time difference of 3 minutes between your server and theirs. How to check In the module Information tab, look at the Remote cFew readers“Display JSON” Option Prevents Actual Feed Submission
Context In the Amazon Marketplace module for PrestaShop, you can manually submit products or offers from the Catalog Amazon tab. There is an option available: Display JSON. What “Display JSON” Does This option enables a simulation mode. It allows you to see the exact data (in JSON format) that would be sent to Amazon. It's useful for debugging or reviewing the data before submitting. Important: Nothing is Sent! If this option is enabledFew readers