Woo & ПЭК — интеграция woocommerce с ТК ПЭК

Интеграция WooCommerce с транспортной компанией ПЭК: расчёт стоимости и сроков доставки на чекауте, создание заявок на отправку, наложенный платёж, трекинг статуса, печать этикетки и накладной прямо из заказа.

Версия 1.1.1  Требует WooCommerce  PHP 7.4+

00О плагине

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

• считает стоимость и сроки доставки ПЭК прямо на чекауте — сборный груз, два варианта: самовывоз из терминала и доставка до двери;
• создаёт заявку на отправку в ПЭК из заказа WooCommerce — вручную кнопкой или автоматически по статусу заказа;
• поддерживает наложенный платёж (оплата при получении, через ПЭК);
• отслеживает статус доставки и обновляет заказ фоновой задачей;
• печатает транспортную этикетку и накладную прямо из карточки заказа, без захода в личный кабинет ПЭК.

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

01Что нужно перед началом

Прежде чем настраивать плагин, подготовьте:

1. Активный WooCommerce. Плагин не работает без него — при активации без установленного WooCommerce покажет предупреждение и не включится.
2. Логин и API-ключ ПЭК. Выдаёт сам ПЭК при подключении API — обратитесь в свой личный кабинет ПЭК или к менеджеру.
3. Реквизиты отправителя. Форма (юрлицо / ИП / физлицо), ИНН, название или ФИО, контактное лицо, телефон — эти данные уходят в каждую заявку на отправку.
4. Город склада отправки. Тот город, откуда магазин физически отгружает товар в ПЭК — используется для расчёта стоимости и определения филиала-отправителя.
5. Лицензионный ключ WordPlace. Выдаётся при покупке плагина, нужен для активации автообновлений.

02Установка и активация

1. Скачайте архив плагина из личного кабинета покупателя на WordPlace (вкладка «Мои покупки»).
2. В админке WordPress откройте Плагины → Добавить новый → Загрузить плагин, выберите скачанный zip-архив и нажмите «Установить».
3. После установки нажмите «Активировать». Если WooCommerce не установлен или отключён, плагин покажет уведомление и не активируется — сначала включите WooCommerce.

После активации в меню слева появится WooCommerce → ПЭК — здесь три вкладки: «Настройки», «Лицензия» и «Инструкция» (краткая версия этой документации прямо в админке).

03Активация лицензии

Перейдите на WooCommerce → ПЭК → Лицензия. Ключ вы получили при покупке плагина на WordPlace — он приходит в личный кабинет покупателя, вкладка «Лицензии и ключи».

1. Вставьте ключ в поле (формат XXXXX-XXXXX-XXXXX-XXXXX) и нажмите «Активировать».
2. Активация привязывает лицензию к текущему домену и открывает автоматические обновления плагина через штатный механизм WordPress.
3. После активации доступны кнопки «Деактивировать» (например, перед переносом на другой домен) и «Проверить обновления».

04Настройка плагина

Все настройки собраны на одной странице — WooCommerce → ПЭК → Настройки, семь разделов подряд. Ниже — по порядку, как они идут на странице.

Доступ к API ПЭК

Отправка и реквизиты отправителя

Раздел «Отправка»: Город склада отправки — например, «Череповец». Отсюда считается стоимость доставки и отсюда формально уходит груз.

Раздел «Реквизиты отправителя (для заявок ПЭК)» — эти данные пойдут в каждую заявку на отправку:

• Форма — юридическое лицо, ИП или физическое лицо;
• ИНН;
• Название/ФИО — например, «ИП Иванов Иван Иванович»;
• Контактное лицо — например, «Иванов Иван Иванович»;
• Телефон — в формате +7XXXXXXXXXX.

Вес и габариты товаров

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

Плагин собирает из содержимого корзины один условный «груз» на весь заказ: суммирует вес, берёт максимальные длину и ширину, а высоту суммирует как условный штабель (высота одного места × количество мест). Это упрощённый расчёт для сборного груза, а не точная 3D-упаковка.

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

Плагин регистрирует новый способ доставки — «ПЭК (сборный груз)». Как и любой другой способ доставки WooCommerce, его нужно добавить в нужные зоны доставки вручную:

1. Откройте WooCommerce → Настройки → Доставка.
2. Выберите нужную зону (или создайте новую) и нажмите «Добавить способ доставки».
3. В списке выберите «ПЭК (сборный груз)» и добавьте его в зону.
4. Откройте настройки добавленного метода — здесь два поля:Название метода — что увидит покупатель на чекауте (по умолчанию «Доставка ПЭК»);Адресная доставка — если включено (по умолчанию да), покупателю на чекауте предлагаются сразу два варианта ПЭК с разной ценой и сроком: самовывоз из терминала и доставка до двери. Если выключено — только самовывоз из терминала.
5. Название метода — что увидит покупатель на чекауте (по умолчанию «Доставка ПЭК»);
6. Адресная доставка — если включено (по умолчанию да), покупателю на чекауте предлагаются сразу два варианта ПЭК с разной ценой и сроком: самовывоз из терминала и доставка до двери. Если выключено — только самовывоз из терминала.

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

