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

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

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

Як працює обмін

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

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

Обидва потоки з'єднує ідентифікатор позиції: він іде в прайс-листі як ID позиції і повертається в кожному рядку замовлення як «ID товару у продавця». Тому прайс-лист налаштовується і проходить перевірку Rozetka раніше, ніж вмикається завантаження замовлень.

У картці інтеграції три вкладки: Налаштування інтеграції — поля блоків Товари і Замовлення, API мапінг — зіставлення характеристик, статусів, доставок і оплат, Журнал синхронізації — результати обміну.

Створення інтеграції в Skynum

Для підключення потрібні логін і пароль, якими ви входите в кабінет продавця seller.rozetka.com.ua: Skynum входить під ними сам і поновлює вхід, коли сесія Rozetka закінчується.

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

Перевірка проходить, коли Rozetka приймає логін і пароль. Якщо перевірка не проходить, увійдіть із цими даними в кабінет продавця: пароль, змінений у кабінеті, потрібно оновити і в інтеграції.

Налаштування прайс-листа

У блоці Товари увімкніть Синхронізація товарів активна, збережіть інтеграцію — і в полі Файл синхронізації товарів (XML) з'явиться посилання на прайс-лист. Далі пройдіть по налаштуваннях блоку; кожне з них змінює вміст файлу після наступного збереження.

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

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

Rozetka приймає ID позиції лише з латинських літер і цифр і не дозволяє змінювати його після того, як товар додано: позиція з іншим ID — це для Rozetka інший товар, який знову йде на модерацію. Той самий ID Rozetka повертає в замовленні, і за ним Skynum знаходить товар або модифікацію.

У полях Ідентифікатор товара і Ідентифікатор модифікації доступні Внутрішній ID, Зовнішній ID, Код і Артикул. Зручний вибір — Код: він є в кожному товарі та модифікації і не змінюється. Зовнішній ID підходить, коли товар уже має сталий ідентифікатор в іншій системі і ним зручно користуватися й на Rozetka. Артикул спільний для всіх різновидів товару, тому для модифікацій не підходить.

Вибране поле має бути заповнене в кожному товарі і кожній модифікації, що йдуть на Rozetka: товар або різновид з порожнім полем Skynum у прайс-лист не включає. Валідатор Rozetka зупиняє прайс-лист, у якому два ID збігаються.

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

У робочій інтеграції не змінюйте Ідентифікатор товара і Ідентифікатор модифікації: усі товари прийдуть на Rozetka з новими ID як нові позиції, а замовлення по старих позиціях перестануть знаходити товар у Skynum.

Різновиди товару

Кожен колір, розмір або інший різновид передається на Rozetka окремою позицією з власним ID, ціною, фото і характеристиками — так вимагає Rozetka. У Skynum різновиди ведуться модифікаціями товару, і Skynum сам розкладає товар з модифікаціями на окремі позиції.

Rozetka збирає різновиди в одну картку сама під час модерації. Для цього позиції мають бути в одній категорії, мати однаковий бренд, заповнену характеристику групування (для одягу і взуття — розмір, у багатьох категоріях ще й колір) і назву, яка містить значення цієї характеристики. За якою характеристикою групується категорія, показує кабінет продавця: Товари → Управління товарами → Правила групування.

Усі ці умови закриває стандартне налаштування Skynum:

• Назва модифікацій — Товар з модифікацією: кожна позиція отримує назву «назва товару + назва модифікації», тому назви у файлі не повторюються і містять ознаку різновиду. Однакові назви валідатор Rozetka позначає помилкою, а назву без ознаки Rozetka не групує.
• Характеристики модифікацій зіставлені на вкладці API мапінг у блоці Модифікації (див. Характеристики).

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

Категорії

Прайс-лист містить власні категорії продавця, а зіставляє їх з каталогом Rozetka менеджер Rozetka під час модерації. Тримайте в одній категорії Skynum товари одного виду з каталогу Rozetka і називайте категорію так, як вона називається на Rozetka: категорію зі змішаними товарами Rozetka зіставить лише з одним видом.

