eMAG.hu WooCommerce integráció: készlet, árak, rendelések API-val

Röviden: így működik az eMAG.hu WooCommerce integráció

Az eMAG.hu WooCommerce integráció az eMAG hivatalos Marketplace API-ján keresztül köti össze a webshopodat a piactérrel. A termékek és ajánlatok a WooCommerce-ből mennek ki az eMAG-ra, a rendelések visszajönnek a WooCommerce-be, a készlet, az ár és a fuvarlevél pedig mindkét irányban automatikusan frissül. Három út van: WooCommerce-bővítmény, multichannel SaaS vagy egyedi integráció.

Ha 200-nál kevesebb, változatok nélküli terméked van, egy bővítmény vagy SaaS általában elég. Ha a készlet az ERP-ből jön, több raktárad van, vagy más árat akarsz az eMAG-on, egy a folyamataidra épített integráció megspórolja a napi kézi javítgatást.

Miért éri meg automatizálni az eMAG piactér kapcsolatot?

Az első ajánlatok feltöltése a könnyebb rész. A gond utána kezdődik: a webshopban elkel az utolsó darab, az eMAG-on az ajánlat aktív marad, beesik egy rendelés, amit nem tudsz teljesíteni, és lemondod. A lemondási arány beszámít az eladói értékelésedbe, a gyenge mutatójú ajánlatok pedig elveszítik a Buy Button pozíciót.

Kézi munkával ezek a feladatok várnak rád minden nap:

• Készlet: minden webshopos, bolti vagy más piactéren történt eladást az eMAG-on is le kell vonni.
• Árak: egy webshopos akciót vagy beszállítói árváltozást át kell vinni a Seller Centerbe.
• Rendelések: minden eMAG-os rendelést vissza kell igazolni, rögzíteni a WooCommerce-ben vagy az ERP-ben, és számlázni.
• Fuvarlevél és számla: a fuvarlevelet (AWB) le kell generálni, a NAV-nak jelentett számlát fel kell tölteni a rendeléshez.
• Visszárú: a visszaküldési kérelmeket külön kell kezelni, és a készletet visszaírni.

Napi 20 rendelésnél ez könnyen napi 1–2 óra kézi munka (becslés), és a Black Friday-szerű csúcsokban szinte biztos a hiba.

Milyen megoldások közül választhatsz?

Szempont	WooCommerce eMAG-bővítmény	Multichannel SaaS (pl. Base.com, easySales)	Egyedi integráció
Kezdeti költség	alacsony (licenc)	alacsony vagy nulla	fix áras projekt
Havi költség	éves licenc vagy nulla	havidíj, gyakran rendelésszám alapján	tárhely és karbantartás
Összetett termékváltozatok	korlátozott	jó	teljesen testre szabott
Készlet az ERP-ből	ritkán	részben, csatolókkal	igen, kétirányú
Több eMAG-ország (HU, RO, BG)	bővítményfüggő	általában igen	igen
Saját árazási szabályok	egyszerűek	közepesek	bármilyen szabály
Adatok helye	a saját szervereden	a SaaS-szolgáltatónál	a saját szervereden

Mikor elég egy bővítmény? Kis katalógus, egyszerű termékek, a készletet csak a WooCommerce tartja nyilván, és naponta néhány rendelésed van.

Mikor jó a SaaS? Ha több piactéren is árulsz (eMAG.hu, Allegro.hu, Kaufland) és egy felületen akarod kezelni a rendeléseket és a fuvarleveleket. Havonta fizetsz, és azokkal a szabályokkal dolgozol, amelyeket a platform enged.

Mikor éri meg az egyedi integráció? Ha az ERP (például Business Central) a készlet és az árak forrása, több ezer változatos terméked van, több raktárból szállítasz, vagy saját logikát akarsz (más árrés az eMAG-on, kategóriák kizárása, biztonsági készlet).

Milyen adatok mennek a WooCommerce és az eMAG között?

Az eMAG Marketplace API erőforrásokra épül. Egy WooCommerce webshopnál a legfontosabbak: product_offer (termékek és ajánlatok), offer_stock (gyors készletfrissítés), order (rendelések), awb (szállítás), rma (visszárú), valamint a category, vat és handling_time törzsadatok. A magyar piactér végpontja a marketplace-api.emag.hu, a románé a marketplace-api.emag.ro.¹

Adat	Irány	Javasolt gyakoriság	API-erőforrás
Új termék (dokumentáció)	WooCommerce → eMAG	publikáláskor	product_offer/save
Ajánlat: ár, állapot, garancia	WooCommerce → eMAG	változáskor	product_offer/save
Készlet	WooCommerce vagy ERP → eMAG	változás után másodpercekkel	offer_stock
Új rendelések	eMAG → WooCommerce	értesítéskor vagy 1–5 percenként	order/read, order/acknowledge
Rendelés állapota, módosított tételek	WooCommerce → eMAG	állapotváltáskor	order/save
Fuvarlevél (AWB)	WooCommerce → eMAG → futár	csomagoláskor	awb/save
Számla PDF	WooCommerce → eMAG	kiállítás után	csatolmány a rendelésen
Visszárú	eMAG → WooCommerce	15–60 percenként	rma/read

