Codihi Smart Cart Order Sync for Skroutz

An active WooCommerce store, a Skroutz Smart Cart merchant account with an API Token (you create it in the Skroutz Merchants Panel, under API), and a site that Skroutz can reach over the internet (HTTPS recommended). A site on localhost or behind a maintenance/password wall cannot receive webhooks.

1. Go to Codihi Plugins → Skroutz Orders → Connection & Security.
2. Paste your Skroutz API Token and keep (or change) the Webhook Secret. Save.
3. Copy the Webhook URL shown on the same tab. It already contains the secret.
4. Paste that URL into the Webhook URL field of the Skroutz Merchants Panel. To change the Webhook Secret later, edit it (or press "Generate new secret" for a random one), save, copy the Webhook URL again and update it in the Skroutz Merchants Panel. The old URL stops working immediately.

New (Skroutz sends it as "open"), accepted, ready (Skroutz Last Mile), dispatched, delivered, rejected, canceled and expired. Each state can be mapped to one of your existing WooCommerce order statuses under Status Mapping, or left as "No Change". Stock is reduced for new, accepted, ready, dispatched and delivered orders, and restored for rejected, canceled and expired orders.

New → On hold, dispatched → Completed, rejected / canceled / expired → Cancelled. Accepted, ready and delivered leave the status unchanged. You can change every one of these in Status Mapping, and tick "Auto Complete" to mark delivered orders as Completed.

Skroutz sends your own product identifier (shop_uid) with every line item. Under Product Matching you choose how it is looked up: by SKU, by Product ID, by a custom meta field (for example an ID imported from another platform), or with "Smart Match", which tries custom meta, SKU, ID, EAN and MPN in turn.

The order is still imported so you never lose a sale. The line appears as "Unknown Product (SKU: …)" with the right quantity and price, no stock is changed for it, and an error is written to the log (if logging is on). Fix the identifier in Product Matching or on the product, then edit the order manually.

Yes. For items with a size Skroutz sends the product code (shop_uid) and the variation code (shop_variation_uid). The plugin looks up the variation first, in the way chosen in Product Matching (SKU, Product ID or custom meta), and checks that it belongs to the matching product, so the stock of the right size is reduced. Each variation needs its own unique SKU (or custom meta value) that matches your Skroutz feed. If no variation is found, the product found through shop_uid is used.

No. Orders are recognised by their Skroutz order code, and while one delivery of an order is being processed a second one (for example a retry from Skroutz) is held back with an HTTP 409 and retried later. If Skroutz sends the same webhook again, or the order changes state, the existing WooCommerce order is updated instead of a new one being created. Older events that arrive late are ignored, and orders you have already cancelled or refunded in WooCommerce are not reopened by later Skroutz updates.

The customer address, line items and Skroutz fees are written only when the order is created. Later webhooks for the same order update the Skroutz details, the order status (according to your Status Mapping) and the stock. Your manual edits to the address or items are kept.

Yes, for orders you ship yourself. Skroutz only sends a shipping cost for those orders. It is added to the new WooCommerce order as a shipping line named "Skroutz Marketplace shipping", so the total is goods plus shipping minus the Skroutz commission and fees. If your shop has taxes switched on, any shipping tax WooCommerce would add on top is removed again so the amount stays as Skroutz sent it. Orders fulfilled by Skroutz have no shipping line.

The "Skroutz Marketplace" box on the order shows the courier, the tracking codes, the number of parcels, a link to the courier voucher, the dispatch deadline (in red once it has passed and the order is not shipped yet), the time you must accept a new order by, and the payment method. Cash on delivery orders are marked "not paid yet". The details are refreshed on every Skroutz update. The plugin shows the voucher that Skroutz provides; creating vouchers is part of the Premium version.

Skroutz amounts already include VAT. If your shop has taxes switched on but "Prices entered with tax" set to "No, I will enter prices exclusive of tax", WooCommerce treats the Skroutz amounts as net and adds VAT on top, so the total is higher. In WooCommerce → Settings → Tax choose "Yes, I will enter prices inclusive of tax" (this changes how prices are entered for the whole store). The settings page of this plugin shows a warning in that situation. With taxes switched off, or with prices entered inclusive of tax, the total is goods plus shipping minus commission and fees, and no tax is added to the commission or the shipping line.