У полі Вивантажувати категорії вибирайте За назвою — категорії підуть з назвами і внутрішніми номерами Skynum. За зовнішнім ID потрібен, коли категорії вже мають власні номери, заповнені в полі Зовнішній ID категорії; тоді вони мають бути заповнені в усіх категоріях, що йдуть на Rozetka. Номер категорії після додавання товарів змінювати не можна.

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

Ціни

Ціна на Rozetka береться з ціни Skynum, вибраної в Тип ціни товарів. Для окремого прайсу Rozetka створіть додаткову ціну і виберіть її. Ціна передається в гривнях.

Заповнена в картці товару Ціна перекреслена стає на Rozetka старою ціною: покупець бачить її перекресленою, а поруч — ціну продажу зі знижкою. Стара ціна має бути вищою за ціну продажу, інакше Rozetka не приймає позицію.

Залишки та наявність

Залишок позиції — вільний залишок у Skynum (залишок без резерву) по складах із поля Тільки залишки по складах; без вибраних складів складаються всі склади. Rozetka показує товар у продажу, доки залишок більший за нуль.

Увімкнений Вивантажувати товари без залишків залишає розпродану позицію у файлі з нульовим залишком: Rozetka ставить їй «немає в наявності», а після надходження товару повертає в продаж без повторної модерації. З вимкненим перемикачем позиція зникає з файлу разом із залишком.

Поле Статус наявності в блоці Інтернет-магазин картки товару керує наявністю вручну: В наявності передає позицію наявною при будь-якому залишку, Немає і Очікується — відсутньою, Автоматично — за залишком. Товар-чернетка, архівний товар і товар, у якого інтеграція Rozetka вимкнена в блоці Підключені інтеграції картки, у файл не потрапляють.

Назва, опис, фото і мови

Назва позиції береться з назви товару; для різновиду до неї додається назва модифікації. Rozetka приймає назву до 255 символів і вимагає, щоб назви у файлі не повторювалися. Бренд у назві пишеться так, як його пише виробник.

Опис береться з поля Опис картки товару, а з увімкненим Опис маркетплейсів — з поля Опис маркетплейсів. Окремий опис потрібен, коли основний опис написаний для власного сайту і містить те, чого Rozetka в описі не допускає: контакти, посилання, згадки інших магазинів. Поле Опис маркетплейсів з'являється в картці товару після вмикання параметра Опис маркетплейсів у Налаштування → Параметри → Облік. Rozetka приймає опис до 50 000 символів з форматуванням.

Виробник товару передається як бренд. Rozetka публікує лише товари з брендом: у картці товару має бути заповнений Виробник назвою зареєстрованої торгової марки так, як вона вже записана на Rozetka. Для товару без торгової марки Rozetka вимагає бренд «Без бренду». Назву магазину, слова «ТМ», «ТОВ» або «ФОП», країну чи завод-виробник як бренд Rozetka не приймає. Артикул товару передається окремим полем і показується в картці Rozetka.

З увімкненим Вивантажувати фото товарів передається до десяти світлин позиції: для різновиду — його власні світлини, а якщо їх немає — світлини товару. Перша стає головним фото картки Rozetka.

У полі Використовувати мови виберіть UA і, якщо картки ведуться двома мовами, RU: тоді Rozetka отримає українську і російську назву з описом із мовних версій картки товару. З однією вибраною мовою другу Rozetka перекладає сама.

Характеристики

Rozetka вимагає для кожної позиції щонайменше три характеристики і зіставляє їх із характеристиками своєї категорії за назвою. Характеристика, назва якої точно збігається з назвою в каталозі Rozetka, зіставляється відразу; іншу Rozetka пробує підібрати, а не підібрану в картці не показує. Чим більше характеристик категорії заповнено, тим вище товар у фільтрах покупця.

