ParcelKit для СДЭК

Описание

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

Виджеты для любой страницы — без ключей и без WooCommerce:

  • Калькулятор стоимости доставки — посетитель выбирает города, вес и размеры и видит все тарифы СДЭК с ценой и сроком. Тарифы живые, а не прайс-лист.
  • Карта пунктов выдачи — все пункты выдачи и постаматы СДЭК города на карте, с адресами, часами работы и списком рядом с картой.

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

Доставка СДЭК при оформлении заказа WooCommerce — на ваших собственных ключах API СДЭК:

  • До трёх вариантов в корзине и при оформлении заказа: до пункта выдачи, до двери, до постамата. В каждом — один тариф СДЭК, самый дешёвый или самый быстрый, со сроком доставки.
  • Покупатель выбирает пункт выдачи или постамат из списка с поиском прямо под вариантами доставки. Пункт сохраняется в заказе и виден на странице заказа, в письмах и на странице «Спасибо».
  • Работает и с блочным оформлением заказа, и с классическим шорткодом [woocommerce_checkout], а также с хранением заказов HPOS.
  • Наценка суммой или в процентах, бесплатная доставка от суммы заказа, округление, дополнительные дни на сборку, предпочтительные коды тарифов СДЭК.
  • Одна посылка на заказ: общий вес и коробка не меньше самого крупного товара и общего объёма. Вес и размеры по умолчанию для товаров без них.
  • Цены в рублях, тенге, белорусских рублях, долларах или евро — в той валюте, что у вашего магазина.
  • Тестовый режим с публичной тестовой учётной записью СДЭК — чтобы увидеть всё до заключения договора.
  • Заказы в СДЭК со страницы заказа. Одним нажатием создаётся заказ в СДЭК с тарифом, пунктом выдачи, получателем и товарами из заказа — с наложенным платежом, если покупатель выбрал оплату при получении. Затем можно напечатать накладную и ярлык места, увидеть номер СДЭК со ссылкой на отслеживание и статус или удалить заказ. Чтобы отправить много заказов сразу, отметьте их в списке заказов и выберите «Создать заказы в СДЭК»; «Печать накладных СДЭК» и «Печать ярлыков СДЭК» дают один PDF на все отмеченные заказы. В списке заказов виден номер СДЭК и статус каждого заказа.

Цены приходят от СДЭК по вашему договору. Заказы в СДЭК создаются, только когда вы нажмёте кнопку в заказе.

Добавьте виджет шорткодом:

[sdekcalc_calculator]

[sdekcalc_map]

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

Плагин сделан командой сдэккалькулятор.рф и не является официальным продуктом СДЭК.

Внешние сервисы

Виджеты — это страницы сервиса сдэккалькулятор.рф, показанные в iframe. Часть с доставкой в WooCommerce связывает ваш сайт с API СДЭК напрямую. Больше никуда плагин данные не отправляет.