Skroutz sends the invoice details with the order. The plugin saves the document type (receipt, invoice, invoice for article 39a VAT exemption, or EU cross-border VIES invoice), the company, VAT number, tax office and activity on the order, and on a new order it uses the company and the invoice address as the billing details (the shipping address stays the customer's delivery address). A note is added to the order, and the "Skroutz Marketplace" box shows the document, company, VAT number and tax office. Values you have already entered on the order are never overwritten. The plugin does not issue the invoice itself.

The details are stored in the order fields _billing_document_type, _billing_vat, _billing_tax_office and _billing_activity, which are the fields used by the Codihi Checkout Invoice and Codihi myDATA plugins, so those can pick them up. For other invoicing plugins you can read the same fields, or the "_skroutz_invoice_document" field with the Skroutz document type.

Skroutz does not send a billing country for an invoice, so the plugin uses the delivery country (Greece if none was sent) and adds an order note asking you to check it before you issue the invoice.

As negative fee lines named "Skroutz Commission" and "Other Skroutz Fees", so the WooCommerce order total is what you actually receive from Skroutz.

Skroutz does not share the customer's email, so the plugin sets a placeholder (skroutz_ORDERCODE@skroutz.gr) as the billing email. The plugin itself never emails customers. WooCommerce's own customer emails (for example "Order completed") would be addressed to the placeholder and are not delivered, so you can switch them off under WooCommerce → Settings → Emails.

The country Skroutz sends with the customer address (country_code). If Skroutz sends none, or a country WooCommerce does not know, Greece is used. The Skroutz region is saved as a custom field and as an order note.

Yes. Tick "Enable notification" under Email Notification in the settings. It goes to the address you enter, or to the site administrator email if you leave it blank, with a direct link to the new order.

The WooCommerce orders list has a Skroutz column with an icon that shows the Skroutz state when you hover over it, and a filter that shows "Skroutz orders only". Each Skroutz order has a "Skroutz Marketplace" box with the order code, state, Skroutz Plus, express delivery, pickup point and locker information.

1. The Webhook URL in the Skroutz Merchants Panel is the one currently shown in the plugin (including the token).
2. The API Token is valid and the Webhook Secret is not empty (an empty secret rejects all requests).
3. Your site is reachable from the internet and the REST API is not blocked: open /wp-json/ on your site, and check security plugins, firewalls (WAF), CDN rules, maintenance mode and password-protection (HTTP authentication) for that address.
4. Turn on "Enable logging" in the settings and look at WooCommerce → Status → Logs (source "smart-cart"). Every webhook that reaches the plugin is logged; if nothing appears, the request is being blocked on the way or rejected because the token in the URL does not match your Webhook Secret (Skroutz then reports an HTTP 401).

Enable logging in the plugin settings. Entries are written with the WooCommerce logger and are visible under WooCommerce → Status → Logs (source: "smart-cart"). Leave logging off when you don't need it.

No. The Free version only reads orders: you accept or reject them, print vouchers and update your product feed from the Skroutz Merchants Panel. Voucher generation, automatic invoice upload and the full Last Mile integration are part of the Premium version.

Yes. The plugin declares compatibility and uses only the WooCommerce order API, so it works with both the classic and the new order tables.

Users who can manage WooCommerce (the "manage_woocommerce" capability), normally Administrators and Shop managers.

No tracking and no bundled libraries. The plugin contacts api.skroutz.gr only when a Skroutz webhook arrives, and an admin who opens the "Codihi Plugins" overview page triggers a plain request for the public Codihi product list. See the "External services" section for the details.

No. It is an independent integration by Codihi and is not affiliated with, endorsed by or sponsored by Skroutz.

Yes. The admin screens are translated into Greek, and the built-in User Manual is available in Greek and English (it opens in the language of your admin profile, with a switch at the top).

Deleting the plugin removes its settings. Orders already imported stay in WooCommerce as normal orders.

Yes. When a Skroutz order is imported, WooCommerce's own stock management reduces the ordered items' stock as part of the normal order-creation flow, and restores it automatically if you reject or cancel the order. This plugin does not send stock levels back to Skroutz — you still need to keep your Skroutz product feed/listing up to date the way you already do today.

Voucher generation is a Premium feature. In the Free version, you manage acceptance/rejection from the Skroutz Merchants Panel, and the plugin strictly handles the WooCommerce order creation and stock deduction.