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