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

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

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

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

Товари потрапляють на Kasta через XML-файл. Skynum збирає файл з картотеки і дає на нього посилання; це посилання додається в кабінеті постачальника Kasta (HUB) як фід, і далі HUB сам читає файл за своїм розкладом. Skynum перезбирає файл щогодини та після кожного збереження інтеграції.

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

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

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

Токен API в кабінеті Kasta

Токен створюється в HUB: Налаштування → Загальні → вкладка API, розділ Управління АПІ постачальника.

1. Натисніть Створити токен.
2. Скопіюйте значення токена.

Токен не має строку дії і працює лише з методами API постачальника. Усі створені токени показуються в тій самій вкладці з датою створення; непотрібний токен видаляється кнопкою Видалити, після чого інтеграція з ним перестає працювати.

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

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

Перевірка проходить, коли Kasta приймає токен. Якщо перевірка не проходить, скопіюйте токен з HUB ще раз або створіть новий.

Налаштування товарів

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

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

Після збереження в блоці з'являється Файл синхронізації товарів (XML) — посилання на файл для HUB.

Артикул і бренд

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

• Артикул — спільний для всіх модифікацій товару. Товар без артикула передається з його Кодом.
• Виробник — назва бренду точно так, як вона записана в довіднику брендів Kasta. Товар з брендом, якого немає в довіднику, Kasta не публікує і показує у звіті фіду помилку бренду. Новий бренд додає Kasta за листом на [email protected] з назвою, країною, логотипом і посиланням на сайт бренду.

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

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

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

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

Той самий ідентифікатор Kasta повертає в рядку замовлення, і за ним Skynum знаходить товар або модифікацію. Вибирайте поле, значення якого не змінюється протягом життя товару.

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

Не змінюйте Ідентифікатор товара або Ідентифікатор модифікації в робочій інтеграції: Kasta отримає ті самі товари з новими ідентифікаторами, створить їх ще раз і відправить на повторну модерацію.

Категорії

Kasta розкладає товари по власному дереву категорій, і кожна категорія файлу зіставляється з категорією Kasta в HUB. У полі Вивантажувати категорії виберіть За назвою: Skynum передасть категорії Skynum з їхніми назвами та вкладеністю, а зіставлення з деревом Kasta робиться один раз у файлі мапінгу (див. Мапінг у HUB).

Одна категорія Skynum має містити товари одного виду: сукні окремо від спідниць, кросівки окремо від черевиків. Категорія зі змішаними видами товарів зіставляється лише з одним видом Kasta, і решта товарів потрапляє не в свій розділ. Полями Виключити категорії і Тільки товари з категорії обмежується, які категорії йдуть у файл.

Ціни

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

Якщо в картці товару заповнена Ціна перекреслена, Kasta отримує її як рекомендовану ціну і показує покупцю перекресленою, а ціну з вибраного типу — як ціну продажу. Рекомендована ціна має бути не нижчою за ціну продажу, інакше Kasta відхиляє позицію з помилкою ціни.

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

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

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

Увімкніть Вивантажувати товари без залишків: позиція, яка закінчилася, залишиться у файлі з нульовим стоком і повернеться в продаж, щойно з'явиться залишок. Товар зі статусом публікації Чернетка, архівований товар і товар, у якого ця інтеграція знята в блоці Підключені інтеграції картки, у файл не потрапляють.

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

Назва позиції береться з картки товару, опис — з поля Опис або, з увімкненим Опис маркетплейсів, з поля Опис маркетплейсів. Kasta приймає опис до 5000 символів без посилань. Назва й опис не мають містити слів, які Kasta забороняє в контенті: ціни в гривнях, умови передоплати, згадки інших маркетплейсів і служб доставки, «розпродаж», «б/у». Позицію з такими словами Kasta не завантажує.

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

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

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

Колір, розмір і характеристики

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

Характеристики передаються лише ті, що зіставлені на вкладці API мапінг:

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

Товар без розмірного ряду (косметика, техніка, аксесуари) розміру не потребує: Kasta сама ставить йому розмір «-». Колір, якого немає в довіднику кольорів Kasta, зіставляється з найближчим у файлі мапінгу; без зіставлення Kasta записує колір «комбінований».

Поле Назва модифікацій визначає назву різновиду у файлі. Для Kasta виберіть Дублювати назву товара: у всіх кольорів і розмірів одного артикула назва має бути однаковою, інакше Kasta бере одну з назв для всієї картки.

Фід у кабінеті Kasta

Після збереження інтеграції скопіюйте посилання з поля Файл синхронізації товарів (XML).

1. У HUB відкрийте Товари → Імпорт новинок → вкладка XML і натисніть Додати новий фід.
2. Вставте посилання в поле URL фіду.
3. Увімкніть Завантажити товари з xml — без цього фід не читається.
4. Увімкніть Оновлювати ціни, Оновлювати стоки і Оновлювати контент, щоб зміни в Skynum доходили до Kasta.
5. Увімкніть Оновлювати стоки і ціни кожні пів години: ціни й залишки оновлюватимуться окремо від повного читання фіду.
6. Увімкніть Зняти з продажу товари, які відсутні в фіді: позиція, яка зникла з файлу, отримає сток 0.
7. Використати offer id, якщо немає артикула залиште вимкненим: артикул у файлі Skynum є в кожної позиції, а з цим перемикачем різновиди одного товару не збираються в одну картку.
8. За бажанням увімкніть Відправити звіт завантаження в листі і натисніть Зберегти.

Фід отримує ідентифікатор (наприклад, R18AE), і Kasta додає його до посилання. Повне читання фіду йде в загальній черзі Kasta і займає до шести годин; ціни й залишки з увімкненим оновленням кожні пів години підтягуються швидше. Одночасно у постачальника можуть працювати три активні фіди.

