Настройка плагина Почты России для WooCommerce

Плагин «Почта России для WooCommerce» показывает покупателям четыре способа доставки: курьером, в почтовое отделение, в постамат и за границу. Отделение или постамат покупатель выбирает на карте. Цену и срок, как правило, считает сама Почта России по вашему договору через «Отправку»; если она недоступна, часть тарифов считается по публичному калькулятору Почты России. Заказ уходит в личный кабинет «Отправки» прямо из админки WordPress. Статья описывает настройку от установки до первого заказа. Настройка плагина Почты России идёт по порядку статьи, сверху вниз. Для отдельных шагов понадобятся ещё инструкции по установке плагинов WordPress, зонам доставки WooCommerce и, если решите вписать свой ключ, выпуску ключа Яндекс Карт, ссылки на них стоят в нужных местах. Как это выглядит у покупателя, можно посмотреть на демо-сайте.

Перейти на страницу плагина

Если у вас нет действующей лицензии Woodev, плагин работает с ограниченными возможностями. Без неё способы доставки не показываются покупателям, а новые операции с Почтой России блокируются: выгрузка и отмена заказа, запрос документов. Просмотр заказов, настройки и обновление статусов остаются доступны. Обновления и помощь с техническими вопросами по плагину мы даём по действующей лицензии, а на вопросы о покупке и продлении отвечаем всегда. Ключ лежит в вашем личном кабинете на woodev.ru.

Общие возможности всех плагинов доставки Woodev описаны в отдельной статье. Мы ссылаемся на неё там, где нужны подробности: возможности плагинов доставки Woodev.

Что нужно до начала #

Требования к сайту #

• WordPress — версия 6.4 или новее.
• WooCommerce — версия 8.5.1 или новее. Кроме того, плагин проверяли с последними версиями WooCommerce.
• PHP — версия 7.4 или новее.

Если версия ниже, сначала обновите сайт, а потом возвращайтесь к статье. Плагин работает с новым хранилищем заказов WooCommerce (HPOS), поэтому включать или отключать его не нужно. WooCommerce нужно установить и включить заранее: без него плагин не включится.

Что нужно в Почте России #

Для выгрузки заказов и расчёта цены по договору нужны договор с Почтой России и ключи доступа к личному кабинету «Отправки» (otpravka.pochta.ru). По подсказке самого плагина, доступ к «Отправке» предусмотрен для юридических лиц, ИП и самозанятых с договором, а частным лицам он недоступен. Для обновления статусов доставки нужен отдельный токен отслеживания, он необязателен для выгрузки.

Ключей три, и нужны они все вместе:

Поле в плагине	Где взять
Токен приложения	В личном кабинете «Отправки»: «Настройки → API → Токен Авторизации»
Логин	Логин от passport.pochta.ru, под которым вы входите в личный кабинет «Отправки»
Пароль	Пароль от passport.pochta.ru

Есть ещё три вещи, о которых лучше знать заранее:

• Токен отслеживания нужен, чтобы статусы доставки обновлялись в заказах. Он необязательный: без него заказы выгружаются, но статусы не меняются. Его выдаёт личный кабинет юридического лица на tracking.pochta.ru. Это другой токен, не тот, что в «Отправке».
• Отделение отправки — почтовое отделение, где вы сдаёте посылки. От него считаются цены и зависит, какие тарифы вам доступны. Список отделений плагин загружает из вашего кабинета «Отправки».
• Ключ API Яндекс Карт (рекомендуется). Карта с отделениями и постаматами работает сразу, ключ вписывать не обязательно. Мы рекомендуем указать свой ключ: тогда в окне выбора пункта работают подсказки при вводе адреса. Ключ выдаёт Яндекс в кабинете разработчика: подключите сервис «JavaScript API и HTTP Геокодер» и скопируйте полученный ключ. Куда его вставить в плагине, мы показываем в разделе про оформление заказа.

Если вы раньше выгружали заказы через кабинет «Виджет» (так работала версия 1.x), в новой версии этот кабинет не поддерживается. Нужны ключи «Отправки», о переходе подробно написано в статье о переходе на новую версию. Лимит запросов к «Отправке» можно увеличить через вашего персонального менеджера Почты России.

Установка плагина и лицензия #

Архив плагина и лицензионный ключ доступны в личном кабинете на woodev.ru.

1. Откройте в админке WordPress «Плагины → Добавить новый» и нажмите «Загрузить плагин».
2. Выберите архив с плагином, нажмите «Установить», а затем «Активировать плагин».
3. Откройте «Woodev → Лицензии», вставьте ключ в поле «Укажите ваш ключ» и нажмите «Активировать».

Если вы никогда не ставили плагины вручную, пошаговая инструкция с картинками лежит в статье «Как установить плагин на WordPress».

Мастер настройки #

После установки в админке появляется сообщение «Завершите настройку …» с кнопкой «Запустить мастер настройки». В строке плагина в списке плагинов стоят ссылки «Настройки», «Поддержка», «Оставить отзыв» и «Лицензия».

Мастер короткий, и каждый его шаг можно пропустить. Он ничего не блокирует: если мастер закрыт, плагин работает на тех значениях, что уже сохранены. Мастер только записывает настройки: ключи, отделение отправки и общие вес и размеры. Способы доставки он не создаёт, их добавляют в зонах WooCommerce, это мы разбираем ниже.

Вверху мастера стоит полоса шагов с короткими названиями: «Ключи», «Отделение», «Габариты», «Тарифы», «Отслеживание» и «Готово». Полные названия шагов такие:

