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