Инструкция по подключению модуля Яндекс Доставки для 1С-Битрикс

Описание

Модуль «Яндекс Доставка: расчет, выбор ПВЗ на карте, заявки и отслеживание» обеспечивает интеграцию интернет-магазина на платформе 1С-Битрикс с сервисом Яндекс Доставка.

После установки в магазине автоматически создаются два профиля доставки:

• Курьер до двери — покупатель вводит адрес, стоимость и сроки рассчитываются по тарифам Яндекс Доставки.
• Самовывоз из ПВЗ/Постамата — покупатель выбирает точку на интерактивной карте с фильтрацией по типу, оператору и услугам.

Заявки создаются автоматически при переходе заказа в нужный статус или вручную из карточки заказа. Модуль обновляет статусы заявок и синхронизирует их со статусами заказов в Битриксе.

Возможности модуля:

• Расчет стоимости и сроков доставки на оформлении заказа с кэшированием, настраиваемой наценкой (процент или фиксированная) и округлением.
• Виджет выбора пункта выдачи на Яндекс Картах: загрузка точек по области карты для любого города РФ, центрирование по городу покупателя, фильтры по операторам, типу (ПВЗ/постамат), примерке и постоплате. Цена и срок — в карточке точки.
• Синхронизация адресов забора (складов) с кабинетом Яндекс Доставки, выбор склада по умолчанию, самопривоз (drop-off) на точку Яндекса.
• Автосоздание заявок при заданном статусе заказа, подтверждение и отмена, отслеживание статуса фоновым агентом со ссылкой отслеживания в заказе.
• Сопоставление статусов заявки со статусами заказа 1С-Битрикс.
• Печатные формы: этикетки и акт приема-передачи в PDF.
• Многоместные заказы: редактор грузомест (вес, габариты, распределение товаров).
• Вызов курьера на забор с выбором даты и интервала.
• Опциональная блокировка оформления заказа без выбранного ПВЗ.

Требования

Перед установкой убедитесь, что ваш сервер и сайт соответствуют следующим требованиям:

• PHP 8.2 или выше;
• MySQL 5.6 или выше;
• «1С-Битрикс: Управление сайтом» версии 20.0 или выше (редакция «Малый бизнес», «Бизнес» или «Интернет-магазин + CRM»);
• активная лицензия 1С-Битрикс;
• зарегистрированный аккаунт и подключенный магазин в личном кабинете Яндекс Доставки;
• доступный URL сервера (для работы фонового агента обновления статусов).

Подготовка: регистрация в Яндекс Доставке и получение токена

Перед установкой модуля необходимо зарегистрировать личный кабинет в Яндекс Доставке и получить API-токен.

Шаг 1 - Регистрация личного кабинета

1. Откройте страницу авторизации https://dostavka.yandex.ru и выберите или создайте аккаунт Яндекс ID.

2. Укажите название организации — его будут видеть ваши клиенты.

3. Подключите расчетный счет: введите и подтвердите ИНН, затем примите оферту.

4. Подтвердите регистрацию одним из способов:

• Пополнить баланс на 500 рублей — кабинет активируется сразу.

• Подтвердить оферту через ЭДО (например, Диадок или Saby) — в этом случае может быть доступен приветственный лимит на первые заказы.

Шаг 2 - Получение API-токена

1. Войдите в личный кабинет Яндекс Доставки.

2. Перейдите в Настройки → API.

3. Скопируйте токен.

4. В административной панели Битрикса перейдите в Магазин → Яндекс Доставка → Настройки → вкладка Подключение.

5. Вставьте токен в поле Токен Яндекс Доставки.

6. Убедитесь, что чекбокс Тестовый режим снят (для работы с боевым контуром).

7. Нажмите Сохранить.

Ключ API Яндекс Карт

Ключ нужен для отображения интерактивной карты выбора ПВЗ на странице оформления заказа.

Без ключа карта работает в ограниченном режиме (лимит запросов в день).

Начиная с версии 0.7.10 карта открывается в городе покупателя и без ключа, но для надежной работы рекомендуется его получить.

Как получить ключ API Яндекс Карт

