Modul eMAG Marketplace
🔹

eMAG Marketplace

Integrarea cu platforma eMAG

Pentru a integra magazinul dvs. cu platforma eMAG, este necesar să utilizați două module: Marketplace și Job Queue. Aceste module sunt scopul de a facilita procesul de integrare și sincronizare a datelor între magazinul dvs. și platforma lor.


Configurare conector eMAG

Pentru a configura conectorul eMAG se accesează modulul Marketplace – se apasă butonul Creează:


Se completează datele în următoarele câmpuri:

  1. Se bifează câmpul Active;
  2. Provider: Se selectează eMag;
  3. Frontend URL;
  4. Sales Team: Echipa de vânzări – Echipa Vânzări eMag;
  5. User: Emag sau oricare alt agent de vânzări;
  6. Tax;
  7. Sales Team: Echipa de vânzări – Echipa Vânzări eMag;
  8. Confirm Sale Order: Comenzile intră în Odoo sub formă de comenzi de vânzare.  


Pentru a configura conectorul eMAG, trebuie să realizați setările pentru următoarele aspecte:

  • Obiecte (en Objects);
  • Credențiale (en Credentials);
  • Preț (en Price);
  • Alte Informații (en Other Info).

Objects

Objects reprezintă obiectele cu care se face integrarea cu platforma Emag sau oricare altă platformă.

Adăugarea unui obiect

Pentru a adăuga un obiect nou : Editare eMag - Objects – Adaugă:


Se va deschide o fereastră Creează Item, de unde se vor alege următoarele:

​a)  Item type : se alege itemul dorit pentru integrare (Products, Product Template, Customers, Taxes, etc.)


​b)  Web Hook Link – acest link trebuie setat în platforma eMAG. Platorma eMAG apelează la această adresă pentru a vă notifica site-ul web cu privire la noile comenzi plasate. Web Hook Link trebuie setat pentru Sale Order.

Atenție!!! Dacă nu este setat Web Hook Link, nu puteți primi și importa comenzile noi de la eMAG. Însă, sistemul va rula periodic comenzile care nu au fost preluate prin Web Hook Link .

 

​c)  Ignore Field – dacă se dorește ignorarea anumitor câmpuri în maparea obiectelor se completează cu cele nedorite (ex. Referința internă).


Se vor adăuga credențialele în următoarele câmpuri:

  1. Location – adresa de conexiune;
  2. Access Type:  User and password;
  3. Username: adresa de logare pentru accesarea sistemului;
  4. Password: parola de logare pentru accesarea sistemului;
  5. Security Token;
  6. Token de acces.

ATENȚIE!! Trebuie făcută o setare la nivel de eMAG în care să-i permită IP-ului sistemului Odoo să facă interogări.


Price

În secțiunea Price se vor seta:

  1. Pricelist: Lista de prețuri configurată pentru eMAG;
  2. Currency: Moneda magazinului;
  3. Price Per Product – se bifează – fiecare produs are un preț în lista de prețuri;
  4. Ignore Price – se bifează – comanda din eMAG vine cu un preț, iar acest preț nu actualizează prețul de listă al produsului. Nu afectează înregistrările din Odoo.

Other Info

În secțiunea Other Info se vor completa câmpurile:

Setări (en Settings)

  • Enable Order Push Invoice:  Trimite factura către eMag atunci când factura este postată. În mod obișnuit, aceasta ar trebui să fie dezactivată în modul de testare.
  • Mapping Product Code: Maparea produselor după Part Number. 
  • Notă!!  Part Number Key este codul unic al produsului pe care îl regăsești de obicei in ultimele 9 caractere, cu majuscule, în URL.
  • Safe Stock: Stoc de siguranță;
  • Carrier - metoda de transport - se alege/ se creează curierul eMag;

Limitări (en Limits)

  • Items Per Page - reprezintă numărul de produse trimise către eMAG la fiecare rulare;
  • Sale Order Days;
  • Purchase Order Days.

Produse (Products)

  • Use Category – utilizarea categoriilor din eMAG. Această bifă are legatură cu transmiterea produselor din Odoo în eMag;
  • Use Public Category;
  • Use Attribute – utilizarea atributelor;
  • Use Variants – utilizarea variantelor de produse;
  • Ignore Image – se poate ignora aducerea imaginilor din eMAG în sistemul Odoo;

Stoc (en Stock)

  • Can send stock- sistemul poate să trimită stocul din sistemul Odoo în platforma eMAG. Dacă se bifează această căsuță și se face transfer/ miscare/ rezervare de stoc, în mod automat se trimite un update al stocului către eMAG.
  • Stock Available
  • Location Stock - locația din Odoo de unde se va transmite stocul.
  • Include Vendor Stock - în transmiterea stocului să fie inclus stocul de la furnizor.

 

