Интеграция 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. Агент Битрикс ежедневно обновляет курс и использует его при генерации фида.
В 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 Битрикс. Данные покупателя из заказа Satu маппируем на поля b_sale_order_props. ID заказа из Satu сохраняем в пользовательское поле заказа для обратной связи при обновлении статусов.
Особенность: товарные отзывы и рейтинг
Satu.kz, как и другие платформы группы EVO, агрегирует отзывы покупателей. Оценка магазина влияет на позицию в листинге. Интеграция не управляет отзывами напрямую, но своевременная обработка заказов (актуальные остатки, корректные статусы) снижает число негативных обращений.
Генерация фида в Битрикс
Агент запускается раз в час и генерирует 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 отличается от структуры каталога сайта. Нужна таблица соответствий: ваша категория Битрикс → категория Satu.kz. Без правильного маппинга товары попадают в неподходящие разделы и теряются при фильтрации.
Ориентиры по срокам
| Задача | Срок |
|---|---|
| Настройка YML-фида с конвертацией в KZT | 3–7 дней |
| + API-интеграция для получения заказов | 1–2 недели |
| Полная интеграция с маппингом категорий и мониторингом | 2–3 недели |
Стоимость рассчитывается индивидуально после анализа структуры каталога и объёма номенклатуры.