← Toate articolele

API eMAG: ce puteți face prin API-ul eMAG Marketplace, cum obțineți acces și ce limite are

· 13 min de citit · Stoc și integrări

Răspuns scurt: API-ul eMAG Marketplace este interfața prin care sistemul dumneavoastră (ERP, program de gestiune sau o platformă externă) comunică direct cu contul de seller eMAG. Prin API puteți încărca produse și oferte, actualiza stocul și prețurile, citi și procesa comenzile, genera AWB-uri și gestiona retururile, fără să lucrați manual în platformă. Documentația este publică, iar potrivit eMAG ultima versiune este v4.5.1, valabilă din 2 martie 2026. Pentru acces aveți nevoie de un utilizator cu drepturi API, iar apelurile sunt acceptate doar de pe adrese IP aprobate. Dacă nu vreți să construiți singur conexiunea, puteți gestiona stocul, prețurile și comenzile de pe eMAG și Trendyol România dintr-un singur panou.

Ce este API-ul eMAG Marketplace?

eMAG spune în documentație că API-ul a fost dezvoltat pentru partenerii Marketplace, ca să își poată folosi propriile sisteme de tip CRM sau ERP. În Infocenter, eMAG îl descrie ca instrument pentru încărcarea produselor și ofertelor, dar și pentru procesarea eficientă a comenzilor.

Concret, API-ul înlocuiește munca repetitivă din interfață: în loc să modificați stocul produs cu produs sau să descărcați comenzile manual, programul dumneavoastră trimite și citește datele automat. Aceeași documentație acoperă eMAG România, Bulgaria și Ungaria, precum și Fashion Days România și Bulgaria, fiecare cu adresa sa de producție. Pentru eMAG România, limba platformei este ro_RO, iar moneda implicită RON.

Ce puteți face prin API eMAG

Potrivit documentației, API-ul permite:

  • Produse și oferte: creați produse noi, actualizați oferte existente sau atașați oferta la un produs eMAG existent, după EAN sau part_number_key.
  • Stoc, preț și status: actualizați prețul, stocul, timpul de procesare (handling time) și statusul ofertei.
  • Date de catalog: citiți categorii, caracteristici, cote de TVA și valorile pentru timpul de procesare; salvați dimensiunile produselor.
  • Comenzi: citiți comenzile, le confirmați (acknowledge), le editați, adăugați sau scoateți produse și faceți storno.
  • Documente și livrare: atașați facturi, garanții și manuale; emiteți AWB-uri și le descărcați în PDF (A4, A5, A6) sau ZPL.
  • Retururi: citiți și procesați cererile de retur (RMA).
  • Campanii: citiți campaniile, vedeți ofertele eligibile și propuneți oferte.
  • Notificări: primiți notificări pe un URL de callback pentru comenzi noi, anulări, retururi, statusul AWB și documentația aprobată.

Documentația API eMAG: unde o găsiți

Documentația o găsiți în Infocenter, la Listarea produselor » Importul produselor prin API / Feed » Documentație API. De acolo, butonul „Accesează Documentația API" duce la pagina publică a documentației. Infocenter indică versiunea v4.5.1, valabilă din 2 martie 2026, iar pagina documentației afișa la 29 octombrie 2026 deja versiunea 4.5.2, cu noutăți legate de campanii. Verificați versiunea înainte de fiecare actualizare a conexiunii.

Pe aceeași pagină din Infocenter găsiți și „Termenii și Condițiile pentru utilizarea API pe eMAG Marketplace". Documentul descrie, potrivit eMAG, restricțiile și limitele de utilizare, autentificarea și securitatea, modificările API-ului și protecția datelor. Îl puteți citi doar autentificat în contul de seller: parcurgeți-l înainte să conectați orice program.

Cum obțineți acces: utilizator API, autentificare și IP-uri

Trei condiții apar explicit în documentație:

  1. Un utilizator cu drepturi API. Contul folosit pentru apeluri trebuie să aibă drepturi API acordate.
  2. Autentificare Basic. Nu există o „cheie API" separată în sensul obișnuit: cererile se autentifică cu numele de utilizator și parola, codificate base64. De aici și importanța unei parole puternice și a unui utilizator dedicat, nu a contului personal.
  3. Filtrare după IP. Înainte de testare trebuie să transmiteți lista de IP-uri de pe care veți face apeluri; eMAG acceptă cereri doar de pe acele adrese. Dacă sistemul dumneavoastră primește notificări de la eMAG, documentația publică și IP-urile de pe care vin acestea, ca să le permiteți în firewall.

Cum se creează utilizatorul API și unde se trimite lista de IP-uri nu este descris în paginile publice; verificați în contul de seller sau cu echipa de suport eMAG. Despre un mediu de test (sandbox): documentația publică listează doar serverele de producție, așa că întrebați suportul înainte de a testa pe date reale.

Limitele API-ului eMAG

Limitele contează mai ales dacă aveți mii de produse:

  • Comenzi — 12 cereri pe secundă (720 pe minut)
  • Celelalte resurse — 3 cereri pe secundă (180 pe minut), cumulat
  • Depășirea limitei — răspuns HTTP 429; și cererile invalide se numără
  • Salvare în bloc — maximum 50 de entități pe cerere (recomandat 10–50)
  • Mărimea cererii — maximum 4.000 de elemente
  • Programare — evitați orele fixe (de exemplu 12:04:42 în loc de 12:00:00)
  • Jurnal — eMAG recomandă alerte pe răspunsuri și păstrarea apelurilor timp de 30 de zile

