Manual:Integrat/Module/EMAG: Diferență între versiuni
Avir (discuție | contribuții) |
Avir (discuție | contribuții) |
||
| (Nu s-au afișat 37 de versiuni intermediare efectuate de același utilizator) | |||
| Linia 1: | Linia 1: | ||
== Rezumat == | == Rezumat == | ||
Acest manual va ajuta sa configurati modulul EMAG introdus in aplicatia Integrat.STS incepand cu versiunea 5.1.7 prin | Acest manual va ajuta sa configurati modulul EMAG introdus in aplicatia Integrat.STS incepand cu versiunea 5.1.7 prin intermediul caruia aplicatia poate interactiona cu platforma marketplace.emag.ro prin intermediul functiilor API puse la dispozitia dezvoltatorilor. | ||
*platforma = marketplace-api.emag.ro | *platforma = marketplace-api.emag.ro | ||
| Linia 9: | Linia 9: | ||
marketplace-api.emag.ro/api-3/order/count si marketplace-api.emag.ro/api-3/order/read | marketplace-api.emag.ro/api-3/order/count si marketplace-api.emag.ro/api-3/order/read | ||
Prin intermediul acestor functii se descarca comenzile primite de la clienti. La | Prin intermediul acestor functii se descarca comenzile primite de la clienti. La apelarea acestor functii se folosesc: | ||
- data de inceput - de la data | - data de inceput - de la data | ||
| Linia 15: | Linia 15: | ||
- data de sfarsit - pana la data | - data de sfarsit - pana la data | ||
- status - Anulate, Noi, Procesate, Pregatite, Finalizate, Stornate | - status - Anulate, Noi, Procesate, Pregatite, Finalizate, Stornate | ||
===Facturi clienti=== | ===Facturi clienti=== | ||
| Linia 33: | Linia 31: | ||
===pagina Comenzi=== | ===pagina Comenzi=== | ||
In aceasta pagina sunt afisate comenzile primite de la clienti pe | In aceasta pagina sunt afisate comenzile primite de la clienti pe platforma. La preluarea comenzii se completeaza automat numarul de referinta (Nr.Ref) cu numarul comenzii alocate de platforma si se adauga : | ||
La preluarea comenzii se completeaza automat numarul de referinta (Nr.Ref) cu numarul comenzii alocate de platforma si se adauga : | |||
- #EMAG la comenzile primite | - #EMAG la comenzile primite | ||
- #EMAG# la stornari | - #EMAG# la stornari | ||
Prin intermediul acestui numar se va pastra legatura cu | |||
Pentru generarea facturilor trebuie sa se selecteze comenzile prin bifarea acestora manual (rubrica *) sau prin selectarea automata care se efectueaza prin apasarea butonului | Prin intermediul acestui numar se va pastra legatura cu platforma. | ||
Pentru generarea facturilor trebuie sa se selecteze comenzile prin bifarea acestora manual (rubrica *) sau prin selectarea automata care se efectueaza prin apasarea butonului '''Selectare''' urmata de apasarea butonului '''Generare facturi'''. In cazul in care o comanda nu se poate factura trebuie verificata rubrica explicatie. | |||
===pagina Miscari=== | ===pagina Miscari=== | ||
| Linia 44: | Linia 45: | ||
===pagina Facturi=== | ===pagina Facturi=== | ||
In aceasta pagina sunt afisate facturile emise catre clienti pe | In aceasta pagina sunt afisate facturile emise catre clienti pe platforma. Publicarea facturilor pe platforma se poate efectua dupa generarea acestora in pagina '''Comenzi'''. Pentru publicare trebuie sa se selecteze facturile prin bifarea acestora manual (rubrica *) sau prin selectarea automata care se efectueaza prin apasarea butonului '''Selectare''' urmata de apasarea butonului '''Publicare facturi'''. | ||
Publicarea consta in: | Publicarea consta in: | ||
| Linia 54: | Linia 55: | ||
3. adaugarea unui link catre factura urcata pe site-ul dvs. pe platforma | 3. adaugarea unui link catre factura urcata pe site-ul dvs. pe platforma | ||
Trebuie avut in vedere ca facturile trebuie sa ramana pe site-ul dvs. deoarece platforma nu pastreaza decat link-ul catre factura. In cazul in care aceste facturi se sterg de pe site-ul dvs. | Trebuie avut in vedere ca facturile trebuie sa ramana pe site-ul dvs. deoarece platforma nu pastreaza decat link-ul catre factura. In cazul in care aceste facturi se sterg de pe site-ul dvs. acestea nu vor mai fi disponibile pe platforma. | ||
===pagina Articole=== | ===pagina Articole=== | ||
In aceasta pagina sunt afisate articolele publicate pe platforma. | In aceasta pagina sunt afisate articolele publicate pe platforma. Pentru descarcarea acestora trebuie apasat butonul '''Descarcare articole'''. Vor fi considerate articole cu probleme acele articole care nu au fost echivalate/mapate. | ||
Pentru descarcarea acestora trebuie apasat butonul | |||
Vor fi considerate articole cu probleme acele articole care nu au fost echivalate/mapate. | |||
Tabelul contine: | Tabelul contine: | ||
- Cod - codul articolului din baza dvs. de date | - Cod - codul articolului din baza dvs. de date | ||
- Denumire - denumirea articolului din baza dvs. de date | - Denumire - denumirea articolului din baza dvs. de date | ||
- Cod2 - codul articolului din baza de date a platformei | - Cod2 - codul articolului din baza de date a platformei | ||
- Denumire2 - denumirea articolului din baza de date a platformei | - Denumire2 - denumirea articolului din baza de date a platformei | ||
- CodExtern - codul atribuit de platforma | - CodExtern - codul atribuit de platforma | ||
- CodExtern2 - cod suplimentar atribuit de platforma | - CodExtern2 - cod suplimentar atribuit de platforma | ||
Legatura intre articolele din baza dvs. de date si cele din baza de date a platformei se realizeaza prin intermediul rubricii | |||
Echivalarea/maparea se realizeaza astfel: | Legatura intre articolele din baza dvs. de date si cele din baza de date a platformei se realizeaza prin intermediul rubricii '''Cod2'''. Echivalarea/maparea se realizeaza astfel: | ||
- deschidere fereastra | |||
- deschidere fereastra '''Catalog articole''' | |||
- cautare articol | - cautare articol | ||
- modificare articol | - modificare articol | ||
- | |||
- apasare buton | - selectarea paginii '''Echivalente''' | ||
- apasare buton '''Editare echivalente''' | |||
- se completeaza | - se completeaza | ||
-- Tip = Cod bare | -- Tip = Cod bare | ||
-- Cod = Cod2 (ex. 500#EMAG | |||
-- Cod = Cod2 (ex. 500#EMAG) | |||
-- Denumire = EAN-128 | -- Denumire = EAN-128 | ||
- urmat de apasarea butonului | |||
La revenirea in pagina | - urmat de apasarea butonului '''OK''' si apoi a butonului '''Salvare''' | ||
La revenirea in pagina '''Articole''', dupa adaugarea unei echivalente, se apasa butonul '''Actualizare'''. | |||
==Conector== | |||
Pentru activarea conectorului sunt necesare urmatoarele informatii: | |||
platforma (API) | |||
- numele utilizatorului pentru accesarea platformei | |||
- parola pentru accesarea platformei | |||
- tabela in care se vor inregistra vanzarile | |||
- tipul documentului folosit pentru vanzare | |||
- articolul folosit pentru transport | |||
- procentul de TVA care se aplica la transport | |||
- articolul folosit pentru voucher | |||
- moneda in care se emite factura | |||
- numarul de zecimale pentru rotunjiri | |||
- Livrare OSS | |||
date despre conectarea la site-ul dvs. (FTP) | |||
- adresa serverului | |||
- directorul FTP in care se vor urca facturile = /public_emag/facturi/ | |||
- utilizator | |||
- parola | |||
Activarea se realizeaza prin bifarea rubricilor '''Activare FTP''' si '''Activare API'''. | |||
In cazul in care utilizatorul FTP are acces direct in directorul de facturi, campul director FTP poate ramane necompletat, deoarece aplicatia nu mai trebuie sa schimbe directorul dupa conectare. | |||
In cazul in care se doreste schimbarea directorului in care se urca facturile atunci aceasta modificare trebuie realizata si in get_invoice.php. | |||
==Site-ul dvs.== | |||
Facturile sunt stocate intr-un director inaccesibil direct prin web. | |||
Accesul public se realizeaza exclusiv prin endpointul '''get_invoice.php''', care valideaza cererea si livreaza numai fisierele permise din directorul configurat. | |||
Aceasta functie trebuie plasata in '''public_html/api/emag/get_invoice.php'''. | |||
Linkul care se trimite pe platforma: | |||
<nowiki>https://site-ul-dvs.ro/</nowiki>'''api/emag/get_invoice.php'''?'''filename=EXEMPLU-FACTURA.pdf''' | |||
unde: | |||
api/emag/get_invoice.php = locatia implicita - nu poate fi modificata | |||
0000001 = numarul comenzii alocate de platforma | |||
EMAG = numele conectorului | |||
100.00 = valoarea facturii | |||
FV = tipul de document (factura de vanzare) | |||
ONLINE = seria facturii | |||
00001 = numarul facturii | |||
20.01.2021 = data facturii | |||
Aici https://www.softteam.ro/update/integrat/emag/get_invoice.txt gasiti sursa pentru fisierul get_invoice.php care trebuie salvat in locatia site-ul-dvs.ro/api/emag/get_invoice.php. | |||
In cadrul acestui fisier trebuie sa se modifice '''###root###''' prin atribuirea valorii corecte. | |||
Versiunea curentă din 3 septembrie 2026 07:57
Rezumat
Acest manual va ajuta sa configurati modulul EMAG introdus in aplicatia Integrat.STS incepand cu versiunea 5.1.7 prin intermediul caruia aplicatia poate interactiona cu platforma marketplace.emag.ro prin intermediul functiilor API puse la dispozitia dezvoltatorilor.
- platforma = marketplace-api.emag.ro
Functii API
Comenzi clienti
marketplace-api.emag.ro/api-3/order/count si marketplace-api.emag.ro/api-3/order/read
Prin intermediul acestor functii se descarca comenzile primite de la clienti. La apelarea acestor functii se folosesc:
- data de inceput - de la data
- data de sfarsit - pana la data
- status - Anulate, Noi, Procesate, Pregatite, Finalizate, Stornate
Facturi clienti
marketplace-api.emag.ro/api-3/order/attachments/save
Prin intermediul acestei functii se va crea o legatura pe site-ul EMAG catre factura generata in format PDF si urcata pe site-ul dvs.
Articole
marketplace-api.emag.ro/api-3/product_offer/read si marketplace-api.emag.ro/api-3/product_offer/count
Prin intermediul acestei functii se descarca catalogul dvs. de articole de pe platforma.
Fereastra API - Comenzi
pagina Comenzi
In aceasta pagina sunt afisate comenzile primite de la clienti pe platforma. La preluarea comenzii se completeaza automat numarul de referinta (Nr.Ref) cu numarul comenzii alocate de platforma si se adauga :
- #EMAG la comenzile primite
- #EMAG# la stornari
Prin intermediul acestui numar se va pastra legatura cu platforma.
Pentru generarea facturilor trebuie sa se selecteze comenzile prin bifarea acestora manual (rubrica *) sau prin selectarea automata care se efectueaza prin apasarea butonului Selectare urmata de apasarea butonului Generare facturi. In cazul in care o comanda nu se poate factura trebuie verificata rubrica explicatie.
pagina Miscari
In aceasta pagina sunt prezentate miscarile aferente comenzilor primite pe platforma. Este utila pentru momentele in care comanda nu poate fi facturata deoarece prezinta fiecare rand din comanda si eventualele probleme (cod nemapat).
pagina Facturi
In aceasta pagina sunt afisate facturile emise catre clienti pe platforma. Publicarea facturilor pe platforma se poate efectua dupa generarea acestora in pagina Comenzi. Pentru publicare trebuie sa se selecteze facturile prin bifarea acestora manual (rubrica *) sau prin selectarea automata care se efectueaza prin apasarea butonului Selectare urmata de apasarea butonului Publicare facturi.
Publicarea consta in:
1. crearea facturii in format PDF
2. urcarea facturii pe site-ul dvs. intr-un director care nu este vizibil pe web
3. adaugarea unui link catre factura urcata pe site-ul dvs. pe platforma
Trebuie avut in vedere ca facturile trebuie sa ramana pe site-ul dvs. deoarece platforma nu pastreaza decat link-ul catre factura. In cazul in care aceste facturi se sterg de pe site-ul dvs. acestea nu vor mai fi disponibile pe platforma.
pagina Articole
In aceasta pagina sunt afisate articolele publicate pe platforma. Pentru descarcarea acestora trebuie apasat butonul Descarcare articole. Vor fi considerate articole cu probleme acele articole care nu au fost echivalate/mapate.
Tabelul contine: - Cod - codul articolului din baza dvs. de date
- Denumire - denumirea articolului din baza dvs. de date
- Cod2 - codul articolului din baza de date a platformei
- Denumire2 - denumirea articolului din baza de date a platformei
- CodExtern - codul atribuit de platforma
- CodExtern2 - cod suplimentar atribuit de platforma
Legatura intre articolele din baza dvs. de date si cele din baza de date a platformei se realizeaza prin intermediul rubricii Cod2. Echivalarea/maparea se realizeaza astfel:
- deschidere fereastra Catalog articole
- cautare articol
- modificare articol
- selectarea paginii Echivalente
- apasare buton Editare echivalente
- se completeaza
-- Tip = Cod bare
-- Cod = Cod2 (ex. 500#EMAG)
-- Denumire = EAN-128
- urmat de apasarea butonului OK si apoi a butonului Salvare
La revenirea in pagina Articole, dupa adaugarea unei echivalente, se apasa butonul Actualizare.
Conector
Pentru activarea conectorului sunt necesare urmatoarele informatii:
platforma (API)
- numele utilizatorului pentru accesarea platformei
- parola pentru accesarea platformei
- tabela in care se vor inregistra vanzarile
- tipul documentului folosit pentru vanzare
- articolul folosit pentru transport
- procentul de TVA care se aplica la transport
- articolul folosit pentru voucher
- moneda in care se emite factura
- numarul de zecimale pentru rotunjiri
- Livrare OSS
date despre conectarea la site-ul dvs. (FTP)
- adresa serverului
- directorul FTP in care se vor urca facturile = /public_emag/facturi/
- utilizator
- parola
Activarea se realizeaza prin bifarea rubricilor Activare FTP si Activare API.
In cazul in care utilizatorul FTP are acces direct in directorul de facturi, campul director FTP poate ramane necompletat, deoarece aplicatia nu mai trebuie sa schimbe directorul dupa conectare.
In cazul in care se doreste schimbarea directorului in care se urca facturile atunci aceasta modificare trebuie realizata si in get_invoice.php.
Site-ul dvs.
Facturile sunt stocate intr-un director inaccesibil direct prin web.
Accesul public se realizeaza exclusiv prin endpointul get_invoice.php, care valideaza cererea si livreaza numai fisierele permise din directorul configurat.
Aceasta functie trebuie plasata in public_html/api/emag/get_invoice.php.
Linkul care se trimite pe platforma:
https://site-ul-dvs.ro/api/emag/get_invoice.php?filename=EXEMPLU-FACTURA.pdf
unde:
api/emag/get_invoice.php = locatia implicita - nu poate fi modificata
0000001 = numarul comenzii alocate de platforma
EMAG = numele conectorului
100.00 = valoarea facturii
FV = tipul de document (factura de vanzare)
ONLINE = seria facturii
00001 = numarul facturii
20.01.2021 = data facturii
Aici https://www.softteam.ro/update/integrat/emag/get_invoice.txt gasiti sursa pentru fisierul get_invoice.php care trebuie salvat in locatia site-ul-dvs.ro/api/emag/get_invoice.php.
In cadrul acestui fisier trebuie sa se modifice ###root### prin atribuirea valorii corecte.