В Shop-Script не рассчитывается доставка: как проверить адрес, вес и плагины

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

Ниже — последовательность диагностики для действующего магазина на Webasyst Shop-Script. У разных версий оформления заказа, тем и интеграций могут отличаться интерфейс и набор настроек. Поэтому выводы следует делать по фактическому поведению, а не только по названию переключателя.

Воспроизведите ошибку на конкретном заказе

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

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

Сначала проверьте включение способа и условия доступности

В административной части Shop-Script найдите используемый способ доставки и проверьте его активность, применимость к нужной витрине и ограничения по адресу, сумме заказа и составу корзины. Названия разделов зависят от версии приложения и типа подключения. Отдельно посмотрите, не скрывает ли способ дополнительный модуль условий доставки или кастомная логика оформления.

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

Проверьте адрес до обращения к перевозчику

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

Официальная документация Webasyst по плагинам доставки описывает методы allowedAddress() для допустимых территорий и requestedAddressFields() для нужных полей адреса. Однако фактические ограничения определяет конкретный плагин: не предполагайте, что каждое подключение обязательно использует все эти механизмы одинаково.

Сверьте вес, габариты и единицы измерения

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

В стандартном интерфейсе и в доработках возможна разная логика формирования одной или нескольких посылок. Если товаров несколько, сравните расчёт для каждой позиции отдельно и для общей корзины. В документации Webasyst разработчикам доступны getTotalWeight(), getItems() и данные габаритов — они помогают понять, что именно передаётся расчётному модулю.

Отделите отказ в тарифе от технической ошибки

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

Согласно документации Webasyst, метод плагина calculate() отвечает за расчёт стоимости и срока либо за сообщение о невозможности выполнить расчёт. Сопоставляйте входные параметры, результат метода и отображение на витрине. HTTP 200 от внешнего сервиса ещё не гарантирует, что тариф подходит выбранному отправлению и принят магазином.

Проверьте совместимость плагина и особенностей товара

Если магазин использует дробное количество товара или нестандартные складские единицы измерения, проверьте их поддержку используемым подключением. В документации Webasyst о совместимости плагинов описано, что при неподдерживаемом сценарии Shop-Script может не передавать такой заказ на обработку в плагин либо действовать согласно настройке совместимости. Применимость этого пункта зависит от редакции и конфигурации магазина.

Обязательно зафиксируйте версии Shop-Script, Webasyst, плагина доставки, темы и PHP. Если проблема появилась после обновления, сравните изменения и требования совместимости. Не подменяйте проверку версий догадкой о том, что «последний релиз всегда виноват».

Исключите конфликт оформления заказа и сторонних модулей

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

На тестовой копии временно изолируйте недавно изменённый компонент и повторите сценарий, сохранив остальные условия. Выключение плагинов по одному на боевом магазине без плана отката рискованно: изменение доставки может нарушить оформление уже начатых заказов. Для нестандартных проверок серверной и клиентской логики используйте программирование и доработку Shop-Script.

Проверьте исправление на разных адресах и корзинах

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

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

Что оставить в отчёте и как предотвратить повторение

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

Сопровождение подобных изменений можно включить в техническую поддержку интернет-магазина. В кейсе ZetZet.ru

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