↑↓ вибірEnter відкритиEsc закрити

    1. Elbuz
    2. Керівництво користувача Elbuz
    3. Завантаження даних
    4. Маркетплейси України й Казахстану

    Як завантажувати замовлення з Kasta в Elbuz

    8 хв читанняОновлено

    Elbuz сам забирає замовлення з кабінету продавця Kasta HUB через API Kasta за токеном і кладе їх документами в одну чергу з іншими каналами. Статус і ТТН можуть іти назад на Kasta.

    Коли це знадобиться:

    • Каталог на Kasta іде фідом з Elbuz — позиції замовлень лягають на ваші картки.
    • Менеджери не хочуть двічі міняти статус — підтвердження, ТТН і скасування доходять до Kasta самі.
    • Покупець скасував або повертає товар — статус документа змінюється сам.

    З чого почати: «Завантаження даних» → «Додати» → тип «Kasta», далі токен із кабінету HUB.

    Що вміє підключення Kasta

    • Замовлення — покупець, отримувач, відділення Нової пошти, ТТН, оплата й коментар лягають у документ.
    • Зіставлення з каталогом — позиції знаходять ваші картки за артикулом і назвою або за номером товару з вашого фіда.
    • Статуси Kasta — зводяться до ваших без налаштування, зокрема відміна й повернення.
    • Статус назад на Kasta — підтвердження, упаковка, ТТН і скасування з причиною.
    • Розклад — кожні 5 хвилин, лише змінені замовлення.

    Товари, ціни й залишки це підключення не передає: асортимент іде на Kasta XML-фідом, і Kasta сама оновлює з нього ціни й наявність.

    Як підключити Kasta за токеном

    1. У кабінеті Kasta HUB відкрийте «Налаштування» → вкладка «API» і скопіюйте токен.
    2. У вікні «Завантаження даних» натисніть «Додати» й оберіть тип «Kasta». Перемикачів «що завантажувати» у формі немає: підключення вміє тільки замовлення.
    3. Вставте токен у поле «Токен» картки «Підключення». Форма зберігається сама.
    4. Натисніть «Перевірити підключення». Успіх — «Підключення працює. Kasta (назва вашої організації)». Невдача — «Підключення не вдалося:» і відповідь Kasta.
    5. Шаблон з пілюлею «Активний» протягом 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Рядок «Упаковано» з позначкою «з таблиці»
    1. Статус на майданчику — так його називає Kasta (рядок «Створено»).
    2. Ваш статус — статус документа в Elbuz, який відповідає статусу майданчика.
    3. Рядок «Упаковано» зіставлено за таблицею статусів, про що свідчить позначка «з таблиці».

    Як статус і ТТН ідуть назад на Kasta

    Змінили статус замовлення Kasta в Elbuz — новий статус іде на Kasta. Для ручної зміни статусу це з коробки вимкнено; скасування замовлення AI-підтримкою йде на Kasta незалежно від перемикача, якщо навпроти «Скасовано» в таблиці стоїть код Cancelled. Щоб увімкнути:

    1. Увімкніть перемикач «Передавати статус замовлення на маркетплейс»: «Звернення» → шестерня → «Автономна підтримка» → вкладка «Канали й проактив».
    2. Відкрийте шаблон 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»)
    Форма шаблону «Kasta» з карткою «Підключення»
    1Поле «Токен»
    2Кнопка «Перевірити підключення»
    1. Поле «Токен» — сюди вставляють токен кабінету Kasta HUB.
    2. Кнопка «Перевірити підключення» — перевіряє, що токен приймається.

    Суміжні теми

    Чи була стаття корисною?

    Не вистачає функції? Напишіть нам.

    Ми додамо її безкоштовно, якщо вона знадобиться й іншим.

    Якщо це потрібно тільки вам — домовимося окремо.

    Зміст статті

    Запропонувати доробку

    Спробувати безкоштовно