Connect your PrestaShop store to Carrefour Hub Spain (Mirakl) without paying a monthly SaaS fee. Push your catalog, sync stock in real time, pull orders back into PrestaShop. Free, open source, maintained.
Status: Work in progress. First stable release (v1.0.0) targeted for June 2026.
- Shoppingfeed, Lengow, Iziflux and friends charge €100–600/month just to operate.
- The previous community module (Activesoft 2018) was abandoned and never supported modern PrestaShop versions.
- Sellers with PrestaShop stores who want to list on Carrefour Hub had no free, maintained alternative.
This module fills that gap.
| This module | Shoppingfeed / Lengow / Iziflux | Mirakl Connect (CSV) | |
|---|---|---|---|
| Cost | Free (+ paid services optional) | €100–600/month | Free |
| Setup time | 30-60 min (or paid onboarding) | Provided | Manual every upload |
| Catalog size | Fits any size | Fits any size | Best <1000 SKU |
| Real-time stock | ✅ | ✅ | ❌ (manual CSV) |
| Multi-marketplace | Carrefour only (v1.2 multi) | 50+ channels | Any Mirakl marketplace |
| Self-hosted / code visible | ✅ AGPL | Closed SaaS | N/A |
| Multi-shop PS | ✅ per-shop credentials | Varies | N/A |
Good fit if: you sell on Carrefour, have a mid-size catalog, run PrestaShop, and prefer paying once for setup over paying monthly to a SaaS.
Not a good fit if: you want a single tool covering 20 marketplaces out of the box — go SaaS.
- Catalog upload to Carrefour Hub via Mirakl API (offers + products).
- Real-time stock sync: hook into PrestaShop stock updates, push to Mirakl immediately.
- Order import: Carrefour orders pulled into PrestaShop as native orders.
- Multi-shop support: each PrestaShop shop can connect to its own Carrefour account, credentials scoped per shop.
- Error dashboard with retry buttons: no more silent failures.
- Async job queue: bulk operations don't block your admin.
- Structured logging to
var/logs/and PrestaShop logger. - Sandbox / Production toggle for safe testing.
- Compatible with PrestaShop 1.6 → 9.x.
See ROADMAP.md for what comes next.
- Download the latest release ZIP from Releases.
- In PrestaShop admin: Modules → Module Manager → Upload a module → select the ZIP.
- Install, then open Sell on Carrefour → Configuration.
- Paste your Mirakl API key and endpoint (get them from your Carrefour Hub seller account).
- Test the connection and start uploading offers.
Detailed guides in docs/.
git clone https://github.com/rafapastor/prestashop-carrefour.git
cd prestashop-carrefour
make dev # spins up PrestaShop + MySQL via Docker
# PrestaShop at http://localhost:8081
# Admin: admin@prestashop.com / prestashop_demo
make test # run PHPUnit
make lint # check coding standards
make format # apply PS coding standardsSee CONTRIBUTING.md for the full contributor guide.
- Installation — install, schedule cron workers, first config
- Configuration — every setting explained
- Multi-shop setup — how per-shop credentials work
- Troubleshooting — common errors and fixes
- FAQ — licence, comparison, GDPR, upgrades
- Mirakl API reference — endpoints used by the module
- 🐛 Bug reports: open an issue
- 💡 Feature requests: open an issue
- 💬 Questions: GitHub Discussions
- 📬 Professional support, setup & custom development: carrefour@smart-shop-ai.com or book a 30-min intro call
Community support is best-effort. If you need guaranteed response times, custom integration or turnkey onboarding, paid services are available.
This project is licensed under the GNU AGPL v3.0 — see LICENSE.
AGPL protects the community: if you modify the module and run it as a network service, you must share your changes back. For commercial use cases where AGPL is not workable, contact the maintainer to discuss a commercial licence.
Based on the abandoned 2018 Activesoft Carrefour module (full rewrite for modern PrestaShop versions).