Cum conectezi OpenCart cu easySales: ghid complet de integrare

De ce sa conectezi OpenCart cu easySales

Vinzi pe OpenCart si vrei un singur loc unde sa administrezi comenzile, sa generezi facturi, sa trimiti AWB-uri catre curieri si sa re-folosesti aceleasi produse ca oferte pe marketplace-uri? easySales se ocupa de tot dintr-un singur dashboard.

Odata conectat, easySales preia produsele si optiunile din OpenCart si centralizeaza comenzile primite. De acolo, generezi facturi, creezi AWB-uri cu orice curier suportat si transformi acele produse in oferte pe eMAG, Allegro, Kaufland, Trendyol si 80+ alte canale. Stocul si statusurile de comanda raman sincronizate in ambele directii.

Pornesti wizardul in easySales, descarci modulul OpenCart care se potriveste cu versiunea magazinului tau, il instalezi in admin-ul OpenCart, apoi lipesti tokenul din easySales inapoi in modul — fara cod, fara acces FTP, fara modificari de tema.

Cum functioneaza conectorul OpenCart

easySales se conecteaza la OpenCart printr-un mic modul .ocmod.zip pe care il descarci din contul tau easySales si il instalezi prin admin-ul OpenCart. Modulul expune un endpoint privat pe care easySales il apeleaza ca sa-ti citeasca catalogul si comenzile, si inregistreaza doua webhook-uri ca schimbarile de comanda si stoc sa ajunga la easySales in timp aproape real.

Modulul nu se conecteaza niciodata in afara. easySales vorbeste cu el, autentificat printr-un token pe care easySales il genereaza per website. Credentialele bazei de date OpenCart, parolele de admin si secretele de gateway raman in instalarea ta OpenCart.

Ce versiuni de OpenCart suporta easySales

easySales livreaza o varianta separata de modul pentru fiecare versiune majora OpenCart, ca integrarea sa corespunda cu API-ul si layout-ul admin al magazinului tau:

• OpenCart 1.5.6.4
• OpenCart 2.0.0.0 – 2.1.0.2
• OpenCart 2.2.0.0
• OpenCart 2.3.0.0 – 2.3.0.2
• OpenCart 3.0.0 – 3.0.2.0
• OpenCart 4.0 – 4.1.0.3

Wizardul alege varianta cand selectezi versiunea. Daca esti pe o versiune patch intre doua dintre acestea (de exemplu 2.3.0.1), se aplica varianta pentru versiunea inferioara cea mai apropiata. Distributiile OpenCart bifurcate si versiunile vechi 1.5.x nu sunt oficial suportate — modulul se poate instala, dar caile din admin pot diferi.

Tur interactiv

Nu ai chef sa citesti? Ia turul interactiv.

Cerinte preliminare — ce sa pregatesti inainte sa incepi

Cateva cerinte previn ca produsele sa fie sarite la import.

Pasul 1 — Porneste wizardul in easySales si descarca modulul

In easySales, mergi la Integrari → Magazine Online → Conecteaza Website, apoi selecteaza OpenCart si alege versiunea magazinului. Wizardul se deschide pe pasul Descarca Modulul.

Apasa butonul de descarcare ca sa obtii arhiva modulului (easysales.ocmod.zip sau un nume specific versiunii ca 2market-oc3x.ocmod.zip). Lasa acest tab deschis — te intorci la el in Pasul 3 ca sa finalizezi configurarea.

Pasul 2 — Incarca si instaleaza modulul in OpenCart

In admin-ul OpenCart, mergi la Extensii → Instaleaza Extensie. Apasa Upload, selecteaza arhiva .ocmod.zip pe care tocmai ai descarcat-o si asteapta confirmarea verde de "succes".

In continuare, deschide Extensii → Extensii, filtreaza dupa Modules in dropdown-ul de sus, gaseste easySales in lista si apasa butonul verde Instaleaza (+). Dupa instalare, apasa butonul albastru Editeaza (creion) ca sa deschizi setarile modulului — vei vedea un camp Token. Lasa acest tab deschis; vei lipi tokenul din easySales aici, la pasul urmator.

Pasul 3 — Configureaza site-ul in easySales si lipeste tokenul in OpenCart