1. Откройте кабинет API Яндекс Карт и войдите через Яндекс ID.

2. Нажмите Подключить API и выберите три продукта:

• JavaScript API — отображение интерактивной карты на сайте;

• API Геокодера — преобразование адресов в координаты и обратно;

• API Геосаджеста — подсказки при вводе адреса.

3. Выберите тариф и нажмите Подключить.

4. Перейдите в раздел Ключи. Первый ключ создается автоматически, но со статусом Не настроен.

5. Справа в строке с ключом нажмите ⋯ → Настроить и заполните поле Ограничение по HTTP Referer - укажите домен вашего сайта (например, example.ru).

6. Нажмите Сохранить и убедитесь, что статус ключа сменился на Активен.

7. Скопируйте ключ и вставьте его в настройках модуля: Настройки → вкладка Подключение → поле Ключ Яндекс Карт.

Установка модуля

Модуль Яндекс Доставка: расчет, выбор ПВЗ на карте, заявки и отслеживание можно установить двумя способами.

Способ 1 — через административную панель сайта

1. Войдите в административную панель вашего сайта на 1С-Битрикс.

   

2. В меню слева нажмите Marketplace.

3. Перейдите в раздел Для интернет-магазина → Корзина, покупка → Службы доставки.

4. Найдите модуль Яндекс Доставка: расчет, выбор ПВЗ на карте, заявки и отслеживание (издатель — Яндекс Логистика).

   

5. Откройте страницу модуля и нажмите кнопку Установить.

   

6. Ознакомьтесь с лицензионным соглашением и примите его условия.

   

7. Нажмите Применить и дождитесь окончания установки.

   

Способ 2 — через сайт Marketplace

1. Откройте страницу модуля в браузере: https://marketplace.1c-bitrix.ru/solutions/yandekslogistika.delivery/.

   

2. Нажмите кнопку Установить.

3. Во всплывающем окне введите адрес вашего сайта и нажмите Установить.

   Вы будете перенаправлены в административную панель, где автоматически откроется страница установки.

4. Ознакомьтесь с лицензионным соглашением и примите его условия.

5. Нажмите Применить и дождитесь окончания установки.

Мастер первоначальной настройки

После установки модуль автоматически запустит мастер первоначальной настройки.

Шаг 1 — подключение к Яндекс Доставке

1. Откройте личный кабинет Яндекс Доставки: https://dostavka.yandex.ru/.

2. Перейдите в раздел Настройки → API и скопируйте токен.

3. Вставьте скопированный токен в поле Токен Яндекс Доставки.

4. Выберите режим работы: Тестовый или Боевой.

   Начиная с версии 0.7.10

   Тестовый режим по умолчанию выключен — новая установка сразу работает с боевым контуром.

   У уже установленных магазинов режим не меняется.

Шаг 2 — адрес забора

На этом шаге модуль автоматически загружает список складов из вашего кабинета Яндекс Доставки.

1. Убедитесь, что появилось сообщение Загружено складов из кабинета Яндекс Доставки: N.

2. Выберите из списка адрес забора по умолчанию — оттуда курьер будет забирать заказы.

3. Если нужного склада нет, оставьте поле пустым и добавьте адрес позже в разделе Магазин → Яндекс Доставка → Адреса забора.

4. Нажмите Далее →.

   Обратите внимание

   Если на шаге 2 склады не загрузились, проверьте корректность введенного токена на шаге 1.

Шаг 3 — 3: завершение

Модуль автоматически создает службу доставки, свойства заказа (YD_PVZ_ID, YD_PVZ_NAME), фоновый агент обновления статусов и необходимые таблицы в базе данных.

Настройки модуля

Перейдите в раздел Магазин → Доставка → [выберите службу] → Настройки модуля.

Настройки разделены на семь вкладок:

• Подключение
• Фильтр пунктов выдачи
• Чекаут
• Бизнес-правила
• Статусы заказа
• Соединение и кэш
• Доступ

Подключение

На этой вкладке вы можете настроить токен, режим работы модуля и ключ Яндекс Карт.

