---
metadata:
  - name: generator
    content: Diplodoc Platform v5.57.3
alternate:
  - https://yandex.com/support/delivery-profile/ru/modules/yd-module-instruction.md
  - href: ru/modules/yd-module-instruction.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/support/delivery-profile/ru/llms.txt

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

## Описание {#description}

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

После установки в разделе **Службы доставки** появляется служба с двумя профилями:

* **Курьер до двери**;
* **Самовывоз из ПВЗ/Постамата**.

## Требования {#requirements}

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

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

## Установка модуля {#installation}

{% note warning %}

Перед установкой убедитесь, что у вашего аккаунта 1С-Битрикс есть права администратора.

{% endnote %}

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

* [через административную панель сайта](#method-1);
* [через сайт Marketplace](#method-2).

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

1. Войдите в административную панель вашего сайта на 1С-Битрикс.
2. В меню слева нажмите **Marketplace**.
3. Перейдите в раздел **Для интернет-магазина → Корзина, покупка → Службы доставки**.
4. Найдите модуль **Яндекс Доставка: расчет, выбор ПВЗ на карте, заявки и отслеживание (издатель — Яндекс Логистика)**.

   ![Screenshot](../_assets/modules/004.png =1200x889)

5. Откройте страницу модуля и нажмите кнопку **Установить**.
6. Ознакомьтесь с лицензионным соглашением и примите его условия.
7. Нажмите **Применить** и дождитесь окончания установки.
   
   ![image.png](../_assets/modules/006.png =550x500)

### Способ 2 — через сайт Marketplace {#method-2}

1. Откройте страницу модуля в браузере: <https://marketplace.1c-bitrix.ru/solutions/yandekslogistika.delivery/>.
2. Нажмите кнопку **Установить**.
3. Во всплывающем окне введите адрес вашего сайта и нажмите **Установить**.
   
   Вы будете перенаправлены в административную панель, где автоматически откроется страница установки.

4. Ознакомьтесь с лицензионным соглашением и примите его условия.
5. Нажмите **Применить** и дождитесь окончания установки.

## Мастер первоначальной настройки {#setup-wizard}

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

### Шаг 1 из 3: подключение к Яндекс Доставке {#step-1}

На этом шаге вы добавляете токен аутентификации и выбираете режим работы модуля (тестовый/боевой).

<center>

![Screenshot](../_assets/modules/008.png =1200x539)

</center>

1. Откройте личный кабинет Яндекс Доставки: <https://dostavka.yandex.ru/>.
2. Перейдите в раздел **Настройки → API** и скопируйте токен.
3. Вставьте скопированный токен в поле **Токен Яндекс Доставки** мастера первоначальной настройки.
4. Для проверки работы модуля оставьте включенной опцию **Тестовый**.
5. Нажмите **Далее →**.

   {% note warning %}

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

   {% endnote %}

### Шаг 2 из 3: адрес забора {#step-2}

<center>

![Screenshot](../_assets/modules/010.png =1200x200)

</center>

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

1. Убедитесь, что появилось сообщение **Загружено складов из кабинета Яндекс Доставки: N**.
2. Выберите из списка адрес забора по умолчанию — оттуда курьер будет забирать заказы.
   
   Если нужного склада нет, оставьте поле пустым и добавьте адрес позже в разделе **Магазин → Яндекс Доставка → Адреса забора**.

3. Нажмите **Далее →**.

   {% note warning %}

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

   {% endnote %}

### Шаг 3 из 3: завершение {#step-3}

На этом шаге подтвердите указанные данные и завершите первоначальную настройку.

Будут автоматически созданы:

* служба доставки с двумя профилями;
* служебные свойства заказа;
* фоновый агент опроса статусов;
* таблицы модуля.

## Настройки модуля {#settings}

Перейдите в раздел **Магазин → Яндекс Доставка → Настройки**, который состоит из шести вкладок:

* [Подключение](#connection)
* [Фильтр пунктов выдачи](#filter)
* [Чекаут](#checkout)
* [Бизнес-правила](#business-rules)
* [Статусы заказа](#order-statuses)
* [Соединение и кэш](#connection-cache)

### Подключение {#connection}

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

<center>

![Screenshot](../_assets/modules/012.png =1200x596)

</center>

#|
|| **Параметр** | **Описание** ||
|| Токен Яндекс Доставки | API-токен из личного кабинета Яндекс Доставки.

Хранится в защищенных настройках модуля.

Не публикуйте в открытом коде. ||
|| Тестовый режим | Режим проверки работы модуля.

Если включен — модуль работает с тестовым контуром. Реальные заявки не создаются. ||
|| Ключ Яндекс Карт | Нужен для отображения покупателю карты ПВЗ при оформлении заказа.

Можно оставить пустым — модуль возьмет ключ из общих настроек Bitrix или загрузит карту без ключа (с ограничением по числу запросов). ||
|#

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

   {% note warning %}

   При включенной опции **Тестовый режим** реальные заявки создаваться не будут, даже если модуль настроен корректно.

   {% endnote %}

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

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

<center>

![Screenshot](../_assets/modules/014.png =1200x548)

</center>

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

Если опция скрыта от покупателя, срабатывает значение по умолчанию, заданное в этом параметре:

* опция включена — примерка доступна;
* опция выключена — примерка недоступна. ||
|| Частичный выкуп по умолчанию | Задает значение опции **Частичный выкуп заказа**, которое уходит в заявку.

Если опция скрыта от покупателя, срабатывает значение по умолчанию, заданное в этом параметре:

* опция включена — частичный выкуп доступен;
* опция выключена — частичный выкуп недоступен.

{% note warning %}

Частичный выкуп подразумевает примерку — при его включении Яндекс Доставка считает примерку доступной.

{% endnote %} ||
|| Скрыть фильтры в виджете | Убирает из виджета выбора ПВЗ группы фильтров: **Тип (ПВЗ, постамат)**, **Оператор**, **Услуги (примерка, постоплата)**. Скрытые здесь операторы и типы точек убираются из фильтров автоматически — отдельно их отмечать не нужно. ||
|#

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

### Чекаут {#checkout}

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

<center>

![Screenshot](../_assets/modules/015.png =1200x600)

</center>

#|
|| **Параметр** | **Значение по умолчанию** | **Описание** ||
|| Код свойства, куда будет сохранён выбранный пункт самовывоза | YD_PVZ_ID | Свойство заказа, куда записывается идентификатор выбранного ПВЗ ||
|| Код свойства для названия/адреса ПВЗ | YD_PVZ_NAME | Свойство заказа, куда записываются человекочитаемые адрес и название ПВЗ (видны покупателю и менеджеру) ||
|| ID тега, куда привязывать ссылку «Выбрать пункт самовывоза» | — | Поле, которое заполняется только при нестандартных шаблонах оформления заказа ||
|| Коды свойств: ФИО получателя | — | Пусто — автоопределение: FIO → NAME → F_I_O ||
|| Коды свойств: телефон | — | Пусто — автоопределение: PHONE → PHONE_MOBILE → TEL ||
|| Коды свойств: email | — | Пусто — автоопределение: EMAIL → E_MAIL ||
|| Коды свойств: адрес доставки | — | Пусто — автоопределение по свойству типа «Адрес», затем — ADDRESS → STREET ||
|| Код свойства позиции корзины: артикул | — | Пусто — автоопределение по полю «Артикул» позиции ARTICLE_NUM, затем — ID товара ||
|#

{% note warning %}

Для стандартного шаблона Bitrix все поля можно оставить пустыми — модуль определит свойства автоматически. Заполняйте поля только при нестандартном чекауте.

{% endnote %}

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

### Бизнес-правила {#business-rules}

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

<center>

![Screenshot](../_assets/modules/017.png =1200x600)

</center>

#|
|| **Параметр** | **Рекомендуемое значение** | **Описание** ||
|| Способ оплаты заявки | Оплачено заранее | Основная настройка для всех заказов. Работает, только если поле **Постоплатные платёжные системы** не заполнено.

Если постоплатные системы настроены — способ оплаты определяется автоматически по каждому заказу. ||
|| Постоплатные платёжные системы | По ситуации | Настраивает платежные системы, при которых покупатель платит при получении (наличные, карта курьеру, оплата в ПВЗ).

Если отмечена хотя бы одна — способ оплаты в заявке определяется по конкретному заказу:

* заказ оплачен — **Оплачено заранее**;
* не оплачен и платежная система из отмеченных — **Постоплата при получении**;
* не оплачен, но платежная система предоплатная (онлайн-оплата) — **Оплачено заранее**.

Если ничего не отмечено — способ оплаты для всех заказов берется из поля **Способ оплаты заявки** выше.

При постоплате карта подстраивается под платежную систему покупателя: ПВЗ без оплаты при получении скрываются. ||
|| Создавать заявку при статусе заказа | Оплачен, формируется к отправке (Р) | При наступлении указанного статуса модуль автоматически создает заявку в Яндекс Доставку. ||
|| Как часто обновлять статусы заявок (минут) | 30 | Задает интервал опроса статусов фоновым агентом Bitrix. ||
|| Не давать оформить заказ без выбранного ПВЗ | По необходимости | При включении покупатель не сможет оформить заказ с доставкой **Самовывоз из ПВЗ/Постамата** без выбора точки на карте. ||
|| Наценка к стоимости доставки | Без наценки | Добавляется к стоимости, рассчитанной Яндекс Доставкой. Например, чтобы заложить комиссию магазина или упаковку. Покупатель видит уже итоговую сумму.

Процент от стоимости или фиксированная сумма. ||
|| Величина наценки | 0 | Число. Для процента — целое (например, 10), для фиксированной — допустимо дробное, с точкой в качестве разделителя (например, 7.5). ||
|| Округлять итоговую стоимость | По необходимости | Округляет стоимость доставки (уже с наценкой) до выбранной кратности. ||
|| Округлять до | до 1 ₽ (целых рублей) | Задает кратность округления. ||
|| Направление округления | Вверх (в пользу магазина) | Задает направление округления итоговой стоимости. ||
|| Бесплатная доставка от суммы заказа (₽) | 0 | При сумме товаров не ниже указанной — доставка бесплатная.

0 — правило выключено. ||
|| Минимальная стоимость доставки (₽) | 0 | Если рассчитанная стоимость доставки ниже — показывается заданная сумма.

0 — без ограничения. ||
|| Максимальная стоимость доставки (₽) | 0 | Если рассчитанная стоимость доставки выше — показывается заданная сумма.

0 — без ограничения. ||
|#

1. В поле **Создавать заявку при статусе заказа** выберите статус, при котором заказ считается подтвержденным и оплаченным.
2. Укажите значение поля **Как часто обновлять статусы заявок (минут)** — рекомендуется 30 минут.
3. При необходимости настройте наценку и округление.
4. Нажмите **Сохранить**.

   {% note warning %}

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

   {% endnote %}

### Статусы заказа {#order-statuses}

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

<center>

![Screenshot](../_assets/modules/019.png =1200x440)

</center>

#|
|| **Событие в Яндекс Доставке** | **Рекомендуемый статус в 1С-Битрикс** ||
|| Заказ ДОСТАВЛЕН (выдан получателю) | Выполнен (F) ||
|| Возврат ВЫПОЛНЕН (товар вернулся) | Отменить заказ ||
|| Заявка ОТМЕНЕНА | Отменить заказ ||
|#

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

### Соединение и кэш {#connection-cache}

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

<center>

![Screenshot](../_assets/modules/020.png =1200x489)

</center>

#|
|| **Параметр** | **По умолчанию** | **Описание** ||
|| Таймаут подключения (секунд) | 5 | Время ожидания установки соединения с API. ||
|| Таймаут ожидания ответа (секунд) | 15 | Время ожидания ответа от API Яндекс Доставки. ||
|| Время кэширования расчетов и списка ПВЗ (секунд, до 14 400) | 3 600 | Кэширование результатов расчета стоимости и списка ПВЗ на указанное время.

Максимум — 14 400 секунд (4 часа). ||
|| Логировать обращения к API | Выключено | Запись каждого запроса к API в файл `/bitrix/modules/yandekslogistika.delivery/log/api.log`. Используйте для диагностики. ||
|| Максимальный размер лог-файла (МБ) | 10 | Максимально допустимый размер файла с логами запросов к API. При превышении этого значения файл будет автоматически переименован в `api.log.1`, и запись начнется заново. ||
|#

{% note warning %}

Включайте логирование только при диагностике проблем, иначе лог-файл может занять значительное место на хостинге.

{% endnote %}

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

## Адреса забора {#pickup-addresses}

В этом разделе вы можете управлять складами, с которых курьер забирает заказы.

### Загрузка адресов из кабинета Яндекс Доставки {#download-addresses}

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

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

   ![Screenshot](../_assets/modules/022.png =1200x351)

3. Дождитесь завершения синхронизации — в таблице появятся адреса из вашего кабинета.
4. Убедитесь, что нужный адрес отмечен опцией **по умолчанию** и его статус **включен**.

   {% note warning %}

   Кнопка **Загрузить из Яндекс Доставки** доступна только при добавленном токене. Если кнопка отсутствует, проверьте токен в настройках модуля на вкладке **Подключение**.

   {% endnote %}

### Добавление адреса вручную {#add-address}

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

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

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

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

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

   * **Координаты на карте**
     
     #|
     || **Параметр** | **Описание** ||
     || Широта * | Например: 55.7522^1^ ||
     || Долгота * | Например: 37.6156^1^ ||
     |#
     
     ^1^ Чтобы посмотреть координаты, на Яндекс Картах нажмите правой кнопкой мыши на нужную точку → **Что здесь?**.

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

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

4. Нажмите **Создать адрес забора**.

   {% note warning %}

   Ограничение Яндекс Доставки: не более 100 адресов забора на аккаунт.

   {% endnote %}

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

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

1. Перейдите в раздел **Магазин → Яндекс Доставка → Адреса забора**.
2. В списке адресов нажмите **настройки** напротив нужного склада.
3. В блоке **Точка самопривоза (drop-off)** нажмите кнопку выбора точки.
4. На карте отображаются точки, доступные для сдачи заказов.

   ![Screenshot](../_assets/modules/027.png =800x600)

5. Используйте фильтры по типу (ПВЗ, Сортировочный центр), оператору (Яндекс Маркет, 5 Post), услуге (с примеркой, с постоплатой).
6. Выберите нужную точку из списка или на карте и подтвердите выбор.

### Вызов курьера на забор {#call-courier}

1. Перейдите в раздел **Магазин → Яндекс Доставка → Адреса забора**.
2. В блоке **Вызов курьера на забор** выберите дату из выпадающего списка.
3. Выберите **Интервал** — доступное время забора (например, 10:00–13:00).
4. Нажмите кнопку **Вызвать курьера**.

   ![Screenshot](../_assets/modules/028.png =1200x341)
   
   {% note warning %}

   Кнопка **Вызвать курьера** вызывает курьера для забора заявок, готовых к отправке. Убедитесь, что все нужные заявки переведены в соответствующий статус.

   {% endnote %}

## Служба доставки {#delivery-service}

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

<center>

![Screenshot](../_assets/modules/030.png =1200x474)

</center>

### Общие настройки {#common-settings}

1. Перейдите в раздел **Магазин → Настройки → Службы доставки**.
2. Откройте созданную службу доставки **Яндекс Доставка** и проверьте поля на вкладке **Общие настройки**:

   #|
   || **Параметр** | **Значение** | **Описание** ||
   || Название | Яндекс Доставка | Отображается покупателю при оформлении заказа ||
   || Тип доставки | Яндекс Доставка | Устанавливается автоматически, не изменяется ||
   || Активность | ![yes](../_assets/yes.svg) | Служба доставки должна быть активна для отображения покупателю ||
   || Сортировка | 100 | Порядок отображения в списке способов доставки ||
   || Валюта | RUB | Российский рубль ||
   || Ставка НДС | Без НДС | Выбирайте тот режим налогообложения, который используется ||
   |#

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

### Профили службы доставки {#delivery-profiles}

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

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

   #|
   || **Профиль** | **Описание** ||
   || Курьер до двери | Курьерская доставка по адресу получателя ||
   || Самовывоз из ПВЗ/Постамата | Доставка в пункт выдачи или постамат с выбором точки на карте ||
   |#

5. Настройте параметры каждого профиля и нажмите **Сохранить**.

   {% note warning %}

   Для работы виджета выбора ПВЗ на карте необходимо создать профиль **Самовывоз из ПВЗ/Постамата**.

   {% endnote %}

### Ограничения службы доставки {#delivery-limits}

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

1. Перейдите в раздел **Магазин → Настройки → Службы доставки**.
2. В созданной службе доставки **Яндекс Доставка** перейдите на вкладку **Ограничения**.
3. Нажмите **+ Добавить ограничение** и выберите тип:
   
   * исключить местоположения;
   * по весу;
   * по группам пользователей;
   * по категории товара;
   * по конкретным товарам;
   * по максимальному размеру;
   * по максимальным размерам;
   * по местоположению;
   * по общей стоимости товаров;
   * по платежным системам;
   * по публичной части;
   * по сайтам;
   * по типу плательщика.

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

## Работа с заказами {#orders}

### Выбор ПВЗ покупателем при оформлении заказа {#pvz-selection}

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

Открывается виджет на Яндекс Картах.

<center>

![Screenshot](../_assets/modules/035.png =1200x556)

</center>

В виджете доступны:

* поиск по адресу или названию;
* фильтры по типу (ПВЗ, Постамат);
* фильтры по оператору (Яндекс Маркет, 5 Post);
* фильтры по услугам (с примеркой, с постоплатой);
* карточка точки с адресом, часами работы, телефоном, стоимостью и сроком доставки.

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

{% note warning %}

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

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

* **Примерка при получении** — разрешить примерку товара до оплаты;
* **Забрать часть заказа, остальное вернуть** — частичный выкуп.

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

Если магазин хочет управлять этими опциями самостоятельно, их можно скрыть от покупателя в настройках модуля (**Фильтр пунктов выдачи → Не показывать покупателю опции**) и задать фиксированное значение по умолчанию.

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

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

{% endnote %}

### Выбор способа доставки {#delivery-method}

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

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

  ![Screenshot](../_assets/modules/038.png =1200x596)

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

### Создание заявки в административной панели {#create-request}

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

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

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

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

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

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

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

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

### Редактор грузомест {#cargo-places}

На странице заявки расположен редактор **Грузоместа (коробки)**:

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

Если посылок в заказе несколько:

1. Задайте для каждой коробки вес и габариты (Д × В × Ш в см) и распределите товары.
2. Нажмите **+ Добавить коробку** для каждой дополнительной упаковки.
3. Кнопка **Автораспределить (1 коробка = вся корзина)** сбрасывает редактор к состоянию «одна коробка — все товары».
4. После заполнения нажмите **Сохранить грузоместа** перед созданием заявки.

   {% note warning %}

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

   {% endnote %}

### Отмена заявки {#cancel-request}

1. На странице заявки нажмите кнопку **Отменить**.

2. В появившемся диалоге подтвердите действие кнопкой **Да**.

   ![Screenshot](../_assets/modules/041.png =1200x447)

   {% note warning %}

   Отмена заявки необратима. После подтверждения заявка будет отменена в системе Яндекс Доставки и восстановить ее будет невозможно.

   {% endnote %}

## Часто задаваемые вопросы {#faq}

### Стоимость доставки не рассчитывается при оформлении заказа {#no-calculation}

Возможные причины:

* у товаров в корзине не заполнен вес или габариты — проверьте карточки товаров в каталоге;
* введен некорректный токен — проверьте значение в настройках модуля на вкладке **Подключение**;
* включен тестовый режим — отключите опцию **Тестовый режим** в настройках модуля на вкладке **Подключение** и сохраните;
* не создан профиль службы доставки — проверьте наличие профиля в разделе **Магазин → Настройки → Службы доставки**.

### Карта ПВЗ не отображается при оформлении заказа {#no-map}

Возможные причины:

* не указан ключ Яндекс Карт в настройках модуля на вкладке **Подключение**;
* ключ недействителен или исчерпана квота запросов — получите новый ключ на сайте <https://yandex.ru/maps-api/console>;
* не создан профиль **Самовывоз из ПВЗ/Постамата** в службе доставки.

### Заявки не создаются автоматически {#no-auto-request}

Возможные причины:

* статус для автосоздания не настроен корректно — проверьте в настройках модуля на вкладке **Бизнес-правила → Создавать заявку при статусе заказа**;
* включен тестовый режим — отключите опцию **Тестовый режим** в настройках модуля на вкладке **Подключение** и сохраните;
* не работает агент 1С-Битрикс — обратитесь к хостинг-провайдеру.

### Статусы заказов не обновляются {#no-status-update}

Возможные причины:

* не настроен маппинг статусов — проверьте в настройках модуля на вкладке **Статусы заказа**;
* значение поля **Как часто обновлять статусы заявок** равно 0 — задайте ненулевое значение;
* не работает агент 1С-Битрикс на сервере.

### Адреса забора не загружаются {#no-addresses}

Возможные причины:

* токен введен некорректно или устарел — обновите значение в настройках модуля на вкладке **Подключение**;
* не настроены склады в личном кабинете Яндекс Доставки — добавьте склад в кабинете.

### Покупатель не видит опции примерки или частичного выкупа {#no-fitting}

Возможные причины:

* опции скрыты в настройках — проверьте в настройках модуля на вкладке **Фильтр пунктов выдачи → Не показывать покупателю опции**;
* выбранный ПВЗ не поддерживает примерку или частичный выкуп — чекбоксы для таких точек не отображаются.

### При постоплате пропали некоторые ПВЗ на карте {#postpaid-pvz}

Это ожидаемое поведение: точки, не принимающие оплату при получении, автоматически скрываются при выборе постоплатной платежной системы.

## Техническая поддержка {#support}

По вопросам работы модуля обращайтесь на портал поддержки: [yandex.ru/support/delivery-profile/ru/troubleshooting](https://yandex.ru/support/delivery-profile/ru/api/other-day/troubleshooting).

При обращении укажите:

* версию модуля (отображается в разделе **Marketplace → Установленные решения**);
* версию 1С-Битрикс (отображается в разделе **Настройки → О программе**);
* описание проблемы и шаги для ее воспроизведения;
* скриншоты ошибок (при наличии).
