Яндекс.ПВЗ

Оперативная поддержка — быстро отвечаем и помогаем! Предлагайте новые функции и настройки — добавим их по вашим пожеланиям.

Яндекс.ПВЗ — выбор пункта выдачи и расчёт доставки в Shop-Script

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

Что умеет плагин

Находит доступные пункты выдачи по указанному городу России.

Передаёт координаты и адреса точек в стандартный интерфейс самовывоза Shop-Script.

Передаёт название пункта, инструкции и расписание, если эти сведения есть в ответе Яндекса.

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

Показывает срок доставки, когда API возвращает его, и позволяет добавить время на сборку заказа.

Учитывает стоимость товаров, вес и количество; использует доступные габариты и резервные размеры из настроек.

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

Позволяет выбирать типы точек и сеть пунктов, доступные через API.

Передаёт выбранный ПВЗ в оформление заказа магазина.

Хранит API-ключ на сервере: ключ не передаётся в браузер покупателя.

Что нужно для подключения

Магазин Shop-Script на Webasyst с оформлением заказа, поддерживающим стандартный выбор пунктов выдачи.

Действующий кабинет и договор Яндекс.Доставки для сервиса «Доставка по России».

API-ключ этого кабинета и идентификатор склада отправления или пункта сдачи platform_station_id .

Доступ сервера магазина к API Яндекс.Доставки по HTTPS и включённое расширение PHP cURL.

Настроенный способ предварительной оплаты заказа.

Договор с перевозчиком и услуги доставки оплачиваются отдельно. Лицензия плагина не включает стоимость перевозки. Доступность городов, точек и тарифов определяется вашим договором и ответами Яндекс.Доставки.

Быстрый запуск: пошаговая инструкция

Установите плагин через «Инсталлер» Webasyst.

Откройте Shop-Script → Настройки → Доставка и добавьте способ доставки на основе плагина «Яндекс.ПВЗ».

Укажите название для покупателей, например «Яндекс.ПВЗ», и включите способ доставки.

В разделе «1. Подключение» вставьте API-ключ и идентификатор склада отправления. Выберите рабочий режим.

В разделе «2. Стоимость для покупателя» задайте правила расчёта. Для передачи тарифа Яндекса без изменений укажите наценку 0, множитель 1, бесплатную доставку от суммы 0 и отключите округление.

В разделе «3. Посылка и сроки» укажите резервный вес и размеры, соответствующие вашим товарам и упаковке. При необходимости добавьте дни на сборку.

В разделе «4. Пункты выдачи» выберите тип точек и сеть. Для первого запуска оставьте все доступные сети.

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

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

1. Подключение

Ключ Яндекс.Доставки. Используйте Bearer-токен своего кабинета «Доставка по России». Не публикуйте ключ в описании способа доставки или на витрине.

Склад отправления. Нужен именно идентификатор platform_station_id , а не почтовый адрес склада. Данные склада должны соответствовать кабинету, которому принадлежит ключ.

Режим работы. Рабочий режим использует реальные пункты и тарифы. Тестовый предназначен для отдельного тестового окружения и тестового ключа; обычный рабочий ключ для него не подходит.

2. Стоимость для покупателя

Наценка, ₽. Фиксированная сумма, добавляемая после применения множителя. Например, 50 — добавить 50 ₽ к рассчитанной стоимости.

Множитель тарифа. Значение 1 сохраняет тариф, 1.1 увеличивает его на 10%, 0.9 уменьшает на 10% за счёт магазина.

Бесплатно от суммы, ₽. Если сумма товаров, переданная магазином для расчёта, достигает указанного порога, доставка для покупателя становится бесплатной. Значение 0 отключает это правило. Перевозчик при этом продолжает тарифицировать доставку по вашему договору.

Округлять вверх. Доступны варианты: без округления, до рубля, до 10 рублей и до 100 рублей.

Порядок расчёта: тариф Яндекса × множитель + наценка, затем округление вверх. Пример: тариф 250 ₽, множитель 1.1 и наценка 30 ₽ дают 305 ₽; при округлении до 10 рублей покупатель увидит 310 ₽. Пример иллюстрирует формулу и не является обещанием тарифа перевозчика.

3. Посылка и сроки

Вес товара, кг. Резервное значение для товара без положительного веса. Количество товара учитывается. Для точного расчёта заполните реальный вес товаров в каталоге.

Длина, ширина и высота коробки, см. Резервные размеры для расчёта, когда данных товара недостаточно. При наличии общих габаритов посылки, переданных Shop-Script, используются они. Иначе модуль оценивает посылку по товарам: берёт максимальные длину и ширину и суммирует высоту с учётом количества. Это приближение, а не алгоритм оптимальной упаковки.

Дней на сборку заказа. Добавляется к сроку, полученному от Яндекса. Значение 0 не увеличивает срок.

Подбирайте резервные размеры под реальную упаковку. Неверные вес и габариты могут привести к расхождению расчёта на сайте и фактической стоимости перевозки.

4. Пункты выдачи

Показывать на карте. Только пункты выдачи, только постаматы либо оба типа. Результат зависит от доступности соответствующих точек у Яндекса.

Сеть пунктов. Все доступные сети, «Яндекс Маркет и партнёры» или 5Post. Выбранный фильтр не гарантирует наличие точек этой сети в каждом городе.

Обновлять список ПВЗ. Срок хранения списка в кэше: 15 минут, 1 час или 3 часа. Это срок повторного использования данных при запросах покупателей, а не фоновая синхронизация по расписанию.

Как это выглядит для покупателя

Покупатель указывает город доставки.

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

Просматривает доступную информацию и подтверждает выбор.

Магазин обновляет стоимость доставки и общую сумму заказа.

Внешний вид карты и списка зависит от интерфейса оформления заказа и темы магазина. Отдельная фирменная карточка доставки не входит в плагин: он использует стандартные механизмы Shop-Script. Нестандартному оформлению заказа может потребоваться адаптация темы.

Телефон и оплата

Плагин не требует телефон для поиска ПВЗ и расчёта тарифа. При завершении заказа магазин может требовать телефон по собственным настройкам контактных полей. Модуль работает с предварительно оплаченными заказами; оплату при получении эта версия не поддерживает.

Что происходит после заказа

Выбранный ПВЗ передаётся в заказ магазина. Заявку на перевозку нужно оформить в кабинете Яндекс.Доставки. В версии 1.0.0 нет автоматического создания или отмены отправлений, печати этикеток, отслеживания статусов и автоматической синхронизации заказов с перевозчиком.

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

Не заполнен город. Укажите город России и повторите выбор.

Нет пунктов. Проверьте город, тип точек и сеть. Попробуйте «Все доступные сети»; доступность также зависит от договора.

Ошибка подключения. Проверьте API-ключ, идентификатор склада и соответствие рабочего или тестового режима.

Временная ошибка API. Повторите расчёт позже. При устойчивой ошибке проверьте HTTPS-доступ с сервера и расширение cURL.

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

Карта не открывается в нестандартной теме. Проверьте поддержку штатного интерфейса ПВЗ Shop-Script и необходимость адаптации оформления заказа.

Ранее выбранный пункт недоступен. Откройте карту повторно и выберите другую доступную точку.

Проверка перед запуском

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