Поле	Описание
Токен Яндекс Доставки	API-токен из личного кабинета Яндекс Доставки. Хранится в защищенных настройках модуля. Не публикуйте в открытом коде.
Тестовый режим	Включить для проверки модуля на тестовом контуре с тестовым токеном. Реальные заявки не создаются. По умолчанию выключен при новой установке. У ранее установленных магазинов режим не меняется.
Ключ Яндекс Карт	Нужен для отображения карты выбора пункта выдачи. Оставьте пустым - модуль возьмет ключ из общей настройки 1С-Битрикса или подгрузит карту без ключа (есть ограничение по числу запросов в день). Получить ключ: developer.tech.yandex.ru/services. Карта открывается в городе покупателя и без ключа Яндекс Карт (для крупных городов координаты встроены в модуль).

1. Убедитесь, что в поле Токен Яндекс Доставки введен актуальный токен.
2. Для работы в боевом режиме отключите опцию Тестовый режим.
3. При необходимости укажите Ключ Яндекс Карт. Ключ можно получить на сайте: https://yandex.ru/maps-api/console.
4. Нажмите Сохранить.

Фильтр пунктов выдачи

На этой вкладке вы можете ограничить список ПВЗ, которые отображаются покупателю на карте.

Поле	Описание
Скрыть операторов	Скрывает от покупателя отмеченные операторы (например, Яндекс Маркет или 5 Post) на карте выбора ПВЗ.
Скрыть типы точек	Скрывает от покупателя ПВЗ (pickup_point) или постаматы (terminal) из списка.
Показывать только с примеркой	Показывает покупателю только те точки, где разрешена примерка перед оплатой.
Показывать только с постоплатой	Показывает покупателю только точки с оплатой привязанной картой при получении.
Не показывать покупателю опции	Скрывает от покупателя при оформлении заказа опции Примерка при получении и/или Частичный выкуп заказа. Значение будет взято из настроек по умолчанию ниже. Проверка серверная: включить скрытую опцию через форму заказа невозможно. Учтена связка: частичный выкуп подразумевает примерку и если примерка скрыта и не включена по умолчанию, частичный выкуп тоже будет скрыт.
Примерка по умолчанию	Задает значение опции Примерка при получении, которое уходит в заявку. Если опция скрыта от покупателя, срабатывает значение по умолчанию, заданное в этом параметре: опция включена — примерка доступна; опция выключена — примерка недоступна.
Частичный выкуп по умолчанию	Задает значение опции Частичный выкуп заказа, которое уходит в заявку. Если опция скрыта от покупателя, срабатывает значение по умолчанию, заданное в этом параметре: опция включена — частичный выкуп доступен; опция выключена — частичный выкуп недоступен. Важно Частичный выкуп подразумевает примерку — при его включении Яндекс Доставка считает примерку доступной.
Скрыть фильтры в виджете	Убирает из виджета выбора ПВЗ группы фильтров: Тип (ПВЗ, постамат), Оператор, Услуги (примерка, постоплата). Скрытые здесь операторы и типы точек убираются из фильтров автоматически — отдельно их отмечать не нужно.

Настройте фильтры под условия вашего магазина и нажмите Сохранить.

Чекаут

На этой вкладке вы можете настроить передачу данных заказа из 1С-Битрикс в Яндекс Доставку.