Încă un detaliu util: fiecare răspuns corect are „isError": false. Excepție: la o eroare de documentație la salvarea unui produs nou, răspunsul poate fi „isError": true, deși oferta a fost salvată.

Stocul și prețul prin API

Pentru actualizări rapide există două metode dedicate:

  • Doar stocul: o cerere PATCH pe resursa de stoc a ofertei, identificată prin ID-ul intern al produsului din sistemul dumneavoastră.
  • Oferta „light": actualizați doar datele ofertei (preț de vânzare, preț recomandat, preț minim și maxim, stoc, timp de procesare, TVA, status), fără documentația produsului.

Trei reguli evită erori costisitoare:

  • Prețurile se trimit fără TVA. Prețul de vânzare, prețul minim și cel maxim sunt definite în documentație fără TVA; prețul minim și cel maxim sunt obligatorii la prima salvare.
  • Statusul ofertei: 1 înseamnă activă, 0 inactivă, iar 2 „End of Life", folosit doar la actualizare.
  • Modificări programate: puteți programa schimbări de preț, stoc sau status cu până la 60 de zile înainte, cel mai devreme pentru a doua zi.

Dacă o parte din marfă stă în depozitul eMAG, regulile de stoc diferă; le găsiți în ghidul despre fbe emag.

Comenzile prin API: statusuri și reguli

Documentația folosește statusurile: 1 Nouă, 2 În procesare, 3 Pregătită, 4 Finalizată, 0 Anulată, 5 Returnată. Câteva reguli de reținut:

  • Confirmarea (acknowledge) este singura metodă de a trece o comandă în „în procesare" și oprește notificările pentru acea comandă.
  • Citirea întoarce implicit ultimele 100 de comenzi; puteți cere până la 1.000 sau folosi paginarea.
  • Editarea este posibilă doar în statusurile 2 și 3, iar prețurile produselor din comandă nu mai pot fi modificate.
  • O comandă anulată nu mai poate fi reactivată după 48 de ore.
  • Printre motivele de anulare din documentație, primul este „Out of stock": exact situația pe care o sincronizare corectă a stocului ar trebui să o evite.

Anulările și întârzierile nu sunt doar o problemă operațională: intră în indicatorii contului de care depinde buy button emag.

API, import .XLS sau feed?

API-ul nu este singura cale. Infocenter descrie și actualizarea ofertelor, prețurilor și stocurilor prin import .XLS, precum și publicarea produselor și actualizarea ofertelor prin feeduri. Pentru un catalog mic, care se schimbă rar, un fișier poate fi suficient. API-ul devine util când stocul se modifică des, când vindeți același produs pe mai multe canale sau când comenzile trebuie să ajungă automat în sistemul dumneavoastră.

Greșeli frecvente

  • Prețuri trimise cu TVA. API-ul așteaptă prețuri fără TVA.
  • Sincronizare la ore fixe. Toate sistemele care trimit la 12:00:00 se lovesc de aceleași limite; alegeți ore decalate.
  • Un singur utilizator pentru tot. Folosiți un utilizator dedicat API, nu contul personal.
  • Fără jurnal. Fără istoricul apelurilor, o eroare de stoc nu mai poate fi reconstituită.
  • Stoc actualizat doar pe un canal. Dacă eMAG primește stocul corect, dar Trendyol nu, anularea se mută doar pe celălalt marketplace.

Cum vă ajută Pratienda

Pratienda adună magazinele dumneavoastră de pe marketplace-uri într-un singur panou. Introduceți o singură dată datele API din conturile de vânzător, iar Pratienda recunoaște același produs pe fiecare marketplace după codul său (SKU) și îl reunește într-o singură fișă. Când vindeți un produs pe un marketplace, stocul scade și pe celelalte, comenzile vin într-o singură listă, cu statusul lor, iar întrebările clienților le vedeți pe un singur ecran. În pachetul Pro, repricing-ul propune prețuri noi fără să coboare sub prețul minim stabilit de dumneavoastră, iar niciun preț nu se schimbă fără aprobarea dumneavoastră.

Conexiunea cu eMAG și Trendyol România o configurăm împreună cu dumneavoastră. Starter costă 59 $ pe lună (fără TVA).

Descoperiți Pratienda →

Întrebări frecvente

Unde găsesc documentația API eMAG?
În Infocenter, la Listarea produselor » Importul produselor prin API / Feed » Documentație API. Potrivit eMAG, ultima versiune este v4.5.1, valabilă din 2 martie 2026; pagina documentației afișa la sfârșitul lui octombrie 2026 versiunea 4.5.2.

Există o cheie API eMAG?
Documentația descrie autentificarea Basic, cu numele de utilizator și parola unui utilizator care are drepturi API, codificate base64. În plus, apelurile sunt acceptate doar de pe IP-urile pe care le-ați transmis.

Câte cereri pot trimite către API-ul eMAG?
Pentru comenzi, 12 cereri pe secundă (720 pe minut); pentru celelalte resurse, 3 cereri pe secundă (180 pe minut), cumulat. Peste limită primiți HTTP 429, iar cererile invalide se numără și ele.

Surse: eMAG Marketplace, Infocenter, „Documentație API"; eMAG, documentația publică „eMAG & FD Marketplace API" (versiunea 4.5.2 la data consultării). Informații valabile la 29 octombrie 2026; eMAG își poate schimba documentația, limitele și condițiile.