Sincronizarea cu eMag
Produsele create in BrandSync pot fi sincronizate catre eMag Marketplace apasand butonul "Sincronizeaza in eMag".
BrandSync suporta 3 platforme eMag: eMAG Romania (RO), eMAG Hungary (HU) si eMAG Bulgaria (BG). Fiecare platforma este un cont separat de vanzator, cu configuratie proprie (credentiale, TVA, garantie, depozit).
Concepte specifice eMag
Produse si Oferte
Pe eMag, un produs (documentatie) si o oferta (pret, stoc, status) sunt concepte separate:
- Documentatia = numele, descrierea, imaginile, caracteristicile produsului
- Oferta = pretul, stocul, statusul, termenul de livrare
Cand listati un produs pe eMag, trimiteti atat documentatia cat si oferta. Dar daca produsul exista deja pe eMag (creat de alt seller), puteti doar adauga o oferta, nu puteti modifica documentatia.
Ownership (Dreptul de editare)
| Ownership | Ce inseamna | Ce puteti face |
|---|---|---|
| Eligible for content | Produsul a fost creat de voi pe eMag | Puteti actualiza totul: nume, descriere, imagini, caracteristici, pret, status |
| Not eligible (offer only) | Produsul exista deja pe eMag | Puteti actualiza doar oferta: pret, status, termen de livrare |
Ownership-ul se seteaza automat la prima sincronizare.
EAN ca identificator
eMag identifica produsele dupa codul EAN. Cand sincronizati un produs:
- Sistemul cauta EAN-ul pe eMag
- Daca il gaseste → produsul exista deja → se ataseaza doar oferta (ownership = Not eligible)
- Daca nu il gaseste → se creeaza produs nou (ownership = Eligible for content)
Produse simple pe eMag
Toate produsele din BrandSync sunt sincronizate ca produse simple pe eMag:
- Un Produs Simplu → 1 produs eMag
- Un Produs cu Variante → fiecare varianta devine un produs eMag separat
Configurarea canalelor de vanzare eMag
Pe Brand
La fel ca pentru Shopify, platformele eMag se configureaza pe Brand ca defaults:
- Deschideti formularul Brand-ului
- In sectiunea Canale de vanzare, gasiti grila Platforme eMag
- Adaugati platformele eMag pe care brandul va fi vandut (ex: eMAG Romania, eMAG Hungary)
Cand creati un produs nou sau o varianta noua, platformele eMag se copiaza automat de pe Brand.
Pe Produs / Varianta
- Produse Simplu: platformele eMag sunt in grila Canale de vanzare de pe formularul produsului
- Produse cu Variante: platformele sunt pe fiecare varianta individual
Puteti adauga sau sterge platforme pe fiecare produs/varianta — la fel ca site-urile Shopify.
Categoria eMag
Fiecare produs trebuie sa aiba o Categorie eMag selectata. Aceasta determina:
- In ce categorie va fi listat produsul pe eMag
- Ce caracteristici obligatorii trebuie completate (vezi mai jos)
Categoriile eMag sunt importate din API-ul eMag si sunt disponibile pe formularul produsului.
IMPORTANT
Fara categorie eMag selectata, produsul nu poate fi sincronizat cu eMag.
Caracteristici eMag (Atribute obligatorii)
Ce sunt caracteristicile
Fiecare categorie eMag are un set de caracteristici (atribute) — unele obligatorii, altele optionale. De exemplu:
| Categorie | Caracteristici obligatorii tipice |
|---|---|
| Vopsea de par | Culoare, Volum, Tip par |
| Sampon | Volum, Tip par, Tip piele |
| Parfum | Volum, Gen (Barbati/Femei/Unisex), Tip parfum |
| Fond de ten | Nuanta, Tip piele, SPF |
Completarea caracteristicilor
Caracteristicile se gestioneaza prin componenta Caracteristici eMag de pe formularul produsului:
- Selectati Categoria eMag pe produs
- Componenta afiseaza automat toate caracteristicile disponibile pentru acea categorie
- Completati valorile pentru cel putin caracteristicile obligatorii (marcate cu rosu)
- Optional: completati si caracteristicile optionale pentru o listare mai buna
LIMITARE: Valorile se completeaza doar in Romana
Caracteristicile se completeaza exclusiv in limba Romana, indiferent de platforma eMag pe care va fi listat produsul (RO, HU sau BG). Dropdownurile afiseaza doar valori in Romana, chiar si pentru utilizatorii BrandSync cu limba Maghiara.
De ce aceasta limitare? Fiecare platforma eMag are propria lista de valori permise, in ordine si format diferit. Nu exista o modalitate automata de a mapa o valoare dintr-o limba in alta la nivel de BrandSync.
Cum sunt trimise caracteristicile catre eMag?
- eMAG Romania → se trimit valorile completate in BrandSync (in Romana)
- eMAG Hungary / Bulgaria → se trimite o lista goala
[], pentru a NU suprascrie valorile existente deja pe eMag HU/BG. Caracteristicile pe aceste platforme trebuie completate direct in interfata eMag sau prin traducerea automata initiala (vezi sectiunea Traduceri).
Reguli de mapare automata
Administratorii pot configura reguli de mapare pe fiecare categorie eMag. Aceste reguli completeaza automat anumite caracteristici:
| Tip regula | Exemplu |
|---|---|
| Valoare fixa | Stare = "Nou" (pentru toate produsele din categorie) |
| Copiere din camp | Volum ← Gramaj produs (din BrandSync) |
| Copiere din metadate | Brand ← Numele brandului |
Regulile se aplica automat cand selectati o categorie eMag. Puteti suprascrie manual orice valoare completata de reguli.
NOTA
Valorile setate manual (sursa = "Manual") sau importate din eMag (sursa = "eMag Import") nu sunt suprascrise de reguli. Doar valorile cu sursa "Rule" sunt recalculate la re-aplicare.
Preturi eMag
Pretul de vanzare
eMag foloseste preturi NET (fara TVA). Pretul trimis catre eMag este Pret fara TVA din inregistrarea de pret corespunzatoare platformei eMag.
Preturi minime si maxime
eMag cere obligatoriu la prima listare:
- Pret minim — pretul minim la care puteti vinde
- Pret maxim — pretul maxim
Aceste campuri sunt pe inregistrarea de pret eMag si trebuie completate inainte de sincronizare.
GPSR (General Product Safety Regulation)
eMag cere informatii GPSR obligatorii:
- Producator — numele, adresa si email-ul producatorului
- Persoana Responsabila UE — numele, adresa si email-ul
Aceste informatii se configureaza pe Brand (tab-ul GPSR) si sunt trimise automat la sincronizare.
Campuri obligatorii — Verificarea automata
Inainte de sincronizare, sistemul verifica automat toate campurile necesare. Daca lipseste ceva, apare un mesaj cu lista detaliata.
Campuri obligatorii — Produs
| Camp | Detalii |
|---|---|
| Brand | Brandul trebuie selectat |
| Categorie eMag | Categoria eMag trebuie selectata |
| Cod EAN | Cel putin un cod EAN activ, marcat ca implicit |
| Platforme eMag | Produsul (Simplu) sau variantele trebuie sa aiba platforme eMag asociate |
| Denumire Shopify | O denumire in limba platformei eMag (ex: Romana pentru eMAG RO) |
| Pret eMag | Pret (NET) + pret minim + pret maxim pentru fiecare platforma eMag |
| Caracteristici obligatorii | Toate caracteristicile obligatorii ale categoriei trebuie completate |
| GPSR | Brand-ul trebuie sa aiba informatii GPSR (Producator + Persoana Responsabila UE) |
Campuri obligatorii suplimentare — Produs cu Variante
| Camp pe varianta | Detalii |
|---|---|
| Cod EAN | Fiecare varianta trebuie sa aiba un cod EAN propriu |
| Pret eMag | Pret per platforma eMag per varianta |
| Caracteristici | Caracteristicile specifice variantei (ex: Culoare) |
Procesul de sincronizare
- Deschideti produsul
- Verificati ca toate campurile obligatorii sunt completate
- Apasati "Sincronizeaza in eMag"
- Sistemul verifica campurile automat
- Daca totul este corect, produsul este sincronizat catre fiecare platforma eMag asociata
- Primiti o notificare cu rezultatul (succes sau eroare)
Ce se intampla per platforma
Pentru fiecare platforma eMag asociata produsului:
Exista junctiune eMag Produs?
├─ DA (sincronizat anterior):
│ ├─ Ownership = Eligible SI exista traducere in limba platformei
│ │ → Actualizare completa (documentatie + oferta)
│ ├─ Ownership = Eligible DAR fara traducere in limba platformei
│ │ → Actualizare doar oferta (fallback)
│ └─ Ownership = Not eligible → Actualizare doar oferta (pret, status)
│
└─ NU (prima sincronizare):
├─ EAN gasit pe eMag → Atasare oferta (ownership = Not eligible)
└─ EAN negasit → Creare produs nou (ownership = Eligible)Actualizare completa (Eligible for content)
Cand detineti ownership-ul si exista o traducere in limba platformei, se actualizeaza:
- Numele si descrierea (din Denumirea Shopify in limba platformei)
- Imaginile produsului (din Shopify CDN)
- Caracteristicile eMag (doar pe RO; pe HU/BG se trimite lista goala ca sa nu suprascrie valorile existente)
- Pretul, termenul de livrare, garantia
- Informatiile GPSR (producator, persoana responsabila UE)
part_number= Codul Intern al produsului/variantei (nu EAN-ul)
NOTA — Stoc
Stocul nu este gestionat prin BrandSync. Stocul real este in ERP-ul BOrg, nu in BrandSync. Sincronizarea catre eMag trimite intotdeauna stoc = 0. Ajustarea stocului pe eMag se face pe alte canale.
Actualizare oferta (Not eligible sau fara traducere)
Cand nu detineti ownership-ul, sau cand aveti ownership dar lipseste traducerea in limba platformei, se actualizeaza doar:
- Pretul de vanzare (NET) + pret minim/maxim
- Statusul ofertei
- Termenul de livrare
- Garantia + TVA
Documentatia (nume, descriere, imagini, caracteristici) nu este trimisa in acest caz — eMag pastreaza ce are deja.
Junctiunea eMag Produs
Pentru fiecare combinatie produs/varianta + platforma eMag, se creeaza automat o inregistrare eMag Produs la prima sincronizare. Aceasta stocheaza:
| Camp | Descriere |
|---|---|
| Part Number Key | Identificatorul unic al produsului pe eMag (PNK) |
| Seller ID | Identificatorul intern al ofertei pe eMag (returnat de eMag) |
| Ownership | Eligible for content / Not eligible |
| Offer Status | Active / Inactive / End of Life |
| Validation Status | Statusul validarii eMag |
Aceasta junctiune este creata automat — nu trebuie sa o creati manual.
Imagini
Imaginile sunt preluate din Shopify CDN (URL-urile publice generate la sincronizarea cu Shopify).
- Imaginea marcata ca principala in BrandSync →
display_type: 1(imagine principala pe eMag) - Celelalte imagini →
display_type: 0(imagini secundare)
PREREQUISIT
Produsul trebuie sa fie mai intai sincronizat cu Shopify pentru ca imaginile sa aiba URL-uri publice. eMag nu poate descarca imagini din Dataverse (necesita autentificare).
La actualizarea unui produs pe care il detineti (Eligible), imaginile sunt inlocuite complet cu cele din BrandSync (images_overwrite: 1).
Denumiri si Descrieri (Traduceri)
eMag afiseaza produsele in limba platformei:
- eMAG Romania → denumire si descriere in Romana
- eMAG Hungary → denumire si descriere in Maghiara
- eMAG Bulgaria → denumire si descriere in Bulgara
Sistemul foloseste Denumirile Shopify existente — aceeasi tabela de traduceri. Denumirea si descrierea sunt selectate automat in functia de limba configurata pe platforma eMag.
Daca nu exista traducere
Daca produsul nu are o traducere in limba platformei eMag (ex: HU lipseste iar produsul este listat pe eMAG HU), sincronizarea nu esueaza — sistemul trimite doar actualizarea ofertei (pret, status). Documentatia existenta pe eMag ramane neatinsa.
Pentru actualizare completa a documentatiei pe HU/BG, trebuie sa creati o Denumire Shopify in limba respectiva (din tab-ul Denumiri Shopify al produsului).
Traducere automata eMag (doar la creare)
Pentru produse noi (care nu exista inca pe catalogul eMag), cand sunt create prin BrandSync eMag poate traduce automat continutul in limba platformei daca primeste parametrul source_language. Aceasta traducere automata se aplica DOAR la crearea produsului, nu si la actualizarile ulterioare.
Dupa ce produsul exista pe eMag, orice actualizare a documentatiei trebuie trimisa deja in limba platformei — de aceea este importanta completarea Denumirilor Shopify in toate limbile.
Statusul sincronizarii
Pe formularul produsului, in tab-ul Sync Status, puteti vedea:
| Camp | Descriere |
|---|---|
| eMag Sync Status | Not Synced / Syncing / Synced / Failed |
| eMag Last Synced On | Data si ora ultimei sincronizari |
| eMag Sync Error | Mesajul de eroare (daca a esuat) |
Notificari
Dupa fiecare sincronizare, primiti o notificare in aplicatie:
| Tip | Mesaj |
|---|---|
| Succes | {Cod Intern} - sincronizat cu succes in eMag |
| Eroare | {Cod Intern} - sincronizare esuata. {detalii eroare} |
Probleme frecvente
| Problema | Solutie |
|---|---|
| Eroare: campuri lipsa | Cititi mesajul de eroare — specifica ce lipseste. Completati si incercati din nou. |
| "Categorie eMag neselectata" | Selectati o categorie eMag pe produs (lookup) |
| "Caracteristici obligatorii lipsa" | Completati toate caracteristicile obligatorii din componenta Caracteristici eMag |
| "Pret minim/maxim lipsa" | Completati Pret Minim si Pret Maxim pe pretul eMag |
| "GPSR lipsa" | Completati informatiile GPSR pe Brand (tab-ul GPSR) |
| "EAN lipsa" | Adaugati un cod EAN marcat ca implicit pe produs/varianta |
| Imaginile nu apar pe eMag | Sincronizati mai intai cu Shopify pentru a genera URL-uri publice |
| Ownership = Not eligible | Produsul exista deja pe eMag (creat de alt seller). Puteti actualiza doar oferta. |
| Nu pot modifica documentatia pe HU/BG | Verificati: (1) ownership-ul — daca este "Not eligible", alt seller detine documentatia; (2) aveti Denumire Shopify in limba platformei (HU/BG)? Fara traducere, doar oferta se actualizeaza. |
| Pret respins de eMag | Verificati ca pretul este in intervalul min/max configurat |
| Stoc 0 pe eMag | Normal — BrandSync nu gestioneaza stocul; stocul se ajusteaza separat |