Limbă ( en Language)

  • Language - se alege limba pentru afișare în magazin; Dacă este configurat eMag HU și eMag BG, trebuie aleasă limba fiecărui conector.

Order and Payment

  • Sales Team - Se selectează echipa de vânzări aferentă conectorului ( eMag RO, eMag HU sau eMag BG)
  • Confirm Sale Order - Această opțiune permite confirmarea automată a comenzilor în Odoo după import. Se bifează pentru a confirma comenzile în mod automat în sistemul Odoo.
  • SO Prefix  - Această opțiune permite completarea prefixului comenzilor (numai dacă este necesar)
  • Disable Import Sale Order - Bifarea câmpului permite ca să se dezactiveze intrarea comenzilor din conector.



Setări implicite (en  Defaults)

  • Default category – categoria implicită a produselor (categoria de produse din Odoo)
  • Default marketplace category;
  • Discount Product.

Queue

  • Inbound Channel;
  • Outbound Channel. 


Atentie!! Va trebui mapată fiecare metodă de plată eMAG cu metoda de plată din sistemul Odoo corespunzătoare. 

Configurare Obiecte (en Objects)

Pentru a realiza integrarea cu platforma eMAG, trebuie definite următoarele obiecte :

  1. Products – Produse – publicarea produselor în platforma eMAG;
  2. Customers  - Clienți;
  3. Sales Order – Oferte de vânzare – preluarea comenzilor de pe platforma eMAG, împreună cu datele clientului și a detaliilor din comandă;
  4. Stock – Stocul – trimiterea stocului dintr-un punct de lucru/ depozit;
  5. Delivery Carrier - metodele de livrare ;
  6. Payment Acquirer.


După crearea obiectelor pentru integrare, sistemul va aduce automat butonul de Import   sau Export   . Aceste butoane sunt aduse în funcție de metodele definite în sistem.

Excepție!! Customers nu are buton de Import/ Export deoarece datele sunt aduse în mod automat prin Sales Order.

Opțiuni Obiecte

  • Edit -  Această opțiune facilitează modificarea obiectelor (de exemplu, completarea sau ignorarea anumitor câmpuri);
  • Defaults
  • Import All -  Această opțiune permite importul întregii game de produse/comenzi de vânzare de pe platforma eMag. Este recomandată utilizarea acestei opțiuni la prima conectare;
  • Import Missing - Această opțiune facilitează importul produselor/comenzilor de vânzare care lipsesc din Odoo.  


Credentials

Maparea Obiectelor

Integrarea cu platforma eMAG nu afectează datele din back-end-ul sistemului Odoo, cum ar fi produsele, comenzile sau clienții. Modulul de integrare realizează o mapare a acestor obiecte, astfel încât fiecare obiect are o corespondență sau o asociere specifică între Odoo și platforma eMAG.

Maparea Comenzilor se face între Odoo Sales Order și External ID:

Maparea Clienților se face între Odoo Customers și External ID:

Maparea Produselor se face între Odoo Product și External ID:

Maparea Procesatorilor de plăți se face dintre Odoo Acquirer și Marketplace NameNotă!!! Confirmarea plății este la nivel de fiecare procesator de plată


Descrierea Produsului

  1. Name – numele produsului în platforma eMAG;
  2. Odoo Product – se alege produsul din sistemul Odoo;
  3. Binder Name;
  4. Marketplace Banckend – EMAG;
  5. Stock in Syncș;
  6. External ID;
  7. PNK - Part Number Key este utilizat pentru a asocia un produs Odoo cu un produs eMAG existent (cod în marketplace);
  8. Part Number;
  9. Sales Price - Nu se transmit toate datele din sistemul Odoo în platforma Emag, se transmite doar un Update pe preț.
  10. Cost;
  11. Auto Price;
  12. Buy Button Rank;
  13. Min. Sale Price și Max. Sale Price - Reprezintă limitele prețului oferit;
  14. Recommended Price;
  15. Best Offer Sales Price;
  16. Best Offer;
  17. Recommended Price;
  18. Emag Active și Emag Stock;
  19. Emag Link.


Indicații Produs

Prețul poate fi adus din platforma eMAG în sistemul Odoo prin apăsarea butonul Get price:Dacă se dorește setarea unui preț - se va apăsa butonul Editare, se modifică prețul dorit în câmpul Sale Price și se va apăsa pe butonul

Auto Price – se permite bifarea câmpului pentru a se calcula prețul optim de vânzare.

