Cuprins
1PowerSync într-un minut
Trei lucruri circulă între gestiune și magazin. Toate trei se fac singure.
Produsele
Denumire, preț, stoc, TVA, categorie și brand: tot ce e în gestiune apare și în magazin.
gestiune → magazinClienții
Partenerii se creează în gestiune, cu adresa lor de email, și apar și în magazin, legați de codul lor de partener.
gestiune → magazinComenzile
Comenzile din magazin intră în gestiune ca documente de validat. Nimic nu se facturează fără tine.
magazin → gestiunePowerSync e un singur program, PowerSync.exe. Nu are bază de date proprie și nu trebuie instalat: se copiază într-un folder și gata.
2Ziua ta cu PowerSync
Așa arată o zi obișnuită după ce programarea e făcută. Singurul pas al tău e marcat cu portocaliu.
- noapteaProdusele și clienții se actualizează în magazin. Prețurile, stocurile și clienții noi din gestiune ajung online. Câteva mii de produse durează câteva secunde.
- toată ziuaClienții comandă în magazin. PowerSync verifică des comenzile noi, de exemplu la 15 minute.
- când vreiDeschizi gestiunea și validezi comenzile noi.pasul tău
Le găsești la comenzi, ca documente nefinalizate, cu număr de document deja pus. Le verifici și le finalizezi ca pe orice comandă. - a doua ziStocul scăzut la validare ajunge în magazin. Clienții văd mereu ce ai cu adevărat în depozit.
Trei semne că totul merge
=== END SYNC ===, fără [ERROR].3Cum fac…?
Situațiile de zi cu zi. Deschide-o pe cea de care ai nevoie.
Pun un produs nou în magazinîn gestiune
- Adaugi produsul în gestiune, ca de obicei: denumire, preț, stoc, subgrupă.
- Atât. La următoarea sincronizare a produselor apare și în magazin. Dacă nu vrei să aștepți, dai dublu-clic pe
SyncProducts.bat.
Rezultat: produsul e activ în magazin, în categoria potrivită subgrupei lui. Poza și descrierea le pui în magazin; acolo rămân.
Schimb un preț sau un stocîn gestiune
- Modifici prețul sau stocul în gestiune. Prețul se trece fără TVA, ca de obicei.
- La următoarea sincronizare, magazinul îl preia și adaugă singur TVA-ul (11% sau 21%, după cota produsului).
Rezultat: în magazin, prețul apare cu TVA, calculat din prețul fără TVA din gestiune.
Nu schimba prețul sau stocul direct în magazin: la următoarea sincronizare se rescrie cu valoarea din gestiune.
Validez o comandă venită din magazinîn gestiune
PowerSync a pus deja comanda în gestiune. O recunoști ușor:
| Nr. doc. | Serie | Client | Introdusă de | Stare |
|---|---|---|---|---|
| 4183 | M | Magazin Alfa SRL · punct de lucru Deva | OpenCart | nefinalizată |
| 4182 | T | Magazin Alfa SRL · punct de lucru Deva | OpenCart | nefinalizată |
| 4181 | M | Bistro Beta SRL | operator | finalizată |
- Deschizi comenzile clienților în gestiune.
- Comenzile noi din magazin sunt nefinalizate, introduse de „OpenCart”, cu numărul de document următor deja pus.
- Le verifici (cantități, client, prețuri) și le finalizezi, exact ca pe o comandă introdusă de mână.
Rezultat: comanda devine document normal în gestiune. Garanțiile SGR apar ca linie separată, iar o comandă cu produse din serii de facturare diferite vine deja împărțită pe serii.
Corectez o comandă adusă greșitîn gestiune
- Ștergi documentul respectiv din gestiune (cât e încă nefinalizat).
- La următoarea rulare a comenzilor, PowerSync îl aduce din nou, curat, din magazin.
Rezultat: ai din nou comanda, adusă de la zero. Ștergerea e chiar felul în care se corectează un import.
Refuz definitiv o comandăîn gestiune
- Anulezi documentul în gestiune, nu-l ștergi.
Rezultat: documentul anulat rămâne în gestiune, deci PowerSync știe că l-a adus deja și nu-l mai aduce.
Pe scurt: șterg = vreau comanda din nou; anulez = nu mai vreau comanda.
Adaug un partener nouîn gestiune
- Creezi partenerul în gestiune, nu în magazin.
- Tot în gestiune îi completezi adresa de email. Fiecare partener are adresa lui, unică, și cu ea se identifică în magazin.
- La sincronizarea clienților, partenerul apare și în magazin, legat de codul lui de partener.
Partener cu mai multe puncte de lucru
Un partener poate avea mai multe puncte de lucru, de exemplu magazine în orașe diferite. Fiecare punct de lucru poate face comenzi individual, iar comanda ajunge în gestiune pe punctul de lucru care a comandat.
Partenerul trebuie să comande autentificat în contul lui. O comandă fără cont nu are cod de partener, așa că PowerSync o sare și o notează în jurnal ca „fără partener”.
Mut produsele unei subgrupe în altă categorieconfig
Categoria din magazin se alege după subgrupa produsului din gestiune, dintr-un tabel de corespondență: config\category_map.json. De obicei îl ține la zi furnizorul; dacă vrei să-l modifici tu:
- Deschide
config\category_map.jsoncu Notepad. - În secțiunea
"subgrupa", găsește sau adaugă codul subgrupei, de forma:"1290": { "cat": 79, "brand": "Nume brand" },
„cat” e numărul categoriei din adminul magazinului (Catalog → Categorii); „brand” e opțional. - Salvează (Ctrl+S) și rulează
SyncProducts.bat.
Rezultat: toate produsele subgrupei trec în categoria nouă. O subgrupă care nu e în tabel ajunge în „Fără categorie”, ca să nu se piardă niciun produs.
Fără ghilimele lipsă sau virgule în plus: un fișier scris greșit nu se mai poate citi. Ambalajele returnabile merg automat în categoria „Ambalaje”.
Pornesc sincronizarea acum, fără să așteptdublu-clic
În folderul PowerSync, dai dublu-clic pe fișierul potrivit:
SyncProducts.bat— produsele, prețurile și stocurile spre magazin;SyncCustomers.bat— clienții spre magazin;SyncOrders.bat— comenzile noi spre gestiune.
Se deschide o fereastră care arată progresul; când se închide singură, s-a terminat:
Rezultat: poți rula oricând și de câte ori vrei; PowerSync nu dublează nimic.
4Pregătirea, o singură dată
De obicei o face furnizorul, la instalare. E bine totuși să știi ce e în folder.
Ce îi trebuie calculatorului
- Windows 10, 11 sau Windows Server.
- Acces în rețea la serverul gestiunii și la internet, pentru magazin.
- Drept de scriere în folderul PowerSync, pentru jurnal.
Nimic altceva: niciun driver, nicio bază de date, nicio instalare.
Setările, în folderul config\
| Fișier | Ce conține | Cine îl completează |
|---|---|---|
erp.json | Unde e gestiunea: serverul, baza de date, utilizatorul și parola. | furnizorul, la instalare |
opencart.json | Adresa magazinului online. | furnizorul, la instalare |
orders.json | Cum intră comenzile online în gestiune: agentul, divizia, gestiunea de lucru, zilele de scadență. | împreună, o singură dată |
category_map.json | Ce categorie din magazin primește fiecare subgrupă din gestiune. | furnizorul; vezi cum îl modifici |
Fișierele se deschid cu Notepad. Schimbi doar ce e între ghilimele, păstrând restul neatins, apoi salvezi. Programul și folderul sql\ nu se modifică.
5Programarea automată
Se face o singură dată, în Planificatorul de activități din Windows (Task Scheduler). Apoi PowerSync rulează singur.
- Din meniul Start, deschide Task Scheduler (Planificator de activități).
- În dreapta, apasă Create Basic Task… și dă-i un nume, de exemplu PowerSync – Comenzi.
- La declanșator alege Daily (zilnic) și ora de început.
- La acțiune alege Start a program.
- La Program/script, apasă Browse și alege fișierul
.batpotrivit. - La Start in scrie calea folderului, de exemplu
C:\PowerSync, ca rularea să pornească din folderul programului. - Apasă Next, apoi Finish.
- Pentru comenzi: deschide activitatea → Triggers → Edit → bifează Repeat task every 15 minutes, for a duration of: Indefinitely.
Cât de des
| Ce rulează | Recomandat | De ce |
|---|---|---|
SyncProducts.bat | o dată pe zi, noaptea | prețurile și stocurile sunt la zi dimineața |
SyncCustomers.bat | o dată pe zi, noaptea | clienții noi pot comanda a doua zi |
SyncOrders.bat | la 15–30 de minute | comenzile ajung repede în gestiune |
Calculatorul pe care faci programarea trebuie să fie pornit la orele alese. Pe un server care merge non-stop e cel mai simplu.
6Jurnalul, pe înțelesul tuturor
Tot ce face PowerSync se scrie în logs\sync.log. Îl deschizi cu Notepad; ultimele rânduri sunt ultima rulare.
Pe scurt: au venit două comenzi noi, cu numerele de document 4183 și 4182. Una a fost sărită pentru că era fără cont de client. Restul fuseseră aduse deja.
Ce înseamnă fiecare mesaj
| Mesajul | Ce înseamnă | Ce faci |
|---|---|---|
| OK: 2480 inserate/actualizate, 0 erori | Toate produsele sau clienții au ajuns în magazin. | nimic |
| OK: 2475 inserate/actualizate, 5 erori | Câteva înregistrări n-au putut fi trimise. | trimite-ne jurnalul |
| Comanda OC 1052 -> … numar document 4183 | O comandă din magazin a intrat în gestiune, cu acest număr. | o validezi |
| Comenzi: 2 importate, 47 sarite (deja trimise: 46 …) | „Deja trimise” sunt comenzile aduse la rulările de dinainte. E normal să fie multe. | nimic |
| fara partener: 1 | O comandă dată fără cont de client nu are cod de partener. | verifici clientul și îi ceri să comande autentificat |
| fara linii: 1 | O comandă fără produse, deci goală. | verifici în magazin |
| [ERROR] Comanda 1054 EROARE: … | Acea comandă n-a putut intra; celelalte au intrat. | nimic urgent: se reîncearcă la rularea următoare; dacă se repetă, trimite-ne jurnalul |
| [WARN] category_map.json lipseste | Lipsește tabelul de categorii; produsele intră fără categorie și fără brand. | pune fișierul înapoi în config\ |
| [ERROR] Config file missing: …\config\erp.json | Lipsește un fișier de setări sau a fost redenumit. | verifici folderul config\: fișierul trebuie să fie acolo, cu numele exact |
| [ERROR] un mesaj despre conexiune, de ex. A network-related … error sau Unable to connect … | Gestiunea sau magazinul nu răspund: rețea, internet, server sau setări de conectare. | verifici rețeaua, apoi erp.json și opencart.json; rularea următoare recuperează tot |
7De reținut
- Gestiunea are ultimul cuvânt.Denumirea, prețul, stocul, TVA-ul, cantitatea minimă, categoria și brandul vin din gestiune și se rescriu în magazin la fiecare sincronizare. Le schimbi în gestiune.
- Ce pui în magazin rămâne.Pozele și descrierile adăugate în adminul magazinului nu sunt atinse de PowerSync.
- Comenzile sunt de validat.Nimic nu se facturează și nu se scade din stoc până nu finalizezi tu comanda în gestiune.
- Rularea repetată e sigură.PowerSync aduce doar ce lipsește: nu dublează produse, clienți sau comenzi.
- Șterg sau anulez?Ștergi un document ca să vină din nou corect; îl anulezi ca să nu mai vină niciodată.
- Partenerii se creează în gestiune.Fiecare cu adresa lui de email, unică. Punctele de lucru ale unui partener pot comanda fiecare separat.
- Doar
config\se modifică.Programul și folderulsql\rămân cum sunt.
8Întrebări frecvente
Un partener are mai multe magazine. Cum comandă?
Fiecare punct de lucru al partenerului poate comanda individual. Comanda intră în gestiune pe punctul de lucru care a comandat, așa că știi exact unde se livrează.
Doi parteneri pot folosi aceeași adresă de email?
Nu. Adresa de email se completează în gestiune și e unică pentru fiecare partener: după ea îl recunoaște magazinul.
Ce se întâmplă dacă pică internetul sau rețeaua?
Rularea respectivă se oprește cu o eroare în jurnal. Nu se pierde nimic: la rularea următoare, PowerSync aduce comenzile rămase și retrimite produsele.
Pot porni PowerSync de pe alt calculator?
Da. PowerSync nu ține nimic doar pentru el: verifică direct în gestiune ce comenzi a adus deja. Poți rula de pe orice calculator cu acces la gestiune, fără dubluri.
Am rulat de două ori la rând. E vreo problemă?
Nu. A doua rulare găsește că totul e deja la zi și nu schimbă nimic.
Am schimbat un preț în magazin și a revenit la cel vechi. De ce?
Pentru că prețul vine din gestiune și se rescrie la fiecare sincronizare. Schimbă-l în gestiune și rămâne.
Un produs a ajuns în „Fără categorie”.
Subgrupa lui nu e încă în tabelul de categorii. Adaug-o în config\category_map.json (vezi cum) sau cere-o furnizorului; la următoarea sincronizare a produselor se mută singur.
Cât durează o sincronizare?
Câteva secunde pentru câteva mii de produse. Comenzile durează și mai puțin.
Vrei să vezi cum funcționează?
Un simulator în browser, cu date fictive: schimbi un preț în gestiune, trimiți o comandă din magazin și vezi ce face PowerSync.
Ai nevoie de ajutor?
Scrie-mi ce s-a întâmplat și atașează fișierul logs\sync.log: cu el găsesc repede cauza.