Інтеграція з Rozetka

Інтеграція з Rozetka дозволяє генерувати XML-прайс для завантаження товарів на Rozetka і завантажувати замовлення з Rozetka у Skynum.

Інтеграція створюється в Налаштування → Інтеграції → Інтернет-магазини.

Як працює інтеграція

У Rozetka основний товарний обмін відбувається через прайс-лист. Skynum генерує XML-файл з категоріями і товарами, а Rozetka завантажує його за посиланням.

У картці інтеграції є вкладки:

• Налаштування інтеграції;
• API мапінг;
• Журнал синхронізації.

Як створити інтеграцію

1. Відкрийте Налаштування → Інтеграції → Інтернет-магазини.
2. Натисніть Додати інтеграцію.
3. Виберіть Розетка.
4. Заповніть Назва магазину.
5. Заповніть Логін і Пароль для підключення.
6. Збережіть інтеграцію.
7. Натисніть Перевірити підключення.

У списку інтеграцій для інтернет-магазинів видно Назва магазину, Сервіс і Інтеграція активна.

Синхронізація товарів

У блоці Товари увімкніть Синхронізація товарів активна і збережіть інтеграцію. Після цього Skynum генерує посилання на XML-прайс.

Основні налаштування товарів:

• Ідентифікатор товара — визначає, яке значення Skynum передає в Rozetka як ID товару;
• Ідентифікатор модифікації — визначає ключ для різновидів товару;
• Вивантажувати категорії — керує передаванням категорій у XML-прайс;
• Тип ціни товарів — вибирає ціну Skynum, яка потрапляє в прайс;
• Вивантажувати товари без залишків — дозволяє включати в прайс позиції без поточного залишку;
• Назва модифікацій — визначає, як називати варіанти товарів у прайсі;
• Виключити категорії — не передає товари з вибраних категорій;
• Тільки товари з категорії — обмежує прайс вибраною категорією;
• Тільки залишки по складах — передає залишки тільки з вибраних складів.

XML-прайс

XML-прайс складається з двох основних частин:

• категорії;
• товари.

Кожен товар передається як окрема позиція з даними: назва, категорія, ціна, залишок, валюта, опис, виробник, фото, характеристики та інші поля, які потрібні для Rozetka.

Після зміни налаштувань інтеграції збережіть картку інтеграції, щоб оновити прайс.

порада

Після першого налаштування відкрийте посилання на XML-прайс і перевірте, що у файлі є категорії, товари, ціни, залишки, фото і характеристики.

Ідентифікатор товара

Поле Ідентифікатор товара визначає, яке значення Skynum передає в Rozetka як ID товару.

У формі доступні варіанти:

• Внутрішній ID;
• Зовнішній ID;
• Код;
• Артикул.

Для багатьох сценаріїв зручно використовувати Код. Якщо товар повʼязаний з іншими системами або має власний стабільний ідентифікатор, можна використовувати Зовнішній ID.

Ідентифікатор модифікації

Для товарів з модифікаціями потрібно вибрати Ідентифікатор модифікації.

У формі доступні варіанти:

• Внутрішній ID;
• Зовнішній ID;
• Код.

Модифікації використовуються для різновидів товару: розмірів, кольорів або інших варіантів однієї моделі.

Категорії

Поле Вивантажувати категорії визначає, як категорії потрапляють у прайс.

У формі доступні варіанти:

• Ні;
• За назвою;
• За зовнішнім ID.

Якщо для Rozetka потрібні власні ID категорій, використовуйте зовнішні ID і перевірте, що вони заповнені в категоріях.

Ціни і залишки

У полі Тип ціни товарів виберіть ціну, яка має потрапляти в Rozetka.

Якщо для Rozetka потрібна окрема ціна, створіть додаткову ціну і виберіть її в інтеграції.

Поля Вивантажувати товари без залишків і Тільки залишки по складах визначають, які товари і залишки потраплять у прайс.

Якщо для Rozetka продається товар тільки з конкретного складу або магазину, виберіть потрібний склад у налаштуванні залишків.

Фото, виробник і опис маркетплейсів

Для Rozetka важливо, щоб у товарів були якісні дані в картці товару:

• фото;
• назва;
• опис;
• виробник;
• характеристики;
• ціна;
• залишок.

Якщо для Rozetka потрібен окремий текст, використовуйте Опис маркетплейсів у картці товару. Наявність цього поля керується параметром системи Опис маркетплейсів у картці товару.

Докладніше про картку товару: Картка товару.

API мапінг характеристик

Rozetka має вимоги до характеристик товарів. Перед вивантаженням перевірте вимоги у кабінеті Rozetka для вашої категорії.

На вкладці API мапінг потрібно зіставити характеристики Skynum з назвами характеристик Rozetka.

попередження

