Где находится
Раздел АйПромо. Яндекс.Маркет → Импорт заказов. Здесь настраивается приём заказов с Маркета, сопоставление статусов, служб доставки, платёжных систем и автоматические действия при смене статусов.
1. Статус обмена
| Поле | Что делает |
|---|---|
| Включить импорт заказов | Автоматический импорт заказов с Яндекс.Маркета. Если выключено — заказы не забираются. |
| Использовать API-уведомления | Яндекс.Маркет сам создаёт заказы и меняет статусы по событию. При включении опции периодический агент обмена отключается — обмен идёт через вебхуки. |
Внимание. Перед включением API-уведомлений убедитесь, что в личном кабинете Яндекс.Маркета включены API-уведомления. Без этого заказы не будут приходить.
2. Настройки заказа
Определяют, как создаётся заказ в Битриксе, если в Маркете не нашлось специфичных данных.
| Поле | Описание |
|---|---|
| Сайт заказа | Сайт, к которому будет привязан заказ. Например, «[s1] Site». |
| Тип плательщика | Тип плательщика для заказа (физлицо / юрлицо). Если оставить пустым — берётся значение по умолчанию. |
| Доставка по умолчанию | Служба доставки, которая используется, если для типа доставки Маркета не найдено соответствие. |
| Оплата по умолчанию | Платёжная система, используемая, если для способа оплаты Маркета не найдено соответствие. |
| Пользователь по умолчанию | Пользователь, к которому привязываются заказы с маркетплейса. Выбирается через кнопку «…». Если оставить 0 — заказы будут привязаны к гостю или системному пользователю. |
3. Сопоставление статусов
Таблица соответствия статусов Яндекс.Маркета статусам заказов в Битриксе. Слева — статус Маркета и его технический код, справа — выпадающий список статусов Битрикса.
| Статус Яндекс.Маркета | Код | Что выбрать в Битриксе |
|---|---|---|
| Оформляется | PLACING | Например, «[N] Принят, ожидается оплата» |
| Зарезервирован | RESERVED | «[N] Принят, ожидается оплата» |
| Не оплачен | UNPAID | «[N] Принят, ожидается оплата» |
| В обработке | PROCESSING | Статус «В обработке» или аналог |
| Готов к отгрузке | READY_TO_SHIP | Статус готовности к отправке |
| Передан в доставку | SHIPPED | Статус «Отгружен» |
| Доставляется (передан в доставку) | DELIVERY | Промежуточный статус доставки |
| Доставляется (в пункте выдачи) | PICKUP | «Готов к выдаче» |
| Выполнен | DELIVERED | «[F] Выполнен» |
| Отменён | CANCELLED | Статус отмены |
| Ожидает обработки | PENDING | Промежуточный статус |
| Возвращён | RETURNED | Статус возврата |
Если статус Маркета не сопоставлен, при получении заказа с таким статусом модуль не будет менять статус заказа в Битриксе — заказ останется в текущем состоянии.
4. Типы доставок Яндекс.Маркета
Таблица соответствия типов доставки Маркета службам доставки магазина.
| Тип доставки | Параметры Маркета | Что выбрать в Битриксе |
|---|---|---|
| Яндекс.Маркет: Самовывоз (ПВЗ) | partner_type=YANDEX_MARKET, dispatch_type=MARKET_BRANDED_OUTLET | Служба самовывоза |
| Яндекс.Маркет: Курьерская доставка | partner_type=YANDEX_MARKET, dispatch_type=BUYER | Курьерская служба |
| Яндекс.Маркет: Почта | partner_type=YANDEX_MARKET, type=POST | Почта России |
| Магазин: Самовывоз | partner_type=SHOP, dispatch_type=SHOP_OUTLET | Служба самовывоза магазина |
| Магазин: Курьерская доставка | partner_type=SHOP, dispatch_type=BUYER | Курьерская служба магазина |
| СДЭК: Самовывоз | service_name=СДЭК, type=PICKUP | СДЭК: ПВЗ |
| СДЭК: Курьерская доставка | service_name=СДЭК, type=DELIVERY | СДЭК: Курьер |
| СДЭК: Постамат | service_name=СДЭК, dispatch_type=POSTAMAT | СДЭК: Постамат |
| Почта России: Стандартная | type=POST, service_name=Почта России | Почта России |
| Почта России: EMS | type=POST, service_name=EMS | EMS |
Если соответствие не найдено, применяется «Доставка по умолчанию» из настроек заказа.
5. Сопоставление способов оплаты
Таблица соответствия способов оплаты Маркета платёжным системам магазина.
| Способ оплаты | Метод Маркета | Что выбрать в Битриксе |
|---|---|---|
| Картой при получении | CARD_ON_DELIVERY | Эквайринг при получении |
| Картой онлайн (предоплата) | CARD_ONLINE | Онлайн-оплата картой |
| Наличными при получении | CASH_ON_DELIVERY | Наличными курьеру |
| Яндекс.Деньги | YANDEX_MONEY | ЮMoney |
| Привязанная карта | BOUND_CARD_ON_DELIVERY | Привязанная карта |
| СберПэй | SBERPAY | SberPay |
| Тинькофф | TINKOFF | Тинькофф |
Если соответствие не найдено, применяется «Оплата по умолчанию» из настроек заказа.
6. Автоматические действия
| Опция | Что делает |
|---|---|
| Автоматически оплачивать заказ при доставке | При получении статуса DELIVERED заказ автоматически отмечается оплаченным. |
| Автоматически отменять заказ при возврате | При получении статуса RETURNED заказ автоматически отменяется. |
| Отправлять номер заказа из Битрикс в Яндекс.Маркет | После создания заказа в Битриксе модуль отправляет в Маркет его идентификатор. Помогает избежать дублей при повторном импорте. |
7. Настройки отправки статусов
| Опция | Что делает |
|---|---|
| Отправлять статус отгрузки в Маркет | При отгрузке заказа модуль автоматически отправляет в Маркет статус READY_TO_SHIP. |
| Уведомлять при изменении статуса | При смене статуса заказа отправляется email-уведомление. |
8. Сопоставление статусов заказа (флаги)
Определяет, какие статусы Битрикса считаются «отгрузкой», «отменой» и «оплатой».
| Поле | Описание |
|---|---|
| Флаг отгрузки | Какой статус Битрикса соответствует готовности к отгрузке. При установке этого статуса модуль отправляет в Маркет READY_TO_SHIP. |
| Флаг отмены | Какой статус Битрикса соответствует отмене заказа. При установке модуль уведомляет Маркет об отмене. |
| Флаг оплаты | Какой статус Битрикса соответствует оплате заказа. Используется при синхронизации оплат. |
9. Ручной импорт
Кнопка «Выполнить импорт сейчас» запускает разовый обмен заказами. Используется для проверки настроек и подтягивания заказов, если автоимпорт отключён.
Результат:
«Импорт заказов выполнен. Импортировано: N, ошибок: M».
Если возникла ошибка, модуль покажет: «Ошибка импорта: #MESSAGE#».
Как работает импорт
- Модуль запрашивает у Яндекс.Маркета список новых или изменённых заказов.
- Для каждого заказа проверяет, есть ли он уже в Битриксе по внешнему ID.
- Создаёт новый заказ или обновляет существующий:
- привязывает к сайту из настроек;
- подбирает тип плательщика;
- подбирает службу доставки по таблице соответствий;
- подбирает платёжную систему по таблице соответствий;
- подставляет пользователя по умолчанию;
- проставляет статус по таблице соответствий.
- Добавляет в заказ товары, адрес доставки, данные покупателя.
- Если задано — отправляет обратно в Маркет ID заказа Битрикса.
Возвраты
При создании возврата в Яндекс.Маркете модуль:
- добавляет в заказ комментарий с типом возврата, датой и списком товаров;
- при включённой опции «Автоматически отменять заказ при возврате» — отменяет заказ.
Типы возвратов: невыкуп, брак, отказ покупателя, другое.
Уведомления
Если включена отправка уведомлений, письмо при смене статуса содержит:
- ID заказа в Битриксе;
- ID заказа в Яндекс.Маркете;
- Новый статус;
- Подстатус;
- Дату изменения;
- Сумму заказа;
- Ссылку на заказ в админке.
