1

eMAG Marketplace Plugin

User Guide

v1.0.1

2

Content 1. General Description ..................................................................................................................... 3

2. Prerequisites ................................................................................................................................ 3

3. Installation ................................................................................................................................... 4

4. Main Configuration ...................................................................................................................... 4

5. CRON Jobs ................................................................................................................................. 11

6. Category Mapping ..................................................................................................................... 12

7. Characteristics Mapping ............................................................................................................. 14

8. Publishing Products To eMAG Marketplace ................................................................................ 15

9. Processing And Updating Orders From eMAG Marketplace ........................................................ 17

10. Uploading Invoices ..................................................................................................................... 19

11. Generating AWBs ....................................................................................................................... 20

12. Downloading AWBs .................................................................................................................... 21

13. Important Notes......................................................................................................................... 22

3

1. General Description

The eMAG Marketplace module helps you integrate your Magento 2 store with the eMAG Marketplace

vendor platform. This will allow your store to:

● Automatically send product documentation (titles, descriptions, images, etc.), product price info

and product stock info, to the eMAG Marketplace platform.

● Automatically send new products and any updates for previously sent products.

● Automatically receive orders from the eMAG Marketplace platform and import them in your

Magento store.

● Automatically send order updates to the eMAG Marketplace platform.

● Upload an invoice to eMAG Marketplace

● Generate AWB’s for imported eMAG orders

2. Prerequisites

The plugin is compatible with Magento version 2.2.4, running on PHP Version 7.0 or higher and to have

the cURL extension enabled.

Before using the plugin you need to:

- have an active eMag Marketplace Seller account.

- configure your eMag Marketplace Seller account, according to your bussiness’s needs.

- add a courier account, in case you want to generate AWBs through the eMag Marketplace

module.

- whitelist your site’s IP address in the eMAG Marketplace platform, from your eMAG Seller

account. If you need help with this step please contact eMAG Marketplace team.

To automatically import new orders placed on eMAG Marketplace, it is required to communicate a

callback url to the eMAG Marketplace team, used by eMAG to notify your website of new orders placed.

This url has the format: <website url>/emagmarketplace/order/ping?order_id=123

Replace <website url> with your website url.

Note: If this url is not set by the eMAG team, you can not receive and import new orders from eMAG

Marketplace.

4

3. Installation

1) Install the plugin from the official Magento marketplace

2) Configure the settings as described bellow

3) If after installation on the plugins pages you find a 404 error , please logout and login back into admin

area

4. Main Configuration

In order to set up the extension, navigate to Stores / Settings / Configuration / Emag Marketplace.

There you will find the settings for the entire eMAG Marketplace Plugin.

5

The module settings can be found under the eMAG Marketplace settings group on the left column.

6

On the first tab („API Settings”) you will need to fill in API URL, Username and Password (provided to you

by the eMAG Marketplace representative) and chose the locale and the currency of your store.

API URL will be filled in depending on the country in which you trying to connect to the eMAG platform.

It can be found in the eMAG Marketplace API Documentation:

https://marketplace.emag.ro/infocenter/centrul-de-oportunitati/conectori-marketplace/documentatia-

api-emag-marketplace/

Note: Don’t forget to click Save Config on each tab before navigating to another page or tab, otherwise

the changes will NOT be saved.

After saving your data, you will receive a success or an error message regarding the test connection.

When you save and connect successfully, the module imports VAT values, Handling Time values and

Courier Accounts associated with your eMAG Marketplace Seller account. If these values need to be

updated, in case they have changed on your eMag Marketplace account, for example, you can click Save

Config in the “API Settings” tab again, and the data will be reimported.

In case of an error message, please check that your API login data is correct, and that your IP address is

whitelisted in your eMAG Marketplace Seller account.

7

In case you do not have any courier accounts associated with your Seller account, you will receive an error

message:

To generate AWBs using the eMag Marketplace Connector extension, you are required to add at least

one active courier account in your eMag Marketplace Seller account. After adding the courier account,

you need to click the Save Config button, in the API Settings section again in order to import the account

into your Magento store.

On the tab „Products Settings” you need to fill in information related to products.

Products Queue Limit represents the number of products sent to eMAG Marketplace on each CRON run.

We recommend a maximum value of 50.

Handling Time represents the handling time, in number of days counted from the day the order was

received. If handling time = 0 the order will be shipped the same day it is received.

VAT Rate is the tax applied to your products. The value set in this field must be the same with the one

applied on product’s page.

8

NOTE: If you are a VAT paying seller it is important to have the Magento Tax Calculation Settings (In

Stores/Configuration/Sales/Tax section) set up accordingly. We recommend setting : “Tax Calculation

Method Based On” by “Unit Price” , “Tax Calculation Based On”: “Shipping Origin” and entering the

address (of the country where you pay VAT) in the “Origin” tab in Sales/Shipping Settings.

If values for the Handling Time and VAT Rate fields are missing, it means that a successful connection to