Поле	Описание
Код свойства, куда будет сохранен выбранный пункт самовывоза	По умолчанию YD_PVZ_ID. Виджет запишет сюда идентификатор выбранного ПВЗ для создания заявки. Для кастомного чекаута укажите свой код.
Код свойства для названия/адреса ПВЗ	По умолчанию YD_PVZ_NAME. Виджет запишет сюда человекочитаемые название, адрес и часы работы ПВЗ. Рекомендуется текстовое свойство.
ID тега, куда привязывать ссылку «Выбрать пункт самовывоза»	Поле, которое заполняется только при нестандартных шаблонах оформления заказа, где ссылка не появляется автоматически. Вставьте в шаблон тег (span, div или p) с уникальным id и укажите его здесь.
Текст призыва выбрать пункт выдачи	Подсказка в плитке самовывоза, пока покупатель не выбрал пункт. Пустое поле — стандартный текст «Выберите пункт выдачи или постамат, тогда рассчитаем стоимость доставки как есть». HTML не поддерживается.
Коды свойств: ФИО получателя	Пусто — автоопределение: FIO → NAME → F_I_O. Несколько кодов через запятую, значения склеиваются через пробел.
Коды свойств: телефон	Пусто — автоопределение: PHONE → PHONE_MOBILE → TEL. Если перечислены несколько кодов, используется первое непустое значение.
Коды свойств: email	Пусто — автоопределение: EMAIL → E_MAIL
Коды свойств: адрес доставки	Пусто — автоопределение по свойству типа «Адрес», затем — ADDRESS → STREET
Код свойства: местоположение	Из какого свойства заказа брать город покупателя для центрирования карты ПВЗ. Пусто — автоопределение: свойство с кодом LOCATION, затем свойство типа «Местоположение».
Код свойства позиции корзины: артикул	Код свойства товара в корзине, передаваемого как артикул (article) в Яндекс Доставку. Пусто — автоопределение по полю «Артикул» позиции ARTICLE_NUM, затем — ID товара

Задайте нужные значения полей или оставьте без изменений и нажмите Сохранить.

Бизнес-правила

На этой вкладке вы можете настроить логику автоматического создания заявок, наценки и ограничения.

Поле	Описание
Способ оплаты заявки	Как получатель рассчитывается за заказ — передается в заявку Яндекс Доставки: Оплачено заранее — покупатель уже оплатил на сайте (предоплата). Яндекс при выдаче деньги не берет. Обычный вариант для интернет-магазина с онлайн-оплатой. Постоплата при получении — покупатель платит при получении в ПВЗ (привязанной картой на большинстве точек Яндекс Маркета), при курьерской доставке — наложенным платежом.
Постоплатные платежные системы	Настраивает платежные системы, при которых покупатель платит при получении (наличные, карта курьеру, оплата в ПВЗ). Если отмечена хотя бы одна — способ оплаты в заявке определяется по конкретному заказу: заказ оплачен — Оплачено заранее; не оплачен и платежная система из отмеченных — Постоплата при получении; не оплачен, но платежная система предоплатная (онлайн-оплата) — Оплачено заранее. Если ничего не отмечено — способ оплаты для всех заказов берется из поля Способ оплаты заявки выше. При постоплате карта подстраивается под платежную систему покупателя: ПВЗ без оплаты при получении скрываются.
Создавать заявку при статусе заказа	Когда заказ переходит в этот статус, модуль автоматически создает заявку в Яндекс Доставку. Ошибки создания заявки теперь попадают в Журнал событий Битрикса (тип: «Яндекс Доставка: не создана заявка»). Видно номер заказа, статус, номер отгрузки и текст ошибки.
Номер заказа для Яндекс Доставки	Что передавать в кабинет Яндекс Доставки как номер заказа: Номер заказа магазина (по умолчанию) — тот же, что видит покупатель; Внутренний ID заказа; Прежний служебный ключ (вида yd-121909-226975), если вы уже сопоставляете заявки по нему. Настройка действует на новые заявки; у ранее созданных номер в кабинете остается прежним. Служебный Идентификатор заявки (ID в Доставке) выдает сама Яндекс Доставка, заменить его нельзя. В карточке заявки теперь показаны оба номера рядом.
Как часто обновлять статусы заявок (минут)	Задает интервал опроса статусов фоновым агентом Bitrix в минутах. По умолчанию 30.
Не давать оформить заказ без выбранного ПВЗ	При включении покупатель не сможет оформить заказ с доставкой Самовывоз из ПВЗ/Постамата без выбора точки на карте. Проверка работает в публичной части, в админке заказ сохранить можно.
Наценка к стоимости доставки	Добавляется к стоимости, рассчитанной Яндекс Доставкой. Например, чтобы заложить комиссию магазина или упаковку. Покупатель видит уже итоговую сумму. Процент от стоимости или фиксированная сумма.
Величина наценки	Число. Для процента — целое (например, 10), для фиксированной — допустимо дробное, с точкой в качестве разделителя (например, 7.5). При выбранной опции Без наценки игнорируется.
Округлять итоговую стоимость	Округляет стоимость доставки (уже с наценкой) до выбранной кратности.
Бесплатная доставка от суммы заказа (₽)	Если сумма товаров в заказе не меньше указанной — доставка для покупателя становится бесплатной (0 ₽), наценка и округление не применяются. 0 — правило выключено. Виджет выбора ПВЗ учитывает эту скидку — покупатель видит «бесплатно» сразу на карте, а не только после выбора точки. При нулевой стоимости в карточке пункта пишется «бесплатно» вместо «0 RUB». Изменения бизнес-правил применяются в виджете сразу, без ожидания истечения кэша.
Минимальная стоимость доставки (₽)	Если рассчитанная стоимость доставки ниже — показывается заданная сумма. 0 — без ограничения. На бесплатную доставку «от суммы» не влияет.
Максимальная стоимость доставки (₽)	Если рассчитанная стоимость доставки выше — показывается заданная сумма. 0 — без ограничения.