1. «Переход с версии 1.x» показывается, только если в магазине нашлись данные прежней версии. Что там написано, объясняет статья о переходе.
2. «Ключи «Отправки»». Введите токен приложения, логин и пароль и нажмите «Проверить ключи». Кнопка отправляет один запрос и не чаще одного раза в 5 секунд. Если поле пустое, мастер не пустит дальше и напишет, какого значения не хватает. Кнопки «Пропустить» и «Продолжить» стоят в той же карточке.
3. «Отделение отправки». Кнопкой «Загрузить отделения отправки» загрузите список отделений из «Отправки». Загрузка в мастере доступна не больше двух раз в сутки. Если отделение ещё не выбрано, мастер сам выбирает первое из загруженных.
4. «Вес и габариты по умолчанию». Четыре общих поля: вес, длина, ширина и высота. Они подставляются в расчёт, если у товара не указан вес или размеры. Это настройка всего магазина, те же значения видны на вкладке «Доставка».
5. «Какие тарифы вам доступны». Это только список из вашего договора, по группам: курьер, отделение, постамат, международные. Рядом с каждым тарифом написано «доступен» или «недоступно» с причиной. Список можно обновить кнопкой «Обновить список», но не чаще раза в минуту и шести раз в сутки.
6. «Отслеживание (необязательно)». Вставьте токен отслеживания и нажмите «Проверить токен». Кнопка отправляет один запрос, он входит в суточный лимит запросов отслеживания. Если пропустить шаг, выключится отслеживание, а выгрузка заказов продолжит работать.
7. «Готово» — последний экран со ссылками «Настройки» и «Оставить отзыв». Под карточкой каждого шага есть ссылка «Вернуться в Консоль WordPress».

Настройка плагина Почты России: подключение #

Настройки плагина лежат на странице «Woodev → Настройки», на вкладке «Почта России». Рядом есть вкладка «Доставка» с общими настройками для всех плагинов доставки Woodev. Администраторам видны обе вкладки, а менеджер магазина с правами «управлять WooCommerce» видит только «Почта России».

Вкладка «Почта России» состоит из разделов «Подключение», «Отслеживание», «Упаковка», «Выгрузка заказов» и «Дополнительно». Раздел «Перенос с версии 1.x» появляется только после обновления с прежней версии. Сначала вы заполняете «Подключение», потом «Выгрузка заказов».

Где взять ключи #

Войдите в личный кабинет «Отправки» и откройте «Настройки → API». Скопируйте значение «Токен Авторизации» в поле «Токен приложения». Затем впишите в поля «Логин» и «Пароль» данные от passport.pochta.ru. В конце нажмите «Сохранить».

Над полями написано: «Ключи личного кабинета «Отправки». Доступ к «Отправке» есть только у юридических лиц, ИП и самозанятых с договором.» Токен и пароль плагин хранит и после сохранения не показывает. В поле остаётся «•••••• сохранено — введите новое для замены» и ссылка «Очистить сохранённое». Если не трогать такое поле, при следующем сохранении останется прежнее значение.

Как проверить подключение #

Нажмите «Проверить подключение». Кнопка отправляет один запрос к «Отправке» со значениями, которые сейчас стоят в полях, даже если вы их ещё не сохранили. Запрос входит в ваш суточный лимит. Повторить проверку можно не раньше чем через несколько секунд. Результат появится рядом с кнопкой.

• «Подключение установлено: токен, логин и пароль приняты.» — всё в порядке.
• «Укажите токен приложения, логин и пароль.» — одно из полей пустое.
• «Токен приложения не принят. Скопируйте его целиком: «Настройки → API → Токен Авторизации» в личном кабинете «Отправки».» — токен неверный или скопирован не полностью.
• «Логин или пароль не приняты. Укажите логин и пароль от passport.pochta.ru.» — ошибка в логине или пароле.
• «Проверьте токен приложения, логин и пароль.» — ключи не приняты, но Почта России не уточнила, какой именно.
• «Почта России отклонила проверку. Если доступ к API не подключён, напишите личному менеджеру.» — проверьте, подключён ли доступ к API. Если нет, обратитесь к личному менеджеру Почты России.
• «Не удалось проверить подключение: Почта России не ответила. Попробуйте позже.» — Почта России не отвечает. Нажмите кнопку позже.

Пока ключи не заданы, способы Почты России не показываются покупателям. Менеджер магазина увидит причину: «в настройках плагина не указаны токен, логин и пароль «Отправки».» Как включить такую подсказку, мы описали в разделе про оформление заказа.

Настройка плагина Почты России: отправитель и общие настройки #

Отделение отправки #

Раздел «Выгрузка заказов» содержит карточки, а карточка «Отправитель» нужна вам сразу. В ней поле «Отделение отправки» — выпадающий список со строкой поиска «Поиск…». Первый пункт «Не выбран», дальше идут отделения в виде «индекс — адрес». У отделений, через которые доступны международные отправления, в конце написано «(международные отправления доступны)».

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

Если список пустой или в кабинете «Отправки» появились новые отделения, нажмите «Обновить список» в той же карточке. Кнопка заново загружает отделения из «Отправки». Она недоступна, пока вы не сохранили ключи в разделе «Подключение». Нажимать её можно не чаще раза в минуту и не больше шести раз в сутки. После загрузки сохраните другие правки и обновите страницу, тогда нужное отделение появится в списке.

Если Почта России не приняла ключи, проверьте их в разделе «Подключение». Если список обновляли слишком часто, повторите завтра.

Вес и габариты по умолчанию #

Эти значения лежат не во вкладке «Почта России», а на вкладке «Доставка» в разделе «Вес и габариты». Они общие для всех плагинов доставки Woodev. Для точной цены укажите вес и размеры в карточке каждого товара, а эти значения подставляются, только если у товара они не заданы.

Полей четыре: «Вес по умолчанию», «Длина по умолчанию», «Ширина по умолчанию» и «Высота по умолчанию». Единицы берутся из настроек WooCommerce («Настройки → Товары»). Если ничего не меняли, там 100 граммов и 10 × 10 × 10 сантиметров. Все четыре поля обязательны, значение должно быть больше нуля.