the eMag Marketplace API has not been established, and you need to recheck the connection details in

the previous API Settings section.

Min Sale Price and Max Sale Price represent the percentage that will be subtracted, respectively added to

each product’s price in order to be validated by eMAG Marketplace. An offer published in eMAG

Marketplace will not be validated or sold with a price value smaller than the initial publish price minus the

Min Sale Price percentage of that initial price, or a price value higher than the initial publish price plus the

Max Sale Price percentage of that initial price (For an initial product price of 100 , Min Sale Price set at 40

, and Max Sale Price set at 50, the product will not be sold with a value less than 60 , or higher than 150).

NOTE: Allowed values for “Handling Time” field are set for each seller individually and can be one of the

following values: 0, 1, 2, 6, 9.

On the “Order Settings” tab, you need to fill in the Magento order statuses that correspond with the eMag

statuses.

For Initial, Finalized and Cancelled status order the value will be selected according to the requirements.

It is recommended to use Magento Order Pending status for Initial Order Status;

Magento Order Complete status for Finalized order status;

Magento Order Cancelled for Cancelled order status.

Note: You will not be able to change order status if the change is not allowed in eMAG.

9

On the „Payments Settings” tab you will need to map each eMAG payment method with the

corresponding Magento payment method.

Note: The payment methods that are selected here, need to be enabled in Magento settings.

On the “Shipping Settings” tab you will need to provide information used to generate the AWBs and to

import the localities list from eMAG.

Shipping method represents the default shipping method with which eMag Marketplace orders are

imported.

The Name, Contact Person, and Zipcode fields may be overwritten with information from your eMAG

Marketplace seller account.

It is very important to import the localities list, by clicking the Import Localities button. AWBs cannot

be generated without localities. Please do not close the browser during the import, this process might

take several minutes.

10

After a successful Localities import, you will receive a success message:

Localities are also imported and updated automatically, once a week, every Monday at 05:11, through

the Localities Import CRON job. If you need to update the localities immediately, you can click the

Import Localities button to trigger the import.

The last tab is „Alerts” where you need to provide one or more email addresses (separated by coma) for

each notification type.

It is required to have an active mailing service, to receive possible error messages generated by the

extension during CRON jobs.

Note: You can add multiple email addresses, separated by comma.

11

5. CRON Jobs

For this module to work properly it is required that the Magento CRON Job is active and working.

It is recommended set up the CRON following the official Magento documentation.

https://devdocs.magento.com/guides/v2.0/config-guide/cli/config-cli-subcommands-cron.html

If it is not already set, generally it can be set using the following example:

After connecting via ssh to your server run:

crontab -u <magento user> -e

* replace <magento user> with a user with root privileges

In the crontab file opened by the previous command, add the command for the CRON job:

* * * * * <php binary path>php <website root path>/cron.php

* <website root path> must be replaced with your Magento installation root folder path.

* <php binary path> must be replaced with your server php binary path.

The module uses four CRON jobs, that:

- Publish products and product updates to the eMAG Marketplace Platform (runs every 15 minutes)

- Imports orders placed on the eMAG Marketplace Platform into your Magento store (runs every

hour)

- Reads the validation status of previously published products (runs every 15 minutes)

- Reads and updates the shipping localities (once a week)

12

To manually trigger one of the actions above, you can also use a console command, for each action. To do

this you need a ssh connection to the server your website is hosted on, and run a console command from

the Magento website root folder:

- php bin/magento zitec_emagmarketplace:product:send

Sends new products, or existing product updates to the eMag Marketplace platform, limited by the

Product Queue Limit setting (will not send more products in one run than the value set as the limit).

- php bin/magento zitec_emagmarketplace:product:read

Reads the product offer validation statuses, for products that have been successfully sent to the eMag

Marketplace platform.

- php bin/magento zitec_emagmarketplace:order:import

Imports new orders placed from eMag Marketplace, into your Magento store.

- php bin/magento zitec_emagmarketplace:locality:import

Imports and updates localities, used in generating AWBs for shipping.

6. Category Mapping

In order to associate the categories from your store with the eMag ones, navigate to eMAG Marketplace

/ Categories and Characteristics Mapping section

13

Before creating a new mapping, you have to import categories from eMAG. To do that, click the Import

Emag Data button. This operation might take several minutes, depending on the resources of the server

where your website is hosted on. In case this import is not finalized successfully, ask you hosting provider

for help.

When the import is finished, click the Add Mapping button. Choose an eMAG Category and a Magento

category you want to associate, and map the eMAG characteristics with the corresponding Magento

attributes and save the changes.

You can map multiple eMAG categories to the same Magento category.

This mapping is required in order to publish a product on eMag Marketplace. Any product we wish to

publish, needs to be included into an eMag mapped Magento category.

14

7. Characteristics Mapping

To edit the characteristics mappings, go to Characteristics Mapping section, under the Category Mapping