Статусы заказа

На этой вкладке вы можете настроить автоматическое изменение статуса заказа в 1С-Битрикс при изменении статуса заявки в Яндекс Доставке.

Событие в Яндекс Доставке	Рекомендуемый статус в 1С-Битрикс
Заказ ДОСТАВЛЕН (выдан получателю)	Что сделать с заказом в 1С-Битрикс, когда заявка Яндекс Доставки перейдет в статус «доставлено получателю» (DELIVERY_DELIVERED). Обычно — статус «Выполнен». Оставьте «не менять», если статусами заказа управляете вручную.
Возврат ВЫПОЛНЕН (товар вернулся)	Что сделать с заказом, когда заявка перешла в «возврат завершен» (RETURN_RETURNED) — товар вернулся отправителю. Логично выбрать «Отменить заказ» (в 1с-Битрикс отмена — это отдельный флаг, а не статус).
Заявка ОТМЕНЕНА	Что сделать с заказом, когда заявка Яндекс Доставки отменена (CANCELLED). Срабатывает автоматически при опросе статусов агентом.

1. Для каждого события выберите соответствующий статус из выпадающего списка.
2. Если управляете статусами заказа вручную, оставьте значение — не менять —.
3. Нажмите Сохранить.

Соединение и кэш

Поле	Описание
Таймаут подключения (секунд)	Время ожидания установки соединения с API Яндекс Доставки. По умолчанию 5.
Таймаут ожидания ответа (секунд)	Время ожидания ответа от API после установки соединения. По умолчанию 15.
Время кэширования расчетов и списка ПВЗ (секунд, до 14 400)	Как долго кэшировать результаты расчета стоимости и список точек. По умолчанию 3600 (1 час). Максимум 14400 (4 часа).
Лимит вызовов API из виджета ПВЗ в сутки	Сколько реальных обращений к API Яндекс Доставки (список точек и расчет цены по точке) виджет выбора ПВЗ может сделать за сутки токеном магазина. По умолчанию 20 000. При исчерпании лимита виджет отдает только закэшированные ответы и не расходует квоту токена магазина. 0 — без ограничения.
Логировать обращения к API	Записывает каждый запрос к API Яндекс Доставки (метод, статус, длительность) в закрытый от веб-доступа файл /bitrix/modules/yandekslogistika.delivery/log/api.log — одна JSON-строка на запрос. Токен в лог не попадает. Держите выключенным в обычной работе. В каждой записи добавлен идентификатор запроса trace_id — сообщите его в поддержку Яндекс Доставки при разборе проблемы.
Детальный лог: тела запросов и ответов	Дополняет каждую запись лога телом запроса и ответа API (обрезка до 8 КБ). Персональные данные покупателей (телефон, email, имя, адрес) маскируются. Используйте для детальной диагностики.
Максимальный размер лог-файла (МБ)	При превышении файл переименовывается в api.log.1 (хранится одна прошлая копия), и лог начинается заново. По умолчанию 10 МБ.

Задайте нужные параметры и нажмите Сохранить.

Доступ

Позволяет раздать право на работу с модулем группам пользователей 1С-Битрикса — менеджеры смогут создавать и отслеживать заявки Яндекс Доставки без полных прав администратора.