Каждое значение подставляется отдельно. Если у товара указан вес, но нет размеров, вес остаётся его собственным, а размеры берутся по умолчанию. Ноль считается «не указано».

Логирование #

Переключатель «Логирование» лежит в разделе «Дополнительно». Пока он выключен, в журнал попадают только ошибки. Когда он включён, в журнал пишутся ещё подробные записи, запросы к Почте России и её ответы. Включайте его на время диагностики и выключайте потом: данных записывается много. Подробнее про журнал в разделе в конце статьи.

Рядом переключатель «Не показывать на странице корзины». Он убирает способы доставки Почты России из корзины, а на оформлении заказа они остаются.

Способы доставки в зонах #

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

Как добавить способ в зону #

1. Откройте «WooCommerce → Настройки → Доставка» и выберите зону, для которой нужна Почта России.
2. Нажмите «Добавить метод доставки». Откроется окно «Создать способ доставки».
3. Выберите «Почта России — курьер», «Почта России — отделение», «Почта России — постамат» или «Почта России — за границу», нажмите «Продолжить» (в окне написано «Шаг 1 из 2») и подтвердите добавление.
4. Нажмите на название добавленного способа. Его настройки откроются на отдельной странице, вверху которой стоит путь вида «Зоны доставки > название зоны > название способа». Каждый способ настраивается отдельно.

В окне добавления и в заголовке страницы способа название короче, чем у покупателя: например, «Почта России — отделение» там и «Почта России — в отделение» на оформлении заказа.

Чем отличаются четыре способа #

Один способ в зоне предлагает один тариф. Чтобы покупатель мог выбрать, добавьте в зону несколько способов, например два курьерских с разными тарифами.

	Курьер	Отделение	Постамат	За границу
Что делает	Доставка до двери получателя	Доставка в почтовое отделение, которое покупатель выбирает на карте	Доставка в постамат, который покупатель выбирает на карте	Международные отправления
Название для покупателя по умолчанию	«Почта России — курьером»	«Почта России — в отделение»	«Почта России — в постамат»	«Почта России — международная доставка»
Тарифы	«Курьер онлайн», «EMS»	«Посылка онлайн», «Посылка 1 класса», «Посылка»	«Посылка онлайн в постамат»	«Международная посылка», «Международное EMS», «Мелкий пакет»
Куда	В России	В России	В России	В любую страну, кроме России
Карта	Нет	Да	Да	Нет
Оплата при получении	Возможна	Возможна	Нет	Нет

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

Заголовок и описание #

Первые два поля способа видит покупатель. «Заголовок» — название способа при оформлении заказа, «Описание» — текст под ним. Чтобы убрать текст, очистите поле «Описание». У курьера и международного способа текст по умолчанию свой, у отделения и постамата — «Доставка в пункт выдачи.»

Тариф #

Поле «Тариф» — выпадающий список. В нём перечислены все тарифы вида этого способа, а недоступные помечены: «— недоступно:» и причина простыми словами. Если проверить тариф не удалось, рядом написано «— не удалось проверить, повторите позже». Под списком есть ссылка «Обновить список тарифов», между двумя нажатиями нужно подождать минуту.

Доступность определяется по данным вашего аккаунта «Отправки» и проверке для выбранного отделения отправки. Живую проверку тарифа плагин делает только тогда, когда вы открываете настройки способа. На оформлении заказа он ничего не проверяет, а использует сохранённый результат. Результат действует около 6 часов, а если проверить тариф не удалось, то 10 минут.

Для нового способа тариф уже выбран: у курьера это «Курьер онлайн», у отделения «Посылка онлайн», у постамата «Посылка онлайн в постамат», у международного «Международная посылка». Если сохранить значение, которого нет среди тарифов этого вида, плагин вернёт тариф по умолчанию.

У каждого тарифа свой предел веса. Если посылка тяжелее, способ скрывается.

Тариф	Способ	Максимальный вес
«Курьер онлайн»	Курьер	31,5 кг
«EMS»	Курьер	31,5 кг
«Посылка онлайн»	Отделение	20 кг
«Посылка 1 класса»	Отделение	5 кг
«Посылка»	Отделение	20 кг
«Посылка онлайн в постамат»	Постамат	20 кг
«Международная посылка»	За границу	20 кг
«Международное EMS»	За границу	30 кг
«Мелкий пакет»	За границу	2 кг

Для российских тарифов сравнивается большее из двух значений: реальный вес или объёмный. Объёмный считается как объём посылки в кубических сантиметрах, делённый на 5 000, в килограммах. За границу плагин считает только реальный вес.

Отделение отправки в способе #

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

Дополнительные услуги #

В способах курьера, отделения и постамата доступны три дополнительные услуги: «SMS-уведомление получателя», «Осторожно / Хрупкое» и «Проверка комплектности». Каждая показывается только для тарифа, который её принимает. За границу услуги не предлагаются.

Что это за услуги:

• «SMS-уведомление получателя» — «Уведомлять получателя по SMS о движении посылки». Доступна для всех внутренних тарифов. Услуга платная, её стоимость входит в цену доставки для покупателя. Для тарифа «Посылка 1 класса» SMS цену «Отправки» не увеличивает.
• «Осторожно / Хрупкое» — «Ставить на посылку отметку «Осторожно / Хрупкое»». Почта России принимает её только для тарифа «Посылка», поэтому поле есть у способа «Отделение» и только пока выбран этот тариф. Услуга платная, её стоимость входит в цену доставки.
• «Проверка комплектности» — в настройках способа поле называется «Проверка комплектности при получении». Платная, её стоимость входит в цену доставки. Доступна для всех внутренних тарифов, кроме EMS.
• «Размер ячейки по умолчанию» у постамата: S до 26×17×8 см, M до 30×20×15 см, L до 40×27×18 см, XL до 53×26×22 см. Плагин укажет эту ячейку в заказе, если по размерам товаров размер посылки определить нельзя. Если размеры известны, берётся большая из двух ячеек. Выбрав крупную ячейку по умолчанию, вы отсекаете постаматы, где все ячейки мельче: покупатель не сможет выбрать такой постамат.

