Kaspi.kz — маркетплейс №1 у Казахстані. Якщо ви продаєте на ньому, замовлення надходять у ваш кабінет продавця Kaspi; Elbuz забирає їх напряму через API й перетворює на документи, з якими працюють ваші менеджери. Так замовлення Kaspi опиняються в одній черзі обробки разом із продажами з інших каналів, а не в окремому кабінеті.
Ця стаття — про підключення саме Kaspi. Загальний порядок для всіх систем із замовленнями описано в огляді імпорту замовлень через API; тут — особливості Kaspi: який ключ потрібен, як іде перше завантаження і що з зіставленням статусів. Kaspi приносить лише замовлення — каталог з нього не завантажується, товари приходять як рядки самих замовлень.
Де це у програмі
У вікні імпорту створіть шаблон і оберіть тип «Kaspi». Це API-джерело: файл не потрібен, підключення відбувається за токеном. Один шаблон — одне підключення до одного магазину Kaspi.
Що потрібно для підключення
Для Kaspi потрібне лише одне значення — Токен. Це ключ доступу до API, який видає сам Kaspi в кабінеті продавця (у розділі налаштувань магазину / інтеграцій). Ви вставляєте його в поле «Токен» у картці «Підключення» — і цього достатньо. Токен це доступ до вашого магазину, тож зберігайте його як пароль; якщо він скомпрометований, у кабінеті Kaspi його можна перевипустити, а потім оновити в шаблоні.
Як підключити крок за кроком
Створіть шаблон типу «Kaspi». Вставте токен у картці «Підключення». Переконайтесь, що ввімкнено завантаження замовлень. Збережіть і запустіть. Перше підключення забере наявні замовлення, наступні — лише нові й змінені. Радимо перший запуск перевірити очима: відкрийте кілька завантажених замовлень і звірте позиції, суми, покупця й статус.
Що приходить із замовленням
Із кожного замовлення Kaspi Elbuz бере склад позицій (товари, кількість, ціни), дані покупця, суми й поточний статус. Самі товари підтягуються як рядки замовлення додатковими запитами до Kaspi, тож окремо вантажити каталог не потрібно. На основі цих даних створюється документ — замовлення покупця, — з яким далі працюють ваші менеджери: підтверджують, комплектують, відвантажують. Покупець із замовлення заводиться у вашу базу контрагентів, тож історія його покупок збирається в одному місці, а не лишається розкиданою по кабінету маркетплейсу.
Перше завантаження і період
Перше підключення Kaspi відрізняється від подальших. Першого разу Elbuz проходить по всіх станах замовлень — нові, ті, що потребують підпису, на видачі, у доставці, у доставці Kaspi та в архіві, — щоб підтягнути повну поточну картину. Далі, під час регулярних оновлень, забираються переважно нові замовлення, щоб не перевантажувати систему й не тягнути вже оброблене.
Важлива деталь: Kaspi віддає замовлення за обмежений період, і Elbuz бере історію максимум за два тижні назад. Тобто перше завантаження підтягне замовлення приблизно за останні 14 днів, а не за весь час існування магазину. Це нормально: подальші оновлення підхоплюють усе нове, а старі замовлення й так уже оброблені в кабінеті Kaspi. Тому не варто відкладати перше підключення — що раніше поставите шаблон на розклад, то повнішою буде історія в Elbuz.
Статуси і їх зіставлення
У Kaspi свої стани й статуси замовлень: новий, на погодженні, виконано, повернення, скасовано тощо. Elbuz зводить їх до власних статусів — базове зіставлення вже вбудоване. Крім того, прямо у формі шаблону є кнопки тонкого налаштування: ви можете вручну задати відповідність зовнішніх статусів замовлення, доставки й оплати вашим внутрішнім, а також зіставити типи оплати (наприклад, «Кредит» чи «Передоплата» Kaspi — вашим типам). Тип оплати «в кредит» і передоплату Kaspi розрізняє, і Elbuz це враховує.
Розклад і оновлення
Kaspi працює поллінгом: Elbuz сам звертається до нього за розкладом і забирає свіжі замовлення — вебхука (миттєвого сповіщення) тут немає. Тому саме розклад визначає, наскільки швидко нові замовлення з'являться в Elbuz. Для активного магазину має сенс перевіряти часто — кільканадцять разів на день. Розклад задають кнопкою налаштування завдання прямо у формі шаблону. Elbuz веде інкремент за датою й номером останнього замовлення, тож повторно те саме не тягнеться.
Навіщо зводити замовлення Kaspi в Elbuz
Кабінет Kaspi добре показує замовлення самого Kaspi, але якщо ви продаєте ще десь, продажі опиняються в різних місцях. Звівши замовлення Kaspi в Elbuz, ви обробляєте їх в одній черзі разом з іншими каналами: списання зі складу, облік покупців, єдині статуси, друк документів. Менеджеру не треба тримати окрему вкладку Kaspi — усі замовлення в одному списку.
Часті труднощі
Найчастіша причина, чому замовлення не приходять, — токен. Перевірте, що він скопійований повністю, без зайвих пробілів, і що доступ до API в кабінеті Kaspi активний. Якщо ви перевипустили токен у кабінеті, його треба оновити й у шаблоні, інакше чергове звернення завершиться помилкою авторизації — це буде видно в журналі.
Друга типова ситуація — «не бачу старих замовлень». Це не помилка: Kaspi віддає історію приблизно за два тижні, тож замовлення давніші за цей період через API не приходять. Працюйте з ними в кабінеті Kaspi, а Elbuz нехай веде все нове з моменту підключення. Якщо ж нові замовлення приходять, а якесь одне «загубилось», перевірте його стан у кабінеті: можливо, воно в тому стані, який на регулярних оновленнях уже не забирається (беруться переважно нові) — тоді досить дочекатися, доки воно перейде в актуальний робочий статус.
Підключіть Kaspi якомога раніше й одразу поставте на розклад: оскільки історія обмежена двома тижнями, кожен день зволікання — це замовлення, які в Elbuz уже не підтягнуться. А от нове піде повністю, щойно шаблон запрацює.
Що далі із завантаженими замовленнями
Завантажити замовлення — це початок. Далі вони живуть у Elbuz як документи «замовлення покупця», і з ними працюють як зі звичайними: підтверджують, резервують і списують товар зі складу, оформлюють доставку й друкують документи, ведуть покупця в базі контрагентів. Якщо ви тільки починаєте знайомство з системою, орієнтуйтеся на загальну карту дій — з чого почати і куди рухатися: там показано весь робочий цикл в Elbuz.
Коли Kaspi — не єдиний ваш канал, його замовлення сходяться в один список разом з іншими майданчиками, і менеджер обробляє їх однаково. Загальні принципи роботи із замовленнями з різних систем описано в огляді імпорту замовлень через API — Kaspi підпорядковується тому самому порядку, з поправкою на свій дволанковий перший імпорт і обмеження історії двома тижнями.
Часті питання
Де взяти токен Kaspi?
Токен видає сам Kaspi в кабінеті продавця, у розділі налаштувань магазину / інтеграцій. Ви вставляєте його в поле «Токен» у формі шаблону — це єдине, що потрібно для підключення.
Чи можна завантажити з Kaspi товари в каталог?
Ні. Kaspi у Elbuz приносить лише замовлення; товари приходять як рядки замовлень. Каталог з Kaspi через це підключення не завантажується.
Чому не завантажились замовлення за минулий місяць?
Kaspi віддає замовлення за обмежений період, і Elbuz бере історію максимум за два тижні назад. Давніші замовлення через API не приходять — це обмеження джерела, а не Elbuz.
Як налаштувати відповідність статусів?
Базове зіставлення вже вбудоване. Для тонкого налаштування у формі шаблону є кнопки: статус замовлення, статус доставки, статус оплати, тип оплати й тип доставки — там ви задаєте, який зовнішній статус відповідає якому вашому.
Замовлення з'являються з затримкою — чому?
Kaspi працює поллінгом, без миттєвих сповіщень, тож нові замовлення підтягуються під час чергового запуску за розкладом. Щоб затримка була меншою, поставте частіший розклад.