section. Here you can map your Magento product attributes to the eMAG characteristics of the previously

associated category.

A list of all eMAG characteristics is shown.

For each of the eMAG required characteristics, select the appropriate attribute from your store and click

the Save button.

15

After saving the mapping, the values of the eMAG characteristics are read and depending on each

characteristic, the associated attributes can accept new values, or must be set from an existing list of

values(indicated by the message “This characteristic does not allow new values.” in the link). Click the

available links to see the existing values from eMag.

If you need help with this step please contact eMAG Marketplace team.

Mandatory characteristics are marked with *.

8. Publishing Products To eMAG Marketplace

The products you wish to publish to eMAG Marketplace must fulfill the following requirements:

● be a simple product

● have a Price

● have an SKU

● have a positive numeric value for the field Qty

● have the In stock value set for the Stock Availability field

● have the category mapped to an eMAG Category

● have all required characteristics from product category added to the Attribute Set with which the

product is created

● have at least one image

● have the checkbox Visible in eMAG Marketplace checked

● the field eMAG Brand must contain a value consistent with the eMAG brands

The last two fields can be found on the eMAG Marketplace tab.

16

Alongside the Visible in eMAG Marketplace and eMAG Brand fields from the eMAG Marketplace tab you

will find the Warranty and the eMAG Part Number Key (PNK) fields.

The Warranty field represents the product warranty in months and it’s optional; if it’s empty eMAG

considers that the product has no warranty.

The eMAG Part Number Key is used to associate a Magento product with an existing eMAG product and

it’s also optional;

The EAN field is mandatory if the product belongs to a mapped eMAG category the has EAN mandatory.

If the product category is not with EAN mandatory, then the field is optional. This field represents the

barcode associated to the product.

NOTE: you can’t delete the association but you can change it, respectively associate it with another

product.

NOTE: You should add only one mapped category to a product (that you want to publish to eMag

Marketplace).

In case you receive an error message when saving a product, that is checked as Visible to eMag

Marketplace, the Visible to eMag Marketplace is automatically unchecked. After solving the issue pointed

17

out by the error message, you need to check again the Visible to eMag Marketplace field and save the

product.

After successfully saving a product marked as Visible to eMag Marketplace, there is no other action

required in order for the product to be published. When the product send CRON runs , the product is

automatically sent to eMag Marketplace. In case an error occurs, you will by notified on the alert email,

and need to solve the issue, and save the product again.

After the product status validation import cron job has finished, the information in the Status,

Validation Status, Offer Validation Status are updated. In case the information for the product

has not passed eMAG validation , details about the reason will be shown in the Validation

Status field.

9. Processing and Updating Orders From eMAG Marketplace

The orders will be received automatically from eMAG Marketplace, provided that the General Settings

have been filled in, CRON service is working properly, and the new order notification url has been set up

by the eMAG Team.

For example, if a new order is created in the eMAG Marketplace, then the order will appear in Magento

Sales Orders list after import.

18

In the Sales/Orders list you will find a new column Emag Order Id , which will contain the corresponding

eMAG order id if the order has been imported from eMAG Marketplace.

On the order view page of an order imported from eMAG Marketplace, there are two new tabs added:

eMag Invoice Upload and eMAG AWBs.

19

New orders, placed on eMag Marketplace, are automatically notified to our extension. The new order

ids received as notifications, are saved in a queue, they are read, and new Magento orders are created

using the eMag order information. This is all done automatically, and the order import is done by the

Order Import CRON job.

In case of an error when importing orders, details of the error are sent to the alerts email address, set in

the Alerts settings section.

An eMag imported order can be edited or returned, depending on the status it is in, using the default

Magento steps for these actions. The modifications are updated also on the eMag Marketplace platform

on the spot. I f an error occurs while saving the eMag order, the error will be shown on Magento and the

modification will not be saved.

When issuing a Magento Credit Memo (a refund) for an order with online payment, Magento by default

will not automatically issue the payment of that refund to the customer. If you are using a third party

extension for online payments, you need to make sure that refunds are not automatically paid back to

customers. Please contact the eMag team for more details on refunding orders with online payment.

10 . Uploading Invoices

To upload an invoice for an order you need select an order, then click on the eMag Invoice tab. Click on

“Choose file”, select the PDF file of the invoice then click on “Upload Invoice” button. This will upload the

order on your server and will send the link to eMAG.

20

11 . Generating AWBs

In order to generate an AWB, choose an order from Sales / Orders and click the Generate Awb button.

Choose a courier, fill in the asked information and click on the “Generate AWB” button.

You can generate as many AWBs as you need for an order.

21

Important: When you generate the first AWB for an order, the order is automatically marked as finalized

in eMag Marketplace, and becomes complete in Magento. Please make sure to invoice and ship the order,

with the default Magento steps, before generating an AWB. You will not be able to perform these actions

if the order is marked “complete”.

12 . Downloading AWBs