Услуга, которую тариф не принимает, не отправляется и не ломает заказ.

Цена и ограничения #

Все правила цены лежат в настройках самого способа. Выше них стоят «Отделение отправки» и услуги, ниже — «Класс доставки», «Способ упаковки» и «Учитывать страховку». Поля идут в том порядке, в каком они перечислены здесь.

• «Минимальная сумма заказа» и «Максимальная сумма заказа». Если сумма заказа меньше минимума или больше максимума, способ не показывается. Считается сумма корзины до скидок. Сумма, равная границе, проходит. Пустое поле значит, что ограничения нет. Если вы перешли с версии 1.x, плагин перенёс сюда прежние ограничения.
• «Минимальная стоимость доставки» и «Максимальная стоимость доставки» ограничивают саму цену доставки. В обоих полях по умолчанию написано «Не ограничено».
• «Бесплатная доставка от». Доставка бесплатна, если стоимость товаров в заказе больше этой суммы. Заказ ровно на пороговую сумму ещё платит за доставку. Почта России всё равно рассчитывает способ: если она его не принимает, он остаётся скрытым и бесплатным не станет.
• «Купон на бесплатную доставку» — флажок «Разрешить использование купонов на бесплатную доставку». Он появляется, только если в WooCommerce включены купоны («Настройки → Общие»). С таким купоном доставка этим способом станет бесплатной.
• «Наценка» — число или процент, в подсказке «Например, 100 или 10%». Рядом стоят «База процента наценки» («Стоимость заказа» или «Стоимость доставки») и «Оплата с наценкой» (по умолчанию «Любой способ оплаты»).
• «Округление цены»: «Не округлять», «В большую сторону», «В меньшую сторону» или «До ближайшего значения». «Шаг округления цены»: «До десятков», «До сотен» или «До целого числа».
• «Срок доставки» — флажок «Показывать покупателю ориентировочный срок доставки». Срок называет сама Почта России. Если срока в ответе нет, он не показывается. Для международных отправлений, посчитанных по публичному калькулятору, срока нет.
• «Способы оплаты» — какие способы оплаты увидит покупатель, выбрав этот способ доставки. Пустое поле значит «любой способ». Если в итоге не осталось бы ни одного способа оплаты, ограничение не применяется, чтобы оформление не встало.

Цена, которую показывает плагин, уже включает НДС: так её возвращает Почта России. Плагин ничего не добавляет сверху, и поля «Налоговый статус» в способе нет. Рассчитанная цена запоминается на 10 минут, чтобы не запрашивать Почту России при каждом обновлении страницы.

Поля наценки и округления работают так же, как у плагинов СДЭК и Яндекс Доставки.

Страховка и объявленная ценность #

Поле «Учитывать страховку» принимает три значения: «Нет», «Всегда» и «Только при оплате при получении». По умолчанию стоит «Нет». Объявленная ценность — это стоимость товаров в посылке после скидок, без налогов, доставки и сборов.

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

Оплата при получении #

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

• Постамат не принимает оплату при получении никогда.
• Курьер: наложенный платёж должен принимать выбранный тариф, а в аккаунте «Отправки» должен быть код ЕСПП.
• Отделение: то же самое, и дополнительно наложенный платёж должна принимать выбранная точка.
• За границу оплата при получении не оформляется.

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

Упаковка #

Поле «Способ упаковки» в настройках способа показывает, как товары корзины собираются в посылки перед расчётом.

• «Как в настройках плагина» берёт значение из раздела «Упаковка» вкладки «Почта России».
• «Каждый товар отдельно» стоит по умолчанию. Каждая единица едет отдельной посылкой.
• «Всё в одну коробку» считает одну посылку.
• «Упаковывать в коробки» раскладывает товары по коробкам магазина. Тогда появляется поле «Непоместившиеся товары» с вариантами «Каждый товар отдельно» и «Всё в одну коробку». Товар, который не влезает ни в одну коробку, не теряется: он едет в отдельной посылке.

Коробки магазина вы заводите один раз для всех плагинов доставки на вкладке «Доставка» в разделе «Упаковка». Одна коробка — одна строка таблицы со столбцами «Название», «Длина, см», «Ширина, см», «Высота, см», «Макс. вес, кг», «Вес упаковки, кг», «Стоимость» и «Использовать». Кнопка «Добавить упаковку» добавляет строку, «Удалить» убирает. Столбец «Действия» с кнопкой «Удалить» стоит справа, на узком экране таблицу нужно прокрутить.

• Размеры внутренние и должны быть больше нуля.
• Максимальный вес включает вес самой коробки. Пустое или нулевое значение значит, что предела нет.
• «Стоимость» — сумма за коробку или процент, например 2%.
• В расчёте участвуют только коробки с галочкой «Использовать».

В таблице на вкладке «Доставка» видны только коробки вашего магазина, готовых коробок Почты России в ней нет. Стандартные размеры коробок Почты России и ячеек постамата S, M, L и XL заложены в плагин. На вкладке «Почта России» есть собственный раздел «Упаковка» с одним полем «Способ упаковки»: он задаёт способ по умолчанию, а в самом способе у этого поля есть вариант «Как в настройках плагина».

Класс доставки #

Поле «Класс доставки» по умолчанию стоит «Любой класс доставки». Выберите класс, если способ нужен только для товаров с ним. Варианты «Любой класс доставки», «Без класса доставки» и классы WooCommerce.