Мапінг у HUB

Після першого читання фіду натисніть Редагувати навпроти фіду і в блоці Мапінги натисніть Отримати файл для ручного мапінгу. Це Excel-файл, у якому зіставляються дані файлу Skynum з довідниками Kasta:

• вкладка Категорія+ — навпроти кожної категорії Skynum вибирається категорія і вид товару з дерева Kasta. Підказки системи лежать на вкладці Підказки категорій, повне дерево — на вкладці Довідник Каста;
• вкладка Каскад+ — зіставлення значень характеристик: кольорів, яких немає в довіднику Kasta, розмірів, які Kasta не впізнала, назв характеристик. Зліва вказується назва і значення з файлу, справа — назва і значення Kasta;
• вкладка Ignore_SKU — ідентифікатори позицій, які не потрібно завантажувати; вкладка має бути у файлі навіть порожньою.

Заповнений файл завантажується кнопкою Завантажити ручний мапінг категорій; після цього Kasta перечитує фід. Файл мапінгу зберігається за фідом: його оновлюють лише коли в Skynum з'явилася нова категорія або нові значення кольорів і розмірів.

Розмірні сітки Kasta для кожного виду товару можна скачати там само кнопкою Отримати файл з розмірними сітками Каста. Розмір, який збігається з українською або міжнародною сіткою виду товару, Kasta зіставляє сама; інший розмір зіставляється на вкладці Каскад+.

Звіт фіду і модерація

На вкладці XML навпроти фіду показуються дата останнього читання, кількість помилок і посилання на повний звіт. У картці фіду (кнопка Редагувати) видно підсумок: скільки позицій у файлі, скільки завантажено, скільки не пройшли через фото, бренд, артикул, категорію, розмір чи ціну, а також журнал читань контенту та оновлень стоків і цін.

Нові товари з фіду проходять модерацію менеджера Kasta. Стан кожного товару — у Товари → Управління товарами в HUB: нові, опубліковані та відхилені з причиною. Після виправлення в Skynum товар потрапляє на повторну модерацію з наступним читанням фіду.

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

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

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

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

У полі Час останньої синхронізації видно момент останнього запиту замовлень до Kasta.

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

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

Скасовані та повернуті позиції Kasta передає окремими переліками; Skynum завантажує їх у те саме замовлення, а не створює нове.

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

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

Покупець створюється з прізвища, імені, по батькові та телефону замовлення в групі з поля Група контрагента; e-mail береться з даних доставки. Коментарі покупця записуються в поле Опис замовлення.

До кожного завантаженого замовлення Skynum додає доставку. Нову пошту, Укрпошту і Meest Skynum розпізнає з даних замовлення і підставляє одержувача з його телефоном і відділенням; номер відправлення, зареєстрований у HUB, записується в доставку. Відділення Kasta (KastaPost) та інші варіанти зіставляються в блоці Доставка вкладки API мапінг зі способами доставки Skynum.

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

Способи оплати Kasta — Готівка, Банківська картка і Розстрочка — зіставляються в блоці Оплата вкладки API мапінг зі способами оплати Skynum. Оплаченим Skynum вважає замовлення, за яке гроші вже отримані: для картки і розстрочки — коли Kasta списала кошти з картки покупця (для картки це відбувається після того, як продавець поставив у HUB «Упаковано»), для готівки — коли продавець відмітив отримання коштів у HUB.

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

Замовлення, за яким Kasta вже повернула кошти покупцю, Skynum автоматично не оплачує: повернення оформлюється вручну окремим платежем.

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

Докладніше:

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

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

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

Статуси зіставляються в блоці Статуси вкладки API мапінг: навпроти кожного статусу Skynum вибирається статус Kasta. Перелік статусів Kasta вже є в Skynum: від «Створено», «Підтверджено» і «Упаковано» до «Доставлено», «Відмінено», «Прийнято повернення» і «Повернуто кошти». Зміна статусу потрапляє в Skynum, якщо увімкнено Імпортувати повторно змінені замовлення і вибраний спосіб оновлення включає статус.

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

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

Запити покупця на скасування і коригування («Запит на відміну», «Запит на коригування») теж приходять статусами: зіставте їх зі статусом Skynum, який покаже менеджеру, що замовлення потребує рішення в HUB.

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

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

Подальша робота — резерв, оплата, доставка і виконання — така сама, як у будь-якому замовленні покупця.

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

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

Результат передавання товарів перевіряється у звіті фіду в HUB: файл формує Skynum, а читає і перевіряє його Kasta.

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

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

• токен створений у HUB, вставлений у Skynum, підключення перевірене;
• у товарах для Kasta заповнені Артикул і Виробник з назвою бренду з довідника Kasta;
• Ідентифікатор товара і Ідентифікатор модифікації вибрані, поля заповнені в кожному товарі та модифікації;
• характеристики кольору і розміру зіставлені в блоці Модифікації як Колір і Розмір;
• Вивантажувати категорії — За назвою, категорії Skynum містять товари одного виду;
• фід доданий у HUB з увімкненими завантаженням товарів і оновленнями;
• файл мапінгу заповнений і завантажений, звіт фіду без помилок категорій, брендів і розмірів;
• товари пройшли модерацію і опубліковані;
• статуси, оплати й доставки зіставлені, тестове замовлення з Kasta завантажилося в Skynum.

Підсумок

Товари йдуть на Kasta файлом, замовлення повертаються через API, і обидва потоки тримаються на ідентифікаторі позиції. Заповнені артикул, бренд, колір і розмір дають Kasta правильні картки з різновидами, а файл мапінгу в HUB розкладає їх по дереву Kasta; зіставлені статуси й оплати дають повний цикл замовлення в Skynum.