Назви характеристик для своєї категорії беруть у кабінеті продавця: Товари → Управління товарами → Довідники, вкладка Загальні довідники, блок Довідники категорій та параметрів. Виберіть кінцеву категорію — і завантажте xls-файл з назвами параметрів і допустимими значеннями.

У Skynum характеристики передаються лише ті, що зіставлені на вкладці API мапінг. Навпроти кожної характеристики впишіть назву з довідника Rozetka:

• Модифікації — характеристики різновидів: навпроти характеристики кольору впишіть Колір, навпроти розміру — Розмір (або ту назву, яку довідник дає для вашої категорії).
• Характеристики — характеристики самого товару: матеріал, країна-виробник, сезон тощо.
• Додаткові поля — поля картки товару, які компанія додала сама; значення піде у файл під вписаною назвою.

Характеристика без вписаної назви у файл не потрапляє. Значення характеристики має бути заповнене в картці: Rozetka не приймає порожню характеристику.

Перевірка і підключення прайс-листа в кабінеті Rozetka

Після збереження інтеграції скопіюйте посилання з поля Файл синхронізації товарів (XML) і перевірте файл у кабінеті продавця: Товари → Управління товарами → Валідатор.

1. Вставте посилання в поле Прайс-лист.
2. Натисніть Перевірити.

Перевірка з'являється в списку з часом завантаження і статусом: Валідація успішно виконана або Помилка валідації. Кнопка Детальніше відкриває звіт: помилки згруповані за причинами — ID, назва, категорія, ціна, виробник, характеристики, фото. Натисніть на групу, щоб побачити позиції з цією помилкою.

Типові помилки виправляються в Skynum:

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

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

Прайс-лист без помилок передайте службі підтримки Rozetka для підключення до профілю продавця — через Допомога в кабінеті, тема Робота з товарами, прайс-лист. Підключений файл з'являється в Товари → Управління товарами → Управління прайс-листами з періодом синхронізації 60 хвилин, кількістю товарів і датою останнього читання. Посилання Skynum постійне: його не потрібно оновлювати після змін у товарах.

Нові позиції з прайс-листа проходять модерацію Rozetka і до публікації видні в кабінеті в Товари → На модерації; відхилені позиції повертаються з причиною. Після виправлення в Skynum позиція йде на повторну модерацію з наступним читанням файлу. Ціна і залишок опублікованого товару оновлюються без модерації.

Налаштування замовлень

Увімкніть у блоці Замовлення перемикач Синхронізація замовлень активна і заповніть налаштування блоку.

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

У полі Час останньої синхронізації видно, коли Skynum останній раз запитував замовлення.

Товари в замовленні

У кожному рядку замовлення Rozetka передає «ID товару у продавця» — той самий ідентифікатор, який Skynum поклав у прайс-лист. За ним Skynum знаходить товар або модифікацію і створює рядок замовлення з кількістю і ціною за одиницю, яку бачив покупець: знижка Rozetka в ціні вже врахована.

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

Якщо товар за ідентифікатором не знайдено, замовлення створюється без цього рядка, а в журналі замовлення записується помилка «Товар не знайдений» з назвою позиції. Так буває після зміни поля ідентифікатора в інтеграції або видалення товару зі Skynum. Поверніть ідентифікатор і завантажте замовлення ще раз кнопкою Завантажити в документі.

Покупець і доставка

Контрагент створюється з ПІБ і телефону покупця в групі з поля Група контрагента. Одержувач посилки береться окремо з даних доставки: ім'я, прізвище, по батькові і телефон одержувача записуються в доставку замовлення. Коментар покупця і коментарі менеджерів Rozetka до замовлення записуються в поле Опис документа.

До кожного замовлення Skynum додає доставку. Замовлення з доставкою ROZETKA Delivery Skynum розпізнає сам і створює доставку виду Магазини Розетка. Решту служб — Нова Пошта, Нова Пошта (поштомати), Укрпошта, Meest ПОШТА — зіставте в блоці Доставка вкладки API мапінг зі способами доставки Skynum; для Нової пошти Skynum підставляє в доставку відділення або поштомат із замовлення. Номер накладної, створеної в кабінеті Rozetka, і планова дата доставки записуються в доставку Skynum.