Buy Button Rank – cuprinde valori între 0 și 6 , în funcție de Buy Button Rank, produsul este afișat primul în platforma eMAG.

Dacă Buy Button Rank este 1 și este pusă bifa de Auto Price, la apăsarea butonului Set Price, prețul va face să crească cu jumătatea dintre prețul maxim și prețul de vânzare. După apăsarea butonului Set Price, Buy Button Rank devine 0, astfel trebuie apăsat butonul Get price pentru a obține din eMAg noua valoare al Buy Button Rank.

Dacă Buy Button Rank este diferit de 1, se va apăsa butonul Set price, prețul va face să scăda cu un sfert dintre prețul maxim și prețul de vânzare, astfel trebuie apăsat butonul Get price pentru a obține din eMAg noua valoare al Buy Button Rank.

Notă!! Trebuie interogat de mai multe ori, deoarece durează până sunt actualizate datele de pe serverele de la eMAG și aducerea acestora în Odoo. 

Butonul Reimport

Pentru readucerea datelor a unui produs se va apăsa butonul Reimport. Acest buton aduce toate datele produsului din platforma Emag.

Notă!! Se poate seta ca la un interval de câteva ore ore datele să fie actualizate.

Configurare Transport eMAG

Pentru configurarea Metodei de livrare pentru platforma eMAG: Vânzări – ConfigurareMetode de expediere - Creează:

Pentru configurarea metodei de livrare Transport eMAG se va selecta:

  • Furnizor: se selecteaza eMag;
  • Calcul preț: se selectează eMAG;
  • Nivel de integrare : obține preț;
  • Companie;
  • Pagina Web;
  • Moneda: RON;
  • Dimensiuni la colete -  Aceste câmpuri pot fi utilizate pentru a specifica dimensiunile fizice ale coletelor asociate cu livrările efectuate prin integrare;
  • Valoarea asigurată fixă - Se referă la o valoare fixă asigurată pentru coletele livrate;
  • EasyBox - Acest câmp indică dacă livrările sunt gestionate prin serviciul EasyBox al eMAG;
  • Livrare Produs: se creează produsul Livrare eMag ( produs de tip Service);
  • Marjă pe tarif -  Specifică o marjă adăugată la tarifele de livrare calculate în cadrul integrării;
  • Gratuit dacă valoarea comenzii este mai mare - Indică faptul că costurile de livrare sunt gratuite dacă valoarea comenzii depășește anumite limite;
  • Limite greutate - Acestea sunt limitele de greutate aplicabile pentru livrările gestionate prin integrare;
  • Serviciu sâmbătă - Indică dacă serviciul de livrare include opțiunea de livrare în zilele de sâmbătă;
  • Preț de sâmbătă - Specifică prețul suplimentar pentru serviciul de livrare în zilele de sâmbătă;
  • Preț fix - Se referă la un preț fix aplicat pentru livrările prin intermediul integrării, indiferent de alte variabile precum greutatea sau distanța.


În secțiune eMAG Configuration se vor completa câmpurile Emag Label Format (ex. A6), Partener Companie, Locație ridicare și Plată ramburs.


În secțiunea Pickup Location se vor completa câmpurile Sursa locației de ridicare: Din curier și Locație ridicare: Depozit.


După configurarea metodei de livrare se va apăsa butonul Salvează și butonul Inițializare:


După inițializare se aduc datele de servicii și locațiile, astfel încât se va face maparea localităților din sistemul Odoo și platforma eMag.

ATENȚIE!!! După configurarea metodei de livrare pentru eMAG, aceasta trebuie arhivată.

JOB QUEUE

Job Queue (Coadă de mesaje) este necesar pentru procesarea tuturor mesajelor printr-o coadă, astfel sistemul Odoo nu se blochează în momentul când se doreste transmiterea sau primirea datelor dintr-o aplicație externă, cum este platforma Emag. Toate procesele nu se fac în timp real.

  • marketplace.backend.job_export_stock_for_item  - export de stoc;
  • marketplace.backend.emag_import_sale_order_by_values – importul unei comenzi după valori acesteia – aici sunt aduse toate datele ce ține de o comanda ( nume client, număr telefon, produs, preț produs, taxă, metoda de plată etc);
  • marketplace.backend.emag_import_order_by_id – importul unei comenzi după ID-ul acesteia.

Toate aceste Job-uri sunt puse într-o coadă ca sistemul Odoo să înceapă procesarea lor. Datorită acestui modul, sistemul Odoo nu va deveni un sistem greoi. Tot aici sunt semnalate prin erori și problemele apărute la transmiterea comenzilor din Emag