Поле	Описание
По умолчанию	Уровень доступа для всех незарегистрированных групп. По умолчанию — [D] закрыт.
Группа пользователей → уровень доступа	Выберите группу и уровень: [R] Просмотр — просмотр заявок; [W] Полный доступ — создание, редактирование, отмена заявок. Нажмите Добавить право доступа, чтобы назначить права нескольким группам.

Адреса забора

Перейдите в раздел: Магазин → Настройки → Доставка → [выберите службу] → Адреса забора.

Загрузка адресов из кабинета Яндекс Доставки

1. Нажмите красную кнопку Загрузить из Яндекс Доставки.

2. Дождитесь завершения синхронизации — в таблице появятся адреса из вашего кабинета.

3. Убедитесь, что нужный адрес отмечен опцией по умолчанию и его статус включен.

Для вызова курьера выберите дату, временной интервал, укажите объем и вес груза, при необходимости отметьте Нужны грузчики и нажмите Вызвать курьера.

Добавление адреса вручную

Нажмите кнопку + Добавить адрес.

В открывшейся форме заполните поля:

• Общие данные

  Поле	Описание
  Название *	Внутреннее название склада. Видно сотрудникам магазина, не покупателю.
  Ваш идентификатор	Произвольный идентификатор в учетной системе. Оставьте поле пустым — он сгенерируется автоматически.

• Адрес

  Поле	Описание
  Страна	Россия (предзаполнено).
  Регион/область	Например, Московская область.
  Город *	Например, Москва.
  Улица *	Например, Ленинградский проспект.
  Дом *	Например, 37.
  Корпус/строение	При наличии.
  Помещение/офис	При наличии.
  Индекс	Почтовый индекс
  Гео-идентификатор Яндекса	Например, 213 = Москва, 2 = Санкт-Петербург. Можно оставить пустым.

• Координаты на карте

  Поле	Описание
  Широта *	Например, 55.75221
  Долгота *	Например, 37.61561

  ¹ Чтобы посмотреть координаты, на Яндекс Картах нажмите правой кнопкой мыши на нужную точку → Что здесь?.

• Контактное лицо

  Поле	Описание
  Имя *	Имя ответственного сотрудника склада
  Фамилия *	Фамилия ответственного сотрудника склада
  Отчество	Отчество ответственного сотрудника склада (при наличии)
  Телефон *	Формат: +74959999999
  Email	Электронная почта (test@test.ru)

Настройки склада

В карточке склада редактируются только Настройки в магазине, данные склада (название, адрес, контакт) хранятся в Яндекс Доставке.

• Настройки в магазине

Поле	Описание
Включен	Если снять, модуль пропустит этот адрес при выборе адреса забора по умолчанию.
По умолчанию	Курьер будет забирать заказы с этого адреса по умолчанию. При выборе этой опции у добавляемого адреса она сбрасывается у других адресов.
Сортировка	Порядок отображения среди других адресов.
Заметка	Внутренняя заметка для сотрудников.

Календарь отгрузок

Часто возникает проблема — склад добавлен в настройках модуля, но не появляется в интеграции или модуль возвращает ошибку: Pickups are not configured for the warehouse.

Причина проблемы — не заполнен календарь отгрузок в личном кабинете — без хотя бы одной запланированной отгрузки склад не «прорастает» в систему.

Чтобы активировать склад:

1. Войдите в личный кабинет Яндекс Доставки.

2. Перейдите в раздел Заказы → Календарь отгрузок.

3. Нажмите желтую кнопку + вверху страницы.

4. В выпадающем меню справа создайте любую отгрузку — выберите дату и временной интервал.

5. После этого вернитесь в Битрикс, перейдите в Адреса забора и нажмите Загрузить из Яндекс Доставки — склад появится в списке.

• Как узнать ID склада (station ID): откройте Яндекс Доставку → Заказы → Календарь отгрузок, выберите нужный склад и посмотрите в адресной строке браузера - значение параметра stationId=XXXXXXXXX.

