ShipWave Channels

Connecting Allegro

Connect Poland's #1 marketplace and reach ~200M monthly visitors via OAuth2.

About Allegro

Allegro is Poland’s dominant e-commerce marketplace with roughly 200 million monthly visits and over 21 million active buyers — the largest marketplace in Central and Eastern Europe. Listings are in Polish, transactions are in PLN (Polish zloty), and shipping is dominated by Poczta Polska, InPost Paczkomaty, and DPD. Allegro is the fastest way to reach Polish shoppers without setting up a local fulfilment operation.

Before you start

From the Allegro seller portal you will need:
  • An Allegro Business seller account (consumer accounts cannot use the API)
  • A registered API application at apps.developer.allegro.pl — this gives you a Client ID and Client Secret
  • The redirect URI https://shipwave.app/api/integrations/allegro/callback added to your app’s allowed redirects (ShipWave provides this; you paste it into your Allegro app config)
You do not paste credentials into ShipWave — the OAuth flow handles it. You just need the app registered.

Connecting your account

  1. Go to Admin → Marketplace → Channels and click New Channel.
  2. Select Allegro as the platform.
  3. Choose the Shopify store to use as the product source.
  4. Name the channel (e.g. “Allegro PL”).
  5. Click Create Channel, then Connect.
  6. You will be redirected to Allegro’s OAuth consent page (in Polish — use your browser’s translate feature if needed).
  7. Sign in with your Allegro Business credentials and click Zezwól (Allow).
  8. Allegro redirects back to ShipWave with an authorization code, which we exchange for an access token + refresh token automatically.
  9. The channel status changes to Connected.
Tokens auto-refresh on a 12-hour cycle — you only re-authorize if you revoke access.

How orders flow in

Allegro does not send webhooks — it uses an event-bus model. ShipWave polls the /order/events endpoint every 5 minutes for new BOUGHT and FILLED_IN events, then fetches order details via /order/checkout-forms/{id}. After you ship and add tracking, ShipWave calls /order/checkout-forms/{id}/shipments with the carrier and tracking number. Expected lag from buyer checkout to ShipWave dashboard: under 5 minutes.

Listings and inventory sync

Allegro uses a 2-step listing creation: first ShipWave creates a product-offer draft via POST /sale/product-offers, then activates it via PUT /sale/offers/{id}/publication. The product must match an Allegro catalog product (matched by EAN/GTIN) or include enough required attributes to create a new one. Inventory and price updates happen via PATCH /sale/offers. Images upload to Allegro’s CDN automatically. See Creating listings for the cross-channel workflow.

Polish localization tips

Allegro shoppers expect Polish descriptions. ShipWave will not auto-translate — you control content per-channel. Best practices:
  • Set the listing title in Polish via Channel overrides on each listing
  • Use PLN pricing (ShipWave converts from USD/EUR using your currency settings)
  • Include Polish-language bullet points — descriptions in English typically convert at half the rate
  • Most categories require 22 days handling time max, often less for B-class items

Carrier mapping

When you ship an Allegro order, ShipWave maps your carrier to one of Allegro’s supported carriers automatically:
  • Poczta Polska — default for letters and small packets
  • InPost Paczkomaty — locker delivery, very popular in Poland
  • InPost Kurier — doorstep delivery
  • DPD / DHL / UPS — for international or larger parcels
If you ship via a carrier ShipWave does not recognize, set the mapping under Channel settings → Carrier mapping.

Common issues

“User token expired” – refresh tokens last 90 days. Reconnect the channel.

“Offer rejected: missing required parameter” – Allegro categories require specific attributes (e.g. Stan/Condition, Marka/Brand). The error response names the parameter; set it via the listing override.

“Cannot publish: account not verified” – new Allegro Business accounts need company verification before publishing. Complete it in the seller portal.

Order events not appearing – ShipWave tracks the last-seen event ID. If polling stalls, click Resync events on the channel detail page.

FAQs

Do I need to speak Polish to sell on Allegro?
Not strictly, but you should at minimum have your listing titles and key bullets translated. Polish customer service is a plus — consider using a translation service or AI for buyer messages.
Why does Allegro use polling instead of webhooks?
Allegro’s event-bus model lets sellers replay events on demand and avoids the lost-webhook problem. Polling every 5 minutes is well within Allegro’s rate limit and means orders never get dropped.
Can I list in EUR or USD on Allegro?
No. Allegro is PLN-only. ShipWave converts your base price to PLN using your configured FX rate. Set a margin in your channel pricing rules to absorb FX fluctuations.
How does Allegro Smart! affect listings?
Allegro Smart! is the buyer-side free shipping program. Sellers opt in to qualifying carrier methods (InPost Paczkomaty especially). Enable Smart! delivery methods in your Allegro account settings; ShipWave will use them automatically on order acknowledgment.
Are there listing fees?
Allegro charges category-based listing fees and a commission on sales. ShipWave does not add any additional fees on top.

More in ShipWave Channels

Back to Help Center