Intoarce-te la tab-ul easySales — wizardul este acum pe pasul Configurare si afiseaza tokenul generat. Copiaza tokenul, treci inapoi la OpenCart si lipeste-l in campul Token al paginii de editare a modulului easySales. Seteaza Status la Activat, lasa restul valorilor implicite, apoi apasa Salveaza in OpenCart.

Inapoi in easySales, finalizeaza configurarea site-ului. Formularul de sub wizard contine tot ce easySales are nevoie ca sa conduca integrarea.

Nume si URL website

• Nume website — o eticheta aleasa de tine. Vizibila doar in easySales.
• URL website — adresa site-ului tau OpenCart. Foloseste URL-ul exact unde ruleaza OpenCart, inclusiv https:// si prefixul www daca domeniul tau il foloseste. Daca OpenCart traieste intr-un subdirector (example.com/shop), include-l.

TVA si TVA pentru transport

Daca esti platitor de TVA, introdu cota care se aplica produselor tale si o cota separata pentru transport (de exemplu 21 pentru cota standard din Romania actuala). Lasa gol daca nu esti platitor. Clasele de taxe OpenCart nu sunt detectate automat — cota pe care o setezi aici este cea pe care easySales o foloseste pe facturi si pe ofertele trimise spre marketplace-uri.

Limba si moneda

Alege limba magazinului (romana, bulgara, maghiara, poloneza sau engleza) si moneda (RON, BGN, HUF, PLN sau EUR). Acestea sunt valori implicite pentru produsele importate si fallback cand o comanda nu poarta o moneda explicita. Nu suprascriu niciodata comenzile individuale — fiecare comanda pastreaza moneda raportata de OpenCart.

Sursa stoc produse

Cea mai importanta decizie din formular. Spune easySales unde se afla valoarea de referinta a stocului:

• Website — OpenCart este sursa de adevar. easySales citeste stocul din OpenCart si nu il suprascrie niciodata.
• easySales — easySales este sursa de adevar. Modificarile de stoc din easySales (vanzari, editari manuale, deduceri de marketplace) sunt trimise in OpenCart.
• Integrare conectata — stocul tau se afla intr-un sistem terta deja conectat la easySales (software de facturare ca SmartBill, Oblio, Fakturownia sau FacturisOnline; un ERP precum NexusERP sau Sedona; un partener de fulfilment precum Fulfillro sau Huboxx; si multe altele). easySales citeste stocul din acea integrare si il trimite in OpenCart. Conecteaza integrarea si declara depozitul ei intai — nu poti alege aceasta optiune altfel.

Operezi cu mai multe depozite? Comuta formularul in modul Depozit avansat. In loc sa legi magazinul de o singura sursa de stoc, alegi unul sau mai multe depozite easySales si definesti cum este agregat, prioritizat sau impartit stocul lor per canal. Setup-ul standard cand acelasi catalog se livreaza din mai multe locatii sau cand canale diferite trag din depozite diferite.

Tip pachet implicit

Folosit la generarea AWB-ului cand comanda nu specifica un pachet. Alege tipul care corespunde majoritatii comenzilor tale.

Pasul 4 — Da refresh la Modificari OpenCart si finalizeaza in easySales

Acesta este pasul specific OpenCart care prinde cele mai multe conexiuni noi si trebuie sa fie ultimul lucru pe care il faci.

Deschide Extensii → Modificari OCMOD in admin-ul OpenCart si apasa butonul albastru Refresh din dreapta-sus. OpenCart compileaza override-urile ocmod la refresh — pana cand apesi, modulul este instalat dar hook-urile nu sunt active.

Acum intoarce-te in easySales si apasa Salveaza ca sa finalizezi conexiunea. easySales testeaza conexiunea, inregistreaza webhook-urile pe site-ul tau OpenCart si incepe sa importeze catalogul.

Ce se intampla automat dupa ce salvezi

easySales se ocupa de configurarea webhook-urilor si de importul initial.

1. Doua webhook-uri sunt inregistrate pe site-ul tau OpenCart: unul pentru schimbari de comenzi si unul pentru schimbari de stoc. Fiecare comanda creata, actualizata sau anulata in OpenCart ajunge in easySales in timp aproape real, si la fel pentru update-urile de stoc.
2. Catalogul de produse este importat — produsele si combinatiile lor de optiuni apar in Magazine Online → Produse, unde le poti rasfoi, edita si transforma in oferte pentru marketplace-uri.
3. Comenzile OpenCart primite apar in ecranul Comenzi, unde generezi facturi, AWB-uri si rulezi flow-uri de automatizare.
4. Stocul se sincronizeaza in functie de sursa pe care ai ales-o. Daca ai ales easySales, push-urile de stoc incep sa ruleze continuu si site-ul tau OpenCart reflecta inventarul centralizat.

