Cum conectezi eMAG (RO, BG și HU) cu easySales: ghid complet de integrare

De ce să conectezi eMAG cu easySales

Vinzi pe eMAG și vrei un singur loc unde să gestionezi comenzile, să generezi facturi, să trimiți AWB-uri la curieri și să-ți menții ofertele sincronizate? easySales acoperă tot dintr-un singur dashboard — pe eMAG România, eMAG Bulgaria și eMAG Ungaria.

Odată conectat, comenzile eMAG ajung automat în easySales. De aici generezi facturi, creezi AWB-uri cu orice curier suportat și rulezi flow-uri de automatizare. Catalogul tău merge în direcția cealaltă: easySales îți publică produsele ca oferte eMAG și menține stocul și prețurile actualizate în mod continuu, ca să gestionezi un singur catalog în loc să editezi fiecare listare manual.

Te conectezi cu datele de autentificare API din contul tău eMAG — nu există plugin de instalat și nu e nevoie de acces de developer. Întregul flux este: adaugi easySales pe lista de IP-uri permise în eMAG și copiezi datele de autentificare API, deschizi formularul de conectare în easySales, lipești credențialele și salvezi.

Cum funcționează conectorul eMAG

easySales comunică cu eMAG prin Marketplace API-ul eMAG, autentificat cu datele de autentificare din contul tău de seller. eMAG acceptă apeluri API doar de la adresele IP pe care le-ai aprobat explicit, așa că primul lucru pe care îl faci este să adaugi easySales pe lista de IP-uri permise din contul tău eMAG. Fără acest pas, fiecare apel este respins și nimic nu se sincronizează.

Sincronizarea este în mare parte unidirecțională și merită să înțelegi împărțirea înainte să începi:

• Comenzile intră. easySales verifică eMAG pentru comenzi noi și actualizate cam la fiecare minut, așa că acestea ajung pe ecranul Comenzi gata pentru facturare, AWB-uri și flow-uri.
• Ofertele, stocul și prețurile ies — odată ce ofertele sunt legate. easySales este sursa de adevăr pentru stocul și prețurile pe care le publică. Sincronizarea nu este automată din momentul conectării: fiecare ofertă eMAG trebuie mai întâi legată de un produs din catalogul tău easySales (detaliat mai jos). Stocul raportat de eMAG este citit înapoi ca referință, dar easySales rămâne sursa de adevăr pentru valorile pe care le împinge.

Cerințe preliminare — ce să pregătești înainte să începi

Câteva cerințe împiedică eșecul conexiunii la prima sincronizare.

Pasul 1 — Adaugă easySales pe lista de IP-uri permise și copiază datele de autentificare API în eMAG

eMAG respinge apelurile API de la orice IP pe care nu îl recunoaște, așa că începi pe partea eMAG.

În contul tău de seller eMAG, mergi la My account → Technical details. La Add new IP Address, adaugă ambele adrese IP de la care se conectează easySales — 51.158.174.60 și 3.124.61.144 — salvând fiecare în parte. (Verifică mereu aceste valori comparându-le cu cele pe care easySales le afișează în instrucțiunile de conectare, în caz că se schimbă vreodată.)

Cât timp ești pe tab-ul Technical details, copiază-ți API Code și notează-ți numele de utilizator și parola — le vei introduce pe toate trei în easySales în Pasul 3.

Pasul 2 — Deschide formularul de conectare în easySales

În easySales, mergi la Integrări → Marketplace. Găsește eMAG pentru țara pe care o conectezi — eMAG (România), eMAG Bulgaria sau eMAG Ungaria — și apasă Conectează pe cardul ei. (Dacă vinzi deja pe alt cont eMAG, deschide meniul ⋮ al cardului și alege Adaugă cont în loc.)

Formularul de setări eMAG se deschide cu două tab-uri: Setări principale (credențialele și configurarea de bază) și Setări adiționale (comportamentul de sincronizare și funcțiile opționale). Vei lucra mai întâi în Setări principale.

Pasul 3 — Introdu credențialele și setările contului

Pe tab-ul Setări principale, completează credențialele și configurarea de care easySales are nevoie ca să conducă integrarea.

Credențiale

• Nume de utilizator și Parola — datele de login pentru contul tău de seller eMAG. Ambele sunt obligatorii.
• Cod API - opțional — codul API pe care l-ai copiat din tab-ul Technical details al eMAG. Câmpul este marcat ca opțional, dar introdu-l: face parte din modul în care eMAG îți identifică integrarea și evită probleme de autentificare care pot fi evitate.

Configurarea contului