• Что планировать в календаре: минимум одна отгрузка достаточна для активации. В дальнейшем заполняйте календарь заранее — не менее чем за день до планируемого забора курьером. Если курьер Яндекс Доставки не нужен (самопривоз), достаточно создать одну тестовую отгрузку для активации склада.

• Срок хранения заявки: созданная заявка действует 14 календарных дней, после чего автоматически отменяется. Штрафных санкций нет.

Настройка самопривоза (drop-off)

Если вы планируете самостоятельно привозить отправления на точку Яндекс Доставки:

1. В списке адресов нажмите Настройки напротив нужного склада.
2. В разделе Точка самопривоза (Drop-Off) нажмите Выбрать точку сдачи.
3. В открывшемся списке найдите нужный ПВЗ или сортировочный центр и выберите его.
4. Нажмите Сохранить настройки.

Список формируется из /pickup-points/list с фильтром available_for_dropoff=true.

Чтобы убрать выбранную точку? нажмите Убрать точку.

Вызов курьера на забор

1. Перейдите в раздел Магазин → Яндекс Доставка → Адреса забора.

2. В блоке Вызов курьера на забор выберите дату из выпадающего списка.

3. Выберите Интервал — доступное время забора (например, 10:00–13:00).

4. Нажмите кнопку Вызвать курьера.

   

Настройка службы доставки

После установки модуль автоматически создаст службу доставки.

Общие настройки

Перейдите: Магазин → Настройки → Доставка → [выберите службу] → Общие настройки.

• Имя службы, отображаемое покупателю;

• Тип доставки;

• Активность (включить/выключить);

• Сортировка среди других служб доставки;

• Валюта (RUB);

• Учет НДС.

При необходимости скорректируйте значения и нажмите Сохранить.

Профили службы доставки

Модуль создает два профиля:

• Курьером до двери — покупатель вводит адрес. Стоимость и сроки рассчитываются по тарифу Яндекс Доставки.

• Самовывоз из ПВЗ / Постамата — покупатель выбирает точку на интерактивной карте.

Профили определяют доступные для покупателя способы доставки.

1. В созданной службе доставки Яндекс Доставка перейдите на вкладку Профили.
2. Нажмите кнопку + Добавить профиль.
3. Из выпадающего меню выберите нужный тип.
4. Настройте параметры каждого профиля и нажмите Сохранить.

Ограничения службы доставки

Ограничения позволяют скрыть службу доставки при определенных условиях.

1. В созданной службе доставки Яндекс Доставка перейдите на вкладку Ограничения.

2. Нажмите + Добавить ограничение и выберите тип:

   • исключить местоположения;
   • по весу;
   • по группам пользователей;
   • по категории товара;
   • по конкретным товарам;
   • по максимальному размеру;
   • по максимальным размерам;
   • по местоположению;
   • по общей стоимости товаров;
   • по платежным системам;
   • по публичной части;
   • по сайтам;
   • по типу плательщика.

3. Задайте параметры ограничения и нажмите Сохранить.

Чек-лист самопроверки перед обращением в поддержку

Если модуль не работает или карта ПВЗ не отображается, последовательно проверьте каждый пункт.

№	Что проверить	Где
1	Установлена последняя версия модуля	Магазин → Маркетплейс → Установленные решения
2	Токен введен корректно, тестовый режим соответствует типу токена (боевой/тестовый). Оферта в ЛК Яндекс Доставки принята.	Настройки модуля → вкладка Подключение
3	Склад загружен из Яндекс Доставки и отмечен как По умолчанию	Магазин → Служба доставки → Адреса забора
4	Календарь отгрузок заполнен — создана хотя бы одна отгрузка в ЛК Яндекс Доставки	ЛК Яндекс Доставки → Заказы → Календарь отгрузок
5	Служба доставки активна и профили доставки активны	Магазин → Настройки → Службы доставки
6	Свойства заказа сопоставлены корректно (ФИО, телефон, email, адрес доставки)	Настройки модуля → вкладка Чекаут
7	Все обязательные свойства имеют привязку к службе доставки	Магазин → Настройки → Свойства заказа → Список свойств → свойство → Привязка свойств
8	Ключ API Яндекс Карт задан и активен (статус Активен в кабинете API Карт). Указан правильный домен в Ограничение по HTTP Referer	Настройки модуля → вкладка Подключение → Ключ Яндекс Карт
9	Москва не находится внутри Московской области в справочнике местоположений	Магазин → Местоположения → Список местоположений (при необходимости — Импорт местоположений)
10	cURL включен на сервере и в PHP	Проверьте у хостинг-провайдера или в phpinfo()
11	Текущее время попадает в настроенный интервал доступности доставки (если интервал задан)	Настройки модуля → Время доступности доставки
12	Включено логирование API, лог-файл не содержит критических ошибок	Настройки модуля → вкладка Соединение и кэш

