Online Developer – Marketplace Connector for Skroutz

Description

Online Developer – Marketplace Connector for Skroutz connects your WooCommerce store to the Skroutz marketplace (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.
• The webhook URL is protected by a secret token, generated automatically; requests without it are rejected.
• Stock is reduced when a Skroutz order is accepted and restored when it is rejected, expired or cancelled.

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+.
• Translation-ready.

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.

External services

This plugin connects your store to services operated by Skroutz S.A. (“Skroutz”), the company behind the Skroutz marketplace. It does not contact any server when it is activated, and it sends nothing anywhere until you set up the features below.

Skroutz terms of use: https://www.skroutz.gr/terms
Skroutz merchant agreement (terms for sellers): https://merchants.skroutz.gr/merchants/terms
Skroutz privacy policy: https://www.skroutz.gr/privacy

1. Skroutz Smart Cart webhook (incoming requests from Skroutz)

What it is and why: Skroutz notifies your store when a Smart Cart order is placed or changes, so the plugin can create or update the matching WooCommerce order.
When: only after you register the Webhook URL (Skroutz → Webhook) in your Skroutz merchant panel. Skroutz then sends a request every time one of your orders is created or updated.
What data: Skroutz sends the order data to your site’s REST endpoint /wp-json/skroutz/v1/webhook/<secret token>: order code and state, customer name, phone, shipping and billing addresses, invoice details, line items, prices, courier, tracking codes and pickup details. The plugin stores this data in the WooCommerce order. Your site answers with an HTTP status only; no store data is sent back.

2. Skroutz Orders API (outgoing requests to https://api.skroutz.gr)

What it is and why: the API lets a store send data about a Skroutz order back to Skroutz. This plugin contains the API client and the API token setting (Skroutz → API Credentials); the free plugin itself makes no API request. The client is used by add-ons, such as the receipt / credit invoice upload of the Pro add-on.
When: only when you perform an action that needs it (for example, attaching a receipt to an order) and only if you have entered an API token. Never automatically, and never on activation.
What data: the API token you entered (as the authorization header), the Skroutz order code, and the data of that action (for example, the receipt or credit invoice file you attach).

3. Skroutz XML product feed (a file on your own site, read by Skroutz)

What it is and why: Skroutz lists your products on skroutz.gr from an XML file.
When: only when you enable the feed (Skroutz → XML Feed). The plugin writes the file to your own site; Skroutz downloads it from there. The plugin itself sends nothing to Skroutz, and disabling the feed deletes the file.
What data: public catalog data of your published products: ID, name, SKU, MPN, image URL, product URL, category, brand, description, availability, stock quantity, weight and price.

4. Skroutz merchant panel links (https://merchants.skroutz.gr)

The “View on Skroutz” button on Skroutz orders is a plain link that opens the order in your Skroutz merchant panel in your browser. The plugin sends no data when it is shown.