Pe scurt: cum funcționează integrarea eMAG WooCommerce
O integrare eMAG WooCommerce leagă magazinul tău de eMAG Marketplace prin API-ul oficial al eMAG: produsele și ofertele pleacă din WooCommerce spre eMAG, comenzile vin înapoi în WooCommerce, iar stocul, prețul și AWB-ul se actualizează automat în ambele direcții. Ai trei variante: un plugin WooCommerce, un SaaS multichannel sau o integrare la comandă. Alegerea depinde de numărul de produse, de câte variații ai și de unde vine stocul (WooCommerce sau ERP).
Dacă vinzi sub 200 de produse fără variații, un plugin sau un SaaS e de obicei suficient. Dacă stocul vine din ERP, ai mai multe depozite sau vrei prețuri diferite pe eMAG, o integrare construită pe fluxurile tale te scutește de corecții manuale zilnice.
De ce merită să automatizezi conexiunea cu eMAG Marketplace
Problema clasică nu e publicarea primelor oferte, ci ce se întâmplă după. Vinzi ultimul produs pe site, oferta rămâne activă pe eMAG, primești o comandă pe care nu o poți onora și o anulezi. Rata de anulare intră în scorul tău de vânzător, iar ofertele cu scor slab pierd Buy Button-ul.
Iată ce costă, concret, lucrul manual:
- Stoc: fiecare vânzare din magazin, din showroom sau de pe alt marketplace trebuie scăzută și pe eMAG.
- Prețuri: o promoție pe site sau o schimbare de preț de la furnizor trebuie copiată în Seller Center.
- Comenzi: fiecare comandă eMAG trebuie confirmată, introdusă în WooCommerce sau în ERP și facturată.
- AWB și factură: AWB-ul se generează, iar factura (care trebuie să ajungă și în e-Factura) se încarcă pe comandă.
- Retururi: cererile de retur se procesează separat și stocul se repune.
La 20 de comenzi pe zi, asta înseamnă ușor 1–2 ore de muncă manuală zilnică (estimare) și erori inevitabile în perioade ca Black Friday.
Ce opțiuni ai: plugin, SaaS sau integrare la comandă
| Criteriu | Plugin WooCommerce pentru eMAG | SaaS multichannel (ex. easySales, Base) | Integrare la comandă |
|---|---|---|---|
| Cost inițial | mic (licență) | mic sau zero | proiect cu deviz fix |
| Cost lunar | licență anuală sau zero | abonament lunar, adesea pe volum de comenzi | hosting și mentenanță |
| Variații complexe | limitat | bun | complet adaptat |
| Stoc din ERP | rar | parțial, prin conectori | da, bidirecțional |
| Mai multe țări eMAG (RO, HU, BG) | depinde de plugin | de obicei da | da |
| Reguli proprii de preț | simple | medii | orice regulă |
| Control asupra datelor | pe serverul tău | la furnizorul SaaS | pe serverul tău |
Când e suficient un plugin: catalog mic, produse simple, stocul ținut doar în WooCommerce, câteva comenzi pe zi.
Când alegi un SaaS: vinzi pe mai multe marketplace-uri (eMAG, Trendyol, Allegro) și vrei un singur panou pentru comenzi și AWB. Plătești lunar, iar regulile de business sunt cele pe care le permite platforma.
Când merită integrarea la comandă: ERP-ul (Business Central, WizRom, SmartBill Gestiune) e sursa stocului și a prețurilor, ai mii de produse cu variații, ai mai multe depozite sau vrei logică proprie (adaos diferit pe eMAG, excluderi pe categorii, stoc de siguranță).
Ce date circulă între WooCommerce și eMAG
API-ul eMAG Marketplace lucrează pe resurse.1 Cele mai importante pentru un magazin WooCommerce sunt product_offer (produse și oferte), offer_stock (actualizări rapide de stoc), order (comenzi), awb (expediere), rma (retururi) și nomenclatoarele category, vat și handling_time. Fiecare țară are propriul endpoint: marketplace-api.emag.ro, marketplace-api.emag.hu și marketplace-api.emag.bg.
| Date | Direcție | Frecvență recomandată | Resursă API |
|---|---|---|---|
| Produse noi (documentație) | WooCommerce → eMAG | la publicare | product_offer/save |
| Ofertă: preț, stare, garanție | WooCommerce → eMAG | la modificare | product_offer/save |
| Stoc | WooCommerce sau ERP → eMAG | în câteva secunde de la modificare | offer_stock |
| Comenzi noi | eMAG → WooCommerce | la notificare sau la 1–5 minute | order/read, order/acknowledge |
| Status comandă, produse modificate | WooCommerce → eMAG | la schimbarea statusului | order/save |
| AWB | WooCommerce → eMAG → curier | la pregătirea coletului | awb/save |
| Factura PDF | WooCommerce → eMAG | după emitere | atașament pe comandă |
| Retururi | eMAG → WooCommerce | la 15–60 de minute | rma/read |
Oferte noi vs. atașare la produse existente
Dacă produsul există deja pe eMAG (alt vânzător îl vinde), îți atașezi oferta la el prin part_number_key (codul produsului eMAG) sau prin EAN. Oferta intră rapid în vânzare. Dacă produsul nu există, trimiți documentația completă: categorie, nume, brand, descriere, imagini, caracteristici obligatorii ale categoriei și EAN. Documentația trece printr-o validare eMAG, care poate dura de la câteva ore la câteva zile.
Câmpurile de ofertă pe care le setezi la fiecare produs: ID-ul tău intern (id), sale_price fără TVA, min_sale_price și max_sale_price (intervalul de preț acceptat), vat_id, stocul pe depozit, handling_time (zile până la predarea către curier), garanția și statusul ofertei (activă sau inactivă).
Fluxul unei comenzi eMAG
Statusurile comenzilor eMAG sunt numerice1 și merită mapate explicit pe statusurile WooCommerce (statusurile WooCommerce sunt date cu denumirea din engleză):
| Status eMAG | Înseamnă | Status WooCommerce sugerat |
|---|---|---|
| 1 – Nouă | comanda tocmai a intrat | On hold (în așteptare) |
| 2 – În procesare | ai confirmat-o (acknowledge) | Processing |
| 3 – Pregătită | coletul e gata | Processing (pregătită) |
| 4 – Finalizată | AWB generat, predată | Completed |
| 5 – Returnată | retur procesat | Refunded |
| 0 – Anulată | anulată de client sau de tine | Cancelled |
Confirmarea (acknowledge) e pasul pe care mulți îl uită: o comandă rămasă în status 1 nu e considerată preluată de tine, iar timpii de procesare contează la evaluarea vânzătorului.
Pas cu pas: cum configurezi integrarea eMAG cu WooCommerce
- Activează accesul API. În contul eMAG Marketplace, în setările tehnice, verifici că utilizatorul are drept de acces la API și adaugi IP-ul public al serverului. Autentificarea se face cu utilizatorul și parola contului de API, conform documentației eMAG.
- Mapează categoriile. Fiecare categorie WooCommerce se leagă de o categorie eMAG (
category/read), iar atributele WooCommerce de caracteristicile obligatorii ale acelei categorii. Aici se pierde cel mai mult timp la cataloagele mari. - Stabilește identificatorii. Fiecare produs simplu sau variație WooCommerce are un ID de ofertă eMAG unic și stabil. Nu folosi SKU-uri care se pot schimba; folosește ID-ul produsului sau al variației.
- Definește regulile de preț. De exemplu: preț eMAG = preț site + 12% pentru a acoperi comisionul, rotunjit la ,99. Setează
min_sale_priceșimax_sale_pricesuficient de larg ca promoțiile să nu fie respinse. - Stoc de siguranță. Trimite pe eMAG stocul real minus 1–2 bucăți la produsele cu rotație mare, ca să absorbi întârzierile de sincronizare.
- Importă comenzile. Citește comenzile noi, confirmă-le, creează-le în WooCommerce cu sursa eMAG, scade stocul și dezactivează e-mailurile WooCommerce către client (eMAG comunică deja cu el).
- Factură și AWB. Factura se emite din programul de facturare (SmartBill, Oblio), se trimite în e-Factura și se atașează pe comanda eMAG. AWB-ul se generează prin curierii disponibili în contul tău eMAG.
- Retururi. Cererile de retur se importă, se aprobă și repun stocul doar după recepția produsului.
- Reconciliere nocturnă. O dată pe noapte, compară toate ofertele eMAG cu stocul și prețul din magazin și corectează diferențele.
Erori frecvente și ce înseamnă
- IP neautorizat: API-ul respinge cererea pentru că IP-ul serverului nu e în lista permisă din cont. Adaugă-l sau mută integrarea pe un server cu IP fix.
- Acces API refuzat: utilizator sau parolă greșite, ori contul nu are acces API activat.
- Preț în afara intervalului:
sale_pricee submin_sale_pricesau pestemax_sale_price. Recalculează intervalul la fiecare schimbare de preț. - Caracteristici obligatorii lipsă: documentația e respinsă la validare. Completează atributele cerute de categoria eMAG.
- EAN deja asociat: EAN-ul aparține altui produs eMAG; atașează oferta la acel
part_number_key, nu crea un produs nou. - Limitare de cereri: prea multe apeluri pe secundă. Trimite actualizările printr-o coadă, grupate, nu câte un apel la fiecare salvare de produs.
- Blocare temporară după erori repetate: eMAG poate limita accesul dacă trimiți constant date invalide. Validează datele înainte de trimitere.
Pe partea WooCommerce, folosește Action Scheduler (coada de joburi inclusă în WooCommerce) pentru sincronizări și activează HPOS (High-Performance Order Storage), ca importul de comenzi să nu încetinească panoul de administrare.
Cât costă o integrare eMAG WooCommerce
Prețurile de mai jos sunt estimări de piață pentru România, fără TVA. Comisionul eMAG este separat și variază pe categorie; procentul exact îl vezi în contract și în contul de vânzător.
| Variantă | Cost inițial (estimare) | Cost lunar (estimare) | Potrivit pentru |
|---|---|---|---|
| Plugin WooCommerce pentru eMAG | 0–300 € | 0–30 € | sub 200 de produse simple |
| SaaS multichannel | 0–200 € configurare | 30–300 €, crește cu volumul | mai multe marketplace-uri, catalog standard |
| Integrare la comandă (modul) | 1.500–5.000 € | inclusă în mentenanță | ERP, variații, mai multe țări |
| Integrare cu ERP și eMAG RO/HU/BG | ofertă Enterprise | SLA | volume mari, mai multe depozite |
La Raao, sincronizarea cu marketplace-uri este un modul pe care îl adaugi peste un magazin existent sau îl incluzi în pachetul Enterprise (vezi prețurile). Primești deviz fix după un apel de 30 de minute, plătești 30% avans și restul pe etape, fără comisioane din vânzări și fără licențe. Găzduirea și mentenanța pornesc de la 89 €/lună.
Fă calculul simplu: dacă integrarea îți economisește o oră pe zi și elimină 2–3 comenzi anulate pe lună, un modul de 2.500 € se amortizează de obicei în mai puțin de un an.
Cum am aplicat aceeași arhitectură pentru Kuiba
Studiul de caz Kuiba nu e despre eMAG, iar Kuiba rulează pe o platformă construită la comandă, nu pe WooCommerce. Problema de bază e însă aceeași: un catalog mare care trebuie să ajungă corect în mai multe canale fără introducere manuală. Ce am construit acolo și refolosim în orice integrare cu marketplace-uri:
- Un catalog central cu peste 10.000 de produse configurabile de la peste 25 de branduri, alimentat prin importuri automate de la furnizori, cu mapare de categorii asistată de AI.
- Feed-uri generate din același catalog pentru Google Merchant, Meta, TikTok și Pinterest, deci o singură sursă de adevăr pentru preț și disponibilitate.
- Comenzi trimise automat în Microsoft Business Central prin stratul CRM al clientului, fără reintroducere.
- Mii de produse și combinații gestionate fără introducere manuală de date.
Pentru un magazin care vinde și pe eMAG, adăugăm aceleași principii: o sursă unică pentru stoc, cozi de sincronizare și reconciliere zilnică. Poți vedea ce mai integrăm pe pagina de ecommerce sau poți programa un apel gratuit de 30 de minute ca să discutăm catalogul tău.