Работа с заказами

Выбор ПВЗ покупателем при оформлении заказа

При оформлении заказа покупатель выбирает способ доставки Яндекс Доставка (Самовывоз из ПВЗ/Постамата) и видит предложение выбрать пункт выдачи. Текст и стиль предложения настраиваются в Чекаут. При нажатии открывается интерактивная карта с:

• Поиском и фильтрацией по типу (ПВЗ / постамат), оператору, услугам (примерка, постоплата).

• Карточкой точки: адрес, часы работы, телефон, стоимость и срок доставки.

• Опциями примерки и частичного выкупа, если они разрешены для точки и не скрыты настройками.

Покупатель нажимает Выбрать этот ПВЗ — выбранная точка фиксируется в заказе.

Примерка и частичный выкуп

Под выбранным пунктом выдачи или под стоимостью курьерской доставки покупатель может отметить:

• Примерка при получении — возможность примерить товар перед оплатой;
• Частичный выкуп — возможность отказаться от части товаров.

Эти опции отображаются только в точках, где они действительно доступны. Выбор покупателя передается в заявку Яндекс Доставки.

Если опции скрыты настройкой Не показывать покупателю опции, значение берется из настроек по умолчанию и уходит в заявку без участия покупателя.

Постоплата и пункты выдачи

Если покупатель выбирает постоплатную платежную систему, пункты выдачи, не принимающие оплату при получении, автоматически скрываются на карте — покупатель не сможет выбрать неподходящую точку.

Создание заявки

Автоматически — заказ переходит в статус из настройки Создавать заявку при статусе заказа.

Вручную — из карточки заказа, кнопка Создать заявку.

После выбора ПВЗ покупатель видит карточку выбранного способа доставки со следующими параметрами:

• название и адрес выбранного ПВЗ;
• часы работы выбранного ПВЗ;
• стоимость доставки;
• срок доставки.

Для смены точки покупатель может использовать кнопку Сменить пункт самовывоза.

Создание заявки в административной панели

Заявка создается автоматически при наступлении статуса, заданного в настройках модуля (Бизнес-правила → Создавать заявку при статусе заказа).

При необходимости создайте заявку вручную:

1. Перейдите в раздел Магазин → Заказы и откройте нужный заказ.

2. В карточке заказа нажмите на блок Яндекс Доставка.

3. Откроется страница заявки с таблицей:

   Поле	Описание
   Отгрузка	Номер отгрузки в 1С-Битрикс
   Идентификатор заявки	UUID заявки в системе Яндекс Доставки
   Статус	Текущий статус заявки
   Отслеживание	Ссылка для отслеживания (появляется после подтверждения заявки)
   Обновлено	Дата и время последнего обновления статуса

   Доступные действия:

   • Создать заявку — отправить заявку в Яндекс Доставку.
   • Отменить — отменить заявку (действие необратимо).
   • Этикетка (PDF) — скачать этикетку для наклейки на посылку.
   • Акт приема-передачи (PDF) — скачать акт для передачи курьеру.

• Кнопка Создать заявку показывает реальный результат — зеленое Готово только при успехе, красное сообщение с текстом ошибки и номером отгрузки — при неудаче.

• Ошибки создания заявки (не заполнен телефон, не настроен модуль, временная ошибка сервиса) фиксируются в Журнале событий Битрикса (Настройки → Инструменты → Журнал событий), тип: Яндекс Доставка: не создана заявка.

• В карточке заявки показаны два номера рядом: номер заказа магазина и ID в Доставке (служебный идентификатор от Яндекс Доставки).