Cum conectezi shopGold cu easySales: configurarea conectorului
Conectează magazinul tău shopGold la easySales: încarcă conectorul din două fișiere cu API Key-ul tău, mapează statusurile comenzilor, codurile de catalog și ce se sincronizează în fiecare direcție.
Ce face conectarea shopGold
shopGold este un software polonez de magazine online care rulează pe serverul tău. Conectat la easySales, aduce produsele și comenzile magazinului tău în easySales, ține stocul din magazin la zi din easySales și trimite înapoi în magazin statusurile comenzilor.
Trei lucruri de știut înainte să începi:
- Conexiunea este un mic conector pe care îl încarci în magazin. Descarci două fișiere din easySales, lipești API Key-ul tău într-unul dintre ele și le încarci pe amândouă în folderul rădăcină al magazinului, lângă
index.php. - Fiecare produs și fiecare variantă are nevoie de codul de catalog (Nr katalogowy). easySales identifică produsele după el. Un produs fără cod de catalog nu este importat, iar o comandă care conține un astfel de produs este refuzată.
- Mapează statusurile comenzilor după ce te conectezi. Statusurile din shopGold sunt ale tale, așa că easySales trebuie să știe care dintre ele înseamnă nouă, finalizată sau anulată. Până le mapezi, toate comenzile rămân New.
Înainte să începi
Acces la fișierele magazinului
Prin FTP sau prin managerul de fișiere al hostingului, ca să încarci două fișiere.
Un cod de catalog pe fiecare produs
Nr katalogowy pe fiecare produs și pe fiecare variantă.
Un editor de text simplu
De exemplu Notepad, ca să lipești API Key-ul în conector.
Pasul 1 — Adaugă magazinul în easySales
Mergi la Integrări → Magazine și apasă Conectare Website. Completează detaliile magazinului:
| Câmp | Ce se trece |
|---|---|
| Nume Website | Un nume pentru magazin, folosit în easySales. |
| URL Website |
Adresa magazinului tău exact așa cum se deschide în browser — același https:// și același www. sau fără. easySales nu urmează redirecționările.
|
| Țară | Țara magazinului, Polonia. |
| TVA | Cota de TVA inclusă în prețurile magazinului tău, de obicei 23%. |
| TVA Transport | Cota de TVA a transportului. |
| Limba, Valuta | Limba și moneda magazinului. |
| Status custom pentru comanda noua | Opțional: statusul custom pe care îl primesc în easySales comenzile noi din shopGold. |
| Sursă stoc produse | Unde se ține stocul magazinului: Depozit clasic cu o sursă precum EasySales, sau Depozit avansat. |
| Tip de pachet implicit | Tipul de pachet pe care îl primesc comenzile noi, folosit când le generezi AWB-urile. |
| Serie Facturi | Seria facturilor pe care le emiți pentru comenzile acestui magazin. |
Pasul 2 — Încarcă conectorul în magazin
Sub detalii, alege tile-ul shopGold, apoi versiunea ShopGold. Tab-ul Detalii îți arată pașii de configurare, butonul Descarcă Modulul și API Key-ul tău.
- Apasă Descarcă Modulul și dezarhivează fișierul. Conține
easy-sales-api.phpșieasy-sales-api-key.php. - Deschide
easy-sales-api-key.phpîntr-un editor de text simplu, de exemplu Notepad, și lipește API Key-ul între ghilimele. Păstrează ghilimelele drepte — un procesor de text le schimbă și strică fișierul. - Încarcă ambele fișiere în folderul rădăcină al magazinului, lângă
index.php. - Înapoi în easySales, apasă Salvare. easySales testează conexiunea și încarcă statusurile comenzilor și metodele de plată ale magazinului tău.
Pasul 3 — Mapează statusurile comenzilor
Deschide din nou magazinul și alege Preferințe.
- Mapează statusul comenzii: pentru fiecare status din shopGold, alege statusul easySales care îi corespunde — de exemplu, o comandă pe care magazinul tău o marchează ca expediată este Completed în easySales. Un status pe care nu îl mapezi intră ca New.
- Trimite statusul comenzii către ShopGold: alege statusul din shopGold pe care îl primește o comandă când o finalizezi, o anulezi sau o returnezi în easySales. Doar aceste trei sunt trimise; un status pe care îl lași nemapat nu este trimis.
Apasă Salvare.
Ce se sincronizează
| Din shopGold în easySales | Din easySales în shopGold |
|---|---|
| Categorii și produse, cu prețuri, imagini, descrieri și atribute | Stocul |
| Comenzi noi și actualizate, cu punctul de ridicare atunci când cumpărătorul a ales unul | Statusul comenzii, când finalizezi, anulezi sau returnezi o comandă |
| Numerele de urmărire, cu Preia documentele din site activat | Numărul de urmărire al AWB-ului pe care îl generezi |
- Comenzile încep să sosească imediat după ce te conectezi. Produsele sunt citite la câteva ore, așa că lasă primului import timp înainte să lucrezi cu comenzile noi: o linie de comandă care sosește înainte să existe produsul ei rămâne fără produs și nu rezervă stoc.
- Stocul: cu sursa de stoc a magazinului setată pe EasySales, easySales trimite magazinului stocul fiecărui produs de fiecare dată când se schimbă. Cu sursa setată pe website, easySales citește stocul magazinului la fiecare 30 de minute.
- Numerele de urmărire: când o comandă primește un AWB în easySales, numărul lui de urmărire este trimis în magazin. Ca să aduci numerele de urmărire pe care le introduci în shopGold, activează Preia documentele din site în Preferințe.
- Prețurile sunt citite din magazin. Modifică-le în shopGold.
Actualizarea conectorului
Când easySales lansează un conector nou, înlocuiește în magazin doar easy-sales-api.php. Păstrează easy-sales-api-key.php așa cum este — cheia din el rămâne valabilă. Dacă apeși butonul de reîmprospătare de lângă API Key, lipește din nou cheia nouă în easy-sales-api-key.php.
Când ceva nu funcționează
| Mesaj | Ce faci |
|---|---|
| Connection failed. Make sure easySales module is properly configured. If you need assistance, please contact us. |
Verifică dacă ambele fișiere sunt în folderul rădăcină al magazinului, dacă cheia este lipită în easy-sales-api-key.php și dacă URL Website se potrivește exact cu adresa magazinului.
|
| Set your easySales key in easy-sales-api-key.php | Fișierul cheii este încă gol. Lipește API Key-ul între ghilimele și încarcă din nou fișierul. |
| easy-sales-api-key.php was changed. Upload a clean copy from the release zip and paste the key again. | Fișierul cheii s-a stricat la editare. Ia-l din nou din arhiva zip, lipește cheia într-un editor de text simplu și încarcă-l. |
| Shop configuration not found. Upload this file inside your shopGold directory, or fill in the database settings at the top of it. |
Fișierele nu sunt în folderul rădăcină al magazinului. Mută-le lângă index.php.
|
| The product.sku field is required. | Produsul nu are cod de catalog în shopGold. Completează Nr katalogowy, pentru produs și pentru fiecare variantă a lui. |
| order.order_products.1.sku jest obowiązkowe. | Un produs din comandă nu are cod de catalog. Completează-l în shopGold; comanda intră la următoarea verificare. |