Skroutz PrestaShop Module
01 Skroutz Module â User Guide
This module connects your PrestaShop store to Skroutz in three ways:
- Product XML Feed â generates the product catalogue feed Skroutz needs to list your products.
- Skroutz Analytics â reports your sales back to Skroutz so they can measure how their traffic performs on your store.
- Skroutz Marketplace Orders (Smart Cart) â receives orders placed on Skroutz directly into your PrestaShop orders, and lets you accept, reject, and ship them from PrestaShop.
You can use any of the three independently â for example, you can use only the XML feed without ever turning on Orders or Analytics.
All settings live in Modules â Module Manager â 01 Skroutz Module â Configure, organized into tabs (Skroutz Analytics, Order Settings), plus two dedicated screens under Catalog â Skroutz XML and Orders â Skroutz Orders.
Product XML Feed
1.1 Creating a feed
Go to Catalog â Skroutz XML â Add new feed. You can create more than one feed (for example, one per category or brand) if you ever need to. Each feed has its own settings:
| Setting | What it does |
|---|---|
| Name | Just a label for you, to tell feeds apart in the list. |
| Unique ID | Which product field Skroutz will use as the product's permanent ID. Product ID is recommended â it's always present. If you choose Reference/EAN13/UPC and a product is missing that value, the module automatically falls back to the Product ID for that one product, so you'll never get a blank or duplicate ID. |
| MPN | Which field is sent as the manufacturer part number. Most stores use Reference Code. |
| Choose Size Attributes / Choose Color Attributes | Tell the module which of your shop's attribute groups represent size and color (e.g. your "Color" attribute group). This is how the module knows how to split products correctly â Skroutz requires every color to be submitted as a separate product, so getting this right matters. If a product has color combinations and you don't set Color Attributes, feed generation will show an error until you do. |
| Categories | Only products in the selected categories go into this feed. Leave empty to include your whole active catalogue. |
| Brands | Only products from the selected manufacturers go into this feed. Leave empty for all brands. |
| Language | Which shop language is used for product names/descriptions/category names in the feed. |
| Description | Whether to send a description, and from which field (short, main, or both). |
| Weight Metric | Whether weights are sent in kilograms or grams. |
| Include Tax at price | Whether the price sent to Skroutz includes VAT or not. |
| Include compinations/attributes | Whether to break products with combinations into the color/size structure at all. Turn this off only for feeds where you genuinely want one flat row per product regardless of its combinations. |
| Include stock | Whether real PrestaShop stock quantities are sent. If off, every product is reported as always available â useful if you don't track stock per item. |
| In stock / Out of stock Availability Text | Must exactly match the text your own store uses for "in stock" and "out of stock" wording. |
Once saved, the list screen shows three useful things for each feed:
- CRON links â a ready-to-copy command for scheduling automatic regeneration (see below).
- XML link â the actual feed URL. This is the link you give to Skroutz when configuring your product feed in their merchant dashboard.
- Last Update â when the feed last finished generating, and whether it succeeded.
1.2 Generating the feed
Manually: click Generate Feed on the feed's row. A popup shows live progress with a percentage and the number of products written. You can keep working in the admin while it runs â it processes the catalogue in short bursts behind the scenes, so it works even on slower/shared hosting.
Automatically (recommended): copy the CRON link shown on the feed list and set up a scheduled task with your hosting provider (or any external "cron job" service) to call that URL once a day. Skroutz expects your feed to be refreshed at least daily.
1.3 If generation reports an error
The most common cause is a product that has color combinations but no Color Attributes configured on the feed â set it under the feed's edit screen and regenerate.
Skroutz Analytics
This reports completed sales back to Skroutz so they can show you (and optimize) how their traffic converts on your store. You only need this if you advertise through Skroutz Ads/comparison listings â it is not required for the Marketplace/Smart Cart order feature.
Go to Configure â Skroutz Analytics tab:
| Setting | What it does |
|---|---|
| Enable Analytics | Master on/off switch. |
| Skroutz Analytics ID | Found in your Skroutz merchant account, looks like SA-XXXX-YYYY. Required when Analytics is enabled. |
| Remove COD fee from revenue | If you charge customers extra for paying Cash on Delivery, turn this on so that surcharge isn't counted as real revenue when reported to Skroutz. |
| Choose your Cash On Delivery modules | Select whichever payment module(s) in your store represent "pay on delivery." If you don't have one, choose the "I have no COD module" option at the bottom of the list. |
| Choose XML | Which feed's settings (Unique ID, Color Attributes, etc.) are used to identify products in the reported sales. This must be the same feed you actually submitted to Skroutz â the product IDs reported here have to match the ones Skroutz already knows from your feed. |
Once enabled, you don't need to do anything else â tracking happens automatically on every page and every completed order.
Skroutz Marketplace Orders (Smart Cart)
This is for stores selling through Skroutz Marketplace: customers buy on Skroutz, and the order needs to land in your PrestaShop.
3.1 One-time setup in Skroutz's merchant dashboard
Go to Configure (the module's main settings page, scroll down to the Webhook section). You'll see a ready-made webhook URL â copy it into Skroutz's merchant area under Marketplace â Configure â Webhook URL. This is how Skroutz notifies your store the moment an order is placed or its status changes.
You will also need an Orders API token from Skroutz (ask your Skroutz account manager, or find it in your merchant dashboard's API/integrations section) â this is what lets your store talk back to Skroutz (accept orders, send tracking numbers, etc.).
3.2 Settings â Configure â Order Settings tab
| Setting | What it does |
|---|---|
| Enable API Orders creation | When ON, every Skroutz order becomes a real order in your PrestaShop orders list, with the customer, products, and price exactly as sold on Skroutz. |
| Enable stock management for marketplace orders | An alternative to the above: instead of creating a PrestaShop order, the module just reduces your stock by the quantity sold on Skroutz (and restores it if the order is later cancelled/rejected/returned). Use this if you'd rather manage Skroutz orders entirely from Skroutz's own dashboard and just need PrestaShop's stock to stay accurate. You can only turn on one of these two at a time. |
| Choose XML for API orders | Which feed's settings are used to match an incoming Skroutz order's products back to your actual PrestaShop products/combinations. Use the same feed you submitted to Skroutz. |
| Orders API | Paste your Orders API token from Skroutz here. |
| Accept mode for new Skroutz orders | Manual: every new order waits for you to click Accept/Reject yourself from the order page. Auto: the module accepts the order on Skroutz automatically the moment it's created in PrestaShop (using a default pickup option) â use this only if you're confident you can always fulfil what Skroutz sends you, since there's no automatic stock check before accepting. |
| Choose an Order Status for the orders that are created from marketplace | Which PrestaShop order status a new Skroutz order starts in (e.g. "Awaiting payment", or a custom status you've made for marketplace orders). |
3.3 What happens when an order comes in
If order creation is enabled: a new order appears in Orders â Orders (and also listed in Orders â Skroutz Orders for a Skroutz-specific overview) within moments of the sale on Skroutz. The customer and address are created automatically from the details Skroutz provides.
Skroutz doesn't share the buyer's real email address with merchants, so the customer is created with a placeholder email. You won't be able to email these customers directly through PrestaShop â communication with Skroutz buyers happens through Skroutz.
If stock management is enabled instead: no order appears, but you'll see the sale reflected in Orders â Skroutz Orders (with no linked PrestaShop order), and your stock quantities update automatically.
3.4 Managing an order from PrestaShop
Open any Skroutz order in Orders â Orders. You'll see a Skroutz Marketplace Order panel on the order page showing the Skroutz order code, current status, courier info once assigned, and the relevant action buttons:
- While the order is awaiting your decision: Accept or Reject buttons.
- Once accepted: a small form to send the courier name and tracking number back to Skroutz.
Whenever you change the order's status in PrestaShop (e.g. mark it "Shipped" after entering a tracking number, or "Delivered"), the module tells Skroutz automatically â you don't need to do anything extra on Skroutz's side for those steps.
One thing the module can't do: if you've already accepted an order and then need to cancel it, Skroutz doesn't provide a way for merchants to cancel an accepted order through the API â you'll need to handle that case directly with Skroutz support.
3.5 The "Skroutz Orders" list
Orders â Skroutz Orders gives you a flat list of every Skroutz sale the module has processed, with its Skroutz status, total, and a link straight to the matching PrestaShop order (when one exists). Rows marked with a red Error badge need your attention â hover over the badge to see why (most often, one of the products in that order couldn't be matched back to anything in your catalogue, which usually means your catalogue changed after the feed was last generated).
Quick checklist for first-time setup
- Catalog â Skroutz XML â create a feed â set Color/Size Attributes correctly â Generate Feed â copy the XML link into Skroutz.
- Schedule the feed's CRON link to run daily.
- (Optional) Configure â Skroutz Analytics â enable, paste your Analytics ID, pick the same feed.
- (Optional, for Marketplace sellers) Configure â Order Settings â enable order creation or stock management, pick the same feed, paste your Orders API token, set your accept mode â copy the webhook URL into Skroutz's merchant dashboard.
That's it â once the feed is accepted by Skroutz and (if used) the webhook is connected, everything else runs automatically.