Интеграция 1С-Битрикс с СберМегаМаркет

Интеграция 1С-Битрикс с СберМегаМаркет

СберМегаМаркет (бывший goods.ru) работает по модели DBS и FBS, но интеграция устроена иначе, чем у Ozon и Wildberries. Основной канал загрузки товаров — XML-фид, близкий по формату к YML, но с расширениями. Управление заказами — через Merchant API. Эта двойственность (фид для каталога + API для заказов) требует настройки двух независимых механизмов на стороне Битрикс.

Фид товаров: формат и требования

СберМегаМаркет принимает фид в формате, совместимом с YML, но с дополнительными тегами. URL фида указывается в личном кабинете продавца, маркетплейс забирает его по расписанию (обычно раз в 2–4 часа).

Структура <offer>:

<outlets> — ключевой тег для DBS-модели. Содержит <outlet id="ID" instock="КОЛИЧЕСТВО"/> для каждой точки продаж. ID точки создаётся в личном кабинете СберМегаМаркет. В Битрикс остатки берутся из складского учёта модуля catalog или из отдельного свойства элемента.

<shipment-options> — указывает, за сколько дней продавец готов отгрузить товар. Пример: <option days="1" order-before="14"/> — отгрузка за 1 день при заказе до 14:00. Маркетплейс использует это для расчёта сроков доставки покупателю.

Генерация фида в Битрикс

Стандартный YML-экспорт в Битрикс (catalog.export, профиль «Яндекс.Маркет») не генерирует теги <outlets> и <shipment-options>. Варианты:

1. Доработка стандартного экспорта. В файле обработчика /bitrix/php_interface/include/catalog_export/ модифицируется шаблон генерации XML — добавляются нужные теги. Остатки подтягиваются из CCatalogStoreProduct::GetList() для каждого товара.

2. Модуль из Marketplace. Готовые решения для СберМегаМаркет (например, от Kooplex или RetailCRM) добавляют профиль экспорта с поддержкой всех специфичных тегов.

3. Отдельный PHP-скрипт. Скрипт по cron генерирует XML, выбирая данные из инфоблока через API CIBlockElement::GetList(). Преимущество — полный контроль без зависимости от модуля экспорта.

Merchant API: обработка заказов

API СберМегаМаркет (https://partner.sbermegamarket.ru/api/) работает через POST-запросы с JSON. Авторизация — токен в заголовке.

Цикл заказа DBS:

1. Получение новых заказов. POST /api/market/v1/orderService/order/new — возвращает список заказов в статусе NEW.
2. Подтверждение. POST /api/market/v1/orderService/order/confirm — продавец подтверждает заказ и указывает срок отгрузки.
3. Отгрузка. POST /api/market/v1/orderService/order/packing — передача трек-номера и подтверждение отгрузки.
4. Отмена. POST /api/market/v1/orderService/order/reject — отмена с указанием причины.

На стороне Битрикс cron-агент раз в 5–10 минут опрашивает API на новые заказы. При получении:

• Создаёт заказ в Bitrix\Sale\Order с маппингом товаров по offerId (артикулу) или штрихкоду.
• Устанавливает свойства заказа: номер заказа СберМегаМаркет, способ доставки, данные покупателя (СберМегаМаркет передаёт ФИО, телефон, адрес).
• При смене статуса заказа в Битрикс — обработчик события OnSaleOrderSaved вызывает соответствующий метод API.

Обновление цен и остатков

Через фид. Цены и остатки обновляются при очередном парсинге фида маркетплейсом. Задержка — до 4 часов. Для большинства магазинов этого достаточно.

Через API (ускоренное обновление). Для высокооборачиваемых товаров — метод POST /api/market/v1/offerService/manualPrice/save для цен и обновление остатков через <outlets> в фиде с принудительным обновлением.

Проблема задержки остатков: если товар закончился, а фид ещё не обновился — маркетплейс примет заказ на отсутствующий товар. Отмена = штраф + снижение рейтинга продавца. Решение: настроить генерацию фида по cron каждые 30 минут и использовать API для критичных товаров.

Категории и модерация

СберМегаМаркет использует собственное дерево категорий. Маппинг задаётся в личном кабинете при настройке фида — для каждого <categoryId> из вашего фида указывается соответствие категории маркетплейса.

Модерация товаров занимает 1–3 дня. Причины отклонения:

• Отсутствие штрихкода.
• Некорректный бренд (нет в справочнике маркетплейса).
• Фото не соответствуют требованиям (водяные знаки, коллажи, текст на изображении).

Сроки интеграции