Залишки, замовлення й відвантаження ходять між Shopify і Fiftify без ручних експортів: вебхуки, ідемпотентна черга й щогодинна звірка розбіжностей.
затримка синхронізації залишків замість добового CSV-експорту; розбіжність між Shopify і складом тримається нижче 0,3%
Магазин на Shopify і склад у Fiftify жили окремо: залишки переливали CSV-експортом раз на добу. За добу встигало статися все: оверселінг топових позицій, скасування вже оплачених замовлень, ручні правки залишків, які наступний імпорт затирав.
Потрібен був синк, який тримає дві системи в одному стані й не ламається, коли Shopify повторно надсилає той самий вебхук, а складський API у цей момент недоступний.
Написали інтеграційний сервіс на TypeScript. Shopify-вебхуки (orders, fulfillments, inventory) і події Fiftify падають у чергу BullMQ; кожна подія ідемпотентна за ключем, тому повторні доставки відсікаються, а не подвоюють залишок.
Залишки їдуть у Shopify через Admin GraphQL пачками з урахуванням rate-limit, замовлення йдуть у Fiftify на комплектацію, трек-номери повертаються в Shopify і клієнту.
Поверх усього щогодинна звірка повного стану залишків: усе, що розійшлося, потрапляє у звіт із зазначеною причиною, а не тихо перезаписується. Розгортання в Docker, метрики й алерти на затримку черги.
Наступний проєкт
Розкажіть про проєкт, і ми повернемось із оцінкою.