Интеграции с онлайн магазини

Как да свържете shopGold с easySales: настройка на конектора

Как да свържете shopGold с easySales: настройка на конектора

Свържете магазина си в shopGold с easySales: качете конектора от два файла с Вашия API код, съпоставете статусите на поръчките, каталожните номера и какво се синхронизира във всяка посока.

Какво прави връзката с shopGold

shopGold е полски софтуер за онлайн магазини, който работи на Вашия собствен сървър. Свързан с easySales, той пренася продуктите и поръчките на магазина Ви в easySales, поддържа наличностите в магазина актуални от easySales и връща към магазина статусите на поръчките.

Три неща, които е добре да знаете, преди да започнете:

  • Връзката е малък конектор, който качвате в магазина си. Изтегляте два файла от easySales, поставяте своя API код в единия от тях и качвате и двата в основната папка на магазина, до index.php.
  • Всеки продукт и всеки вариант се нуждае от каталожен номер (Nr katalogowy). easySales разпознава продуктите по него. Продукт без каталожен номер не се импортира, а поръчка с такъв продукт се отказва.
  • След свързването съпоставете статусите на поръчките. Статусите в shopGold са Ваши собствени, затова easySales трябва да знае кой от тях означава нова, завършена или отменена поръчка. Докато не ги съпоставите, всяка поръчка остава New.

Преди да започнете

✓

Достъп до файловете на магазина

Чрез FTP или файловия мениджър на хостинга Ви, за да качите два файла.

✓

Каталожен номер на всеки продукт

Nr katalogowy на всеки продукт и на всеки вариант.

✓

Обикновен текстов редактор

Например Notepad, за да поставите API кода в конектора.

Стъпка 1 — Добавете магазина в easySales

Отидете в Интеграции → Уебсайтове и натиснете Свържете уебсайт. Попълнете данните на магазина:

Формулярът с данните на магазина: Website Name Demo Webshop, Website URL https:// sklep-demo.pl, Country Poland, Price Vat 23%, Shipping Vat 23, Language Polish, Currency Polish Zloty, Inventory source Clasic warehouse с EasySales, Implicit package type Parcel и Invoice Series SG.
Данните на магазина.
Поле Какво се попълва
Име на уебсайт Име на магазина, използвано в easySales.
URL на уебсайт Адресът на магазина Ви точно както се отваря в браузъра — със същото https:// и със същото www. или без него. easySales не следва пренасочвания.
Страна Държавата на магазина, Полша.
Цена с ДДС Ставката на ДДС, включена в цените на магазина Ви, обикновено 23%.
ДДС за доставка Ставката на ДДС за доставката.
Език, Валута Езикът и валутата на магазина.
Персонализиран статус за нова поръчка По избор: персонализираният статус, който новите поръчки от shopGold получават в easySales.
Източник на стокови наличности Къде се водят наличностите на магазина: Класически склад с източник като EasySales или Разширен склад.
Обичаен тип пакет Типът пакет, който получават новите поръчки, използван при създаването на етикетите им.
Серия фактури Серията на фактурите, които издавате за поръчките от този магазин.
Данни на магазина

Стъпка 2 — Качете конектора в магазина си

Под данните изберете плочката shopGold, след това версията ShopGold. Разделът Подробности показва стъпките за настройка, бутона Модул за изтегляне и Вашия API код.

Разделът Details на версията ShopGold, отбелязан Connection successful: стъпките за настройка, бутонът Download Module и API Key с бутоните за опресняване и копиране, над бутоните Delete и Save.
Изтеглете конектора и копирайте API кода.
  1. Натиснете Модул за изтегляне и разархивирайте файла. В него са easy-sales-api.php и easy-sales-api-key.php.
  2. Отворете easy-sales-api-key.php в обикновен текстов редактор, например Notepad, и поставете API код между кавичките. Кавичките трябва да останат прави — текстообработваща програма ги променя и поврежда файла.
  3. Качете двата файла в основната папка на магазина, до index.php.
  4. Върнете се в easySales и натиснете Запази. easySales тества връзката и зарежда статусите на поръчките и методите на плащане на магазина Ви.

Стъпка 3 — Съпоставете статусите на поръчките

Отворете отново магазина и изберете Предпочитания.