The generated AWBs are stored in the ‘Emag AWBs’ tab on the left-hand side of the order view. You can

download an Awb by selecting the printing format under the “Action” column. The AWB will be

downloaded as PDF file.

22

13 . Important Notes

a. VAT and Currency

It is mandatory that the Tax Rate set in the Magento Configuration and applied to products

and the Currency used to create the Magento products correspond with the VAT Rate value

set in the Product Settings tab, and the Currency setting under Api Settings , in the eMag

Marketplace plugin settings section.

23

b. Error Alerts

It is mandatory to set an email address in the Alert Settings section , to receive notifications

and details of potential issues regarding product publishing or order importing processes.

When attempting to import eMag orders, if a product is not found , is out of stock or can not

be added to the order for some reason, the order is not created in Magento, and there will

be no further attempts to import the order. Manual intervention is needed in this case, using

the error information provided by email to the alert email address.

c. Status Order

For initial status order, finalized and cancelled status order the values will be selected

according to the requirements.

d. Editing Orders

When editing an imported order, which is still in it’s initial status, the customer data(name,

email, adresses) will not be modified or updated in the eMAG Marketplace platform. We

recommend not to edit this data in the Magento store, in order to avoid unsynchronized

order data.

24

25

Extensie eMAG Marketplace

Manual de utilizare

v1.0.1

Cuprins 1. Informații generale .................................................................................................................... 26

2. Cerințe preliminare .................................................................................................................... 27

26

3. Instalare..................................................................................................................................... 27

4. Configurație principală ............................................................................................................... 27

5. CRON-uri.................................................................................................................................... 34

6. Asocierea categoriilor ................................................................................................................ 35

7. Asocierea caracteristicilor .......................................................................................................... 37

8. Publicarea de produse în platforma eMAG Marketplace ............................................................ 38

9. Procesarea și actualizarea comenzilor din eMAG Marketplace ................................................... 40

10. Incărcarea facturilor ................................................................................................................... 42

11. Generarea AWB-urilor ................................................................................................................ 43

12. Descărcarea AWB-urilor ............................................................................................................. 44

13. Note importante ........................................................................................................................ 45

1. Informații generale

Extensia eMAG Marketplace facilitează integrarea magazinului Magento 2 cu platforma eMAG

Marketplace. Extensia vă permite să:

● Trimiteți în mod automat documentația produselor (titlu, descriere, imagini, etc), informații

despre preț și stoc către platforma eMAG Marketplace.

● Trimiteți în mod automat produse noi sau actualizări pentru cele existente.

● Primiți și importați în mod automat comenzi din platforma eMAG Marketplace direct în magazinul

dumneavoastră Magento.

● Trimiteți actualizări în mod automat pentru comenzile provenite din platforma eMAG

Marketplace.

27

● Să atasati factură la comanda eMAG

● Sa generati AWB-uri pentru comenzile importate din eMAG

2. Cerințe preliminare

Extensia este compatibilă cu Magento versiunea 2.2.4. Este necesar ca versiunea dumneavoastră de PHP

sa fie minim 7.0 și sa aibă extensia cURL activată.

Înainte de a utiliza această extensie este necesar să:

- aveți un cont de Seller pe aplicatia eMag Marketplace.

- să configurați contul de seller eMag Marketplace, in functie de necesitatile bussiness-ului

dumneavoastră.

- adăugați cont de curieri, in cazul in care generati AWB-uri prin intermediul eMag.

- adăugați IP-ul site-ului dumneavoastră în lista cu IP-uri permise, in contul dumneavoastră de Seller

in aplicatia eMAG Marketplace. În cazul în care aveți nevoie de ajutor cu acest pas vă rugăm să

contactați echipa eMAG Marketplace.

Pentru importarea automată a comenzilor din eMAG Marketplace, este necesar să comunicati echipei

eMAG url-ul din site-ul dumneavoastră către care plaforma eMAG Marketplace va transmite notificarea

pentru comenzi noi.

Acest url are forma: <website url>/emagmarketplace/order/ping?order_id=123

Inlocuiti <website url> cu adresa site-ului dumneavoastră.

Nota: Fără setarea acestui url de către echipa eMAG nu se pot importa comenzile plasate in eMAG

Marketplace.

3. Instalare

1) Instalați extensia din marketplace-ul oficial Magento.

2) Configurați extensia conform pașilor de mai jos.

3) Dacă după instalare primiți o eroare de tip 404 la navigarea pe paginile legate de acest plugin, ieșiți

din contul de administrator și autentificați-vă din nou

4. Configurație principală

28

Pentru configurarea setărilor necesare extensiei eMAG Marketplace, accesați Stores / Settings /

Configuration / Emag Marketplace.

În această pagina veți găsi toate setările generale pentru extensia eMAG Marketplace.

29

În primul tab (”API Settings”) este necesar sa completați API URL, Username și Password (furnizate de

către reprezentantul eMAG Marketplace) și să selectați limba (Locale), respectiv moneda (Currency)