сдэккалькулятор.рф (https://xn--80ahsabfbysbsk9ij2b.xn--p1ai/)

  • Что делает: показывает калькулятор и карту, считает тарифы и возвращает список пунктов выдачи. Тарифы и пункты сервис берёт из API СДЭК.
  • Что и когда отправляется: страница виджета загружается, когда посетитель долистал до виджета. Затем браузер посетителя отправляет введённые им города, вес и размеры посылки. Раз в сутки с каждого браузера виджет сообщает домен сайта, на котором он открыт (только домен, без адреса страницы), — чтобы сервис знал, где используется виджет. Как и любая веб-страница, сервер получает IP-адрес посетителя и user agent браузера.
  • В админке WordPress: когда администратор вводит город в конструкторе шорткода, введённый текст отправляется с вашего сервера в сервис, чтобы подсказать названия городов.
  • Условия использования: https://xn--80ahsabfbysbsk9ij2b.xn--p1ai/vidzhet.html
  • Политика конфиденциальности: https://xn--80ahsabfbysbsk9ij2b.xn--p1ai/policy.html

API СДЭК (только доставка в WooCommerce, когда вы ввели ключи API или включили тестовый режим)

  • Что делает: находит город покупателя, считает тарифы и возвращает список пунктов выдачи; когда вы нажимаете кнопку в заказе — создаёт, печатает или удаляет заказ в СДЭК.
  • Что и когда отправляется: ваши ключи API — чтобы получить токен доступа. Когда корзине или оформлению заказа нужны тарифы доставки: город отправки, страна, город и индекс покупателя, вес и размеры посылки. Когда покупатель выбирает вариант доставки, которому нужен пункт выдачи: код города. Пока вы не настроили способ доставки, ничего не отправляется. При оформлении заказа имена, телефоны, email и адреса покупателей не отправляются.
  • Заказы: только когда менеджер магазина нажимает «Создать заказ в СДЭК» в заказе или применяет «Создать заказы в СДЭК» к заказам, отмеченным в списке, плагин отправляет номер заказа, имя, телефон, email и адрес доставки или пункт выдачи получателя, примечание покупателя к заказу, товары (название, артикул, цена, вес, количество), вес и размеры посылки, суммы наложенного платежа и данные отправителя из настроек плагина. Печать, обновление статуса и удаление отправляют только идентификатор заказа СДЭК.
  • Серверы: https://api.cdek.ru (рабочий) и https://api.edu.cdek.ru (тестовый режим).
  • Условия использования: https://www.cdek.ru/ru/integration/
  • Политика конфиденциальности: https://www.cdek.ru/ru/privacy_policy/

API Яндекс Карт (только карта пунктов выдачи)

  • Карта внутри виджета рисуется через JavaScript API Яндекс Карт, который загружает страница виджета в браузере посетителя.
  • Условия использования: https://yandex.ru/legal/maps_api/
  • Политика конфиденциальности: https://yandex.ru/legal/confidential/

Скриншоты

Установка

  1. Установите плагин на странице «Плагины» или загрузите папку parcelkit-for-cdek в /wp-content/plugins/.
  2. Активируйте его.
  3. Откройте Настройки Калькулятор СДЭК, соберите шорткод и вставьте его в страницу, запись или блок «Шорткод».

Для доставки при оформлении заказа:

  1. Откройте WooCommerce Настройки Доставка СДЭК, введите ключи API из личного кабинета СДЭК (раздел «Интеграция») или включите тестовый режим, выберите город отправки и сохраните. Страница сразу покажет, принял ли СДЭК ключи.
  2. Добавьте способ СДЭК в зону доставки и выберите, какие варианты показывать.
  3. Чтобы создавать заказы в СДЭК из заказов магазина, заполните раздел «Заказы в СДЭК» на странице настроек СДЭК: пункт приёма, куда вы сдаёте посылки, или адрес забора для курьера.

Часто задаваемые вопросы

Нужен ли договор со СДЭК или ключи API?

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

Для доставки при оформлении заказа WooCommerce нужны ключи API, а их СДЭК выдаёт клиентам с договором. До этого всё можно попробовать в тестовом режиме — тестовые цены не настоящие.

Почему покупатель не видит вариантов доставки СДЭК?

Город покупателя ещё не заполнен, СДЭК туда не доставляет или не заданы ключи либо город отправки. Ошибки от СДЭК смотрите в WooCommerce Статус Журналы (источник «parcelkit-for-cdek»).

Создаёт ли плагин заказы в СДЭК и печатает ли ярлыки?

Да, со страницы заказа. Блок «СДЭК» там создаёт заказ в СДЭК, печатает накладную (два экземпляра: вам и на посылку) и ярлык места (A4 или A6, задаётся в настройках СДЭК), обновляет статус и удаляет заказ, пока СДЭК ещё не получил посылку.

Чтобы создать заказы в СДЭК сразу для многих заказов, отметьте их в списке заказов и выберите в массовых действиях «Создать заказы в СДЭК» (до 30 заказов за раз). Заказы, которые уже есть в СДЭК, и заказы без доставки СДЭК пропускаются; список покажет, что создано и почему заказ не создан. «Печать накладных СДЭК» и «Печать ярлыков СДЭК» скачивают один PDF на все отмеченные заказы с номером СДЭК (до 100 за раз). В колонке «СДЭК» списка заказов — номер со ссылкой на отслеживание и последний известный статус.

Курьера плагин не вызывает: если посылки забирает курьер СДЭК, закажите забор в личном кабинете СДЭК.

Я уже пользуюсь другим плагином СДЭК для оформления заказа

Тогда эта часть вам не нужна: просто не добавляйте способ «СДЭК» из этого плагина в зоны доставки. Виджеты работают вместе с любым плагином оформления заказа.

Замедлит ли виджет мой сайт?

Виджет — это iframe с отложенной загрузкой: браузер загружает его, только когда посетитель долистает до него. Ваши скрипты и стили он не трогает.

У калькулятора появляется своя полоса прокрутки

В плагине есть небольшой скрипт, который подгоняет высоту iframe под содержимое. Если плагин кэширования или оптимизации убирает скрипты из подвала, задайте высоту вручную: [sdekcalc_calculator height="900"].

Обязательна ли ссылка на ваш сайт?

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

Работает ли плагин с конструкторами страниц?

Да, везде, где работают шорткоды: в блочном редакторе (блок «Шорткод»), в классическом редакторе, в виджете Shortcode у Elementor и в текстовых виджетах.

Отзывы

Нет отзывов об этом плагине.

Участники и разработчики

«ParcelKit для СДЭК» — проект с открытым исходным кодом. В развитие плагина внесли свой вклад следующие участники:

Участники

«ParcelKit для СДЭК» переведён на 1 язык. Благодарим переводчиков за их работу.

Перевести «ParcelKit для СДЭК» на ваш язык.

Заинтересованы в разработке?

Посмотрите код, проверьте SVN репозиторий, или подпишитесь на журнал разработки по RSS.

Журнал изменений

0.3.0

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

0.2.1

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

0.2.0

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

0.1.0

  • Первый выпуск: шорткоды калькулятора и карты пунктов выдачи, конструктор шорткода, настройки темы и акцентного цвета.