Недавно к нам обратился магазин бытовой техники из Алматы. У них был каталог на 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 и использует при генерации фида.
В 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 часов в месяц на обработке заказов.
Почему маппинг категорий критичен?
Дерево категорий Satu.kz отличается от структуры каталога сайта. Без таблицы соответствий (ваша категория Битрикс → категория Satu.kz) товары попадают в неподходящие разделы и теряются при фильтрации. Это напрямую влияет на видимость и продажи. Маппинг реализуется через HL-блок или отдельную таблицу в базе.
Сравним два подхода:
| Подход | Время настройки | Точность категорий | Сопровождение |
|---|---|---|---|
| Ручное сопоставление | 1-2 дня под 5000 товаров | 80-90% | Частые ошибки при добавлении новых категорий |
| Автоматический маппинг через HL-блок | 3-5 дней | 95%+ | Обновляется через CRM по запросу |
Автоматический маппинг даёт на 15% больше переходов в карточку товара, по нашим замерам.
Генерация фида в Битрикс
Агент запускается раз в час и генерирует 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 агрегирует отзывы покупателей. Оценка магазина влияет на позицию в листинге. Интеграция не управляет отзывами напрямую, но своевременная обработка заказов (актуальные остатки, корректные статусы) снижает число негативных обращений. Опыт показывает, что магазины с быстрой обработкой заказов получают в среднем на 15% выше рейтинг.
Что входит в работу по интеграции?
В рамках проекта мы предоставляем:
- Настройку YML-фида с конвертацией в KZT и маппингом категорий.
- Интеграцию REST API для приёма и обновления заказов.
- Тестирование на боевых данных: не менее 100 заказов для проверки.
- Документацию по агентам и процедуре обновления курса.
- Поддержку в течение 30 дней после запуска.
Бюджет интеграции — от 100 до 300 тысяч тенге в зависимости от объёма каталога и сложности логики. Точную стоимость рассчитаем после аудита вашего проекта.
Ориентиры по срокам
| Задача | Срок |
|---|---|
| Настройка YML-фида с конвертацией в KZT | 3–7 дней |
| + API-интеграция для получения заказов | 1–2 недели |
| Полная интеграция с маппингом категорий и мониторингом | 2–3 недели |
Стоимость рассчитывается индивидуально после анализа структуры каталога и объёма номенклатуры. Получите консультацию: свяжитесь с нами, чтобы оценить ваш проект.
Гарантируем корректную работу фида и обработки заказов. Свяжитесь — обсудим детали.