Створення підключення Shopify для Mergado Marketplaces#

Цей покроковий посібник пояснює, як створити застосунок Shopify, налаштувати потрібні дозволи API і підключити ваш магазин Shopify до Mergado Marketplaces для синхронізації замовлень.

Якщо хочете використовувати імпорт замовлень для Shopify, спочатку потрібно створити підключення Shopify в Mergado Keychain.

ℹ️ Якщо у вас уже є підключення до Mergado через API за допомогою „власного застосунку" в адмініструванні Shopify у Mergado Keychain, достатньо лише оновити список дозволів для цього застосунку в Shopify, як описано нижче.

Ця інструкція суворо спирається на офіційну документацію Shopify та актуальний інтерфейс користувача для створення застосунків за допомогою Shopify Developer Dashboard.

Офіційні джерела: https://shopify.dev/docs/apps/build/dev-dashboard/create-apps-using-dev-dashboard

Ви створюєте власний (custom) API-застосунок для одного конкретного інтернет-магазину. Застосунок не потрібно публікувати в Shopify App Store.

Що вам знадобиться?#

• Обліковий запис Shopify з доступом адміністратора до інтернет-магазину
• доступ до Shopify Developer Dashboard

1. Створення застосунку в Shopify#

Щоб Mergado Marketplaces мало API-доступ до вашого облікового запису Shopify, потрібно створити застосунок із потрібними дозволами:

а) Відкрийте Shopify Developer Dashboard#

До Shopify Developer Dashboard можна потрапити двома способами:

Варіант А: Прямий доступ

1. Відкрийте https://dev.shopify.com/
2. Увійдіть за допомогою свого облікового запису Shopify
3. У лівому меню відкрийте розділ Apps

Варіант Б: Через адміністрування Shopify

1. Відкрийте адміністрування Shopify свого інтернет-магазину
2. Перейдіть до Settings → Apps
3. Натисніть Develop apps
4. Натисніть Build apps in Dev Dashboard

б) Створіть новий застосунок#

1. Переконайтеся, що ви в розділі Apps
2. Натисніть Create app
3. Виберіть Start from Dev Dashboard
4. Введіть назву застосунку (наприклад, Mergado integration)
5. Натисніть Create

Після створення застосунку вас буде перенаправлено на вкладку Versions.

в) Створіть версію застосунку й налаштуйте дозволи (scopes) #

Кожен застосунок мусить мати принаймні одну версію, щоб його можна було встановити в інтернет-магазин.

Налаштування URL-адреси застосунку та вбудовування

• У розділі URLs знайдіть поле App URL
• Стандартне значення https://example.com замініть на:

https://app.mergado.com

Цей крок обов’язковий для правильної роботи інтеграції з Mergado. Якщо залишиться стандартне значення, авторизація не працюватиме правильно.

• Під полем App URL зніміть позначку з варіанта Embed app in Shopify admin

г) Налаштування дозволів доступу#

1. У розділі Access натисніть Select scopes
2. У модальному вікні знайдіть і позначте:

Потрібні дозволи для Mergado Marketplaces:

• read_customers + write_customers
• write_orders + read_orders
• read_products
• read_shipping + write_shipping
• write_order_edits + read_order_edits

А якщо хочете через API також імпортувати товари до Mergado, додайте:

• read_products
• write_products
• read_markets
• write_markets
• read_metaobjects

Більше інформації про імпорт товарів до Mergado знайдете в цій статті.

3. Підтвердьте, натиснувши Done

ґ) Публікація (release) версії #

1. Прокрутіть сторінку нижче
2. Натисніть Release
3. У вікні підтвердження назву версії можна залишити порожньою
4. Підтвердьте, натиснувши Release

Версію застосунку тепер опубліковано, і вона готова до встановлення.

д) Встановіть застосунок в інтернет-магазин#

1. У лівому меню відкрийте Home
2. Праворуч угорі натисніть Install app
3. Виберіть інтернет-магазин Shopify, який хочете підключити до Mergado
4. Вас буде перенаправлено до адміністрування Shopify
5. Встановлення підтвердьте, натиснувши Install

Застосунок тепер встановлено в інтернет-магазині.

2. Підключення Shopify в Mergado Keychain#

а) Отримайте дані доступу до API (Client ID і токен)#

Після встановлення застосунку потрібно отримати два значення, які ви використовуватимете для інтеграції з Mergado:

1. Client ID
2. Токен доступу до API (Secret)

Порядок дій:

1. Поверніться до Shopify Developer Dashboard
2. Відкрийте свій застосунок
3. Перейдіть до Settings
4. У розділі Credentials :

• скопіюйте значення Client ID (поле розташоване над значенням Secret)
• скопіюйте значення Secret

Client ID слугує для ідентифікації застосунку, Secret працює як токен доступу до API. Для правильної роботи інтеграції з Mergado потрібні обидва значення .

б) Отримайте URL-адресу інтернет-магазину#

1. Відкрийте адміністрування Shopify підключеного інтернет-магазину
2. У лівому меню відкрийте Home
3. У розділі Domains скопіюйте URL-адресу інтернет-магазину

Приклад:

your-store.myshopify.com

в) Підключіть Shopify до Mergado#

1. Відкрийте Mergado Keychain
2. Заповніть:
   • Shopify URL → вставте URL-адресу інтернет-магазину
   • Client ID → вставте скопійований Client ID з Shopify Developer Dashboard
   • Client Secret → вставте скопійований Secret
3. Натисніть Log in

3. Активація замовлень у Mergado Marketplaces#

Перейдіть до розділу Connections у Mergado Marketplaces, за допомогою кнопки “Order synchronization” біля Shopify активуйте замовлення й збережіть зміни. Синхронізацію на сторінці активації можна будь-коли легко призупинити. Замовлення синхронізуються кожні 5 хвилин.

ℹ️ Система керування замовленнями не синхронізує заднім числом. Тож не бійтеся, що після запуску вашу систему заполонять усі попередні замовлення.

Готово! 🎉 Відтепер замовлення регулярно передаватимуться між вашими маркетплейсами й Shopify.