Международный способ #

У способа «Почта России — за границу» нет услуг, зато есть поле «Доставка»: «Авиа (быстрее)» стоит по умолчанию, «Наземным путём (дешевле, дольше)» дешевле и медленнее. Для посылки и мелкого пакета плагин использует другой вариант, если страна не принимает выбранный. У EMS выбора нет.

Перед расчётом плагин проверяет, что страна есть в справочнике и открыта для этого тарифа, и что вес и размеры укладываются в её ограничения. Если нет, способ скрыт. Покупателю под названием добавляется подсказка: «Имя, город и адрес — только латиницей (английскими буквами), иначе Почта России не примет отправление.» Для международного способа покупателю нужно указать почтовый индекс, иначе способ не появится.

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

Что увидит покупатель #

Курьерский и международный способы выглядят как обычные способы доставки WooCommerce. У способов «в отделение» и «в постамат» есть карта. Подробнее о том, как покупатель оформляет заказ, написано в статье «Как покупатель оформляет заказ: пункты выдачи и поля адреса».

Цена зависит от индекса #

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

Если «Отправка» временно недоступна, ключи не приняты или лимит запросов почти исчерпан, плагин считает цену по публичному калькулятору Почты России, и оформление заказа не останавливается. Для тарифов «Посылка» и «Мелкий пакет» запасного расчёта нет: если «Отправка» не отвечает, эти способы скрываются. Публичный калькулятор не считает дополнительные услуги, поэтому плагин добавляет к цене фиксированные суммы: 14,64 ₽ за «SMS-уведомление получателя» и 36,60 ₽ за «Проверку комплектности». Для тарифа «Посылка 1 класса» SMS цену «Отправки» не увеличивает.

Выбор отделения или постамата на карте #

1. Покупатель выбирает способ «Почта России — в отделение» или «Почта России — в постамат».
2. Нажимает кнопку «Выбрать пункт выдачи». После выбора она называется «Выбрать другой пункт выдачи», а под ней стоит «Выбранный пункт выдачи:».
3. Выбирает точку на карте или в списке. Можно искать по адресу.
4. Нажимает «Выбрать этот пункт». Пока плагин проверяет точку, кнопка показывает «Проверяем…».

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

Что ещё важно знать об окне:

• Метки на карте разные: у отделений синие, у постаматов голубые, выбранная точка оранжевая. Отделения и постаматы показываются в разных окнах: у способа «в отделение» на карте только синие метки, у способа «в постамат» только голубые. Рядом стоящие точки объединяются в кружок с числом.
• Строка поиска называется «Ваш адрес». Список точек скрыт, пока не нажата синяя кнопка со стрелкой, на экране у неё нет подписи. В списке у каждой точки видны адрес, название вида «Отделение почтовой связи 108821» (у постамата «Почтомат 918452») и расстояние.
• Список отсортирован по расстоянию от центра карты в момент открытия или от найденного адреса. Если сдвинуть карту, порядок в списке не перестраивается.
• Пока адрес покупателя неизвестен, карта открывается на Москве. Слишком далёкий масштаб карты заменяется сообщением «Приблизьте карту, чтобы увидеть пункты выдачи».
• Выбранная точка запоминается для населённого пункта, где её выбрали. В другом населённом пункте она не предлагается.
• Окно можно закрыть кнопкой «Закрыть». Если в настройках включено «Закрывать карту», оно закроется само после выбора.

Что написано в карточке точки #

Заголовок карточки — тип и индекс, например «Почтомат 918594» или «Отделение почтовой связи 101000». Если в одной точке несколько отделений, они показываются вкладками с короткой подписью, например «ОПС 101000», а для почтоматов «Почтомат 918594». Дальше в карточке идут:

• Адрес — полный, с областью, населённым пунктом, улицей и домом.
• Часы работы — расписание по дням, с перерывами. Время местное, по часовому поясу точки. Ближайшие праздничные дни добавляются отдельной строкой, например «Праздничные дни: 03.11 — 09:00–20:00; 04.11 — выходной».
• Максимальный вес — число в килограммах без единицы. У постамата 20.00, у отделения предел выбранного тарифа.

Телефон, услуги и способы оплаты в карточке не показываются.

Когда точку выбрать нельзя #

Точка остаётся на карте, но кнопка «Выбрать этот пункт» не работает, а над ней написана причина:

Что не так	Что видит покупатель
Заказ тяжелее предела точки	«Вес заказа … кг превышает ограничение пункта выдачи — … кг.»
Посылка не влезает ни в одну ячейку постамата	«Заказ не помещается в ячейки этого постамата»
Ячейки постамата мельче, чем «Размер ячейки по умолчанию»	«Посылка не поместится в ячейки этого постамата. Выберите другой постамат.»
Выбрана оплата при получении, а точка её не принимает	«В этом пункте выдачи недоступна оплата при получении. Выберите другой пункт или другой способ оплаты.»
Точка закрыта или исчезла	«Этот пункт выдачи больше не найден. Пожалуйста, выберите другой.»

Закрытую точку карта может показать, а выбрать её не получится. Партнёрские точки плагин не загружает совсем.

Когда покупатель нажимает «Оформить заказ», плагин проверяет выбор ещё раз. Если в этот момент служба точек Почты России недоступна, заказ по умолчанию проходит, а сбой записывается в журнал.

Настройки карты и формы заказа #

Общие настройки карты лежат на вкладке «Доставка», раздел «Карта». Они одни для всех плагинов доставки с пунктами выдачи.