pentru magazinul dumneavoastră.

API URL va fi completat in functie de țara in care se vrea conectarea cu eMAG Markeplace, și poate fi

preluat din documentația oficială eMAG Marketplace API Documentation :

https://marketplace.emag.ro/infocenter/centrul-de-oportunitati/conectori-marketplace/documentatia-

api-emag-marketplace/

Notă: Nu uitați sa dați click pe butonul Save Config. În cazul in care navigați pe o altă pagină fără să dați

click pe butonul respectiv modificările dumneavoastră nu vor fi salvate.

Dupa salvarea setărilor va fi afișat un mesaj de succes privind accesarea API-ului eMAG Marketplace.

In momentul conectării cu succes, se realizează importul de valori TVA, valorile permise de Handling Time,

și conturile de curieri asociate contului dumneavoastră de eMAG Marketplace.

In cazul in care este necesară actualizarea acestor valori, in urma modificării lor in contul dumneavoastră

de seller eMag Markteplace, se poate da click din nou pe butonul Save Config, din tabul ”API Settings”, și

datele respective vor fi re-importate.

În cazul în care nu s-a reușit conectarea la API, verificați datele de conectare și că IP-ul dumneavoastră a

fost adăugat în lista IP-uri permise în contul dumneavoastră de Seller în aplicația eMAG Marketplace.

30

In cazul in care nu aveti adăugate in contul dumneavoastră de eMag Marketplace Seller, conturi de curieri,

veti primi un mesaj:

Pentru a genera AWB-uri folosind extensia eMAG Marketplace Connector, este necesar să vă adăugati un

cont de curier activ in contul dumneavoastră de seller eMag Marketplace. după ce acest cont de curier a

fost adăugat, se va da click din nou pe ”Save Config” din tab-ul API Settings pentru a importa acest cont in

magazinul dumneavoastră Magento.

Dacă nu doriti sa generati AWB-uri prin extensia eMAG Marketplace Connector se poate ignora acel mesaj

de eroare și se trece la pasii urmatori.

În cel de al doilea tab (”Product Settings”) este necesar să completați informații în legătură cu produsele

dumneavoastră.

Products Queue Limit reprezintă numărul de produse trimise sau actualizări trimise către platforma eMAG

Marketplace la fiecare rulare de CRON. Este recomandat ca acest numar sa fie mai mic de 50.

31

Handling Time reprezintă numărul de zile necesar expedierii comenzii, numărate începând cu ziua primirii

comenzii. În cazul în care Handling Time este zero, eMAG va considera ca veți expedia comanda în ziua

primirii acesteia.

VAT Rate reprezintă TVA-ul produselor dumneavoastră. Aceasta valoare trebuie sa corespunda cu

valoarea TVA-ului aplicat in pagina de produs.

Daca valorile pentru Vat Rate și Handling Time lipsesc, inseamna ca nu a fost facuta cu succes conexiunea

la API-ul eMag și trebuie sa verificati acest aspect, folosind pasii anteriori din tab-ul API Settings.

In cazul in care sunteti platitor TVA, este important ca sa aveti setarile de taxe configurate corect in

magazinul dumneavoastra Magento. Pentru zona de setari Magento

Store/Configuration/Sales/Tax/Calculation Settings, recomandam setarea campului “Tax Calculation

Method Based On” la valoarea “Unit Price”, “Tax Calculation Based On” la valoarea “Shipping Origin” si in

zona Sales/Shipping settings, sa setati adresa in tab-ul “Origin” (adresa din tara in care vindeti si platiti

TVA).

Nota: Valorile permise pentru câmpul „Handling Time” sunt stabilite pentru fiecare seller in parte și poate

avea una din valorile: 0, 1, 2, 6, 9.

Min Sale Price și Max Sale Price reprezintă procentul care va fi scăzut, respectiv adăugat la prețul

produselor dumneavoastră pentru a fi validat de către eMAG Marketplace. Un produs publicat in eMAG

nu va putea fi validat sau vândut cu un pret mai mic decat pretul trimis initial minus valoarea procentajului

Min Sale Price din acest pret, sau mai mare decat pretul initial plus valoarea procentajului Max Sale Price

(Pentru un pret initial publicat al unui produs de 100 , și valorile Min Sale Price cu valoarea 40 și Max Sale

Price de 50, produsul nu va fi vândut cu mai putin de 60 sau mai mult de 150).

Următorul tab, ”Order Settings”, conține setări necesare comenzilor.

32

Initial status order reprezintă statusul pe care comenzile provenite din eMAG Marketplace îl vor avea

atunci cănd vor ajunge in magazinul dumneavoastră;

Finalized status order pe cel care îl vor avea comenzile finalizate;

Cancelled status order pe cel care îl vor avea comenzile anulate;

Recomandam valorile Pending, Complete și Cancelled pentru aceste setari.

