Інтеграція замовлень зі службою доставки

Потік даних

Сценарій: передача замовлення з інтернет-магазину до служби доставки та синхронізація статусу назад у магазин.

POST /orders → перевірка даних → PostgreSQL → Celery/Redis → API перевізника → оновлення статусу.

• FastAPI: окремий сервіс приймає дані замовлення й повертає ID операції.
• Ідемпотентність: ключ із ID магазину та замовлення не дозволяє створити повторну накладну при повторній доставці webhook.
• Повторні спроби: тимчасові помилки API перевізника запускаються з паузою; після ліміту операція переходить у чергу розбору з кодом відповіді.
• Синхронізація: таблиця відповідності переводить статуси перевізника у стани магазину; невідоме значення не змінює замовлення автоматично.

Логи містять ID операції та код зовнішньої відповіді без платіжних даних. Перевірені сценарії: затримка API, повторний webhook, помилка авторизації та невідомий статус. На підключеному потоці кількість повторних накладних скоротилася з приблизно двох десятків на місяць до поодиноких випадків. Ручні замовлення до цього вимірювання не входили.