Skroutz XML Feed for OpenCart

Overview

Skroutz XML Feed turns your OpenCart catalogue into the XML product feed that Skroutz (Greece and Cyprus) reads. You map your categories to the Skroutz category tree, say what each stock status means for availability, and give Skroutz one secret feed URL. The feed is a cached file that the OpenCart cron rebuilds, so Skroutz never slows your shop down.

What it does

• Skroutz feed format. A <mywebstore> document with id, name, link, image, additionalimage, category, price_with_vat, vat, manufacturer, mpn, ean, availability, size, weight, color, description, quantity and specifications, as published in the Skroutz XML feed specification.
• Prices with VAT in euros. Special prices and customer-group discounts of the default group are used; taxes are added the way your storefront shows them; the amount is converted with the rate in your OpenCart currencies.
• Category mapping. One Skroutz category path per store category, a nearest-parent fallback and a per-product override.
• Availability from stock status. In stock when the quantity is above zero. Otherwise each stock status maps to "Available from 1 to 3 days", "Available from 4 to 6 days", "Available up to 12 days" or "left out of the feed".
• Variants. Choose the size option and the colour option. Sizes become <variation> entries with their own stock and price; colours become separate products, as the specification asks.
• Per-product exclude and a cached feed file with a secret URL.
• Self-check. A product list that shows missing required fields (errors) and things worth fixing (warnings) for every product.
• Events only, no OCMOD, no core edits. OpenCart 4, tested on 4.1.0.4.

Limits to know

• One feed per store; the default store is read.
• The extension builds the feed. You still need a Skroutz merchant account, and Skroutz decides which products it accepts.
• Skroutz expects https links and images; the self-check flags http addresses.

Installation

Requirements

• OpenCart 4.1.x (tested on 4.1.0.4) and PHP 7.4 or newer.
• A currency EUR in System > Localisation > Currencies with a rate against your default currency.
• OpenCart's cron running (see below) if you want the feed rebuilt automatically.

Install

1. Go to Extensions > Installer and upload kv_skroutz_feed.ocmod.zip, then press the install button.
2. Go to Extensions > Extensions, choose Modules and install Skroutz XML Feed (plus button). Installation creates two small tables, an hourly cron job and a secret key for the feed URL.
3. Press the edit button. On the General tab choose the currency (EUR), the size and colour options if you use them, and check where MPN and the barcode come from.
4. On Availability choose what each stock status means. On Categories type the Skroutz category path for your categories. Press Save.
5. Press Build feed and run check, open Products and check, fix what is listed, build again.
6. Copy the Feed URL from the top of the page into your Skroutz account.

Other user groups need access and modify rights for extension/kv_skroutz_feed/module/kv_skroutz_feed under System > Users > User Groups.

Cron

The extension registers the job "Skroutz XML Feed" in System > Maintenance > Cron Jobs. It needs the standard OpenCart cron call on your server, for example every 15 minutes:

*/15 * * * * curl -s "https://your-shop.example/index.php?route=cron/cron" > /dev/null

The job rebuilds the file when it is older than the interval you set (default 6 hours). A server cron can also call the cron URL shown on the settings page. If nobody calls the cron, the feed URL rebuilds an outdated file when Skroutz asks for it.

Uninstall

Uninstalling removes the tables, the cron job, the events and the generated files. Your products and categories are not touched.

Configuration

General

• Status. Off stops the feed URL and the scheduled rebuild. Nothing else changes.
• Feed currency. Skroutz prices are in euros. The amount is your price with taxes, converted with the rate of the currency.
• Rebuild interval. How old the cached file may get before the cron or the feed URL builds it again.
• Store address. Optional public address for product and image links, for example behind a proxy. It must start with https.
• Size option, Color option. Product options whose values are sizes and colours. Sizes become variations with the stock and price of each option value; colours become separate products.
• MPN and barcode. Where the manufacturer part number and the EAN come from (the identifier fields of the product in OpenCart 4.1, or Model / SKU).
• Fixed shipping cost, Season. Optional values sent for every product. Leave the shipping cost empty if it is not the same for all products.

Availability

A product with a quantity above zero is "In Stock". For the others the feed says what you choose for the product's stock status: 1 to 3 days, 4 to 6 days, up to 12 days, or leave the product out. Variations use the Skroutz variation labels (4 to 10 days, up to 30 days).

Categories

Type the full Skroutz category path, for example Computers > Desktops. A sub-category without its own entry uses the nearest mapped parent. A category with no mapping sends the store path and the check lists it as a warning. A single product can have its own category on the Products and check tab.

Products and check

Press Build feed and run check. The list shows every product with OK, errors (required fields that are missing: name, https link, image, category, price, manufacturer, MPN or EAN, description) and warnings (EAN, weight, image smaller than 1000 px, unmapped category). Exclude keeps a product out of the feed.

FAQ

Where do I give the feed to Skroutz?

Copy the Feed URL from the top of the settings page into your Skroutz merchant account. The URL contains a secret key; create a new key on the General tab if it ever leaks.

Why is a product missing from the feed?

It is disabled, excluded, not in the default store, or it has no stock and its stock status is set to "Leave out of the feed". The Products and check tab shows "Excluded" and "Left out".

Why does the check say "link must start with https"?

Skroutz asks for https product and image links. Move the shop to https or set a public https address under Store address.

Do prices include VAT?

Yes. The price is the one your storefront shows with taxes, converted to the feed currency. The vat element carries the percentage rate of the product's tax class.

How do colours and sizes work?

Choose the options on the General tab. Each colour becomes its own product (<id> is the product id plus the colour), each size a variation of it with its own stock and price.

Does it use OCMOD or change core files?

No. It uses OpenCart events and its own files only.

Does it call any other server?

No. Building and serving the feed uses only your own shop.