Інтеграція 1С-Бітрікс з Satu.kz (Казахстан)
Satu.kz — найбільший казахстанський прайс-агрегатор (частина групи EVO, до якої також належать Prom.ua, Satu.kz, Tiu.ru). Для казахстанських інтернет-магазинів на 1С-Бітрікс інтеграція з Satu.kz — стандартне завдання при виході на місцевий ринок або розширенні присутності. Технічно платформа працює за тією ж схемою, що й Prom.ua: YML-фід плюс API для управління замовленнями.
Формат фіду Satu.kz
Satu.kz приймає фід у форматі YML (Yandex Market Language). Базова структура ідентична стандартному YML, але з вимогою вказувати ціни в казахстанських тенге (KZT).
Обов'язкові поля офера:
-
<url>— URL сторінки товару на сайті -
<price>— ціна в KZT -
<currencyId>KZT</currencyId> -
<categoryId>— ID категорії з вашого дерева (зазначеного в блоці<categories>) -
<name>— назва товару -
<available>— наявність
Додаткові параметри <param> для конкретних категорій підвищують клікабельність офера в результатах фільтрації.
Конвертація валют
Якщо магазин веде ціни в рублях (RUB) або доларах (USD), для фіду потрібна конвертація в KZT. Курс Національного банку Казахстану (НБК) публікується через API: https://nationalbank.kz/rss/rates_all.xml. Агент 1С-Бітрікс щодня оновлює курс і використовує його при генерації фіду.
У b_catalog_currency додаємо валюту KZT, налаштовуємо оновлення курсу. При генерації фіду беремо ціну з b_catalog_price, конвертуємо через \Bitrix\Currency\CurrencyManager::convertCurrency().
API Satu.kz для замовлень
Платформа EVO (до якої належить Satu.kz) надає 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 1С-Бітрікс. Дані покупця із замовлення Satu маппимо на поля b_sale_order_props. ID замовлення з Satu зберігаємо в користувацьке поле замовлення для зворотного зв'язку при оновленні статусів.
Особливість: товарні відгуки та рейтинг
Satu.kz, як і інші платформи групи EVO, агрегує відгуки покупців. Оцінка магазину впливає на позицію в лістингу. Інтеграція не управляє відгуками безпосередньо, але своєчасна обробка замовлень (актуальні залишки, коректні статуси) знижує кількість негативних звернень.
Генерація фіду в 1С-Бітрікс
Агент запускається раз на годину та генерує 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.
Маппінг категорій
Дерево категорій Satu.kz відрізняється від структури каталогу сайту. Потрібна таблиця відповідностей: ваша категорія 1С-Бітрікс → категорія Satu.kz. Без правильного маппінгу товари потрапляють у невідповідні розділи та губляться при фільтрації.
Орієнтири за термінами
| Завдання | Термін |
|---|---|
| Налаштування YML-фіду з конвертацією в KZT | 3–7 днів |
| + API-інтеграція для отримання замовлень | 1–2 тижні |
| Повна інтеграція з маппінгом категорій і моніторингом | 2–3 тижні |
Вартість розраховується індивідуально після аналізу структури каталогу та обсягу номенклатури.