Назви характеристик мають відповідати вимогам Rozetka. Якщо характеристик недостатньо або назви не підходять, прайс може не пройти валідацію.

Валідація прайсу в Rozetka

Після генерації прайсу скопіюйте посилання і перевірте його у валідаторі Rozetka.

Якщо валідатор показує помилки, відкрийте звіт, знайдіть проблемні товари і виправте дані в Skynum: фото, виробника, назву, категорію, характеристики або інші поля.

Після виправлення збережіть інтеграцію, оновіть прайс і пройдіть валідацію ще раз.

Синхронізація замовлень

У блоці Замовлення налаштовується завантаження замовлень з Rozetka у Skynum.

Основні налаштування замовлень:

• Синхронізація замовлень активна — вмикає завантаження замовлень з Rozetka;
• Інтервал синхронізації — задає період автоматичного завантаження замовлень;
• Резервувати товари після створення замовлення — резервує товари після імпорту замовлення;
• Імпортувати повторно змінені замовлення — дозволяє повторно оновлювати замовлення, які змінилися в Rozetka;
• Спосіб оновлення замовлень — визначає, які дані Skynum оновлює при повторному імпорті;
• Заборонити оновлення замовлень у статусі — захищає вибрані статуси від змін через інтеграцію;
• Створити пов'язаний платіж на суму оплати — вмикає створення окремого платежу за переданою сумою оплати;
• Фіскалізація платежу — запускає фіскалізацію автоматично створеного платежу;
• ПРРО для фіскалізації — визначає фіскальний сервіс для автоматичного чека;
• Експорт замовлень — визначає, чи передавати зміни зі Skynum назад у Rozetka;
• Склад за замовчуванням — використовується для резервування та обліку товарів із замовлення;
• Канал продажів — позначає джерело продажу в аналітиці;
• Група контрагента — задає групу для нових покупців.

Після завантаження замовлення потрапляють у розділ продажів як звичайні замовлення покупця. Далі менеджер працює з ними стандартно: перевіряє товар, оплату, доставку, резерв і виконання.

Оплата і фіскалізація

Для автоматичної оплати замовлень у блоці Замовлення увімкніть Створити пов'язаний платіж на суму оплати. Коли Rozetka передає суму оплати, а спосіб оплати Rozetka зіставлений зі способом оплати Skynum на вкладці API мапінг, Skynum створює пов'язаний платіж до замовлення.

Для автофіскалізації увімкніть Фіскалізація платежу і виберіть ПРРО для фіскалізації. Після створення платежу Skynum запускає фіскалізацію цього платежу. Спосіб оплати Skynum має бути пов'язаний із касою або банківським рахунком.

Докладніше:

• Оплачені замовлення з інтернет-магазинів і автофіскалізація;
• Способи оплати;
• Налаштування фіскального сервісу.

Повторне оновлення замовлень

Параметр Імпортувати повторно змінені замовлення потрібен, якщо після першого імпорту замовлення в Rozetka може змінюватися.

У полі Спосіб оновлення замовлень доступні варіанти:

• Не оновлювати;
• Тільки статус;
• Оновити заповнені;
• Повністю оновити.

попередження

Режим Повністю оновити може перезаписати дані, які менеджер уже змінив у Skynum. Використовуйте його тільки тоді, коли це справді відповідає процесу компанії.

API мапінг замовлень

Для замовлень у API мапінг налаштовуються:

• статуси;
• доставка;
• оплата.

Статуси Rozetka зіставляються зі статусами Skynum. Доставки зіставляються зі способами доставки Skynum, наприклад Магазини Розетка, Нова пошта, Укрпошта або Meest. Оплати зіставляються зі способами оплати, які налаштовані в довідниках.

Докладніше про довідник оплат: Способи оплати.

Журнал синхронізації

На вкладці Журнал синхронізації перевіряйте, чи успішно проходить завантаження замовлень і генерація даних.

Після першого налаштування перевірте:

• XML-прайс відкривається;
• прайс проходить валідацію Rozetka;
• тестове замовлення завантажується в Skynum;
• статуси, доставка і оплата зіставляються правильно.

Коротка перевірка

• інтеграція створена в Інтернет-магазини;
• логін і пароль заповнені;
• підключення перевірене;
• синхронізація товарів активна;
• ідентифікатор товару вибраний правильно;
• ціна, категорії, фото, виробник і характеристики підготовлені;
• XML-прайс проходить валідацію Rozetka;
• синхронізація замовлень активна;
• API-мапінг статусів, доставки і оплат налаштований;
• тестове замовлення з Rozetka завантажується в Skynum.

Підсумок

Інтеграція з Rozetka тримається на якості XML-прайсу і правильному мапінгу замовлень. Спочатку добийтеся валідного прайсу з товарами, фото, виробниками і характеристиками, а потім налаштовуйте завантаження замовлень та обмін статусами.