• Nume Conexiune — o etichetă aleasă de tine (de exemplu „eMAG RO"). Vizibilă doar în easySales, utilă când rulezi mai multe conexiuni eMAG.
• Țara TVA — țara ale cărei reguli de TVA se aplică comenzilor tale (RO, HU, BG, GR sau SK).
• Plătitor de taxe (doar eMAG România) — selectează Da dacă ești înregistrat în scopuri de TVA sau Nu dacă nu ești. Pe formularele eMAG Ungaria și Bulgaria setezi TVA-ul prin câmpul Cotă TVA implicită în schimb.
• Cotă TVA implicită — procentul de TVA implicit aplicat ofertelor și comenzilor tale. Setează 0 dacă nu ești plătitor de TVA. (Acesta este câmpul de TVA afișat pe formularele eMAG Ungaria și Bulgaria.)
• Seria de facturare — seria de facturare implicită atribuită comenzilor eMAG importate, care corespunde seriei pe care o folosești în software-ul tău de facturare.
• Adaos Preț — un procent opțional adăugat peste prețul produsului la publicarea ofertelor pe eMAG.
• Tip de pachet implicit — pachetul implicit (plic sau colet) folosit la generarea AWB-urilor pentru comenzile eMAG.
• Zile de livrare — timpul de procesare publicat odată cu ofertele tale. Alege o valoare din listă (0 implicit).

Apasă Save ca să finalizezi.

Ce se întâmplă automat după ce salvezi

Odată ce testul de conexiune trece, easySales configurează integrarea fără nicio altă acțiune din partea ta.

1. Se programează o sincronizare inițială — easySales începe să importe comenzile tale eMAG recente, ca să ai imediat cu ce lucra.
2. Comenzile eMAG noi ajung pe ecranul Comenzi în decurs de un minut-două de atunci înainte, gata pentru facturi, AWB-uri și flow-uri de automatizare.
3. Ofertele pe care le vinzi deja pe eMAG sunt importate în Marketplace → Oferte (tab-ul eMAG) — dar nu sunt sincronizate încă. Fiecare ofertă importată trebuie mai întâi legată de produsul corespondent din catalogul tău easySales; doar ofertele legate trimit actualizări de stoc, preț și conținut către eMAG.

Comenzile sunt singurul lucru care intră de la sine. Listările tale sunt un al doilea pas deliberat: leagă ofertele eMAG importate de catalogul tău (easySales poate lega automat multe dintre ele pentru tine), iar pentru produsele pe care nu le vinzi încă pe eMAG, mapează-le categoriile și publică-le ca oferte noi. Odată ce o ofertă este legată, easySales îi menține stocul și prețul actualizate în mod continuu de atunci înainte.

RO vs BG vs HU — conectează fiecare țară o singură dată

Procedura de conectare este identică pentru toate cele trei marketplace-uri eMAG. Ce diferă este specific fiecărei țări, iar easySales se ocupă de asta odată ce alegi marketplace-ul corect:

• Endpoint-ul API (eMAG România, Bulgaria sau Ungaria).
• Moneda implicită — RON pentru RO, BGN pentru BG, HUF pentru HU.
• Contul în sine — fiecare țară este un cont eMAG de seller separat, așa că fiecare are propria conexiune în easySales.

Adaugă easySales pe lista de IP-uri permise și copiază credențialele separat în contul eMAG al fiecărei țări, apoi adaugă o conexiune separată pentru fiecare țară în Integrări → Marketplace.

Reglarea fină a conexiunii eMAG

Tab-ul Setări adiționale controlează cum sincronizează easySales cu eMAG după ce conexiunea este activă.

Opțiunile care contează cel mai mult de zi cu zi:

• Trimite prețurile pe marketplace — împinge schimbările de preț din easySales către ofertele tale eMAG. Dezactivează dacă gestionezi prețurile direct în eMAG.
• Trimite stocul ofertei către marketplace — împinge nivelurile de stoc către eMAG. Dezactivează dacă eMAG nu citește stocul din easySales.
• Suprascrie imaginile ofertei — înlocuiește imaginile de pe ofertele eMAG existente cu cele din easySales.
• Exclude transportul din facturile cu livrare în locker — elimină linia de transport de pe facturile pentru comenzile livrate la locker.
• Trimite factura către marketplace după generare — trimite fiecare factură către eMAG automat, odată ce easySales o generează.

Acest tab acoperă și reguli opționale de preț automat și detalii GPSR de siguranță a produselor (informații despre reprezentantul UE și producător) pe care eMAG le solicită pentru anumite categorii de produse. Le setezi o dată și easySales le aplică ofertelor tale.

Ești conectat — ce urmează

Cu comenzile sosind, pasul următor este automatizarea: configurează flow-uri ca să generezi facturi, să creezi AWB-uri și să notifici clienții.

Ca să-ți pui catalogul pe eMAG, mapează-ți mai întâi categoriile la cele eMAG — ofertele nu pot fi publicate până când produsele tale nu sunt corelate cu categoriile și caracteristicile eMAG potrivite. Odată ce maparea este gata, transformă-ți produsele în oferte și lasă easySales să le publice și să le mențină.