Переход на новую версию СДЭК

Плагин «СДЭК для WooCommerce» версии 2.3 написан заново. Поэтому при обновлении с версии 2.2.0 и новее он автоматически переносит поддерживаемые настройки и способы доставки в зонах, а данные старых заказов остаются на месте. Переход на новую версию СДЭК проходит автоматически, а затем плагин показывает отчёт о том, что нашёл и что сделал. Тем не менее мастер покажет, какие настройки нужно задать заново, и лучше знать о них заранее.

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

Лицензия не нужна для переноса данных. Но без действующей лицензии Woodev плагин работает с ограниченными возможностями: после обновления он не рассчитывает доставку и блокирует новые операции с СДЭК, то есть выгрузку и отмену заказа, оформление отказа и получение документов. Поэтому перед обновлением проверьте, что ключ на месте.

Что изменилось в новой версии #

• Вместо одного способа доставки в зонах теперь три: «СДЭК — курьер (Woodev)», «СДЭК — пункт выдачи (Woodev)» и «СДЭК — постамат (Woodev)».
• Кроме того, появился тестовый режим со встроенными тестовыми ключами и кнопка «Проверить подключение».
• В новой версии появился общий «Адрес склада» в разделе «Отправка». Прежний адрес забора переносится в поле «Адрес отправления» способа доставки.
• Вместо «Фиксированной стоимости» есть «Минимальная стоимость доставки» и «Максимальная стоимость доставки».
• Вызов курьера из заказа и массовый вызов были доступны и в прежней версии. В новой версии добавились массовая печать документов и оформление отказа от посылки.
• Наконец, минимальные требования изменились: теперь нужны WordPress 6.4, WooCommerce 8.5.1 и PHP 7.4 или новее.

Если нужны подробности обо всех возможностях новой версии, они лежат в статье «Настройка плагина СДЭК».

Что сделать до обновления #

Сделайте резервную копию #

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

Проверьте версию плагина #

Версию вы видите в списке плагинов WordPress. От неё зависит, что именно перенесётся.

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

Если у вас 2.0 или 2.1, мастер переноса при этом скажет, что автоматический перенос недоступен: ключи и лицензия сохранены, остальное нужно настроить заново.

Проверьте требования и лицензию #

Новой версии нужны WordPress 6.4 или новее, WooCommerce 8.5.1 или новее и PHP 7.4 или новее. Если у вас версии ниже, сначала обновите сайт. Только делайте это отдельно от плагина, чтобы понимать, что именно изменилось.

Ключ Woodev лежит в вашем личном кабинете. Он остаётся в базе и переносится сам, а если понадобится, его можно вставить заново в «Woodev → Лицензии». Ключи СДЭК тоже сохраняются, поэтому вводить их заново не нужно.

Запишите, как всё устроено сейчас #

Откройте «WooCommerce → Настройки → Доставка» и сохраните снимки экрана своих зон. Затем запишите, какие способы СДЭК стоят в каких зонах. Кроме того, отметьте тарифы, наценки, пороги бесплатной доставки и ограничения по регионам и городам. Если записи есть, после обновления сравнивать намного проще.

Что происходит при обновлении #

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

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

Что переносится #

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

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

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

Мастер переноса #

Затем плагин покажет напоминание «Завершите настройку …» со ссылкой «Запустить мастер настройки». Если нужен общий порядок работы мастера, мы описали его в статье «Мастер переноса настроек». Сам мастер необязателен: магазин работает на перенесённых значениях, даже если вы его не откроете.

Шаги мастера идут в таком порядке: «Начало», «Поля», «Регионы», «Склад», «Коробки», «НДС», «Статусы», «Заказы» и «Очистка». Шаги с переносом настроек показываются, только если в прошлой версии было что переносить.

На первом шаге есть три кнопки.

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

Что не переносится и что настроить заново #

Часть прежних настроек в новой версии не читается. Вот что нужно сделать вручную.

Регионы, города и поля формы #

