Если адрес из доставки не попадает в заказ, менеджер видит пустое поле, курьер не получает маршрут, а клиент считает, что все заполнил правильно. Обычно адрес теряется на одном из переходов: форма, корзина, API, оплата, CRM.

Нужно проследить один заказ от ввода адреса до записи в базе. Важно проверить не только текст адреса, но и город, координаты, квартиру, подъезд, комментарий и выбранный способ доставки.

Коротко: что сделать

  • Создать тестовый заказ с полным адресом
  • Проверить payload формы и API checkout
  • Сравнить данные в корзине, заказе и CRM
  • Проверить маппинг полей доставки
  • Проверить работу адресных подсказок и геокодера

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

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

  • Frontend отправляет адрес в одном поле, backend ожидает другое
  • Адрес сохраняется в сессии корзины, но не переносится в заказ
  • CRM принимает только часть полей доставки
  • После оплаты заказ пересоздается без адреса
  • Адресные подсказки возвращают координаты, но не текст адреса

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

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

  • Открыть Network и проверить запрос оформления заказа
  • Посмотреть запись заказа в базе сразу после оформления
  • Проверить webhook оплаты, если заказ обновляется после платежа
  • Сравнить поля API сайта и CRM
  • Проверить разные сценарии: самовывоз, курьер, пункт выдачи

Как исправить проблему

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

  • Привести названия полей адреса к единой схеме
  • Сохранять адрес в заказе до перехода к оплате
  • Исправить передачу адреса в CRM или службу доставки
  • Добавить валидацию обязательных частей адреса
  • Логировать адресный блок при создании и обновлении заказа

Безопасный план решения

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

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

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

Что подготовить перед исправлением

  • Номер проблемного заказа
  • Скрин формы доставки до отправки
  • Payload checkout без платежных данных
  • Название CRM или службы доставки

FAQ

Почему адрес виден в корзине, но не в заказе?

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

Нужны ли координаты?

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

Можно ли восстановить адрес старых заказов?

Иногда да, если он остался в логах, сессии, CRM, письме клиенту или payload платежа.

Когда стоит обратиться за помощью

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

Итог

Проследите адрес от формы до CRM и найдите шаг, где поле исчезает. Если нужно аккуратно починить checkout и передачу доставки, пишите в Telegram @rabotator_support.