EMAG Marketplace Connector
by Terrabit https://www.terrabit.ro , Dorin Hongu https://www.terrabit.ro$ 2313.08
Availability |
Odoo Online
Odoo.sh
On Premise
|
Odoo Apps Dependencies |
•
Sales (sale_management)
• Discuss (mail) • Invoicing (account) • Inventory (stock) • eCommerce (website_sale) • Website (website) |
Community Apps Dependencies | Show |
Lines of code | 11290 |
Technical Name |
deltatech_marketplace_emag |
License | OPL-1 |
Website | https://www.terrabit.ro |
Versions | 15.0 16.0 17.0 |
Availability |
Odoo Online
Odoo.sh
On Premise
|
Odoo Apps Dependencies |
•
Sales (sale_management)
• Discuss (mail) • Invoicing (account) • Inventory (stock) • eCommerce (website_sale) • Website (website) |
Community Apps Dependencies | Show |
Lines of code | 11290 |
Technical Name |
deltatech_marketplace_emag |
License | OPL-1 |
Website | https://www.terrabit.ro |
Versions | 15.0 16.0 17.0 |
EMAG Marketplace Connector
Features:
Table of contents
Bug Tracker
Bugs are tracked on Terrabit Issues. In case of trouble, please check there if your issue has already been reported.
Do not contact contributors directly about support or help with technical issues.
Credits
Authors
- Terrabit
- Dorin Hongu
Maintainers
Current maintainer:
This module is part of the terrabit-ro/bitshop project on GitHub.
You are welcome to contribute.
eMAG Marketplace
Manual de utilizare v. 14.0.0.0
Cuprins
Integrarea cu platforma eMAG
I. Crearea conectorului Emag............................................................................................................3
I.1.Objects.....................................................................................................................................4
I.1.1. Adăugarea unui obiect.........................................................................................................4
I.2. Credentials..............................................................................................................................5
I.3. Price........................................................................................................................................6
I.4. Other Info...............................................................................................................................6
II. Integrarea cu platforma eMAG.....................................................................................................7
II.1. Maparea Obiectelor..............................................................................................................7
II.2. Descrierea Produsului ..........................................................................................................8
III. Job Queue..................................................................................................................................10
IV. Configurare Transport eMAG....................................................................................................11
Integrarea cu platforma eMAG
Pentru a face integrarea cu platforma eMAG sunt necesare două module Marketplace și Job Queue. Conectorul eMAG Marketplace vă ajută să integrați magazinul dvs. cu platforma eMAG.
I. Crearea conectorului eMAG
Pentru configurarea conectorului eMAG se accesează modulul Marketplace – se apasă butonul Creează:
Se completează datele în următoarele câmpuri:
- Se bifează câmpul Active;
- Provider: Se selectează Emag;
- Sales Team: Echipa de vânzări - Vânzări Emag;
- User: Emag sau oricare alt agent de vânzări;
- Location Stock : se setează Locația de unde se va lua stocul și se va transmite în platforma eMAG.
Pentru configurarea conectorului eMAG trebuie să se facă setările pentru:
- Objects;
- Credentials;
- Price;
- Other Info.
I.1. Objects
Objects reprezintă obiectele cu care se face integrarea cu platforma Emag sau oricare altă platformă.
I.1.1. Adăugarea unui obiect
Pentru a adăuga un obiect nou : 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. Cod de bare).
I.2. Credentials
Se vor adăuga credențialele în următoarele câmpuri:
- Location – adresa de conexiune;
- Access Type: User and password;
- Username: adresa de logare pentru accesarea sistemului;
- Password: parola de logare pentru accesarea sistemului.
ATENȚIE!!! Trebuie făcută o setare la nivel de eMAG în care să-i permită IP-ului sistemului Odoo să facă interogări.
I.3. Price
În secțiunea Price se vor seta:
- Pricelist: Lista de prețuri configurată pentru eMAG;
- Currency: Moneda magazinului;
- Price Per Product – se bifează – fiecare produs are un preț în lista de prețuri;
- 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.
I.4. Other Info
În secțiunea Other Info se vor completa câmpurile:
- Language : se alege limba pentru afișare în magazin;
- Items Per Page : reprezintă numărul de produse trimise către eMAG la fiecare rulare;
- Metode de plată : Payment COD (cash on delivery) - Ramburs , Payment bank transfer – Ordin de plată, Payment online card payment – Card online;
- Carrier: metoda de transport - se alege/ se creează curierul Transport;
Aici sunt și câmpuri care permit bifarea lor:
- Use Category – utilizarea categoriilor din eMAG;
- Use Attribute – utilizarea atributelor;
- Use Variants – utilizarea variantelor de produse;
- Ignore Image – se poate ignora aducerea imaginilor din eMAG în sistemul Odoo;
- 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.
Atentie!!! Va trebui mapată fiecare metodă de plată eMAG cu metoda de plată din sistemul Odoo corespunzătoare.
II. Objects - Integrarea cu platforma eMAG
Pentru integrarea cu platforma eMAG se definesc obiectele următoare:
- Products – Produse – publicarea produselor în platforma eMAG;
- Customers - Clienți;
- Sales Order – Oferte de vânzare – preluarea comenzilor de pe platforma eMAG, împreună cu datele clientului și a detaliilor din comandă;
- Stock – Stocul – trimiterea stocului dintr-un punct de lucru/ depozit.
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.
II.1. Maparea Obiectelor
Integrarea cu platforma eMAG nu intervine asupra datelor din back-end-ul sistemului Odoo (produse, comenzi, clienți). Modulul de integrare face o mapare, de aceea fiecare obiect are o mapare.
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:
II.2. Descrierea Produsului
a) Name – numele produsului în platforma eMAG;
b) Odoo Product – se alege produsul din sistemul Odoo;
c) External ID;
d) PNK - Part Number Key este utilizat pentru a asocia un produs Odoo cu un produs eMAG existent.
e) Sales Price - Nu se transmit toate datele din sistemul Odoo în platforma Emag, se transmite doar un Update pe preț.
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 Set Price:
f) Auto Price – se permite bifarea câmpului pentru a se calcula prețul optim de vânzare.
g) 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.
h) Prețul minim de vânzare (Min Sale Price) și prețul maxim de vânzare (Max. Sale Price) reprezintă limitele prețului oferit.
i) Emag Stock și Odoo Stock
Este afișat stocul din Emag și stocul din sistemul Odoo. Dacă sunt neconcordanțe, aici se pot vedea diferențele dintre stocuri.
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.
III. 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;
b) 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);
c) 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
IV. Configurare Transport eMAG
Pentru configurarea Metodei de livrare pentru platforma eMAG: Vânzări – Configurare – Metode de expediere:
În Metode de livrare se va apăsa butonul Crează:
Pentru configurarea metodei de livrare Transport eMAG se va selecta:
- Calcul preț: se selectează eMAG;
- Nivel de integrare : obține preț;
3. Livrare Produs: se creează produsul Transport ( produs de tip Service);
3. În eMAG Configuration se vor completa câmpurile Emag Label Format (ex. A6), Locație ridicare și Plată ramburs.
În secțiunea Pickup Location se vor completa câmpurile Pickup Location Source: From Carrier ș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ă.
Odoo Proprietary License v1.0 This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from the authors, typically via Odoo Apps, or if you have received a written agreement from the authors of the Software (see the COPYRIGHT file). You may develop Odoo modules that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the Odoo Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one). It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software. The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Please log in to comment on this module
Report comment
Any abuse of this reporting system will be penalizedThere are no ratings yet!
Hello!
Can it used in cloud version?
Re:
Only on premise or in odoo.sh.