Как подключить расчет доставки к сайту и корзине

Стоимость доставки зависит от состава корзины, адреса, склада и тарифа. Рассчитанный вариант нужно сохранить вместе с исходными параметрами заказа.

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

Как проявляется проблема

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

Что проверить сразу

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

Основные причины

• В товарах нет точного веса и габаритов.
• Адрес передается строкой без нормализации и кода населенного пункта.
• Кеш тарифа не учитывает состав корзины или склад.
• При оформлении выполняется новый расчет с другими параметрами.

Пошаговая диагностика

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

Как исправить

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

• Нормализуйте адрес и используйте справочник населенных пунктов.
• Рассчитывайте посылку по реальным весу и габаритам.
• Кешируйте справочники отдельно от персонального тарифа.
• Фиксируйте выбранный тариф, цену, срок и ПВЗ при создании заказа.

Как проверить результат

• Контрольные города и корзины совпадают с калькулятором перевозчика.
• После оформления цена и выбранный ПВЗ не меняются самопроизвольно.

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

Чего не стоит делать

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

Как не допустить повторения

• Мониторьте ошибки и время ответа API доставки.
• Регулярно обновляйте справочники и проверяйте товары без логистических параметров.

Что подготовить для технического разбора

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

Частые вопросы

Можно ли обойтись без полной переделки?

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

Почему ошибка возникает только иногда?

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

Итог

Корректный расчет строится на качественных данных товара и сохраняется как часть условий оформленного заказа.

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