Notă: Nu veți putea schimba statusul unei comenzi dacă schimbarea nu este permisă de către eMAG.

În următorul tab, ”Payments Settings”, este necesar sa asociați fiecare metodă de plată din eMAG cu

metoda de plată corespunzătoare din magazinul dumneavoastră.

Notă: Este necesar să asociați metode de plată active în magazinul dumneavoastră.

În tab-ul „Shipping Settings” este necesar sa completați informatiile in legatura cu livrarea comenzilor și

generarea AWB-urilor.

33

Înainte de completarea câmpurilor este necesar să dați click pe butonul „Import Localities”. Fără acest

pas NU se vor putea genera AWB-uri. Este necesar să nu închideți browser-ul în timpul procesului de

import care poate dura mai multe minute.

Dupa terminarea cu succes a importului se primeste un mesaj de succes:

Localitățile se actualizeaza și automat , o data pe sapt (luni) la ora 5:11 , prin rularea automata a CRON-

ului de import localitati. Daca este nevoie de actualizare imediata, se poate da click din nou pe butonul

Import Localities .

Shipping Method reprezintă metoda de livrare care va fi folosita pentru comenzile provenite din eMAG

Marketplace. Valoarea costului de livrare pentru o comanda importata din eMAG Marketplace, va fi cel

provenit din eMAG, indiferent daca in platforma Magento aveti setata alta valoare pentru metoda de

livrare respectiva.

Câmpurile Name, Contact Person și Zipcode vor fi completate automat de platforma eMAG Marketplace

la generarea AWB-urilor.

34

Ultimul tab, ”Alerts Settings”, este destinat configurării adresei de e-mail pentru notificare in caz de

alertă. Este necesar sa aveti un serviciu de mail-uri activ, pentru a primi mesajele de erori care pot

aparea la rularea CRON-urilor.

Notă: Puteți introduce mai multe adrese de e-mail despărțite prin virgulă pentru fiecare tip de alertă.

5. CRON-uri

Pentru o funcționare corespunzătoare a extensiei este necesar sa va asigurați ca functioneaza CRON-ul

Magento.

Este recomandat sa urmariți pasii descrisi in documentatia oficiala Magento.

https://devdocs.magento.com/guides/v2.0/config-guide/cli/config-cli-subcommands-cron.html

In cazul in care acesta nu este deja setat, in general poate fi setat după exemplul:

Dupa conectarea ssh la serverul dumneavoastră, rulati comanda:

crontab -u magento_user -e

* inlocuiți <magento user> cu un user cu privilegii root.

In fisierul crontab salvati următoarea comanda CRON:

* * * * * <php binary path>php <website root path>/bin/magento cron.php

35

* inlocuiți <website root path> cu calea fizică către directorul radacină a instantei dumneavoastră

Magento.

* inlocuiți < php binary path> cu calea fizică către executabilul php.

Extensia foloseste patru CRON-uri, care:

- Publică produse și actualizări de informatii către platforma eMAG Marketplace (rulează la

fiecare 15 minunte)

- Importa comenzile plasate in eMAG Marketplace (rulează o data la o ora)

- Citeste status-ul de validare a produselor publicate in eMAG Marketplace (rulează la fiecare 15

minunte)

- Citeste localitățile folosite la generarea AWB (rulează o data pe saptamana)

Pentru rularea manuala a cronurilor, sunt create comenzi de consola, care se pot apela prin conectare ssh

la serverul pe care este hostat site-ul dumneavoastră, din fisierul radacina al site-ului Magento:

- php bin/magento zitec_emagmarketplace:product:send

Publica produsele noi și modificarile la produsele deja trimise, marcate pentru publicarea in eMag

Marketplace, in limita setata folosind câmpul Product Queue Limit

- php bin/magento zitec_emagmarketplace:product:read

Citeste statusurile de validare a produselor publicate in eMag Marketplace

- php bin/magento zitec_emagmarketplace:order:import

Importă comenzile plasate in platforma eMag Marketplace in magazinul dumneavoastră Magento

- php bin/magento zitec_emagmarketplace:locality:import

Importa localitățile folosite la generarea AWB-urilor

6. Asocierea categoriilor

36

Pentru a asocia categoriile din magazinul dumneavoastră la categoriile eMag, accesați secțiunea eMag

Marketplace / Categories and Characteristics Mapping.

Înainte de crearea unei noi asocieri este necesar să dați click pe butonul Import Emag Data din partea de

sus a paginii. Această operațiune poate dura mai multe minute în funcție de resursele serverului pe care

este hostată instanța Magento. În cazul în care nu se finalizează importul cu succes, cereți ajutorul

furnizorului dumneavoastră de hosting.

După finalizarea importului dați click pe butonul Add Mapping. In noua pagină, alegeti o categorie eMAG

și una Magento, apoi asociați caracteristicile acestor categorii eMAG in secțiunea Characteristic Mapping

cu atributele corespunzătoare produselor din Magento care vor fi publicate in eMAG și aparțin categoriei

