• Контакты
  • Тема оформления

    Документация

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

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

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

    00О плагине

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

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

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

    Быстрый стартЕсли коротко: установите и активируйте плагин → активируйте лицензию → заполните логин/API-ключ и реквизиты отправителя во вкладке «Настройки» → добавьте способ доставки «ПЭК (сборный груз)» в нужную зону доставки WooCommerce → укажите вес и габариты у товаров. Подробности — по каждому шагу ниже.

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

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

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

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

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

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

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

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

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

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

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

    Доступ к API ПЭК

    ПолеЧто указать
    ЛогинЛогин, выданный ПЭК для доступа к API.
    API-ключКлюч, выданный ПЭК. Хранится в базе данных сайта (wp_options) — не публикуйте его в скриншотах и репозиториях.
    Контур«Боевой» для реальной работы. У ПЭК нет отдельного тестового контура API, поэтому «Тестовый» переключать пока не на что.
    Base URL APIНе трогайте без необходимости — значение по умолчанию (https://kabinet.pecom.ru/api/v1) верное.

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

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

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

    • Форма — юридическое лицо, ИП или физическое лицо;
    • ИНН;
    • Название/ФИО — например, «ИП Иванов Иван Иванович»;
    • Контактное лицо — например, «Иванов Иван Иванович»;
    • Телефон — в формате +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 в новой вкладке;
    • кнопку «Отменить заявку» — аннулирует заявку в ПЭК (с подтверждением).
    На заметкуСразу после создания заявки отмена может не сработать — ошибка «Не удалось обработать запрос на аннулирование». Это особенность API ПЭК: ему нужно немного времени на обработку новой заявки. Попробуйте ещё раз через минуту.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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