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