mapate și dați click pe butonul Save.

37

Puteți asocia mai multe categorii Magento la o singură categorie eMag.

Această asociere este necesara la publicarea produselor in eMag Marketplace. Un produs pe care il vrem

publicat, trebuie sa apartină unei categorii mapate cu o categorie eMag.

7. Asocierea caracteristicilor

Sub secțiunea de mapare a categoriilor, se află secțiunea de mapare a caracteristicilor. Aici veți asocia

atributele produselor dumneavoastră cu atributele eMAG ale categoriilor asociate anterior.

38

Va fi afișată o lista cu caracteristicile eMAG

Pentru fiecare caracteristică eMAG, alegeți atributul corespunzător din magazinul dumneavoastră, după

care dați click pe butonul Save din partea de jos a paginii.

După salvarea mapării, se citesc automat valorile existente pentru fiecare caracteristica si, in funcție de

caracteristică, atributul asociat poate permite valori noi (indicat prin mesajul din link), sau este necesar să

fie parte dintr-o listă predefinită. Accesați linkurile disponibile sub caracteristici pentru a afla valorile

existente in eMag.

În cazul în care aveți nevoie de ajutor cu acest pas vă rugăm să contactați echipa eMAG Marketplace.

Caracteristicile obligatorii ale eMAG sunt marcate cu *.

8. Publicarea de produse în platforma eMAG Marketplace

Pentru a publica un produs în platforma eMAG Marketplace este necesar ca acesta să îndeplinească

următoarele cerințe:

● Trebuie sa fie produs de tip simplu

● Trebuie să aibă preț

● Trebuie să aibă SKU

● Trebuie sa aibă o valoare numerică pozitivă (sau zero) pentru câmpul Quantity (cantitate)

● Trebuie sa aibă setata valoarea In stock pentru câmpul Stock Status

● Trebuie sa aibă minim o poză

● Trebuie să aibă bifată categoria din care face parte, categorie mapată anterior la una din eMAG

● Trebuie să aibă completate toate atributele Magento asociate caracteristicilor obligatorii

● Trebuie să aibă opțiunea Visible in eMAG Marketplace setata la valoarea Yes (activat)

● Câmpul eMAG Brand trebuie să conțină o valoare din lista brand-urilor eMAG

Ultimele două câmpuri se găsesc în tab-ul eMAG Marketplace din pagina de editare produs.

39

În același tab menționat anterior se găsesc și câmpurile Warranty (Garanție) și eMAG Part Number Key

(PNK).

Câmpul Warranty reprezintă numărul lunilor de garanție și completarea acestuia este opțională. În cazul

în care câmpul nu este completat, eMAG consideră că produsul nu beneficiază de garanție.

Part Number Key este utilizat pentru a asocia un produs Magento cu un produs eMAG existent și este, de

asemenea, opțional.

Câmpul EAN este obligatoriu daca produsul face parte dintr-o categorie care are EAN obligatoriu. In caz

contrar, acesta este opțional. Câmpul acesta reprezintă codul de bare asociat produsului.

Notă: o asociere, o dată creată, nu poate fi ștearsă însă poate fi schimbată, respectiv produsul Magento

poate fi asociat altui produs eMAG.

Notă: un produs care urmeaza a fi publicat in eMag Marketplace, ar trebui sa apartina unei singure

categorii mapate (la o categorie eMag). Poate avea mai multe categorii Magento, dar numai una sa fie

mapata la o categorie eMag.

In cazul in care, pentru un produs marcat ca Visible to eMag Marketplace (bifat), la salvare primiti un

mesaj de eroare, câmpul Visible to eMag Marketplace este resetat (debifat). după rezolvarea problemei

detaliata in eroare, este necesar sa bifati din nou câmpul Visible to eMag Marketplace și sa salvati

produsul.

40

După salvarea cu succes a produsului bifat ca Visible to eMag Marketplace, nu mai este nevoie de alta

actiune pentru a publica produsul. La urmatoarea rulare automata sau manuala a cronului de publicare a

produselor, va fi publicat in platforma eMag Marketplace. In cazul unei erori la publicarea produsului, se

primeste o notificare pe adresa de email de alerta, și după rezolvarea problemei detaliate in email, se va

salva din nou produsul.

Daca aveti produse cu pret special programat sa fi activat sau dezactivat la o data anume, este necesar sa

salvati din nou acele produse pentru a fi updatate in eMag Marketplace.

După rularea cron-ului de verificare a validării produselor in eMAG Marketplace, câmpurile

Emag Status, Validation Status, Offer Validation Status, vor fi populate cu informații despre

status-ul publicarii produsului. In cazul in care documentarea produsului este respinsă la

verificarea in eMAG, după rularea cronului de preluare a status-urilor de validare, aceste erori

vor fi detaliate in câmpul Validation Status.

9. Procesarea și actualizarea comenzilor din eMAG Marketplace