Ajusteaza conexiunea OpenCart

Dupa ce salvezi, deschide tab-ul Preferinte al website-ului OpenCart. Doua grupuri de setari merita o trecere rapida.

Order Behavior

• Allow reopening completed orders — implicit, statusurile terminale ca "Complete" nu pot reveni la "Processing". Activeaza daca ai nevoie sa redeschizi comenzi.
• Allow reopening cancelled orders — aceeasi logica pentru comenzile anulate (util cand o comanda anulata temporar, neplatita, este in final platita).

Synchronization

• Fetch orders — import automat al comenzilor noi din OpenCart.
• Update order status on OpenCart — trimite schimbarile de status din easySales inapoi in OpenCart, ca ambele sisteme sa ramana sincronizate.
• Update product stock on OpenCart — trimite nivelurile de stoc din easySales catre site-ul OpenCart. Dezactiveaza daca OpenCart este sursa ta de stoc.

Apasa Salveaza in partea de jos a paginii ca sa aplici modificarile.

Optiuni, lockere si alte particularitati OpenCart

Cateva comportamente specifice OpenCart de stiut:

• Optiuni de produs. Produsele OpenCart au optiuni (marime, culoare etc.) cu SKU-uri optionale per optiune. easySales importa fiecare combinatie vandabila ca o variatie separata, legata de produsul parinte prin SKU. Daca magazinul tau foloseste optiuni fara SKU-uri, acele produse sunt importate ca o singura intrare — seteaza SKU-uri per optiune inainte de conectare daca vrei sa fie urmarite individual pe marketplace-uri.
• Lockere. Daca magazinul tau foloseste o extensie de locker suportata — Sameday EasyBox, InPost si alte retele de locker din pietele pe care le servim — easySales citeste ID-ul lockerului automat din custom fields-urile comenzii. Nu e nevoie de configurare. Lockerul e folosit apoi ca punct de livrare la generarea AWB.
• Metode de plata personalizate. OpenCart permite adaugarea oricarei metode de plata prin extensii. easySales mapeaza metodele standard (transfer bancar, ramburs, card prin gateway-urile comune) automat. Metodele non-standard vin ca Unknown — contacteaza suportul ca sa extindem maparea pentru gateway-ul tau specific.
• URL-uri de imagini. OpenCart serveste imagini din image/catalog/... relativ la radacina vitrinei. Modulul le rescrie la URL-uri absolute la export. Daca imaginile produselor nu apar in easySales, cea mai comuna cauza este lipsa fisierelor de pe disc — OpenCart inregistreaza calea chiar daca fisierul a disparut.
• Cache de modificari. Daca schimbi extensii sau teme de admin OpenCart dupa ce modulul easySales este instalat, da refresh la Extensii → Modificari OCMOD din nou. OpenCart dezactiveaza silentios override-urile ocmod la anumite update-uri de admin.
• Actualizari de modul. Cand se publica o versiune noua de modul, easySales afiseaza un avertisment rosu in Preferintele website-ului. Descarca noul build, sterge modulul vechi din admin-ul OpenCart (Extensii → Extensii → Modules → Dezinstaleaza), apoi instaleaza noua arhiva urmand Pasul 2 din nou. Salveaza si in OpenCart si in easySales, apoi da refresh la Extensii → Modificari OCMOD.
• Prefix serie factura. Daca vrei o anumita serie de facturi pe documentele generate in aval din OpenCart, seteaz-o in admin-ul OpenCart la Settings → Option → Checkout → Invoice Prefix. easySales citeste aceasta valoare odata cu comanda.

Esti conectat — ce urmeaza

Odata ce comenzile incep sa soseasca, urmatorul pas este automatizarea. Configureaza flow-uri ca sa generezi facturi, sa creezi AWB-uri si sa trimiti notificari de tracking. Daca vinzi si pe marketplace-uri, transforma catalogul OpenCart in oferte si lasa easySales sa le distribuie.