Поле	Что делает	По умолчанию
«Расположение кнопки»	«В строке выбранного метода» или «После списка методов»	«В строке выбранного метода»
«Подстановка адреса»	После выбора точки подставляет её адрес в поля доставки	Включено
«Закрывать карту»	Карта закрывается сразу после выбора точки	Выключено
«Акцентный цвет»	Цвет кнопок, выбранных точек и кружков на карте, в формате #rrggbb	Не задан — используется цвет по умолчанию
«Ключ API Яндекс Карт»	Один ключ для карт всех способов в магазине	Пусто

Поле «Ключ API Яндекс Карт» стоит в разделе последним. Карта работает и без него: метки и список точек появятся сразу. Мы рекомендуем вписать свой ключ, чтобы в окне выбора пункта работали подсказки при вводе адреса. Если поле заполнено, плагин использует ваш ключ. Список отделений и их адреса при этом не требуют ключей Почты России.

При включённой «Подстановке адреса» в поле «Адрес» записываются только улица и дом, в «Город» — населённый пункт точки, в «Индекс» — индекс точки. У части точек нет улицы или дома, тогда в поле «Адрес» попадает полный адрес. Полный адрес точки остаётся в заказе.

Раздел «Форма заказа» на той же вкладке управляет полями адреса: «Единый порядок полей», «Страна», «Регион», «Адрес», «Индекс», «Формат поля телефон» и «Блокировать оформление заказа». В блочной форме часть значений недоступна: например, «Скрывать для методов ПВЗ» для индекса. Подробности есть в статье «Общие настройки доставки в плагинах Woodev».

Почему способ не показался #

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

Включите «Логирование» (вкладка «Почта России», раздел «Дополнительно») и откройте оформление заказа от имени администратора или менеджера. Под списком способов появится красная строка вида «Скрыт: «Почта России — в постамат» — причина». Если скрыто несколько способов с одной причиной, строка начинается со слова «Скрыты». Покупатели эту строку не видят. Причина в любом случае записывается в журнал WooCommerce, независимо от «Логирования»: источник wc-russian-post-rates, строка вида russian_post_courier:12 → weight_over_limit.

Причина (как написана в подсказке)	Что проверить
«в настройках плагина не указаны токен, логин и пароль «Отправки».»	Раздел «Подключение»
«Почта России отклонила токен, логин или пароль. Проверьте их в настройках плагина.»	Раздел «Подключение», кнопка «Проверить подключение»
«аккаунт «Отправки» заблокирован или доступ к API не подключён — напишите личному менеджеру.»	Обратитесь к персональному менеджеру Почты России
«выбранный тариф не подключён в вашем договоре или в вашем пункте приёма — обратитесь к личному менеджеру.»	Выберите другой тариф в способе или обратитесь к менеджеру
«не удалось определить индекс назначения для адреса покупателя.»	Нужен индекс: на гостевом оформлении он появляется после ввода
«в вашем пункте приёма услуги «Курьер онлайн» нет.»	Выберите другой тариф или другое отделение отправки
«посылка тяжелее или больше, чем допускает выбранный тариф (для международных — страна получателя).»	Вес и размеры товаров, предел тарифа в таблице выше
«дневной лимит запросов к Почте России почти исчерпан, расчёт отложен до завтра.»	Лимит можно увеличить через персонального менеджера
«Почта России не принимает выбранный тариф в страну покупателя (или страны нет в её справочнике).»	Другой тариф или транспорт у международного способа
«сумма заказа вне границ «Минимальная/Максимальная сумма заказа» в настройках этого способа доставки.»	Поля «Минимальная сумма заказа» и «Максимальная сумма заказа» в способе
«Почта России не ответила или отказала в расчёте. Подробности — в журнале WooCommerce, включите «Логирование».»	Журнал WooCommerce
«лицензия плагина не действует. Введите или продлите ключ на странице лицензий: …»	«Woodev → Лицензии»

Без подсказки и без записи в журнал способ пропадает по трём причинам: страна покупателя не та, на которую рассчитан способ, не подходит класс доставки, или у международного способа нет индекса. Об этом мы писали выше.

Заказы Почты России #

Заказы доставки всех плагинов Woodev собраны на странице «WooCommerce → Заказы доставки». Общая работа с этой страницей описана в статье «Заказы доставки: список, выгрузка, документы и статусы». Если у вас стоят несколько плагинов доставки, вверху выбирают перевозчика: «Все перевозчики» или «Почта России». На странице заказа в админке WordPress справа есть блок «Информация Почта России»: номер заказа в «Отправке», трек-номер со ссылкой на страницу отслеживания, пункт выдачи и статус доставки.

Выгрузка заказа #

Кнопки действий в таблице заказов нарисованы значками без подписей, название видно во всплывающей подсказке. У выгруженного заказа это «Обновить» (круговые стрелки), «Отменить» (красный кружок) и «Этикетка Ф7» (кнопка со стрелкой вправо). У ещё не выгруженного — «Редактировать» (карандаш), «Экспорт» (зелёная стрелка вверх) и «Выгрузить с интервалом» (календарь). Кнопка «Экспорт» есть только у заказа, который ещё не выгружен.

Кнопка «Экспорт» выгружает заказ в «Отправку». Она есть у заказа в статусах «Ожидает оплаты», «На удержании» и «Обработка». Заказ попадает во вкладку «Новые» в личном кабинете «Отправки», а в магазине сохраняется трек-номер. Покупателю уходит письмо с трек-номером, подробнее ниже.

В «Отправку» уходят номер заказа, тариф с категорией (обычная, с объявленной ценностью или наложенный платёж), отделение отправки, вес в граммах, получатель из адреса доставки (если его нет, то из платёжного), телефон и, если посылка одна, размеры. Для наложенного платежа передаётся вся оставшаяся сумма с доставкой. Для постамата передаются индекс и ячейка: большая из нужной по размерам и «Размера ячейки по умолчанию». Для отделения передаётся индекс выбранной точки. Список товаров не передаётся.