• Ограничения по регионам и городам. Пока вы не настроите их заново, способ доступен во всех регионах и городах. Например, для регионов используйте зоны доставки WooCommerce. Для городов в самом способе есть поле «Ограничение по городам» и список «Города». Пока ограничения остаются старыми, в админке висит напоминание «СДЭК: старые ограничения по регионам и городам не перенесены», и его можно скрыть кнопкой «Понятно, не напоминать».
• Скрытие полей «Регион» и «Индекс» только для СДЭК. В новой версии поле либо убирается для всех способов, либо нет. Поэтому выберите нужный вариант на шаге «Поля» мастера.
• Город по умолчанию для покупателя. Он не переносится. Выберите его в «Woodev → Настройки», вкладка «Доставка», раздел «Локация».

Заказы и статусы #

• Автоматическая выгрузка заказов по статусу. Старые настройки не читаются. Чтобы заказы уходили сами, включите «Включить автоэкспорт» и отметьте «Статусы для автоэкспорта» на вкладке «СДЭК», в разделе «Выгрузка заказов».
• Интервал и переключатели проверки статусов. Теперь статусы всегда обновляются раз в 15 минут и ещё мгновенными уведомлениями СДЭК, если вы их подключили. Если вы не хотите, чтобы плагин менял статус самого заказа, выберите «Не менять» в полях «Статус доставленного заказа» и «Статус отменённого заказа».

Карта, письма, услуги и тарифы #

• Настройки карты и подсказок. Старые настройки карты и подсказок DaData не переносятся. Настройте нужный источник подсказок и параметры карты заново в «Woodev → Настройки», вкладка «Доставка», разделы «Карта» и «Форма заказа».
• Ограничение городов для местного самовывоза WooCommerce. Оно не переносится. Если вы им пользовались, создайте ограничение заново другими средствами.
• Письма покупателю. Прежние настройки писем о доставке не переносятся. Поэтому откройте «WooCommerce → Настройки → Письма» и проверьте письма «Доставка: …». Подробности в статье «Письма покупателю о статусе доставки».
• Дополнительные услуги, которых больше нет. Это «Реверс», «Прозвон», «Сейф-пакеты А2–А5» и «Фото документов». Эти услуги не входят в список услуг, которые предлагает новая версия плагина. Если вы ими пользовались, мастер на шаге «Склад» покажет, какие услуги пропали.
• Тарифы, которых нет в списке. Список доступных тарифов в новой версии изменён. Если сохранённого тарифа нет в актуальном списке, он остаётся записанным и помечается «— нет в списке», поэтому выберите доступный тариф.
• Ставки НДС 12% и 20%. Они могут сохраниться в старых настройках, но новая версия не передаёт их для заказа с оплатой при получении. Выберите поддерживаемую ставку в «Woodev → Настройки → СДЭК → Отправка → Заказ и расчёты» или на шаге «НДС» мастера.

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

Что проверить после обновления #

1. Откройте «Woodev → Настройки», вкладку «СДЭК», и нажмите «Проверить подключение». Ключи сохранились, а кнопка подтвердит, что СДЭК их принимает.
2. Затем откройте «WooCommerce → Настройки → Доставка» и проверьте каждую зону. Каждый прежний способ должен стать одним из трёх новых и оказаться нужного типа.
3. Откройте настройки каждого способа и проверьте «Тариф CDEK». Кроме того, у способа должен быть «Город отправления», иначе он не покажется покупателям.
4. Также для тарифов «от двери» проверьте «Адрес отправления» или «Адрес склада» в разделе «Отправка». Если раньше адреса не было, такие тарифы пропадут с оформления заказа, пока вы его не заполните. Для тарифов «от склада» проверьте «ПВЗ отправления СДЭК».
5. Проверьте «Способы оплаты» и список способов доставки у оплаты при получении, потому что плагин переписал его при переносе.
6. В конце сделайте пробный заказ с каждым способом. Выберите пункт выдачи на карте, проверьте цену и выгрузите заказ в СДЭК кнопкой «Экспорт».

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

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

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

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

Напишите в поддержку, если красное сообщение о незавершённом обновлении не исчезает после нескольких открытий админки или если способ СДЭК пропал с оформления заказа, а причину вы не нашли. Сначала откройте «Woodev → Настройки → Дополнительно», включите «Логирование» и посмотрите причину в строке «Скрыт: …» на оформлении заказа. Если сами не разберётесь, пришлите в обращении версию плагина, фрагмент журнала и снимок экрана. Не забудьте выключить «Логирование», когда закончите.