Manual:Integrat/Module/OpenCart
Rezumat[modificare]
Acest manual va ajuta sa configurati modulul OpenCart introdus in aplicatia Integrat.STS incepand cu versiunea 4.5.5 prin intermediu caruia aplicatia poate actualiza in mod automat un magazin online gestionat de platforma e-commerce OpenCart versiunea 3.0.3.1, valabil doar intr-o singura limba.
Incepem prin a va prezenta prescurtarile folosite in acest manual:
- ERP - aplicatia Integrat.STS
- OC - platforma e-commerce OpenCart
- OC:+1 - identificator generat de catre OC
- ERP:+1 - identificator generat de catre ERP
Acest modul este foarte util avand in vedere ca tabelele din ERP contin majoritatea informatiilor necesare crearii unui magazin online.
Pe langa informatiile cu care sunteti deja familiarizati:
- denumirea articolului
- grupa din care face parte
- pretul de vanzare, etc
prezentarea on-line a unui articol atrage dupa sine cateva proprietati pe care, cel mai probabil, nu le-ati folosit pana in prezent:
- brand/marca/producator
- imaginea produsului/grupei/brandului
- dimensiunile produsului
- caracteristici
- proprietati specifice magazinelor online:
- description (descriere)
- meta tag title (titlul paginii)
- meta tag description (descrierea paginii)
- meta tag keywords (cuvinte cheie)
Cum functioneaza?[modificare]
Au fost implementate trei functii principale care efectueaza sincronizarea informatiilor existente in cele doua baze de date:
- Export: sursa ERP si destinatie OC (Grupe de articole, Articole, Stocuri, Preturi, Branduri)
- Import: sursa OC si destinatie ERP (Comenzi, Clienti, Adrese)
- Export: sursa ERP si destinatie OC (Stocuri)
In continuare sunt prezentate modificarile aduse ERP-ului si rubricile care contribuie la prezentarea corecta si completa a articolelor in mediul virtual.
Grupe de articole[modificare]
Au fost adaugate rubricile:
- html Description?
- Meta Tag Title?
- Meta Tag Description?
- Meta Tag Keywords?
Acestea sunt necesare pentru definirea corecta si completa a unei grupe de articole in baza de date OC.
In cazul in care rubricile mentionate anterior se vor intretine prin intermediul OC, atunci aveti posibilitatea sa dezactivati actualizarea acestora de catre ERP.
Pentru ca o grupa de articole sa ajunga sa fie publicata, trebuie sa aiba completata rubrica “Ordine” cu o valoare mai mare decat zero.
Structura arborescenta a grupelor va fi publicata ca atare. Ordinea de afisare pe site a grupelor o impune valoarea completata in rubrica “Ordine”.
Caracteristicile definite la nivelul grupei de articole, impreuna cu valorile lor stabilite la nivelul fiecarui articol, sunt destinate sa constituie zona de filtrare, respectiv zona de specificatii care ajuta la compararea articolelor.
oc_category[modificare]
| oc_category | |||
|---|---|---|---|
| camp | explicatie | adaugare | modificare |
| category_id | ID-ul categoriei | OC:+1 | ERP |
| image | calea si numele fisierului care contine imaginea | ERP: imagini.imagine | ERP/OC |
| parent_id | ID-ul categoriei parinte | OC:+1 | ERP |
| top | 1= vizibila 0= invizibila |
ERP: 1 implicit | ERP/OC |
| column | numarul coloanei pe care se doreste afisarea grupei in cazul subgrupelor | ERP: 0 implicit | OC |
| sort_order | Ordinea de afisare a grupelor | ERP: ordine | ERP/OC |
| status | 1= activa 0= inactiva |
ERP: 1 implicit | ERP/OC |
| category_id_sts | ID-ul categoriei din ERP | ERP:+1 | ERP |
| checksum_sts | ID integritate | ERP:+X | ERP |
oc_category_description[modificare]
| oc_category_description | |||
|---|---|---|---|
| camp | explicatie | adaugare | modificare |
| category_id | ID-ul categoriei | OC:+1 | ERP |
| language_id | ID-ul limbii | OC:+1 | ERP:+setari |
| name | denumirea grupei de articole | ERP:denumire | ERP |
| description | descrierea grupei de articole | ERP:html_desc | ERP/OC |
| meta_title | meta titlu | ERP:meta_titlu | ERP/OC |
| meta_description | meta descriere | ERP:meta_desc | ERP/OC |
| meta_keyword | meta keyword | ERP:meta_key | ERP/OC |
| category_id_sts | ID-ul categoriei din ERP | ERP:+1 | ERP |
| checksum_sts | ID integritate | ERP:+X | ERP |
Informatiile din urmatoarele tabele sunt gestionate in totalitate de ERP:
oc_attribute, oc_attribute_description, oc_attribute_group, oc_attribute_group_description, oc_category_path, oc_category_to_store, oc_category_filter, oc_filter, oc_filter_description, oc_filter_group, oc_filter_group_description, oc_manufacturer, oc_manufacturer_to_store
Catalog articole[modificare]
Au fost adaugate rubricile:
- html Description?
- Meta Tag Title?
- Meta Tag Description?
- Meta Tag Keywords?
Acestea sunt necesare pentru definirea corecta si completa a unui articol in baza de date OC.
In cazul in care rubricile mentionate anterior se vor intretine prin intermediul OC, atunci aveti posibilitatea sa dezactivati actualizarea acestora de catre ERP.
Pentru caracteristicile definite la nivelul grupei de articole, se pot declara valorile pentru fiecare articol. Aceste valori sunt destinate sa constituie zona de filtrare, respectiv zona de specificatii care ajuta la compararea articolelor.
oc_product[modificare]
| oc_product | |||
|---|---|---|---|
| camp | explicatie | adaugare | modificare |
| product_id | id-ul produsului | OC:+1 | ERP |
| model | codul de articol | ERP: cod | ERP |
| quantity | stoc | ERP: stoc | ERP |
| stock_status_id | 1= in stoc, 2= precomanda, 3= fara stoc | ERP: automat ? | ERP |
| image | calea si numele fisierului care contine imaginea | ERP: imagini.imagine | ERP / OC |
| shipping | pentru articole care necesita transport 1= necesita, 0 = nu necesita (ex:licente) | ERP: 1 implicit | ERP / OC |
| price | pretul cu tva | ERP: pret cu tva din lista de preturi de vanzare aferenta site-ului | ERP |
| tax_class_id | id-ul clasei de taxare | ERP: 0 implicit | ERP |
| weight | greutate exprimata in kg | ERP: kg/um | ERP |
| weight_class_id | id-ul clasei de greutate | ERP: 0 implicit | ERP |
| length | lungime exprimata in cm | ERP: lungime | ERP |
| length_class_id | id-ul clasei de lungime | ERP: 1 implicit | ERP |
| width | latime exprimata in cm | ERP: latime | ERP |
| height | inaltime exprimata in cm | ERP: inaltime | ERP |
| substract | 1= scade din stoc cantitatea comandata la finalizarea cosului, 0= nu scade stocul | ERP: 1 implicit | ERP |
| minimum | cantitatea minima pentru comanda | ERP: cantitate minima comanda client | ERP |
| status | 1= activa; 0= inactiva | ERP: 1 daca stoc >0 | ERP |
| product_id_sts | codul de articol | ERP | ERP |
| checksum_sts | id integritate | ERP:+X | ERP |
oc_product_description[modificare]
| oc_product_description | |||
|---|---|---|---|
| camp | explicatie | adaugare | modificare |
| product_id | id-ul produsului | ERP | ERP |
| language_id | id-ul limbii | ERP: 1 implicit | ERP |
| name | denumire | ERP: denumire | ERP |
| description | descriere | ERP: html descriere | ERP / OC |
| tag | meta-tag | ERP: meta-tag | ERP / OC |
| meta_title | meta-titlu | ERP: meta-titlu | ERP/ OC |
| meta_description | meta-descriere | ERP: meta-descriere | ERP/ OC |
| meta_keyword | meta-cuvinte cheie | ERP: meta-keyword | ERP/ OC |
| product_id_sts | codul produsului | ERP | ERP |
| checksum_sts | id integritate | ERP:+X | ERP |
oc_product_discount[modificare]
| oc_product_description | |||
|---|---|---|---|
| camp | explicatie | adaugare | modificare |
| product_discount_id | id-ul discountului | OC | OC |
| product_id | id-ul produsului | OC/ERP | OC/ERP |
| customer_group_id | id-ul grupului de clienti | ERP: 1 implicit | ERP |
| quantity | cantitatea minima la care se aplica discountul | ERP: minim | ERP |
| priority | prioritatea | ERP: calculata in functie de cantitatea minima | ERP / OC |
| price | pretul cu TVA | ERP: pret cu TVA calculat prin aplicarea discountului la pretul cu TVA al listei | ERP |
| date_start | data de inceput | ERP: nefolosit | ERP / OC |
| date_end | data de sfarsit | ERP: nefolosit | ERP / OC |
| product_discount_id_sts | id-ul unic al discountului generat de ERP | ERP: meta-keyword | ERP/ OC |
| product_id_sts | codul produsului | ERP | ERP |
| checksum_sts | id integritate | ERP:+X | ERP |
oc_product_image[modificare]
| oc_product_image | |||
|---|---|---|---|
| camp | explicatie | adaugare | modificare |
| product_image_id | ID-ul imaginii produsului | OC:+1 | OC |
| product_id | ID-ul produsului | OC:+1 | OC |
| image | calea si numele fisierului care contine imaginea | ERP: imagini.imagine | ERP / OC |
| sort_order | Ordinea de afisare a imaginilor | ERP: 0 implicit | ERP / OC |
| checksum_sts | ID integritate | ERP:+X | ERP |
oc_manufacturer[modificare]
| oc_manufacturer | |||
|---|---|---|---|
| camp | explicatie | adaugare | modificare |
| manufacturer_id | ID-ul brandului | OC:+1 | OC |
| name | Denumire | ERP: denumire | ERP |
| image | calea si numele fisierului care contine imaginea | ERP: imagini.imagine | ERP / OC |
| sort_order | Ordinea de afisare a brandurilor | ERP: 0 implicit | ERP / OC |
| manufacturer_id_sts | Codul brandului | ERP:+1 | ERP |
| checksum_sts | ID integritate | ERP:+X | ERP |
oc_product_special[modificare]
| oc_product_special = oferte de pret promotionale | |||
|---|---|---|---|
| camp | explicatie | adaugare | modificare |
| product_special_id | ID-ul produsului special | OC:+1 | ERP |
| product_id | ID-ul produsului din OC | OC/ERP | OC/ERP |
| customer_group_id | ID-ul grupului de clienti | OC/ERP | OC/ERP |
| priority | prioritarea in cazul in care exista mai multe oferte pe acelasi articol | ERP/OC | ERP/OC |
| price | pretul de vanzare cu TVA | ERP/OC | ERP/OC |
| date_start | data de inceput a ofertei | ERP/OC | ERP/OC |
| date_end | data de sfarsit a ofertei | ERP/OC | ERP/OC |
| product_id_sts | ID-ul produsului din ERP | ERP:+1 | ERP |
| product_special_id_sts | ID-ul special al produsului generat de ERP | ERP:+1 | ERP |
| checksum_sts | ID integritate | ERP:+X | ERP |
oc_banner_image[modificare]
| oc_banner_image = produse promovate | |||
|---|---|---|---|
| camp | explicatie | adaugare | modificare |
| banner_image_id | ID-ul imaginii | OC:+1 | ERP |
| banner_id | ID-ul bannerului | OC/ERP | ERP:+setari |
| language_id | ID-ul limbii | OC/ERP | ERP:+setari |
| title | denumirea | ERP:denumire articol | ERP/OC |
| link | calea catre articol | ERP | ERP/OC |
| image | calea catre imagine | ERP | ERP/OC |
| sort_order | ordinea de afisare | ERP | ERP/OC |
| banner_image_id_sts | ID-ul categoriei din ERP | ERP:+1 | ERP |
| checksum_sts | ID integritate | ERP:+X | ERP |
Gestiune[modificare]
Pentru a putea exporta catre site in cadrul conectorului, trebuie sa se completeze rubrica Gestiune cu gestiunea corespunzatoare conexiunii respective prin selectarea acesteia din catalogul de gestiuni.
Atentie! In catalogul Preturi vanzare trebuie sa existe cel putin o lista de pret activa pentru gestiunea selectata si deasemenea trebuie sa fie bifata optiunea Oferta site.
Activare FTP[modificare]
Pentru a putea realiza conexiunea la serverul FTP trebuiesc completate rubricile"
| Server FTP | |||
|---|---|---|---|
| denumire | tip | explicatie | |
| Activare FTP | L(1) | 0 = inactiv, 1 = activ | |
| Server* | C(100) | exemplu.ro (pentru a verifica conexiunea se apasa click pe eticheta Server*) | |
| Port | N(10) | daca nu se atribuie un port, se completeaza automat cu 21 in momentul deschiderii conexiunii | |
| Director | C(100) | /exemplu.ro/image/catalog/demo/ (calea absoluta catre directorul care contine imaginile) | |
| Subdirector | C(100) | in cazul OC nu trebuie completat | |
| Utilizator | C(50) | numele de utilizator pentru conectare la serverul FTP | |
| Parola | C(50) | parola pentru conectare la serverul FTP | |
| Conectare AuthTLS | L(1) | 0 = inactiv, 1 = activ (daca conectarea se realizeaza printr-un certificat) | |
| Certificat | L(1) | fisierul care contine certificatul (daca conectarea se realizeaza printr-un certificat) | |
Activare ODBC[modificare]
| Server ODBC | |||
|---|---|---|---|
| denumire | tip | explicatie | |
| Activare ODBC | L(1) | 0 = inactiv, 1 = activ | |
| Server* | C(100) | exemplu.ro (pentru a verifica conexiunea se apasa click pe eticheta Server*) | |
| Port | N(10) | daca nu se atribuie un port, se completeaza automat cu 3306 in momentul deschiderii conexiunii | |
| Driver | C(100) | MySQL ODBC 3.51 Driver | |
| Baza de date | C(100) | denumirea bazei de date | |
| Utilizator | C(50) | numele de utilizator pentru conectare la baza de date | |
| Parola | C(50) | parola pentru conectare la baza de date | |
Status comanda[modificare]
- 1 = Asteptare
- 2 = Preluata
- 3 = In Lucru
- 4 = intern
- 5 = intern
- 6 = intern
- 7 = Pregatita
- 8 = Facturata
- 9 = Incasata
- 99 = Anulata
Pas cu pas[modificare]
Se adauga conectorul de tip FO-OC prin intermediul ferestrei Cataloage/EDI - Conectori si se verifica daca cele doua conexiuni sunt completate corect prin apelarea rubricii Server* la fiecare in parte.
Se completeaza corect variabilele sts descrise in aceasta pagina.
Se uploadeaza imaginile articolelor.
FAQ[modificare]
De ce nu ajung articolele promovate in sliderul principal?[modificare]
Pentru ca un articol sa fie prezentat in slider :
- in catalogul Preturi vanzare
- rubrica Promovat trebuie sa fie bifata
- rubrica Pret trebuie sa fie diferita de ZERO
- rubrica Blocat trebuie sa nu fie bifata
- articolul sa aiba imagine atasata
De ce nu ajung brandurile pe site (Brands/Manufacturers)?[modificare]
Pentru ca un brand definit in catalogul de branduri din aplicatie sa fie vizibil pe site, trebuie sa existe cel putin un articol care indeplineste conditiile de publicare pe site a carui rubrica a fost completata cu brandul respectiv.
Brandurile care nu au fost alocate nici unui articol nu vor fi adaugate in tabela oc_manufacturers.
De ce nu apar brandurile in banner-ul specific pe site (Brands/Manufacturers)?[modificare]
Aparitia brandului in cadrul banner-ul specific pe site depinde de:
- completarea corecta a variabilei sts__brand_banner_id; de obicei acest id este 8 si se regaseste in tabelul oc_banner si oc_banner_image cu titlul Manufacturers. Daca dezvoltatorul site-ului foloseste alt id pentru pentru branduri, trebuie completata variabila sts__brand_banner_id cu id-ul respectiv.
- brandul trebuie sa aiba atasata o imagine si aceasta sa fie prezenta pe site
Dupa upload-ul imaginii pe site prin intermediul ferestrei Imagini, trebuie efectuat un Export catre site din meniul Front office.
De ce se vad si brandurile implicite?[modificare]
Aplicatia actualizeaza prin adaugare sau stergere doar imaginile brandurilor care sunt gestionate de aplicatie. Acestea au rubrica banner_image_id_sts completata cu id-ul din baza de date a aplicatiei. Imaginile implicite se pot sterge doar manual de catre dezvoltatorul site-ului.
De ce anumite articole nu sunt disponibile pe site?[modificare]
In functie de setarile variabilelor sts, aplicatia completeaza rubrica Status aferenta articolului cu valoarea 0=inactiv sau cu valoarea 1=activ.
Articolele marcate cu 0=inactiv nu vor fi active pentru comanda pe site.
- sts_export_pret_completat = 1, atunci se vor exporta doar articolele care au stabilit pret de vanzare si nu sunt blocate
- sts_export_pret_completat = 0, atunci se vor exporta toate articolele din catalog
- articolele fara pret sau blocate nu vor fi sterse de pe site, va fi modificat doar statusul acestora in 0=inactiv
Ofertele promotionale[modificare]
Ofertele promotionale sunt declarate in ERP ca si liste de pret completand perioada de valabilitate si cu legatura la lista de baza (4.generala cu legatura promotionala). Acestea sunt inregistrate in tabelul oc_product_special. Lista trebuie sa fie neaparat legata la o lista de baza pentru a se putea stabili pretul anterior si cel aferent promotiei. Pe site se vor afisa ambele preturi dar cel din lista de baza va fi taiat 15.25 iar cel nou va fi normal 14.98.
Articolele aflate in promotie au pret final, nu se mai acorda discount pentru volum.
Trebuie avut in vedere ca ERP-ul poate acorda acest tip de discount inclusiv pentru acest tip de discount. De preferat ca acestor oferte sa nu li se adauge discount pentru volum.
Produsele promovate[modificare]
Produsele promovate se marcheaza in listele de pret de vanzare si apar in sliderul/bannerul de pe pagina principala. Acestea sunt inregistrate in tabelul oc_banner_image.
Preturi vanzare[modificare]
Pentru clientii care nu fac parte dintr-un grup preturile sunt obtinute din listele de pret care au bifata rubrica Oferta site.
Listele de pret aferente clientilor se pot publica:
- lista de pret trebuie sa fie o lista de pret la care a fost specificat clientul
- rubrica Tip tert aferenta clientului selectat in lista sa fie completata cu un tip de tert care are completata rubrica ID
Variabile[modificare]
| oc_manufacturer | |||
|---|---|---|---|
| denumire | tip | explicatie | |
| sts__brand_banner_id | L(1) | implicit 0 (banerul pentru producatori poate fi 8, de verificat in OC) | |
| sts__promovat_banner_id | L(1) | implicit 0 (banerul pentru articole promovare (slider) poate fi 7, de verificat in OC) | |
| sts__customer_group_id | L(1) | implicit 1 | |
| sts__language_id | L(1) | implicit 1 | |
| sts__store_id | L(1) | implicit 0 | |
| sts_export | L(1) | 0 = inactiv, 1 = activ | |
| sts_export_pret_completat | L(1) | 0 = inactiv, 1 = activ | |
| sts_export_status_influentat_de_pret | L(1) | 0 = inactiv, 1 = activ | |
| sts_export_status_influentat_de_stoc | L(1) | 0 = inactiv, 1 = activ | |
| sts_export_stoc | L(1) | 0 = inactiv, 1 = activ | |
| sts_export_stoc_minus_comandat | L(1) | 0 = inactiv, 1 = activ | |
| sts_export_stoc_pozitiv | L(1) | 0 = inactiv, 1 = activ | |
| sts_import | L(1) | 0 = inactiv, 1 = activ | |
| sts_imagini | L(1) | 0 = inactiv, 1 = activ | |
| sts_imagini_director_local | C(100) | C:\Imagini | |
| sts_imagini_director_server | C(100) | catalog/demo/ | |
| sts_imagini_xml_md5 | C(100) | exemplu.ro/image/catalog/demo/xmlmd5.php | |
Tips[modificare]
- sts_imagini_xml_md5 = exemplu.ro/oc/image/catalog/demo/xmlmd5.php
- sts_imagini_director_server = catalog/demo/
- FTP:Director = /public_html/oc/image/catalog/demo
- https://www.softteam.ro/update/integrat/oc/xmlmd5.txt > exemplu.ro/oc/image/catalog/demo/xmlmd5.php