Engleza
Romana
Integrarea TecDoc cu eMAG Marketplace se face printr-un flux automat care preia datele din catalogul TecDoc (compatibilitate vehicul-piesa, coduri OE, imagini, atribute tehnice) si le transforma in feed-ul de produse cerut de API-ul eMAG Marketplace, cu mapare corecta de categorii si sincronizare periodica de stoc si preturi. Fara acest flux automatizat, un magazin cu cateva mii de piese ajunge sa actualizeze manual produsele pe eMAG, ceea ce genereaza intarzieri, discrepante de stoc si oferte respinse de validarea marketplace-ului.
Pentru magazinele auto care au deja un catalog TecDoc integrat, eMAG Marketplace este in mod firesc urmatorul canal de vanzare: volum mare de trafic, cautare dupa numar OE si compatibilitate auto deja asteptata de cumparatori. Provocarea reala nu e sa publici piese pe eMAG, ci sa mentii catalogul sincronizat automat, fara erori de compatibilitate si fara sa dubleze munca facuta deja pentru magazinul propriu.
Acest ghid explica arhitectura tehnica a sincronizarii TecDoc-eMAG, maparea de categorii si atribute, actualizarea de stoc si pret, erorile frecvente de validare si un plan practic de implementare.
Ce inseamna, tehnic, integrarea TecDoc cu eMAG Marketplace
TecDoc este catalogul de referinta pentru piese auto aftermarket, cu compatibilitate vehicul-piesa structurata pe tip de motor (K-Type), an de fabricatie si model. eMAG Marketplace este platforma prin care selleri terti isi listeaza produsele pe eMAG.ro, folosind un API propriu (Marketplace API) cu reguli stricte de format pentru fiecare categorie de produse, inclusiv pentru categoria Auto-Moto-Velo.
Integrarea celor doua sisteme nu inseamna o conexiune directa TecDoc-eMAG — nu exista un asemenea produs oficial. Inseamna construirea unui strat intermediar (de obicei in aplicatia Laravel/PHP a magazinului) care:
- preia datele de produs din baza locala alimentata de TecDoc (denumire, cod OE, imagini, atribute tehnice, compatibilitate);
- le transforma in formatul cerut de API-ul eMAG Marketplace (categorie, caracteristici, EAN, familie de produs);
- trimite periodic actualizari de stoc si pret catre eMAG, fara sa retrimita intregul catalog de fiecare data.
Practic, TecDoc ramane sursa de adevar pentru datele tehnice ale piesei, iar eMAG Marketplace devine un canal de distributie suplimentar al aceluiasi catalog, nu o baza de date separata intretinuta manual.
Arhitectura fluxului de sincronizare TecDoc-eMAG
Un flux de sincronizare stabil are, in mod tipic, patru componente separate, fiecare cu propriul job programat:
- Sincronizare produse (catalog) — ruleaza rar (zilnic sau la modificare), trimite produse noi si actualizeaza atribute/imagini/compatibilitate pentru produsele existente.
- Sincronizare stoc — ruleaza frecvent (la 15-60 de minute, in functie de volum), trimite doar cantitatea disponibila, fara restul datelor de produs.
- Sincronizare pret — separata de stoc, deoarece preturile se pot schimba dupa reguli diferite (campanii, marje, conversie valutara pentru piese importate).
- Preluare comenzi — sens invers: eMAG trimite comenzile plasate de clienti catre magazin, pentru procesare si expediere in termenul limita impus de marketplace.
Separarea acestor patru fluxuri este importanta pentru performanta: daca trimiti tot catalogul la fiecare actualizare de stoc, ajungi rapid la limitele de rate-limiting impuse de API-ul eMAG, mai ales pentru cataloage TecDoc cu zeci de mii de referinte.
Mapare categorii: de la structura TecDoc la taxonomia eMAG
Cea mai frecventa piedica tehnica nu este API-ul in sine, ci maparea de categorii. TecDoc organizeaza piesele pe grupe de produse standardizate (ex: placute de frana, filtre, amortizoare), in timp ce eMAG foloseste propria taxonomie de categorii Auto-Moto-Velo, cu caracteristici obligatorii diferite pentru fiecare categorie (ex: pentru placute de frana, eMAG poate cere obligatoriu numarul de omologare sau pozitia fata/spate).
Solutia practica este un tabel de mapare intretinut manual, nu generat automat: fiecare grupa de produse TecDoc este asociata o singura data cu id-ul categoriei eMAG corespunzatoare, iar atributele obligatorii ale categoriei eMAG sunt completate din campurile echivalente din TecDoc (sau marcate ca lipsa, pentru completare manuala inainte de publicare).
| Camp TecDoc | Camp eMAG Marketplace | Observatie |
|---|---|---|
| Cod OE / cod producator | part_number, part_number_key | Foloseste codul OE ca part_number_key pentru gruparea variantelor. |
| Grupa de produse (ex. filtre ulei) | category_id | Necesita tabel de mapare intretinut manual. |
| Compatibilitate vehicul (K-Type) | Caracteristica "Compatibilitate" (descriptiva) | eMAG nu are echivalent tehnic de K-Type; se transforma in text structurat. |
| Imagini produs | images (URL-uri publice) | Imaginile trebuie gazduite pe URL public accesibil de eMAG. |
| EAN (daca exista) | ean | Multe piese aftermarket nu au EAN — verifica politica eMAG pentru produse fara EAN. |
Cum tratezi compatibilitatea vehicul-piesa in feed-ul eMAG
eMAG Marketplace nu are un mecanism nativ echivalent cu logica de compatibilitate K-Type din TecDoc. In practica, magazinele rezolva acest lucru in doua moduri complementare:
- Text structurat in descriere si caracteristici — lista de marci/modele/ani compatibili, generata automat din datele TecDoc si inserata in descrierea produsului sau intr-o caracteristica dedicata, astfel incat cumparatorul sa poata verifica vizual potrivirea.
- Titlu de produs optimizat cu marca si model principal — pentru piese cu compatibilitate ingusta (ex: un singur model), titlul include direct marca si modelul, ceea ce ajuta si cautarea interna eMAG.
Pentru piese cu compatibilitate foarte larga (ex: un filtru de ulei compatibil cu zeci de modele), este recomandat sa limitezi lista afisata la principalele modele si sa mentionezi explicit ca lista completa este disponibila la cerere sau pe pagina magazinului propriu — descrierile eMAG au limite de lungime si supraincarcarea lor cu liste exhaustive afecteaza lizibilitatea.
Sincronizarea stocului si a pretului: reguli practice
Stocul si pretul sunt cele mai sensibile date din sincronizare, pentru ca o eroare aici duce direct la comenzi neonorabile sau la penalizari de performanta din partea eMAG. Cateva reguli practice:
- Trimite stocul la interval fix (ex: la 30 de minute), nu doar la modificare, pentru a evita desincronizari cauzate de erori temporare de retea.
- Rezerva o marja de siguranta (ex: stoc real minus 1-2 bucati) pentru piesele cu stoc limitat, ca sa eviti suprvanzarea in intervalul dintre doua sincronizari.
- Separa logica de pret de campaniile eMAG — pretul trimis prin API trebuie sa fie pretul de vanzare real, campaniile marketplace se configureaza separat, in contul de seller.
- Loghează fiecare raspuns de eroare primit de la API-ul eMAG (coduri de validare respinsa), nu doar succesul — erorile de validare la nivel de caracteristica obligatorie lipsa sunt cea mai frecventa cauza de produse respinse.
Erori frecvente la sincronizarea TecDoc-eMAG si cum le eviti
Riscurile tehnice cele mai intalnite la acest tip de integrare sunt previzibile si au, in general, o mitigare directa:
| Risc | Cauza tipica | Mitigare |
|---|---|---|
| Produse respinse la publicare | Caracteristici obligatorii lipsa pentru categoria eMAG | Validare locala a feed-ului inainte de trimitere, dupa tabelul de mapare categorii |
| Suprvanzare (stoc negativ) | Interval prea mare intre sincronizarile de stoc | Reducerea intervalului si marja de siguranta pe stoc |
| Rate-limiting / blocare temporara API | Trimiterea intregului catalog la fiecare actualizare | Separarea fluxurilor de produs, stoc si pret, cu joburi distincte |
| Compatibilitate afisata gresit | Mapare incompleta intre K-Type TecDoc si text descriptiv eMAG | Revizuire manuala periodica a listelor de compatibilitate generate automat |
| Imagini neincarcate | URL de imagine invalid sau gazduit pe un domeniu inaccesibil public | Verificare automata a URL-urilor de imagine inainte de trimitere in feed |
Plan practic de implementare (etape)
Pentru un magazin care are deja catalogul TecDoc integrat local, un plan realist de implementare a sincronizarii cu eMAG Marketplace arata astfel:
- Saptamana 1 — mapare si cont seller. Deschide contul de seller eMAG Marketplace, obtine acces API, construieste tabelul de mapare categorii TecDoc-eMAG pentru grupele de produse principale.
- Saptamana 2 — feed de produse. Construieste jobul care genereaza si trimite feed-ul initial de produse, cu validare locala a caracteristicilor obligatorii inainte de trimitere.
- Saptamana 3 — stoc si pret. Implementeaza joburile separate de sincronizare stoc si pret, cu logging de erori si alertare la esec repetat.
- Saptamana 4 — preluare comenzi si testare. Conecteaza fluxul invers (preluare comenzi eMAG in sistemul intern) si testeaza pe un subset restrans de produse inainte de publicarea intregului catalog.
Publicarea graduala, pe un subset de categorii, este preferabila publicarii integrale dintr-o data — permite identificarea rapida a problemelor de mapare fara sa afecteze performanta contului de seller pe intregul catalog.
Cand merita sa investesti in aceasta integrare
Sincronizarea automata TecDoc-eMAG are sens clar pentru magazine cu catalog TecDoc de peste cateva sute de referinte si actualizari frecvente de stoc. Pentru cataloage foarte mici (sub 100 de produse), cu miscare rara de stoc, actualizarea manuala directa in contul de seller poate ramane suficienta pe termen scurt, iar investitia intr-un flux automat se justifica atunci cand volumul de produse sau frecventa modificarilor face intretinerea manuala nesustenabila.
Intrebari frecvente despre integrarea TecDoc-eMAG
Exista o integrare oficiala directa intre TecDoc si eMAG Marketplace?
Nu. TecAlliance (TecDoc) si eMAG sunt platforme independente, fara un conector oficial comun. Sincronizarea se construieste ca strat intermediar propriu, in aplicatia magazinului, care preia date din TecDoc si le trimite prin API-ul Marketplace al eMAG.
Cat de des trebuie sincronizat stocul catre eMAG?
Depinde de volumul de vanzari, dar un interval de 15-30 de minute este un punct de plecare rezonabil pentru majoritatea magazinelor de piese auto, cu ajustare in functie de viteza reala de vanzare si de politica eMAG privind penalizarile pentru comenzi neonorate.
Cum se trateaza piesele fara cod EAN in feed-ul eMAG?
Multe piese aftermarket nu au EAN alocat de producator. eMAG permite, in anumite conditii, publicarea fara EAN, dar politica exacta trebuie verificata direct in documentatia curenta a API-ului Marketplace, pentru ca regulile se pot schimba pe categorie.
Ce se intampla daca structura de categorii eMAG se schimba?
Tabelul de mapare categorii TecDoc-eMAG trebuie revizuit periodic (recomandat trimestrial), pentru ca eMAG isi poate actualiza taxonomia sau caracteristicile obligatorii ale unei categorii, iar o mapare invechita duce direct la respingerea produselor la publicare.
Se poate automatiza si preluarea comenzilor din eMAG?
Da — fluxul invers, de preluare a comenzilor plasate pe eMAG in sistemul intern al magazinului, este parte standard a unei integrari complete si reduce riscul de a rata termenul limita de expediere impus de marketplace.
Concluzie
Integrarea TecDoc cu eMAG Marketplace transforma un catalog auto deja structurat intr-un canal suplimentar de vanzare, fara munca dubla de introducere manuala a produselor. Cheia unei sincronizari stabile este separarea fluxurilor (produs, stoc, pret, comenzi), un tabel de mapare categorii intretinut activ si validarea locala a feed-ului inainte de trimitere, pentru a evita respingerile si penalizarile de performanta pe contul de seller.
Vrei sa iti sincronizezi automat catalogul TecDoc cu eMAG Marketplace? Contacteaza-ne pentru o consultatie tehnica.
Construim aplicatii Laravel cu integrare TecDoc si conectori catre marketplace-uri. Vezi portofoliul nostru.
Scrie un comentariu