ShopGold Settings в Preferences: Map order status свързва Zamówienie złożone и Zamówienie przyjęte с New, Zamówione towary wysłane с Completed и Zamówienie anulowane с Canceled; Send order status to ShopGold изпраща Canceled като Zamówienie anulowane и Completed като Zamówione towary wysłane.
Статусите на поръчките, съпоставени в двете посоки.
  • Map order status: за всеки статус в shopGold изберете статуса в easySales, на който той отговаря — например поръчка, която магазинът Ви отбелязва като изпратена, в easySales е Completed. Статус, който не съпоставите, постъпва като New.
  • Изпращане на статуса на поръчката към ShopGold: изберете статуса в shopGold, който поръчката получава, когато я завършите, отмените или върнете в easySales. Изпращат се само тези три; статус, който оставите несъпоставен, не се изпраща.

Натиснете Запази.

Какво се синхронизира

От shopGold към easySales От easySales към shopGold
Категории и продукти, с цени, изображения, описания и атрибути Наличност
Нови и обновени поръчки, с пункта за получаване, когато купувачът е избрал такъв Статусът на поръчката, когато завършите, отмените или върнете поръчка
Номера за проследяване, при включено Вземи документи от уебсайта Номерът за проследяване на етикета, който създавате
Какво върви във всяка посока
  • Поръчките започват да постъпват веднага след свързването. Продуктите се четат на всеки няколко часа, затова оставете време на първия импорт, преди да работите с нови поръчки: ред от поръчка, който пристигне преди продуктът му да съществува, остава без продукт и не резервира наличност.
  • Наличност: когато източникът на наличности на магазина е EasySales, easySales изпраща на магазина наличността на всеки продукт при всяка нейна промяна. Когато източникът е уебсайтът, easySales чете наличностите на магазина на всеки 30 минути.
  • Номера за проследяване: когато поръчка получи етикет в easySales, номерът му за проследяване се изпраща към магазина. За да въвеждате в easySales номерата за проследяване, които попълвате в shopGold, включете Вземи документи от уебсайта в Предпочитания.
  • Цените се четат от магазина. Променяйте ги в shopGold.

Обновяване на конектора

Когато easySales пусне нов конектор, заменете в магазина само easy-sales-api.php. Оставете easy-sales-api-key.php както е — ключът в него остава валиден. Ако натиснете бутона за опресняване до API код, поставете отново новия ключ в easy-sales-api-key.php.

Когато нещо не работи

Съобщение Какво да направите
Connection failed. Make sure easySales module is properly configured. If you need assistance, please contact us. Проверете дали двата файла са в основната папка на магазина, дали ключът е поставен в easy-sales-api-key.php и дали URL на уебсайт съвпада точно с адреса на магазина.
Set your easySales key in easy-sales-api-key.php Файлът с ключа все още е празен. Поставете API кода между кавичките и качете файла отново.
easy-sales-api-key.php was changed. Upload a clean copy from the release zip and paste the key again. Файлът с ключа е повреден при редактирането. Вземете го отново от zip архива, поставете ключа в обикновен текстов редактор и го качете.
Shop configuration not found. Upload this file inside your shopGold directory, or fill in the database settings at the top of it. Файловете не са в основната папка на магазина. Преместете ги до index.php.
The product.sku field is required. Продуктът няма каталожен номер в shopGold. Попълнете Nr katalogowy за продукта и за всеки от вариантите му.
order.order_products.1.sku jest obowiązkowe. Продукт от поръчката няма каталожен номер. Попълнете го в shopGold; поръчката постъпва при следващата проверка.
Съобщения и какво да направите

Често задавани въпроси

В основната папка на магазина Ви, до index.php. Качете и easy-sales-api.php, и easy-sales-api-key.php.

Статусите на поръчките Ви не са съпоставени. Отворете магазина в easySales, изберете Предпочитания и съпоставете всеки статус от shopGold със статус в easySales.

Той няма каталожен номер (Nr katalogowy) в shopGold. Попълнете го за продукта и за всеки от вариантите му; продуктът постъпва при следващия импорт на продукти.

Completed, Canceled и Return — всеки като статуса в shopGold, който изберете в Предпочитания. Статус, който оставите несъпоставен, не се изпраща.

Не. Цените се четат от shopGold; променяйте ги в магазина си.

Заменете само easy-sales-api.php с новия. Оставете easy-sales-api-key.php както е.

Отворете в браузъра адреса на магазина си, последван от /easy-sales-api.php. Отговорът трябва да е Expected a JSON body.

Беше ли полезно това ръководство?