У списку блоку Доставка показуються служби доставки, які вже зустрічалися в замовленнях вашого магазину. Якщо потрібної служби немає, натисніть Завантажити з Розетка після того, як з'явиться перше замовлення з нею.

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

Способи оплати Rozetka — Оплата під час отримання товару, Оплата карткою Visa/MasterCard, Apple Pay, Google Pay, Оплатити частинами від Rozetka та інші, якими платили ваші покупці, — зіставляються в блоці Оплата вкладки API мапінг зі способами оплати Skynum. Один спосіб оплати Skynum може об'єднувати кілька способів Rozetka: усі карткові оплати — в один безготівковий спосіб, оплату при отриманні — в готівковий.

Оплаченим Skynum вважає замовлення зі статусом оплати Rozetka Оплачено: гроші списані з картки покупця і зараховані Rozetka. Замовлення з оплатою під час отримання статусу оплати не має — покупець платить перевізнику, і оплата в Skynum вноситься після отримання коштів. Заблокована на картці, але не списана сума оплатою не вважається.

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

Замовлення, за яким Rozetka повернула кошти покупцю повністю або частково, Skynum автоматично не оплачує — повернення оформлюється вручну окремим платежем. Коли Rozetka повідомляє про часткову оплату, суми якої не передає, Skynum завантажує замовлення без платежу і записує в журнал замовлення попередження «Сума оплати невідома»: звірте оплату в кабінеті продавця і внесіть платіж вручну.

Замовлення, яке дійшло до завершального статусу без оплати від Rozetka, Skynum завершує продажем у кредит; борг покупця закривається окремим платежем.

Докладніше:

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

Статуси замовлень

Відповідність статусів задається в блоці Статуси на вкладці API мапінг: для кожного статусу Skynum вибирається статус Rozetka. Повний довідник статусів Rozetka завантажується в Skynum кнопкою Завантажити з Розетка: від «Нове замовлення», «Комплектується. Дані підтверджені», «Передано до служби доставки», «Доставляється» і «Замовлення виконано» до скасувань — «Скасовано покупцем», «Клієнт не оплатив», «Немає в наявності», «Відмова при отриманні» та інших.

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

З Експорт замовлень — Тільки статус працює і зворотний напрямок: коли менеджер переводить замовлення в статус Skynum, зіставлений зі статусом Rozetka, Skynum передає цей статус у Rozetka разом з номером накладної з доставки замовлення. Rozetka приймає лише дозволені переходи між своїми статусами, а для статусів «Передано до служби доставки» і «Заплановано передачу перевізникові» вимагає номер накладної. Відхилений Rozetka перехід записується в журнал синхронізації з текстом причини, а статус у Skynum залишається.

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

Один статус Rozetka зіставляйте лише з одним статусом Skynum. Статуси, яких немає у вашому процесі, залишайте без зіставлення.

Ручне завантаження

Щоб не чекати інтервалу, натисніть у картці інтеграції Завантажити замовлення. Завантажені замовлення видно в Торгівля → Замовлення з фільтром за джерелом Розетка; окреме замовлення оновлюється з Rozetka кнопкою Завантажити в документі.

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

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

Стан прайс-листа перевіряється на боці Rozetka: у валідаторі і в розділі Управління прайс-листами кабінету продавця.

Порядок перевірки обміну після підключення — у статті Перевірка синхронізації інтеграцій, причини типових помилок — у статті Типові помилки інтеграцій.

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

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

Підсумок

Прайс-лист зі Skynum дає Rozetka товари з різновидами, характеристиками і фото, замовлення повертаються через API і доходять до статусу з номером накладної, який Skynum передає назад. Обидва потоки тримаються на одному ідентифікаторі позиції, а якість картки Rozetka — на заповнених виробнику, фото і характеристиках за довідником Rozetka.