v 15.0 Third Party
Availability
Odoo Online
Odoo.sh
On Premise
Odoo Apps Dependencies Sales (sale_management)
Discuss (mail)
Invoicing (account)
Inventory (stock)
Community Apps Dependencies
Lines of code 10229
Technical Name deltatech_marketplace_emag
LicenseOPL-1
Websitehttps://www.terrabit.ro
Versions 14.0 15.0
You bought this module and need support? Click here!
Availability
Odoo Online
Odoo.sh
On Premise
Odoo Apps Dependencies Sales (sale_management)
Discuss (mail)
Invoicing (account)
Inventory (stock)
Community Apps Dependencies
Lines of code 10229
Technical Name deltatech_marketplace_emag
LicenseOPL-1
Websitehttps://www.terrabit.ro
Versions 14.0 15.0

EMAG Marketplace Connector

Production/Stable License: OPL-1 terrabit-ro/bitshop

Features:

Table of contents

Bug Tracker

Bugs are tracked on GitHub Issues. In case of trouble, please check there if your issue has already been reported. If you spotted it first, help us to smash it by providing a detailed and welcomed feedback.

Do not contact contributors directly about support or help with technical issues.

Credits

Authors

  • Terrabit
  • Dorin Hongu

Maintainers

Current maintainer:

dhongu

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.

1-Odoo.png

I. Crearea conectorului eMAG

Pentru configurarea conectorului eMAG se accesează modulul Marketplace – se apasă butonul Creează:

2 - Odoo.png

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

3 - Odoo.png

  1. Se bifează câmpul Active;
  2. Provider: Se selectează Emag;
  3. Sales Team: Echipa de vânzări - Vânzări Emag;
  4. User: Emag sau oricare alt agent de vânzări;
  5. 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:

  1. Objects;
  2. Credentials;
  3. Price;
  4. Other Info.

3 - Odoo.png

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ă:

2022-02-22 15_47_57-emag - Odoo.png

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.)

2022-02-22 15_50_08-emag - Odoo.png

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 .

web hook-emag - Odoo.png

c) Ignore Field – dacă se dorește ignorarea anumitor câmpuri în maparea obiectelor se completează cu cele nedorite (ex. Cod de bare).

2022-02-23 08_36_08-Window.png

I.2. Credentials

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.

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

4 - Odoo.png

I.3. 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.

5 - Odoo.png

I.4. Other Info

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

  1. Language : se alege limba pentru afișare în magazin;
  2. Items Per Page : reprezintă numărul de produse trimise către eMAG la fiecare rulare;
  3. Metode de plată : Payment COD (cash on delivery) - Ramburs , Payment bank transfer – Ordin de plată, Payment online card payment – Card online;
  4. Carrier: metoda de transport - se alege/ se creează curierul Transport;

Aici sunt și câmpuri care permit bifarea lor:

  1. Use Category – utilizarea categoriilor din eMAG;
  2. Use Attribute – utilizarea atributelor;
  3. Use Variants – utilizarea variantelor de produse;
  4. Ignore Image – se poate ignora aducerea imaginilor din eMAG în sistemul Odoo;
  5. 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.

6 - Odoo.png

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:

  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.

3 - Odoo.png

După crearea obiectelor pentru integrare, sistemul va aduce automat butonul de Import image12 sau Export image13 . 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:

comanda de vanzare.png

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

partener-Window.png

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

2022-02-22 16_16_35-CAMERA IP DE INTERIOR CU MONTURA TAVAN C26 6MP - Odoo.png

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:

get price - Odoo.png

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:

set price - Odoo.png

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

2022-02-23 10_15_05-Window.png

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

image20

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.

2022-02-22 16_16_35-CAMERA IP DE INTERIOR CU MONTURA TAVAN C26 6MPasdsd - Odoo.png

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.

2022-02-22 13_32_20-Jobs - Odoo.png

  1. 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 – ConfigurareMetode de expediere:

10Oferte - Odoo.png

În Metode de livrare se va apăsa butonul Crează:

11Metode de Livrare - Odoo.png

Pentru configurarea metodei de livrare Transport eMAG se va selecta:

  1. Calcul preț: se selectează eMAG;
  2. 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.

8-.png

În secțiunea Pickup Location se vor completa câmpurile Pickup Location Source: From Carrier și Locație ridicare: Depozit:

9TRANSPORT_Odoo.png

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

2022-02-22 13_29_15-TRANSPORT - Odoo.png

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

  • The author can leave a single reply to each comment.
  • This section is meant to ask simple questions or leave a rating. Every report of a problem experienced while using the module should be addressed to the author directly (refer to the following point).
  • If you want to start a discussion with the author or have a question related to your purchase, please use the support page.
There are no ratings yet!
by
Anton Hvatcov
on 10/19/21, 3:10 AM

Hello!

Can it used in cloud version?

Re:
by
Dorin Hongu
on 10/19/21, 11:54 AM

Only on premise or in odoo.sh.