Не нашли ответы на свои вопросы в наших публикациях? Задайте вопрос в службу техподдержки!
Введение
Модуль "Экспорт на порталы + API" содержит блок "Интеграция с заказами". Данный функционал предназначен для интеграции внешних торговых площадок (маркетплейсов, соц. сетей и т.д.) с интернет-магазином. Он предоставляет возможность выгружать заказы площадок в заказы магазина. Это позволит вести общий товарный учёт, консолидировать обработку заказов в одном месте и даст общую статистику по продажам.
Раздел "Интеграция с заказами" содержит профили интеграции с внешними торговыми площадками, такими как Ozon, Wildberries и т.п. Профиль настраивается под определённую площадку и содержит в себе как общие для всех профилей настройки, так и специфические.
Все настройки сгруппированы в семи вкладках:
- Площадка. Настройки подключения к выбранной торговой площадке.
- Общие настройки. Базовые параметры создания заказов.
- Покупатель. Настройка привязываемого пользователя к создаваемому заказу.
- Статусы. Настройки сопоставления статусов интернет-магазина и статусов торговой площадки.
- Свойства. Настройки сопоставления свойств интернет-магазина и полей торговой площадки.
- Товары. Настройки поиска товаров площадки в каталоге интернет-магазина для создаваемого заказа.
- Синхронизация. Ручная загрузка заказов в интернет-магазин и настройка фоновой регулярной синхронизации.
Далее пошагово описан ход настройки нового профиля.
Обратите внимание, что у большинства полей есть подсказки 
, которые помогают сориентироваться по настройке профиля без обращения к документации.
Шаг 1. Подключение к торговой площадке
В первую очередь, при создании нового профиля необходимо задать название профиля и выбрать плагин (площадку, с которой происходит синхронизация) на вкладке "Площадка". После сохранения профиля появятся остальные вкладки и поля.
В блоке "Данные для подключения" появятся поля, специфические для каждого плагина, т.к. у разных площадок свои требования для подключения к их API. Например, для подключения к СберМегаМаркету требуется только ввести токен, полученный в личном кабинете, а для подключения к Rozetka.com.ua требуется логин и пароль.
В блоке "Параметры синхронизации" два пункта. Поле "Направление синхронизации" в данный момент имеет только один вариант - "Только из площадки в магазин". В будущем в плагин планируется добавить обратную синхронизацию тех данных, которые торговые площадки позволяют менять посредством API (например статус и трек-номер). Поле "Дата начала синхронизации" позволяет "отсечь" старые заказы, которые уже не актуально синхронизировать с магазином. Заказы площадки, созданные до указанной в поле даты, будут игнорироваться в процессе обмена.
Шаг 2. Базовые настройки профиля
Во вкладке "Общие настройки" задаются базовые параметры создаваемых заказов.
Поле "Поле для хранения связки с заказами площадки" определяет, в каком поле заказа магазина будет храниться идентификатор заказа внешней площадки. По умолчанию это скрытое поле XML_ID, но можно выбрать и какое-либо из строковых пользовательских свойств заказа.
В полях "Покупатель" и "Ответственный" задаётся один из пользователей базы магазина. В списке "Тип плательщика" содержатся заданные в настройках интернет-магазина варианты. Данные настройки определяют следующие поля заказа:
"Способ оплаты" и "Способ доставки" определяют соответствующие блоки в создаваемых заказах. Как-правило оплата происходит непосредственно на торговой площадке и информация о способе оплаты через API не передаётся. Поэтому можно либо не указывать здесь ничего, либо указать некий наиболее подходящий условный способ оплаты, типа "Банковской карты" или "Наличных".
Шаг 3. Настройки покупателя заказа
У каждого нового заказа долен быть привязанный битрикс-пользователь, который называется покупателем. Вкладка "Покупатель" определяет, как будет происходить поиск такого пользователя в магазине (или создание нового), чтобы привязать его к заказу (поиск происходит по логину или имейлу). Левая колонка блока "Соответствие данных торговой площадки и пользователя интернет-магазина" содержит стандартные поля пользователя интернет-магазинов на 1С-Битрикс. Правая же колонка содержит специфические для выбранного торговой площадки поля, содержащие данные покупателя.
Многие площадки предоставляют довольно ограниченный перечень данных покупателя, поэтому не всегда этих данных достаточно, чтобы создать нового пользователя. Например, обязательным для всех новых пользователей является поле E-mail, но не всегда это поле есть в списке данных торговой площадки. На этот случай можно заполнить поле "E-mail по-умолчанию" и пользователи будут создаваться даже при пустом имейле от площадки (это поле будет использоваться и для логина, если он не задан).
Шаг 4. Синхронизация статусов
Вкладка "Статусы" связывает статусы заказов интернет-магазина и статусы заказов торговой площадки. При изменении статуса у заказа на площадке, статус заказа в магазине будет соответственно меняться. К одному статусу магазина можно привязать несколько статусов площадки.
Помимо привязки статусов, можно указать, при каких статусах заказа на площадке, заказ в магазине должен помечаться как отменённый (в 1С-Битрикс у заказа есть отдельная метка "Заказ отменён" - речь о ней).
Шаг 5. Синхронизация полей
Вкладка "Свойства" связывает поля торговой площадки и свойства магазина. Свойства магазина отображаются не все, а только те, которые привязаны к указанному в "Общих настройках" типу плательщика. Слева перечисляются свойства магазина, а справа им можно поставить в соответствие подходящие поля из данных заказа площадки. Можно оставить свойства и без заполнения данными портала.
Шаг 6. Синхронизация товаров
Вкладка "Товары" отвечает за поиск товаров заказа площадки в базе магазина. Подразумевается, что все товары, которые выставлены на продажу на площадке, есть и в базе интернет-магазина. Также подразумевается, что между товарами этих двух баз есть общий признак. Например, одинаковое название товара, одинаковый артикул или штрихкод.
Для каждой торговой площадки в плагине сразу задано, по какому полю будет происходить поиск товаров в базе магазина - это поле указано в подсказке на жёлтом фоне. А в блоке "Поле идентификатор товара в интернет-магазине" необходимо для каждого инфоблока с товарами указать, в каком поле товара хранится искомое поле из товара площадки. Например, если для поиска используется поле "Артикул товара", в таблице нужно для каждого инфоблока указать, в каком именно свойстве хранится артикул.
Шаг 7. Запуск синхронизации
Когда все шаги пройдены, остаётся отладить выгрузку с помощью двух последних вкладок.
Во вкладке "Синхронизация" в блоке "Ручной запуск синхронизации" можно протестировать настроенный профиль. Укажите, за какой срок синхронизировать заказы и запустите загрузку. Заказы площадки, созданные в этих временных рамках будут загружены в магазин - из них будут созданы заказы.
Опция "Пропускать уже загруженные в интернет-магазин заказы" может пригодиться, если из-за какого либо сбоя часть заказов не будет выгружена и вам понадобится догрузить в магазин лишь заказы, которые ещё туда не загружены, не теряя времени на обработку уже загруженных заказов.
Блок "Фоновая регулярная синхронизация" отвечает за основной механизм обмена. После активации галки "Активность фоновой синхронизации" создаются функции-агенты (раздел "Агенты" в настройках интернет-магазина). Они будут отвечать за периодический фоновый запуск синхронизации с площадкой (важно, чтобы агенты запускались на CRON, а не на хитах). Поля данного блока отличаются для разных профилей и зависят от особенностей работы с API конкретной площадки. Соответственно и количество создаваемых агентов может быть разным (обычно создаются либо один, либо два агента).
Если в блоке присутствует только одно поле "Период синхронизации", это поле будет определять, как часто будет запускаться обмен данными с площадкой. При этом будут обрабатываться только изменения, произошедшие за указанный в данном поле период.
Если в блоке полей больше одного, как правило это означает, что площадка не позволяет получить отдельно изменения за заданный период и приходится "на всякий случай" обрабатывать все созданные за достаточно большой период заказы. В этом случае будет запускаться два процесса - один более частый, но охватывающий небольшой объём заказов (для оперативной реакции на изменения) и более редкий, но охватывающий больший объём заказов.
Отслеживание хода синхронизации
В ходе ручной или фоновой синхронизации могут возникать проблемы. Чтобы увидеть ошибки, перейдите во вкладку "Лог" и проверьте, какая информация представлена в блоке "Лог профиля" (возможно придётся обновить этот блок). Если в логе не видно ошибок, но что-то с обменом не так, вы можете в настройках модуля экспорта включить "Режим отладки" - после этого модуль будет выдавать в логе максимум информации по обмену.
Если данная инструкция не помогла, вы всегда можете обратиться в наш отдел технической поддержки.
Назад в раздел