Плагин проверяет заказ до отправки и сразу пишет причину отказа. Вот самые частые:

• Не выбрано отделение отправки: плагин просит выбрать его в настройках Почты России.
• «Не удалось рассчитать посылку: у товаров заказа нет веса, а значения по умолчанию не заданы.»
• «У заказа нет способа доставки Почты России с действующим тарифом. Проверьте способ доставки в заказе.»
• «Тариф «…» не принимает наложенный платёж.» и «Тариф «…» недоступен для этого заказа: аккаунт не подключает нужную категорию отправления.»
• «В заказе не выбран постамат.» и «Посылка не помещается ни в одну ячейку постамата.»

Если у вас сохранён только токен отслеживания, а ключей «Отправки» нет, доступна одна кнопка «Обновить». Выгрузка и отмена скрыты, вместо них написано «Укажите ключи «Отправки» в настройках плагина, чтобы выгружать и отменять заказы.»

Если «Отправка» не ответила, исход выгрузки неизвестен. Тогда появится кнопка «Выгрузить повторно (я проверил кабинет)»: сначала проверьте личный кабинет «Отправки», и только если заказа там нет, выгружайте снова. Автоматического сверения плагин не делает.

Кнопка «Редактировать» (карандаш) открывает мастер заказа на странице «Заказы доставки», пока заказ не выгружен.

Автоматическая выгрузка #

Карточка «Автоэкспорт» лежит в разделе «Выгрузка заказов» вкладки «Почта России». Переключатель «Включить автоэкспорт» по умолчанию выключен. Когда он включён, заказ сам уходит в «Отправку» в момент, когда получает один из статусов в поле «Статусы для автоэкспорта». Доступны «Ожидает оплаты», «На удержании» и «Обработка», по умолчанию отмечен «Обработка». Покупатель при этом ничего не ждёт: выгрузка идёт в фоне. Вручную заказ можно выгрузить всегда.

Если выгрузка не прошла, плагин делает до пяти попыток: повторные идут через 1 минуту, 5 минут, 30 минут и 2 часа. Когда попытки закончились, на заказе остаётся заметка «Не удалось выгрузить заказ перевозчику за … попыток: …».

Плагин проверяет и адрес доставки. Для российских заказов он отправляет адрес в службу проверки Почты России. Если адрес сомнительный, автоматическая выгрузка такой заказ пропускает, а в заметке к заказу написано «Адрес сомнительный. … Автовыгрузка такой заказ не отправит; вручную его выгрузить можно.» Исправьте адрес в заказе, и после подтверждения Почтой России заметка сообщит, что отметка снята. Вручную сомнительный заказ выгружается всегда.

Если заказ перевели в «Отменён» или полностью вернули, заявка в «Отправке» отменяется сама, независимо от этих настроек.

Без действующей лицензии автоматическая выгрузка не выполняется. В заметке к заказу будет написано об этом, а после продления заказ выгружается кнопкой «Экспорт».

Этикетка Ф7 и документы #

В заказе для российского отправления есть кнопка «Этикетка Ф7». Тип печати выбирается в карточке «Документы для печати» поля «Печать этикетки Ф7»: «Термопринтер» по умолчанию или «Обычный принтер (лист)».

«Отправка» выдаёт этикетку Ф7 только для заказа, который уже добавлен в партию в личном кабинете «Отправки». Исключение — EMS: этикетка доступна сразу из вкладки «Новые». Плагин партии не создаёт. Партию, форму Ф103 и вызов курьера оформляют в кабинете Почты России. Если заказ ещё не в партии, в заметке к заказу будет написано: «Почта России: этикетка Ф7 доступна только для заказа в партии. Добавьте заказ в партию в личном кабинете «Отправки» и запросите этикетку снова.»

Отмена заказа #

Кнопка «Отменить» удаляет заказ из вкладки «Новые» кабинета «Отправки». Заказ, который уже в партии, плагин не отменяет, он ответит «Заказ уже в партии — отмените его в кабинете «Отправка».» Кнопка исчезает, когда отправление доставлено, возвращено, отменено или не удалось доставить. После отмены плагин удаляет трек-номер и текущий статус отправления, поэтому повторная выгрузка начинается заново. Служебные данные версии 1.x могут остаться: они нужны для переноса. Кнопки возврата на версию 1.x в плагине нет.

Международные заказы #

Для отправлений за границу в карточке товара, на вкладке «Доставка», есть два поля:

• «Код ТН ВЭД» — десять цифр, листовой код товара. Он нужен для всех стран, кроме Казахстана, Армении и Киргизии. Можно писать с пробелами или точками, сохраняются только цифры. Почта России проверяет код по своему справочнику и не примет выдуманный. У вариации товара, если поле пустое, берётся значение основного товара.
• «Страна происхождения» — для таможенной декларации. Если не выбрана, считается Россия.

Перед выгрузкой плагин проверяет, что адрес и данные укладываются в правила Почты России. Имя, регион, город, улица, дом и квартира должны быть записаны латиницей. Кириллицу плагин переводит сам по таблице загранпаспорта: «Жуков» становится Zhukov. Если в поле есть другие символы, например иероглифы, выгрузка остановится и назовёт эти поля. Нужны почтовый индекс, город и адрес. Названия товаров в декларации тоже пишутся латиницей.

Наложенный платёж за границу плагин не оформляет, такой заказ выгружают с предоплатой. Для Казахстана, Армении и Киргизии отправление уходит без таможенной декларации.

Документы для международного заказа — кнопка «Формы CN22/CN23». Она выдаёт один PDF, также только для заказа в партии: CN23 для посылки, E-1 для EMS, CN22 и адресный ярлык для мелкого пакета.

Отслеживание и статусы #