Új termék vagy csatlakozás meglévő termékhez

Ha a termék már létezik az eMAG.hu-n (más eladó is árulja), az ajánlatodat a part_number_key (az eMAG termékkódja) vagy az EAN alapján csatolod hozzá, és gyorsan élesedik. Ha nem létezik, teljes dokumentációt küldesz: kategória, név, márka, leírás, képek, a kategória kötelező jellemzői és EAN. Ezt az eMAG jóváhagyja, ami néhány órától néhány napig tarthat.

Minden ajánlatnál ezeket a mezőket állítod be: a saját belső azonosítód (id), a nettó eladási ár (sale_price, ÁFA nélkül, forintban), a min_sale_price és max_sale_price ársáv, a vat_id (ÁFA-kulcs, nálunk jellemzően 27%), a raktárankénti készlet, a handling_time (napok a futárnak átadásig), a garancia és az ajánlat állapota.

Egy eMAG-os rendelés útja

Az eMAG rendelésállapotai számok, érdemes őket egyenként a WooCommerce állapotaihoz rendelni:

eMAG állapot	Jelentés	Javasolt WooCommerce állapot
1 – Új	most érkezett	Fizetés függőben (Pending payment) vagy saját „eMAG: új” állapot
2 – Feldolgozás alatt	visszaigazoltad (acknowledge)	Feldolgozás alatt
3 – Előkészítve	a csomag kész	Feldolgozás alatt (csomagolva)
4 – Teljesítve	fuvarlevél kész, átadva	Teljesített (Completed)
5 – Visszaküldve	visszárú feldolgozva	Visszatérített (Refunded)
0 – Törölve	vevő vagy te mondtad le	Visszamondott (Cancelled)

A visszaigazolás az a lépés, amit sokan kihagynak: az 1-es állapotban maradt rendelést az eMAG nem tekinti átvettnek, és a feldolgozási idő beleszámít az eladói értékelésbe.

Lépésről lépésre: hogyan állítsd be az integrációt?

1. Kapcsold be az API-hozzáférést. Az eMAG Marketplace fiókod technikai beállításainál ellenőrizd, hogy a felhasználónak van API-jogosultsága, és add hozzá a szerver nyilvános IP-címét. A hitelesítés Basic típusú (felhasználónév és jelszó base64-kódolva).
2. Párosítsd a kategóriákat. Minden WooCommerce-kategóriát egy eMAG-kategóriához kötsz (category/read), a WooCommerce-attribútumokat pedig a kategória kötelező jellemzőihez. Nagy katalógusnál itt megy el a legtöbb idő.
3. Rögzítsd az azonosítókat. Minden egyszerű termék vagy változat kapjon egyedi, állandó eMAG-ajánlatazonosítót. Ne változékony cikkszámot használj, hanem a termék vagy a változat azonosítóját.
4. Határozd meg az árazási szabályt. Például: eMAG-ár = webshopár + 12% a jutalék fedezésére, 90-re kerekítve. A min_sale_price és max_sale_price sávot hagyd elég szélesre, hogy az akciós árakat ne utasítsa el a rendszer.
5. Biztonsági készlet. A gyorsan forgó termékeknél a valós készlet mínusz 1–2 darabot küldd ki, így elnyeled a szinkron késését.
6. Rendelésimport. Olvasd be az új rendeléseket, igazold vissza őket, hozd létre WooCommerce-rendelésként eMAG-forrással, vond le a készletet, és kapcsold ki a WooCommerce vevőnek szóló e-mailjeit (az eMAG már kommunikál vele).
7. Számla és fuvarlevél. A számlát a Számlázz.hu vagy a Billingo állítja ki és jelenti a NAV-nak, az integráció pedig csatolja a PDF-et az eMAG-os rendeléshez. A fuvarlevél az eMAG-fiókodban elérhető futárokon keresztül készül.
8. Visszárú. A kérelmeket importálod, jóváhagyod, és a készletet csak a termék beérkezése után írod vissza.
9. Éjszakai egyeztetés. Éjjelente vesd össze az összes eMAG-ajánlatot a webshop készletével és áraival, és javítsd az eltéréseket.

Mire figyelj kifejezetten magyar eladóként?

