Автоматизация / MODX и доставка
Интеграция СДЭК с MODX
Подключаю интернет-магазин на MODX к API СДЭК: выбор пункта или адреса, расчёт доставки, создание отправления и обновление разрешённых статусов. Все внешние идентификаторы и ответы сохраняются рядом с заказом.
Написать в Telegram
01 Контекст
Выбранный пункт должен стать частью заказа
Город, пункт выдачи, адрес, вес, габариты и вариант доставки образуют связанный набор. Если одно значение изменилось, прежний расчёт и выбранный пункт могут стать недействительными.
Создание отправления отделяется от предварительного расчёта. Интеграция хранит внешний идентификатор и проверяет его перед повторной операцией.
02 Исходная ситуация
Какие операции подключаются
Выбор доставки
Покупатель выбирает доступный способ и пункт, а MODX сохраняет идентификатор и адрес вместе с заказом.
Расчёт по составу заказа
Сайт передаёт город, вес и габариты, проверяет ответ и фиксирует выбранный вариант.
Регистрация и статусы
Подтверждённый заказ создаёт отправление, получает документы и обновляется по согласованным событиям.
03 Состав
Состав интеграции
Данные корзины и доставки
Фиксирую источник веса, габаритов, города, пункта и правила повторного расчёта.
- карта полей
- состояния выбора
- проверки данных
Виджет и API
Подключаю выбор пункта, расчёт и доступные операции с отправлением через отдельный серверный контур.
- интерфейс выбора
- модуль API
- контрольные заказы
Статусы и журнал
Сопоставляю внешние и внутренние состояния, сохраняю ответы и настраиваю повтор безопасных операций.
- таблица статусов
- журнал
- уведомления
04 Метод
Порядок подключения
- 01
Обследование заказа
Проверяю корзину, товары, адреса, способы доставки и доступы СДЭК.
На выходе: спецификация данных - 02
Контрольные сценарии
Проверяю разные города, пункты, габариты, изменение корзины и повтор создания.
На выходе: тестовый контур - 03
Рабочая эксплуатация
Подключаю журнал и передаю порядок обработки ошибок и изменений API.
На выходе: регламент интеграции
05 Ответственность
Кто за что отвечает
Я отвечаю
- за интерфейс и интеграцию на стороне MODX
- за сопоставление заказа, пункта и отправления
- за журнал, повторы и документацию
Со стороны магазина нужны
- аккаунт и доступы СДЭК
- достоверные вес и габариты товаров
- правила упаковки, отправки и внутренних статусов
06 Оценка
Что влияет на оценку
Объём зависит от сценариев доставки и состояния данных каталога.
- 01пункты выдачи и курьерская доставка
- 02источник веса и габаритов
- 03составные упаковки
- 04создание и изменение отправления
- 05печатные документы
- 06статусы, журнал и уведомления
Условия и доступность вариантов доставки определяет СДЭК на стороне своего сервиса.
07 Среда
Технический контур
Используются официальный API и виджет, если он соответствует сценарию магазина.
- 01СДЭК API
- 02MODX Revolution
- 03PHP
- 04JavaScript-виджет
- 05HTTP и JSON
- 06планировщик и журналы
08 Вопросы
До начала работы
01Что будет, если покупатель изменит корзину?
Выбор доставки и расчёт проверяются заново, если изменились параметры, влияющие на них.
02Можно показать пункты выдачи на карте?
Да. Идентификатор выбранного пункта сохраняется в заказе и проверяется при создании отправления.
03Можно автоматически создавать отправление?
Да, после события, которое магазин считает подтверждением заказа. До этого расчёт не должен создавать внешний объект.
04Как обрабатывается повторный запрос?
Интеграция проверяет сохранённый внешний идентификатор и не создаёт второе отправление без явного решения оператора.
10 Следующий шаг
Собрать сценарий доставки СДЭК
Укажите способы доставки, данные товаров, структуру заказа и доступы. Я подготовлю карту расчёта, выбора пункта и создания отправления.
Написать в Telegram