Чтобы статусы доставки обновлялись, вставьте токен отслеживания в разделе «Отслеживание» вкладки «Почта России». Рядом с полем есть кнопка «Проверить подключение», как у основного токена: она отправляет один запрос, который учитывается в суточном лимите запросов отслеживания. Это токен личного кабинета юридического лица на tracking.pochta.ru, не токен «Отправки». Без него заказы выгружаются, но статусы не обновляются.

Плагин опрашивает Почту России каждые 15 минут, по пять запросов за раз, не больше 25 за запуск. Отдельный заказ он спрашивает не чаще раза в 2 часа, а когда посылка ждёт в отделении, не чаще раза в 6 часов. Заказ, который уже доставлен или возвращён, больше не опрашивается. Выполненный заказ плагин проверяет ещё 60 дней, пока отправление не закрыто.

Всего в сутки плагин делает не больше 100 запросов, счётчик сбрасывается в полночь по Москве. Когда активных заказов больше, плагин сначала получает первый ответ по каждому, и только потом второй. Лимит можно изменить кодом, настройки для него нет.

Кнопка «Обновить» (круговые стрелки) у заказа запрашивает статус сразу. Она тоже входит в лимит, а для одного заказа её можно нажимать раз в минуту.

Что пишет Почта России	Статус на странице «Заказы доставки»
«Оформлено»	«Принято»
«В пути»	«В пути»
«Готово к вручению»	«К выдаче»
«Вручено»	«Доставлено»
«Возвращается отправителю»	«Возврат»
«Возвращено отправителю»	«Возвращено»
Отмена присвоения идентификатора	«Отменено»

Конечный статус («Доставлено», «Возвращено», «Отменено») плагин назад не меняет.

Когда статусы не обновляются #

Рядом с трек-номером может появиться значок:

• «Отслеживание выключено» — не указан токен отслеживания. На выгрузку заказов это не влияет.
• «Токен отслеживания не принят» — Почта России трижды подряд отклонила токен. Опрос остановится, пока вы не замените токен, или пока не пройдут сутки. Над страницей появится красное сообщение.
• «Отслеживание приостановлено» — в подсказке причина: суточный лимит исчерпан (статусы обновятся после полуночи по Москве), Почта России просит не частить (обновятся завтра) или служба отслеживания временно недоступна (плагин попробует через 15 минут).

Статус заказа в WooCommerce #

Сам статус заказа в WooCommerce плагин меняет только в двух случаях, и оба включены по умолчанию. Они лежат в карточке «Статусы доставки» раздела «Выгрузка заказов»:

• «Статус доставленного заказа» — по умолчанию «Выполнен». Заказ получает его один раз, когда посылка вручена. Отменённый, возвращённый и неоплаченный заказ не меняется.
• «Статус отменённого заказа» — по умолчанию «Отменён». Заказ получает его, когда Почта России сообщила об отмене отправления. Отмена кнопкой «Отменить» в магазине заказ не отменяет.

Вариант «Не менять» оставляет статус как есть. Другие события, например «в пути» или «ждёт в отделении», статус заказа не меняют.

Письма покупателю #

Плагин отправляет собственное письмо «Номер для отслеживания — Почта России». Оно лежит в «WooCommerce → Настройки → Письма» и уходит один раз, когда заказ выгружен и получил трек-номер: вручную или автоматически. Получатель — адрес из платёжных данных. Тема по умолчанию «[{site_title}] — заказ №{order_number} передан в Почту России», заголовок «Вашему заказу №{order_number} присвоен трек-номер». Текст письма можно изменить в поле «Текст сообщения». В нём доступны подстановки {order_number}, {order_date}, {status}, {tracking_number} и {tracking_url}. Токен отслеживания для этого письма не нужен: оно уходит сразу после выгрузки. Письмо можно выключить, как любое письмо WooCommerce.

Если заказ после отмены выгрузили заново и у него новый трек-номер, письмо уходит ещё раз. Если письмо отключено, покупателю уходит общее письмо «Передан в доставку».

Остальные письма о доставке общие для плагинов Woodev, о них написано в статье «Письма покупателю о статусе доставки». Если письмо плагина включено, общее письмо «Передан в доставку» тем же номером не дублируется.

Журнал #

Включите «Логирование» в разделе «Дополнительно», повторите действие и откройте «WooCommerce → Статус → Журналы». Там записаны запросы к Почте России и её ответы, пароль и токен маскируются. Записи делятся по источникам: расчёт цены, «Отправка», отслеживание, документы. Отдельный источник wc-russian-post-rates ведёт причины скрытых способов и работает всегда.

Почта России рядом с другим перевозчиком #

Плагин работает на одном сайте вместе с плагинами «СДЭК для WooCommerce» и «Яндекс Доставка для WooCommerce», и они друг другу не мешают. Общее у них следующее:

• одна страница «Woodev → Настройки» с вкладкой на каждый плагин и общей вкладкой «Доставка»;
• общие вес и габариты по умолчанию, форма заказа и карта;
• одна страница «Заказы доставки», где заказы каждого перевозчика видны под его именем.

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

Если на сайте остался Почта России версии 1.x, а СДЭК или Яндекс Доставка уже новой версии, плагин 1.x не запустится. В админке появится красное сообщение «Следующие плагины устарели и поэтому не были запущены: Russian Post EMS integration with Woocommerce. Обновите их до последней версии.» Порядок обновления описан в статье «Как обновить плагины WooDev на новую версию».

Если что-то пошло не так #

Сначала включите «Логирование» (вкладка «Почта России», раздел «Дополнительно») и повторите действие. Затем найдите в журнале WooCommerce строку об ошибке, а на оформлении заказа — подсказку «Скрыт: …». Если сами не разберётесь, напишите нам на странице поддержки и приложите версию плагина, фрагмент журнала и снимок экрана с ошибкой. Не забудьте выключить «Логирование», когда закончите.