Allegro integration
for Medusa
An Allegro seller account connected to Medusa: offers linked to products by signature, orders imported exactly once, and stock, parcels, invoices and prices sent back to Allegro.
What exactly
this integration does
-
Orders exactly once
Every Allegro purchase becomes a Medusa order once, through Medusa's own flow: stock is reserved, tax comes from the region, and the payment is marked once Allegro holds the money.
-
Offers linked to products
Offers link to variants by signature, the SKU that sellers and BaseLinker put in the offer. Never by offer name.
-
Stock that cannot hurt
By default stock only goes down and sold out offers end. A plan that looks like a broken read, most variants suddenly at zero for instance, is refused as a whole.
-
Parcels and invoices
Parcel number, carrier and seller status reach Allegro with every shipment, and invoices from the Fakturownia plugin attach to the order once.
-
Prices within bounds
The Medusa price goes to Allegro only inside the bounds you set on the product. Anything outside waits for a decision.
-
Customer issues in view
Returns, disputes, claims and unread messages in one place, with due dates and links to the seller panel. The plugin never answers for you.
How it guards
your data
-
Two switches per write
Every writer is allowed in the options and armed separately in the admin. The admin shows who armed it and when.
-
Circuit breaker
A writer that fails five times in a row disarms itself and leaves the reason in the admin. Failures of single offers do not count.
-
Sandbox and demo mode
Test against the Allegro sandbox or a simulated account built from your catalog, no developer account needed.
Setup
in three steps
The full list of options, events and API routes is in the package README on GitHub.
Paste it into Claude Code, Cursor or another AI assistant in your Medusa project: it installs and configures the integration, with writes off.
- 1 Install the package from npm.
npm install @koda-plus/medusa-plugin-allegro - 2 Add the plugin to medusa-config.ts.
plugins: [ { resolve: "@koda-plus/medusa-plugin-allegro", options: { clientId: process.env.ALLEGRO_CLIENT_ID, clientSecret: process.env.ALLEGRO_CLIENT_SECRET, encryptionKey: process.env.ALLEGRO_ENCRYPTION_KEY, environment: "production", // or "sandbox" // writes: { orders: true, stock: true, shipping: true, invoices: true }, // demo: true, }, }, ] - 3 Run the migrations and open the integration in the Medusa admin.
npx medusa db:migrate
Running for our clients
See our portfolio
Outside Medusa: the same logic and the same code in a project on another stack.
Other
integrations
- BaseLinker Cards, stock, prices and orders both ways
- Subiekt nexo Orders as ZK, WZ and invoices with KSeF
- Fakturownia Invoices, corrections and KSeF exactly once
- InPost Parcel lockers, courier and COD on ShipX
- OLX Adverts that match the store's stock
- Stripe Volume, fees, disputes and account health
- Negotiations Target price, counter offer, acceptance
- Trade credit Limits, terms and customer balances
- Loyalty Points, a reward ladder and a ledger
- Packaging Piece, box, pallet, minimum and step
- EU compliance GPSR, RODO and Omnibus in one panel
- VAT whitelist NIP, VIES and REGON in one panel
- E-mails Ready templates in Polish and English
- Tasks Tasks on orders, products and customers
Tell us about your project,
we'll tailor the rest to you
A 15-minute call is enough for us to know whether we are a fit for your project.
We start from what you need, not from an off-the-shelf solution.