• Forintárak és kerekítés. Az API nettó árat vár, a vásárló bruttót lát. Számold a bruttó célárból visszafelé (például 12 990 Ft ÷ 1,27), különben a kerekítés miatt 12 989 vagy 12 991 Ft jelenik meg.
• Számla és NAV. A számlát a számlázóprogramod jelenti a NAV-nak; az eMAG csak a PDF-et kapja meg. Ha a számla sztornózásra kerül, a módosító számlát is csatold a rendeléshez.
• Szállítási idő. A handling_time munkanapban értendő. Ha pénteken délután érkezik a rendelés, és 1 nap a vállalásod, hétfőn már késésben lehetsz.
• Román és bolgár terjeszkedés. Ha később az eMAG.ro-n is árulsz, előre tervezd be a lejes árakat, a román nyelvű termékadatokat és a határon átnyúló szállítást.

Gyakori hibák és jelentésük

• Invalid vendor ip: a szerver IP-címe nincs engedélyezve a fiókban. Add hozzá, vagy tedd fix IP-s szerverre az integrációt.
• You are not allowed to use this API.: hibás felhasználónév vagy jelszó, vagy a fiókban nincs bekapcsolva az API-hozzáférés.
• Ár az engedélyezett sávon kívül: a sale_price a min_sale_price alatt vagy a max_sale_price felett van. Minden árváltozáskor számold újra a sávot.
• Hiányzó kötelező jellemzők: a jóváhagyás elutasítja a dokumentációt. Töltsd ki az eMAG-kategória által kért attribútumokat.
• Az EAN már másik termékhez tartozik: csatold az ajánlatot a meglévő part_number_key-hez, ne hozz létre új terméket.
• Kéréskorlát: túl sok hívás másodpercenként. Feladatsorral, csoportosítva küldd a frissítéseket, ne minden termékmentéskor külön hívással.
• Ideiglenes tiltás ismételt hibák után: ha folyamatosan hibás adatot küldesz, az eMAG korlátozhatja a hozzáférést. Küldés előtt validáld az adatokat.

A WooCommerce oldalon az Action Schedulert (a WooCommerce beépített feladatsorát) használd a szinkronhoz, és kapcsold be a HPOS-t (High-Performance Order Storage), hogy a rendelésimport ne lassítsa az adminfelületet.

Mennyibe kerül egy eMAG.hu WooCommerce integráció?

Az alábbi összegek piaci becslések, ÁFA nélkül (a forintösszeg kb. 365 Ft/€ árfolyammal számolva²). Az eMAG jutaléka külön tétel, kategóriánként állapítják meg a szerződéskötéskor; a pontos százalékot a szerződésben és a Seller Centerben látod. Piaci források szerint ez nagyjából 7% és 22% között mozog kategóriától függően.³

Megoldás	Kezdeti költség (becslés)	Havi költség (becslés)	Kinek való
WooCommerce eMAG-bővítmény	0–300 € (kb. 0–110 ezer Ft)	0–30 €	200 alatti egyszerű termék
Multichannel SaaS	0–200 € beállítás	30–300 €, a forgalommal nő	több piactér, szabványos katalógus
Egyedi integráció (modul)	1 500–5 000 €	a karbantartás része	ERP, változatok, több ország
ERP + eMAG HU/RO/BG integráció	Enterprise ajánlat	SLA	nagy volumen, több raktár

A Raao-nál a piactér-szinkron egy modul, amelyet meglévő webshophoz adsz hozzá, vagy az Enterprise csomag része (lásd az árakat). Egy ingyenes 30 perces hívás után fix árajánlatot kapsz, 30% előleggel és mérföldkövenként fizetsz, eladási jutalék és licencdíj nélkül. A tárhely és karbantartás havi 89 €-tól indul.

Egyszerű becslés: ha az integráció napi egy órát megspórol, és havonta 2–3 lemondott rendelést kivált, egy 2 500 eurós modul jellemzően egy éven belül megtérül.

Hogyan alkalmaztuk ugyanezt az architektúrát a Kuibánál?

A Kuiba nem eMAG-projekt, de az alapprobléma ugyanaz: egy nagy katalógusnak kézi adatbevitel nélkül, pontosan kell eljutnia több csatornára. Amit ott felépítettünk, és minden piactér-integrációnál újrahasznosítunk:

• Központi katalógus 25+ európai márka több mint 10 000 konfigurálható termékével, automatizált beszállítói importokkal és AI-támogatott kategórialeképezéssel.
• Ugyanabból a katalógusból generált Google Merchant, Meta, TikTok és Pinterest feedek, így az ár és az elérhetőség egyetlen forrásból jön.
• Rendelések automatikus továbbítása a Microsoft Business Centralba az ügyfél CRM-rétegén keresztül.
• Termékek és kombinációk ezrei kezelve kézi adatbevitel nélkül.

Egy eMAG.hu-n is értékesítő webshopnál ugyanezeket az elveket alkalmazzuk: egyetlen készletforrás, szinkron-feladatsor és napi egyeztetés. Hogy mi mindent kötünk még össze, azt az e-kereskedelmi oldalon látod, vagy foglalj egy ingyenes 30 perces hívást, és nézzük meg együtt a katalógusodat.