Integration for Skroutz and WooCommerce Pro

Integration for Skroutz and WooCommerce connects your WooCommerce store to Skroutz, the leading marketplace in Greece and Cyprus. Orders placed through Skroutz Smart Cart appear in WooCommerce automatically, in real time, and your product catalog is published to Skroutz through an always up-to-date XML feed.

No manual order entry and no copy-pasting between dashboards: Skroutz notifies your store through a webhook every time an order is placed or changes, and the plugin creates or updates the matching WooCommerce order.

Skroutz Smart Cart orders

• Receives Skroutz `new_order` and `order_updated` events in real time through a secure webhook.
• Creates the WooCommerce order on the first event and keeps it in sync on every following one: order status, courier, tracking codes, shipping voucher, fees and pickup details.
• Billing details come from the invoice information when the customer asks for an invoice, otherwise from the customer’s address.
• Detailed shipping data: street, number, floor, postcode, city, Greek region derived from the postcode, carrier collection-point pickup, courier, tracking codes, voucher link, pickup window and address, number of parcels.
• Detects the requested document type: receipt, invoice, Article 39a invoice or VIES invoice.
• Correct VAT: Skroutz sends prices with VAT included; the plugin stores the net price using the rate of the matching WooCommerce tax class, and WooCommerce calculates the tax as usual.
• Matches Skroutz line items to your products by SKU.
• Adds a “Dispatched” order status if your store doesn’t already have one.
• Duplicate deliveries are detected and ignored, so an order is never created twice.
• Optional shared secret on the webhook URL for extra protection.

Skroutz XML product feed

• Generates the Skroutz XML file of all your published products with one click, with a live progress bar.
• Built for large catalogs: the file is generated in small batches and the progress is saved after each one. If the connection drops or the server times out, generation retries automatically from the exact point where it stopped, and an interrupted run can be resumed at any time.
• Always current: whenever a product is edited or sold, its entry in the feed and the feed’s creation date are refreshed automatically within a minute.
• Includes ID, name, SKU (as EAN), MPN, image, product link, full category path, brand (WooCommerce Brands), description, availability, stock quantity, weight, and price with VAT.
• Adds “MPN (part number)” and “Skroutz availability” fields to every product, right under the SKU.
• Variable products are listed once, with their lowest price and total stock.
• Choose a default availability and whether out-of-stock products are included.
• Turn the feed on or off at any time; turning it off removes the XML file.

Order management tools

• Skroutz ID column and search by Skroutz order code on the WooCommerce orders screen.
• View on Skroutz button that opens the order in your Skroutz merchant panel.
• Skroutz box on the order screen with the Skroutz code, courier and tracking codes.
• Every webhook event and error is logged in WooCommerce → Status → Logs.

Compatibility

• WooCommerce High-Performance Order Storage (HPOS) and the classic orders screen.
• WordPress 6.5+, WooCommerce 7.0+, PHP 7.4+.
• Greek translation included.

Pro add-on

Everything above is free and fully functional. The optional Pro add-on adds:

• Editable field mapping: VAT tax classes, product matching by SKU or any meta key, document type values and unlimited custom fields.
• Editable order status mapping, including custom statuses.
• Receipt & credit invoice attachment: send receipts and credit invoices to Skroutz from the orders list or the order screen, from your computer or automatically from a folder on your server, one by one or in bulk.
• XML feed price rules: increase or decrease all prices by a percentage or a fixed amount.
• XML feed mapping: take any element’s value from any product field, attribute, taxonomy or meta key, and add your own elements.
• XML feed exceptions: leave out chosen categories and SKUs.

This plugin is developed by Online Developer and is not affiliated with or endorsed by Skroutz S.A.

Installation

Requirements

• WordPress 6.5 or newer
• WooCommerce 7.0 or newer
• PHP 7.4 or newer
• A Skroutz merchant account with Smart Cart enabled

Install the plugin

1. In your WordPress admin, go to Plugins → Add New Plugin and search for Integration for Skroutz and WooCommerce.
2. Click Install Now, then Activate. WooCommerce must already be installed and active.
3. A new Skroutz menu appears in the admin sidebar.

To install manually, upload the `integration-for-skroutz-and-woocommerce` folder to `/wp-content/plugins/` and activate it from the Plugins screen.

Receive Skroutz orders

1. Go to Skroutz → Webhook.
2. Optional: enter a shared secret and click Save Settings. The secret is added to the webhook URL automatically.
3. Click Copy next to the Webhook URL.
4. In your Skroutz merchant panel, open Merchants → Services → Skroutz Marketplace (Smart Cart settings) and paste the URL into the webhook setting.
5. Make sure the SKU of each WooCommerce product matches the product code (`shop_uid`) you send to Skroutz.
6. Check that the Standard, Reduced rate and Zero rate tax classes in WooCommerce → Settings → Tax have the correct rates.

New Skroutz orders now appear in WooCommerce → Orders with a Skroutz icon and their Skroutz code.

Publish your products with the XML feed

1. Go to Skroutz → XML Feed.
2. Tick Enable the Skroutz XML feed, choose a Default availability, decide whether to include out-of-stock products, and click Save Feed Settings.
3. Click Generate XML and wait for the progress bar to reach 100%. If the connection drops, the plugin retries on its own; if you close the page, click Resume interrupted generation when you come back.
4. Copy the XML file URL shown on the same screen and register it in your Skroutz merchant panel.
5. Optional: on each product, fill in MPN (part number) and Skroutz availability under the SKU in Product data → Inventory.

From then on the feed updates itself whenever a product changes or is sold.

API token (optional)

The Skroutz → API Credentials tab stores your Skroutz Orders API token. It isn’t needed to receive orders or to publish the XML feed; it is used by features that send data to Skroutz, such as receipt upload in the Pro add-on.