Elbuz сам забирає замовлення з кабінету продавця Kasta HUB через API Kasta за токеном і кладе їх документами в одну чергу з іншими каналами. Статус і ТТН можуть іти назад на Kasta.
Коли це знадобиться:
- Каталог на Kasta іде фідом з Elbuz — позиції замовлень лягають на ваші картки.
- Менеджери не хочуть двічі міняти статус — підтвердження, ТТН і скасування доходять до Kasta самі.
- Покупець скасував або повертає товар — статус документа змінюється сам.
З чого почати: «Завантаження даних» → «Додати» → тип «Kasta», далі токен із кабінету HUB.
Що вміє підключення Kasta
- Замовлення — покупець, отримувач, відділення Нової пошти, ТТН, оплата й коментар лягають у документ.
- Зіставлення з каталогом — позиції знаходять ваші картки за артикулом і назвою або за номером товару з вашого фіда.
- Статуси Kasta — зводяться до ваших без налаштування, зокрема відміна й повернення.
- Статус назад на Kasta — підтвердження, упаковка, ТТН і скасування з причиною.
- Розклад — кожні 5 хвилин, лише змінені замовлення.
Товари, ціни й залишки це підключення не передає: асортимент іде на Kasta XML-фідом, і Kasta сама оновлює з нього ціни й наявність.
Як підключити Kasta за токеном
- У кабінеті Kasta HUB відкрийте «Налаштування» → вкладка «API» і скопіюйте токен.
- У вікні «Завантаження даних» натисніть «Додати» й оберіть тип «Kasta». Перемикачів «що завантажувати» у формі немає: підключення вміє тільки замовлення.
- Вставте токен у поле «Токен» картки «Підключення». Форма зберігається сама.
- Натисніть «Перевірити підключення». Успіх — «Підключення працює. Kasta (назва вашої організації)». Невдача — «Підключення не вдалося:» і відповідь Kasta.
- Шаблон з пілюлею «Активний» протягом 5 хвилин почне забирати замовлення сам, перший раз — за 30 днів. Не чекати — натисніть «Завантажити».
З токеном можна читати ваші замовлення й міняти їхні статуси. Не пересилайте його у відкритих чатах. Видали або замінили токен у HUB — вставте новий у шаблон, інакше завантаження отримуватиме відмову.
Що переноситься в замовлення
Замовлення лягає документом «Замовлення покупця».
| Дані Kasta | Що з них виходить в Elbuz |
|---|---|
| номер замовлення | зовнішній номер і ключ, за яким замовлення впізнається повторно |
| покупець: ім'я, по батькові, прізвище, телефон; пошта з адреси доставки | контрагент і контакти документа |
| отримувач: ім'я, прізвище, телефон, місто | отримувач доставки |
| доставка Новою поштою | вид доставки «Нова пошта», відділення за його кодом — з адресою з довідника Нової пошти |
| номер відправлення | ТТН документа |
| спосіб оплати | код Kasta як є: card (карткою), cod (при отриманні), bnpl (оплата частинами) |
| успішне списання з картки або статус «Оплачено» в історії замовлення | статус оплати «Оплачено», інакше «Чекання» |
| коментарі | опис замовлення |
| статус | статус документа (таблиця) |
| позиції | рядки документа з ціною, яку заплатив покупець; позиції, зняті коригуванням, не переносяться |
Сума документа — те, що покупець заплатив за товари. Вартість доставки в документ не додається.
Як позиції знаходять картки каталогу
У рядку замовлення Kasta повертає ідентифікатор товару з вашого фіда (offer id) з приставкою rzid_, а також артикул, бренд, колір і розмір. Загальний порядок пошуку — як позиції знаходять товар:
- Спершу — картка, яку Elbuz уже заводив під цю позицію Kasta на минулих завантаженнях, потім — внутрішній код товару.
- Далі — за артикулом разом із назвою, потім за самою назвою. Назву Elbuz складає з виду товару, бренду, кольору й розміру з рядка Kasta.
- Останнім — за ідентифікатором із фіда як номером товару в Elbuz: у шаблоні Kasta з Elbuz
offer idі є цей номер. - Не знайшлося нічого — Elbuz заводить картку в службовій категорії «Товари - kasta - ‹назва шаблону›». Категорія створюється вимкненою, тож у фіди такі картки самі не підуть.
Як статуси Kasta стають вашими
Зіставлення вбудоване в підключення. Kasta не віддає поточний статус окремим полем — Elbuz визначає його з історії замовлення: відміна й повернення перекривають доставку, а з етапів доставки береться найпізніший.
| Статус на Kasta | Код | Статус документа в Elbuz |
|---|---|---|
| Створено | Created | Новий |
| Підтверджено | ConfirmedBySupplier | Підтвердження |
| Упаковано; Зареєстровано у кур'єрській службі | Packed; AnnouncedForDelivery | Зібрано |
| Відправлено | SentToDelivery | Відвантажено |
| Прибув у відділення | AtLocation; ReceivedAtSelfDelivery | Доставлено |
| Доставлено | Delivered | Видано |
| Відмінено | Cancelled | Скасовано |
| Запит на відміну (поки продавець не відмовив) | CancellationRequested | Чекає скасування |
| Повернення створено, відправлено, у відділенні, доставлено (якщо повернення не скасовано) | ReturnCreated та інші | Чекає повернення |
| Прийнято повернення; Повернуто кошти | ReturnArrived; Refunded | Повернуто |
1
Статус на майданчику2
Ваш статус3
Рядок «Упаковано» з позначкою «з таблиці»- Статус на майданчику — так його називає Kasta (рядок «Створено»).
- Ваш статус — статус документа в Elbuz, який відповідає статусу майданчика.
- Рядок «Упаковано» зіставлено за таблицею статусів, про що свідчить позначка «з таблиці».
Як статус і ТТН ідуть назад на Kasta
Змінили статус замовлення Kasta в Elbuz — новий статус іде на Kasta. Для ручної зміни статусу це з коробки вимкнено; скасування замовлення AI-підтримкою йде на Kasta незалежно від перемикача, якщо навпроти «Скасовано» в таблиці стоїть код Cancelled. Щоб увімкнути:
- Увімкніть перемикач «Передавати статус замовлення на маркетплейс»: «Звернення» → шестерня → «Автономна підтримка» → вкладка «Канали й проактив».
- Відкрийте шаблон Kasta, кнопку «Статуси замовлення», і впишіть коди Kasta навпроти своїх статусів, наприклад: «Підтвердження» — ConfirmedBySupplier, «Зібрано» — Packed, «Відвантажено» — SentToDelivery, «Скасовано» — Cancelled. Для реєстрації ТТН є ще AnnouncedForDelivery, для «Доставлено» — Delivered.
- Проміжні етапи можна пропускати. Elbuz просить Kasta сформувати пропущені етапи самій, тож одразу «Відвантажено» можна ставити без «Підтверджено» й «Упаковано».
- ТТН. «Зареєстровано у кур'єрській службі» і «Відправлено» Kasta приймає лише з ТТН. Якщо в HUB увімкнено автоматичне відстеження відправлень, «Відправлено» Kasta ставить сама й чужий не приймає — тоді навпроти «Відвантажено» впишіть AnnouncedForDelivery. Якщо в документі ТТН порожня, Elbuz статус не відправляє і пише про це в історію документа. Впишіть ТТН і поставте статус ще раз.
- «Упаковано» — Elbuz бере позиції й суму з самого замовлення на Kasta. За оплати карткою Kasta списує гроші з картки покупця саме в момент «Упаковано».
- Скасування йде з причиною: прохання покупця, «передумав» чи «знайшов дешевше» у зверненні до AI-підтримки — «Покупець сам попросив скасувати», дубль — «Замовлення дубльоване», в усіх інших випадках, зокрема ручне «Скасовано», — «Персональне рішення продавця».
- Повтор безпечний. Той самий статус для того самого замовлення Kasta приймає лише раз, повторна передача не створює дубля.
- Результат видно в історії документа: «Статус передано на маркетплейс: Packed» або причина, чому ні — статус не зіставлено, немає доступів шаблону, помилка від Kasta.
Для Kasta таблиця «Статуси замовлення» потрібна лише для передавання статусу назад: при завантаженні статуси зводить вбудована таблиця. Якщо в рядку стоїть кілька кодів через кому, на Kasta піде перший.
Що буде з уже завантаженим замовленням
Замовлення впізнається за номером на Kasta, тож копії не з'являється. Правила загальні для маркетплейсів (два статуси одного замовлення):
- Документ не проведено, статус на Kasta змінився — статус документа перезаписується за вбудованою таблицею; той самий — ваш статус лишається.
- Документ проведено — змінюється лише на статуси, що знімають резерв: відміна чи повернення на Kasta переведуть і проведений документ, резерв перерахується.
Після успішної передачі статусу на Kasta Elbuz запам'ятовує відправлений код, тож наступне завантаження з тим самим кодом ваш статус не перепише. Сума, кількість і ціна в рядках при повторному завантаженні не змінюються.
Автоматичне завантаження
Системне завдання «Замовлення з маркетплейсів» кожні 5 хвилин забирає замовлення всіх активних шаблонів Kasta з токеном. Розклад шаблону не потрібен. Докладніше — автоматичне завантаження замовлень.
- Перший запуск забирає замовлення за останні 30 днів.
- Наступні — лише змінені після найсвіжішого вже завантаженого, із запасом 10 хвилин: статуси на Kasta з'являються із затримкою.
- Обсяг прогону — порції по 100 замовлень, до 100 порцій. Помилка Kasta обриває прогін без запису: наступний перечитає те саме вікно цілком.
- Ліміти Kasta. На «забагато запитів» (429) Elbuz чекає довше й пробує до трьох разів, на збій сервера — так само до трьох.
Рядки журналу: «Kasta: сторінка N, отримано замовлень: M» і в кінці «Kasta: завантаження замовлень завершено, усього: N».
Вимикач — пілюля «Активний» / «Вимкнений» у колонці «Стан» списку завантажень. Вимкнений шаблон автоматичне завантаження пропускає, і статуси на Kasta перестають іти: передавання шукає активний шаблон Kasta.
Сценарії
Замовлення мають приходити самі
Вставте токен, натисніть «Перевірити підключення» й переконайтеся, що шаблон «Активний». Кожні 5 хвилин прогін забирає змінені замовлення, перший — за 30 днів.
Менеджер оформлює ТТН в Elbuz, Kasta дізнається сама
Увімкніть передавання статусу й впишіть SentToDelivery навпроти «Відвантажено». Впишіть ТТН у документ і поставте «Відвантажено»: Kasta отримає статус «Відправлено» з номером; пропущені етапи Elbuz просить Kasta сформувати самій. З авто-треком у HUB ставте навпроти «Відвантажено» AnnouncedForDelivery.
Покупець просить скасувати
Запит на відміну з Kasta переведе документ у «Чекає скасування». Поставте «Скасовано» — при ввімкненому передаванні й коді Cancelled у таблиці Kasta отримає відміну з причиною «Персональне рішення продавця». Через AI-підтримку відміна на прохання покупця піде з причиною «Покупець сам попросив скасувати».
Позиції мають лягати на наявні картки
Вивантажуйте каталог на Kasta шаблоном Elbuz і не міняйте в ньому offer id: тоді ідентифікатор у замовленні дорівнює номеру товару, і позиція знайде свою картку.
Що робити, коли замовлення не приходять або статус не доходить
| Що ви бачите | Чому так | Що зробити |
|---|---|---|
| «Kasta: не вказано токен доступу» | У шаблоні порожнє поле «Токен» | Вставте токен із «Налаштування» → «API» кабінету HUB |
| «Kasta: помилка звернення до API.» у журналі | Kasta відповіла помилкою; причина стоїть у тому ж рядку | Разовий збій — наступний прогін через 5 хвилин перечитає те саме вікно. Помилка повторюється — перевірте токен кнопкою «Перевірити підключення» |
| «Статус … не передано на маркетплейс: для нього площадка вимагає ТТН» | Для «Зареєстровано у КС» чи «Відправлено» в документі немає ТТН | Впишіть ТТН і поставте статус ще раз |
| «Статус не передано на маркетплейс: «…» не зіставлено зі статусом площадки» | Навпроти цього статусу в таблиці «Статуси замовлення» немає коду Kasta | Впишіть код, якщо статус має щось означати на Kasta |
| «Статус … не передано на маркетплейс: …» з відповіддю Kasta про неможливий статус або увімкнений авто-трек | Kasta не прийняла перехід: замовлення там уже скасовано чи далі за ланцюжком, або «Відправлено» Kasta відстежує сама | Звірте статус у кабінеті HUB; з авто-треком передавайте ТТН кодом AnnouncedForDelivery |
Часті запитання
Чи оновлює це підключення ціни й залишки на Kasta?
Ні. Elbuz передає на Kasta асортимент, ціни й залишки XML-фідом, а Kasta сама оновлює їх із нього — вивантаження на Kasta.
Чому сума документа менша, ніж у кабінеті Kasta?
У документ іде лише сума, яку покупець заплатив за товари. Вартість доставки Elbuz не додає.
За який період підтягнуться замовлення під час першого запуску?
За останні 30 днів. Потрібен інший період — впишіть дату в поле «Завантаження замовлень починаючи з дати (РРРР-ММ-ДД)» розділу «Розширене» форми шаблону.
Покупець відмовився від частини товарів — що буде з документом?
Позиції, зняті коригуванням на Kasta, у новий документ не потрапляють. У вже завантаженому документі рядки й сума при повторному завантаженні не змінюються — поправте їх вручну.
Чи заважає Kasta підключенню Rozetka чи Prom?
Ні. Кожен майданчик — свій шаблон, а таблиці статусів ведуться для кожного шаблону окремо.
Де це і хто має доступ
- Меню
- Операції → Завантаження даних → шаблон типу «Kasta»
- Право доступу
- вікно «Завантаження» у «Правах груп»
- Підготувати
- токен із кабінету Kasta HUB («Налаштування» → «API»)
1
Поле «Токен»2
Кнопка «Перевірити підключення»- Поле «Токен» — сюди вставляють токен кабінету Kasta HUB.
- Кнопка «Перевірити підключення» — перевіряє, що токен приймається.
Суміжні теми
- Якщо каталог на Kasta ще не вивантажено — вивантаження товарів на Kasta XML-фідом.
- Якщо замовлення приклеїлося не до того покупця — завантаження замовлень через API.
- Якщо продаєте ще на Rozetka — каталог і замовлення з Rozetka.