Comenzile din eMAG Marketplace vor fi importate în mod automat în Magento în cazul în care aveți CRON-

urile de la punctul 5. configurate corespunzător, setările generale completate și url-ul pentru notificarea

comenzilor salvat de către echipa eMAG. De exemplu, dacă o comandă nouă este creată in eMAG

Marketplace, aceasta va fi vizibila in lista de comenzi din magazinul dumneavoastră după import.

Aceasta va conține în partea stângă doua tab-uri noi, eMag Invoice și eMag AWB.

Comenzile provenite din eMag vor avea completat câmpul Emag Order Id cu id-ul comenzii din platforma

eMAG in pagina de listare comenzi din Magento.

41

Aceste comenzi vor avea prezente și doua tab-uri noi pe pagina de vizualizare a comenzii: tab-ul eMag

AWBs și eMag Invoice Upload.

42

Comenzile noi, plasate in platforma eMag Marketplace sunt notificate automat de către eMag la plasarea

lor. Id-urile nou primite sunt salvate intr-o lista și la rularea CRON-ului de import comenzi, sunt citite și

sunt create comenzi Magento cu datele citite din eMag Marketplace. Acest lucru se face automat și nu

este nevoie de alte actiuni din partea administratorului.

In cazul unei probleme la importul comenzii, detaliile despre eroare sunt trimise pe adresa de email setata

in zona Alerts.

O comanda importata va putea fi editata si/sau stornata, in functie de statusul in care se afla, urmand

pasii Magento pentru aceste operatiuni. Actualizarea in eMag Marketplace a acestor modificari se face pe

loc, și in cazul unei erori in la actualizarea in eMag Marketplace, se va primi mesaj și nu se va putea salva

modificarea cu succes și in Magento.

Implicit, in Magento, la stornarea unei comenzi platita online, nu se declanseaza o plata automata cu

valoarea stornata către client. Daca folositi o extensie pentru procesarea platilor online, este necesar sa

va asigurati ca la stornare nu sunt efectuate automat plati inapoi către client. Daca sunt neclaritati, va

rugam sa contactati echipa eMag, pentru clarificari legate de stornarea comenzilor platite online.

10. Incărcarea facturilor

Pentru a incarca o factura a unei comenzi este necesar sa navigati pe pagina de vizualizare comandă. Acolo

veti gasi, in partea stanga tabul eMag Invoice Upload.

Dați click pe “Choose file”, alegeți factura in format PDF, apoi apăsați butonul “Upload Invoice”.

43

11. Generarea AWB-urilor

Pentru a genera un AWB pentru o comandă este necesar să navigați pe pagina de vizualizare comandă din

Sales / Orders. Selectați o comandă, apoi apăsați butonul Generate AWB.

Alegeți un curier, completați informațiile cerute și apoi apasați pe butonul „Generate AWB”.

Notă: Puteți genera mai multe AWB-uri pentru o comandă, in funcție de necesitațile dumneavoastră.

44

Important: La generarea primului AWB, comanda devine automat „finalizata” in eMag Marketplace, si

automat se sincronizeaza statusul comenzii si in Magento. Pentru a nu crea disconcordante intre comanda

eMag si comanda Magento , este necesar sa urmati pasii impliciti Magento in ordine inainte de generarea

unui AWB (facturare, livrare, si dupa acestea generare AWB). Acesti pasi nu mai pot fi facuti pe o comanda

in statusul „finalizata”.

12. Descărcarea AWB-urilor

După generarea AWB-urilor, acestea se salveaza in tab-ul eMag Awbs in stânga paginii de vizualizare a

comenzii. În coloana Action, puteți alege formatul paginii în care să se printeze Awb-ul. Acesta va fi

descărcat ca fișier PDF.

45

13. Note importante

e. TVA și Valuta

Este necesar ca valoarea TVA-ului aplicat pe produse, și valuta (currency) cu care sunt setate

prețurile în Magento să corespundă cu valoarea câmpului VAT Rate din tab-ul Products și

Currency din tab-ul Product Settings din setările extensiei eMAG Marketplace.

46

f. Alerte erori Este important să vă setați o adresă de email în zona Alert Settings pentru a primi detalii

despre posibile probleme de sincronizări de produse sau comenzi. Dacă un produs din

comandă eMag pentru care se încearcă importarea nu este găsit în Magento, nu mai este în

stoc sau apar alte excepții, comanda nu este creată în Magento, nu se mai încearcă

importarea ei și este nevoie de intervenție manuală, plecând de la detaliile din email.

g. Statusurile comenzilor

Statusul inițial al comenzilor, respectiv statusurile pentru comenzile finalizate sau anulate

trebuie configurate conform specificațiilor.

h. Modificarea comenzilor

La modificarea comenzilor aflate in statusul initial, datele clientului (nume, email, adrese)

care a plasat comanda nu se modifica in eMAG, se recomanda sa nu se modifice nici in

Magento.