2026-06-23 · 8 min de citit

Noua versiune a API-ului eMAG (v4.5.1) și de ce contează acum o integrare ERP↔eMAG solidă

Dacă vinzi pe eMAG și ții evidența reală în ERP, probabil ai simțit deja cum se schimbă regulile sub picioare. Versiunea curentă a API-ului eMAG Marketplace, v4.5.1, e mai strictă decât tot ce a fost înainte — și exact aici se vede diferența dintre o integrare făcută pe genunchi și una construită ca să reziste. Hai să-ți arăt ce s-a schimbat concret și de ce o legătură solidă ERP↔eMAG nu mai e un moft, ci infrastructură.

Ce s-a schimbat de fapt în v4.5.1

Nu e un redesign cosmetic. E o strângere de șuruburi pe toată suprafața API-ului, iar fiecare șurub e un loc unde o integrare neglijentă se poate rupe.

Format de cerere mai sever

Fiecare apel își împachetează acum payload-ul într-un envelope {"data":[...]}, iar răspunsul trebuie citit pentru isError:false înainte să-l consideri reușit. Validarea câmpurilor e mai strânsă decât în versiunile vechi. În practică: dacă trimiteai date „cam așa" și mergea, acum nu mai merge — eMAG respinge cererea, iar tu rămâi cu o ofertă nepublicată fără să-ți dai seama, dacă nimeni nu verifică răspunsul.

Oferte și prețuri

Publici o ofertă completă prin product_offer/save și faci actualizări ușoare de stoc/preț prin offer/save. Două detalii unde se împiedică toată lumea: prețurile se trimit fără TVA (ex-VAT), iar un preț minim și unul maxim de vânzare sunt obligatorii. Cotele de TVA le iei din vat/read. Dacă ERP-ul tău ține prețul cu TVA inclus — și majoritatea îl țin — cineva trebuie să scoată corect TVA-ul, de fiecare dată, fără greșeli de rotunjire. O eroare aici nu e o eroare tehnică, e bani pierduți sau un produs vândut sub cost.

Comenzi cu ceas care ticăie

Comenzile se citesc prin order/read, iar fiecare comandă nouă trebuie confirmată (order/acknowledge) ca eMAG să nu ți-o tot retrimită. Ai o fereastră limitată — în jur de 48 de ore — ca să procesezi o comandă. Dacă integrarea pică peste weekend și nu confirmă, comenzile se acumulează, se retrimit și riști să intri în întârziere pe propriul tău cont de seller.

Livrare și factură

La expediere, eMAG generează numărul AWB prin awb/save și finalizează comanda — nu tu inventezi tracking-ul, el vine de la eMAG. Factura deja emisă o atașezi prin order/attachments/save, ca PDF, după URL.

Limite și autentificare

eMAG impune un ritm: aproximativ 12 cereri/secundă pentru comenzi și 3/secundă pentru restul resurselor. Autentificarea e Basic, iar IP-ul serverului tău trebuie să fie pe lista albă. Dacă o integrare „dă din coate" și depășește limitele, eMAG o încetinește sau o blochează — și sincronizarea ta se oprește exact când ai mai mult trafic.

De ce contează acum o integrare solidă

Fiecare regulă de mai sus e un loc unde lucrurile se pot strica liniștit, fără zgomot, până când vezi o supravânzare sau o comandă neonorată. O integrare bună nu doar „vorbește" cu API-ul — îl tratează cu respectul cuvenit unui sistem strict. Asta facem cu MEGZO Vortex.

ERP-ul tău rămâne unica sursă. Vortex sincronizează în ambele sensuri: catalog, stoc și preț ies către eMAG, comenzile intră în ERP. Tu nu introduci nimic de două ori.
Protecție anti-supravânzare. Stocul se publică cu un buffer de siguranță, iar o reconciliere zilnică prinde orice abatere. Nu vinzi aceeași ultimă bucată de două ori.
Zero comenzi duplicate. Fiecare comandă eMAG devine exact un sales order în ERP — idempotent. O comandă retrimisă (vezi fereastra de 48h de mai sus) nu creează niciodată o a doua înregistrare.
Reîncercări care respectă regulile eMAG. Când un apel eșuază, Vortex reîncearcă cu backoff, ținând cont de limitele de 12/s și 3/s — nu forțează, nu se blochează. Ce tot nu reușește ajunge într-o dead-letter queue, cu alertă, și poate fi redat. Nimic nu se pierde în tăcere.
Baleieri zilnice de reconciliere. Comenzi, abateri de stoc și preț, comenzi orfane — toate verificate zilnic, nu „sperăm că s-a sincronizat".
AWB și factură, predate automat. Numărul AWB generat de eMAG și PDF-ul facturii se atașează comenzii fără intervenție manuală.

O precizare onestă, pentru că aici se nasc cele mai multe confuzii: noi nu generăm facturi fiscale. e-Factura/ANAF e un sistem separat, în afara noastră. Vortex doar atașează o factură pe care ERP-ul tău a produs-o deja. Atât — și exact atât.

Sub capotă, fiecare client e izolat de ceilalți, credențialele sunt criptate în repaus, iar fiecare sincronizare e urmărită cap la cap. Dacă ceva merge prost, se vede unde și de ce — nu rămâi pe întuneric.

ERP-uri românești pe care le conectăm la eMAG

Pe scurt

API-ul eMAG a devenit mai strict pentru un motiv bun — vrea date curate, prețuri corecte și comenzi confirmate la timp. Asta e o veste bună pentru cine are o integrare serioasă și o problemă pentru cine se bazează pe scripturi improvizate. Dacă vinzi pe eMAG și vrei ca ERP-ul tău și marketplace-ul să fie mereu pe aceeași pagină, fără supravânzări și fără introdus de două ori, spune-ne ce stack ai pe vortex.megzo.biz/start/ și îți arătăm sincronizarea rulând live.

← Blog