• Автосоздание заявки при статусе — выберите статус заказа (например, «Выполняется»), при переходе в который плагин сам создаст заявку в ПЭК. Можно оставить выключенным («— Не создавать автоматически —») и создавать заявки только вручную кнопкой в заказе — оба способа работают одновременно, автосоздание просто экономит клик.
• Забор груза — заказ машины ПЭК для забора груза со склада магазина. По умолчанию выключено — магазин сдаёт груз в терминал самостоятельно.

Наложенный платёж

• Наложенный платёж — включает передачу данных для НП в заявку.
• Способ оплаты WooCommerce — какой способ оплаты в вашем магазине считается «наложенным платежом» (обычно «Оплата при доставке»). Для заказов с любым другим способом оплаты наложенный платёж не отправляется автоматически.
• Ставка НДС — единая для всех товаров магазина (БезНДС, НДС22, НДС10, НДС7 или НДС5). Если у вас разные ставки НДС на разные товары, потребуется доработка плагина под ваш случай.
• Услуги ПЭК — кто платит за доставку. Если выключено (по умолчанию), стоимость доставки удерживается из суммы, которую ПЭК перечисляет вам после наложенного платежа. Если включено — отправитель оплачивает услуги ПЭК отдельно.

Трекинг и SMS-уведомления

SMS-уведомления от ПЭК — если включено, ПЭК будет присылать клиенту SMS о статусе груза напрямую, в обход сайта (отдельный механизм ПЭК, не email-уведомления магазина). Статус в самом заказе WooCommerce обновляется независимо от этой галочки — фоновой задачей раз в 30 минут.

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

После того как покупатель на чекауте указывает город доставки, среди способов доставки появляются варианты ПЭК:

• «Доставка ПЭК — терминал: город, N дн.» — самовывоз из терминала, дешевле;
• «Доставка ПЭК — до двери, N дн.» — доставка курьером до адреса, дороже (появляется только если в настройках метода включена «Адресная доставка»).

Работает одинаково и в блочном чекауте (Cart & Checkout Blocks), и в классическом — плагин определяет тип чекаута автоматически и подключается к обоим.

06Обработка заказа

После создания заявки (вручную или автоматически, если настроен статус-триггер) блок показывает:

• номер заявки (код груза) и, если есть, номер сопроводительного документа;
• текущий статус доставки от ПЭК;
• раскрывающуюся «Историю статусов» — список всех промежуточных статусов с датами;
• кнопки «Печать этикетки» и «Печать накладной» — открывают готовый PDF в новой вкладке;
• кнопку «Отменить заявку» — аннулирует заявку в ПЭК (с подтверждением).

07Технические логи

Все запросы и ответы API ПЭК плагин пишет в штатный журнал WooCommerce: WooCommerce → Статус → Журналы, источник woo-pek. Полезно при разборе любых ошибок — там виден точный текст ответа ПЭК, а не только код HTTP.

08Частые проблемы

На чекауте не появляется способ доставки ПЭК

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

В шапке админки жёлтое предупреждение «ПЭК: не удалось связаться с API»

Проблема на стороне соединения с ПЭК, а не в ваших данных. Пока ПЭК недоступен, способ доставки просто не показывается покупателям — сайт продолжает работать в обычном режиме. Если предупреждение не исчезает часами, стоит написать в поддержку ПЭК.

При создании заявки — ошибка с конкретным текстом (не просто «HTTP 400»)

Плагин показывает точный текст ошибки от ПЭК — обычно там прямо сказано, какое поле не так. Частая причина — не полностью заполнены реквизиты отправителя в настройках плагина.

Наложенный платёж не работает / заявка не создаётся при включённой опции

Проверьте, что у вас действительно заключён отдельный договор на наложенный платёж с ПЭК — без него будет ошибка при создании заявки с этой опцией.

Где смотреть, что именно плагин отправил и получил от ПЭК

В журнале woo-pek — см. главу «Технические логи» выше.

09Технические ограничения

• Стоимость доставки считается по одному «грузу» на весь заказ — если товаров много и они разных габаритов, точность расчёта объёма/упаковки приблизительная (условный штабель, а не точная 3D-упаковка).
• Ставка НДС для наложенного платежа — одна на весь магазин, а не по отдельным товарам.
• Забор груза (вызов машины ПЭК на склад) реализован в коде, но не проверен вживую на реальных заявках.
• У ПЭК нет отдельного тестового контура API — все проверки идут через боевой контур с реальными заявками.