Интеграции · Skerry ·
Как связать интернет-магазин и доставку по API.
Интеграция доставки начинается с правил передачи заказа. Нужно определить готовность заказа, состав данных, поведение при ошибке и способ проверить, что отправление создано.
В какой момент передавать заказ
В задаче интеграции СДЭК, с которой мы работали, данные покупки и выбранной доставки должны были автоматически поступать из витрины в курьерскую службу.
Для нового проекта сначала уточняем, что запускает передачу: подтверждение заказа, оплата или действие сотрудника. Нельзя считать любой незавершённый заказ готовым к отправлению.
Какие сведения нужны получателю
Сопоставьте поля витрины с требованиями выбранного API: состав заказа, данные получателя, параметры доставки и отправления. Набор обязательных полей проверяется по документации конкретной службы.
Отдельно определите источник каждого значения и условия обработки пользовательских данных. Недостающие сведения должны обнаруживаться до передачи.
Повтор не должен создавать второй заказ
Сеть может прерваться после того, как внешняя система приняла запрос. Простая повторная отправка без проверки результата может создать дубликат.
Нужно согласовать идентификаторы, повторные попытки, обработку отказов и доступные API способы проверки состояния. Лог успешного HTTP-запроса ещё не доказывает, что весь сценарий доставки завершился.
Как проверить интеграцию до запуска
Проверяем согласованные сценарии в безопасной среде: корректный заказ, нехватку данных, ошибку внешней системы и повторную передачу. Рабочие отправления не создаём ради теста без отдельного основания.
Для оценки пришлите описание витрины, выбранного тарифа и момента передачи заказа. Интеграция доставки — самостоятельная задача; пример каталога MilitaryShop ниже показывает опыт работы с товарной структурой, но не заявляет наличие в нём интеграции СДЭК.
Документация
Похожая задача?
Интеграции