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