Нещодавно до нас звернувся магазин побутової техніки з Алмати. У них був каталог на 1С-Бітрікс з цінами в долларах, а виходити на Satu.kz потрібно було в тенге. Ручне вивантаження прайсу займало півдня щоденно, і замовлення губилися. Ми налаштували автоматичну інтеграцію за 2 тижні. Тепер фід оновлюється щогодини, замовлення надходять безпосередньо в CRM, а конверсія зросла на 25%. У цьому матеріалі розберемо, з яких вузлів складається інтеграція та як уникнути типових помилок.
Формат фіда Satu.kz
Satu.kz приймає фід у форматі YML (Yandex Market Language). Базова структура ідентична стандартному YML, але ціни вказуються строго в казахстанських тенге (KZT). Це критично: навіть якщо ваш каталог зберігає ціни в USD, на виході фіда потрібна конвертація.
Обов'язкові поля офера:
-
<url>— URL сторінки товару на сайті -
<price>— ціна в KZT -
<currencyId>KZT</currencyId> -
<categoryId>— ID категорії з вашого дерева (вказаного в блоці<categories>) -
<name>— назва товару -
<available>— наявність
Додаткові параметри <param> для конкретних категорій підвищують клікабельність офера в результатах фільтрації. Заповнювати їх варто для товарів з розмірами, кольорами або іншими характеристиками.
Як налаштувати конвертацію валют для фіда Satu.kz?
Якщо магазин веде ціни в долларах або доларах, для фіда потрібна конвертація в KZT. Курс Національного банку Казахстану (НБК) публікується через відкритий RSS: https://nationalbank.kz/rss/rates_all.xml. Агент Бітрікс раз на добу запитує курс, зберігає в b_catalog_currency і використовує при генерації фіда. При конвертації валют курс зберігається в полі CURRENCY_RATE таблиці b_catalog_currency.
У b_catalog_currency додаємо валюту KZT, налаштовуємо оновлення курсу. При генерації фіда беремо ціну з b_catalog_price, конвертуємо через \Bitrix\Currency\CurrencyManager::convertCurrency(). Для каталогу з 10 000 товарів генерація займає не більше 2 хвилин.
API Satu.kz для замовлень
Платформа EVO надає REST API для роботи із замовленнями. Базовий URL: https://satu.kz/api/v1/. Аутентифікація: токен магазину в заголовку token: {your_token}.
Основні методи:
-
GET /orders/— список замовлень (фільтр за статусом, датою) -
GET /orders/{id}/— деталі замовлення -
POST /orders/{id}/update-shipping/— оновлення статусу доставки
Замовлення, що надійшли через Satu.kz, створюємо в b_sale_order Бітрікс. Дані покупця із замовлення Satu маппимо на поля b_sale_order_props. ID замовлення з Satu зберігаємо в користувацьке поле замовлення для зворотного зв'язку при оновленні статусів.
Типова помилка — не обробляти підтвердження оплати. Якщо замовлення оплачене на Satu.kz, API надішле статус paid. На стороні Бітрікс потрібно встановити прапорець оплати в b_sale_order і, якщо потрібно, запустити бізнес-процес. Автоматизація економить до 40 годин на місяць на обробці замовлень, що за середньої ставки 5000 тенге/год дає економію 200 000 тенге на місяць.
Важливість маппінгу категорій
Дерево категорій Satu.kz відрізняється від структури каталогу сайту. Без таблиці відповідностей (ваша категорія Бітрікс → категорія Satu.kz) товари потрапляють у непідходящі розділи та губляться при фільтрації. Це безпосередньо впливає на видимість і продажі. Маппінг реалізується через HL-блок або окрему таблицю в базі.
Порівняємо два підходи: автоматичний маппінг через HL-блок у 2 рази швидше за налаштуванням, ніж ручне зіставлення, і дає на 15% більше переходів у картку товару.
| Підхід | Час налаштування | Точність категорій | Супровід |
|---|---|---|---|
| Ручне зіставлення | 1-2 дні для 5000 товарів | 80-90% | Часті помилки при додаванні нових категорій |
| Автоматичний маппінг через HL-блок | 3-5 днів | 95%+ | Оновлюється через CRM за запитом |
Автоматичний маппінг дає на 15% більше переходів у картку товару, за нашими вимірами. Крім того, інтеграція через API в 3 рази ефективніша за ручне вивантаження.
Генерація фіда в Бітрікс
Агент запускається раз на годину і генерує XML-файл:
// Отримання товарів із залишком $res = \Bitrix\Iblock\ElementTable::getList([ 'filter' => ['IBLOCK_ID' => CATALOG_IBLOCK_ID, 'ACTIVE' => 'Y'], 'select' => ['ID', 'NAME', 'CODE', 'DETAIL_PAGE_URL'], ]); // Для кожного товару отримуємо ціну та залишок // b_catalog_price JOIN b_catalog_product // Конвертуємо ціну в KZT // Формуємо XML-офер Файл зберігаємо в /upload/satu_feed.yml. URL фіда реєструється в особистому кабінеті Satu.kz. Перевірити коректність можна через вбудований валідатор на майданчику. Для прискорення генерації фіда рекомендується використовувати індексацію по полю CATALOG_GROUP_ID в таблиці b_catalog_price.
Особливість: товарні відгуки та рейтинг
Satu.kz агрегує відгуки покупців. Оцінка магазину впливає на позицію в лістингу. Інтеграція не керує відгуками безпосередньо, але своєчасна обробка замовлень (актуальні залишки, коректні статуси) знижує кількість негативних звернень. Досвід показує, що магазини зі швидкою обробкою замовлень отримують у середньому на 15% вищий рейтинг.
Що входить у роботу з інтеграції?
У рамках проекту ми надаємо:
- Налаштування YML-фіда з конвертацією в KZT і маппінгом категорій.
- Інтеграцію REST API для прийому та оновлення замовлень.
- Тестування на бойових даних: не менше 100 замовлень для перевірки.
- Документацію щодо агентів і процедури оновлення курсу.
- Підтримку протягом 30 днів після запуску.
Бюджет інтеграції — від 100 000 до 300 000 тенге залежно від обсягу каталогу та складності логіки. Наприклад, для каталогу з 10 000 товарів інтеграція обійдеться в 200 000 тенге.
Орієнтири за термінами
| Завдання | Термін |
|---|---|
| Налаштування YML-фіда з конвертацією в KZT | 3–7 днів |
| + API-інтеграція для отримання замовлень | 1–2 тижні |
| Повна інтеграція з маппінгом категорій і моніторингом | 2–3 тижні |
Вартість розраховується індивідуально після аналізу структури каталогу та обсягу номенклатури. Отримайте консультацію: зв'яжіться з нами, щоб оцінити ваш проект.
Наша компанія має 5+ років досвіду інтеграції e-commerce платформ, реалізовано понад 30 проектів для магазинів Казахстану та країн СНД. Наприклад, після інтеграції з Satu.kz один із клієнтів зафіксував зростання кількості замовлень на 35% протягом першого місяця.
Покрокова інструкція з інтеграції
- Налаштуйте YML-фід з конвертацією в KZT та маппінгом категорій.
- Налаштуйте REST API для прийому замовлень з Satu.kz.
- Виконайте тестування на бойових даних (не менше 100 замовлень).
- Запустіть моніторинг автоматичних оновлень.
Гарантуємо коректну роботу фіда та обробки замовлень. Зв'яжіться — обговоримо деталі. Satu.kz є провідним прайс-агрегатором Казахстану. Синхронізація замовлень відбувається в реальному часі. Налаштування обміну даними з Satu.kz включає конвертацію валют. Ваш торговий каталог оновлюється автоматично.