Ідемпотентність від номера замовлення
Ключ кожного чека виводиться з самого замовлення. Повтор, перезапуск чи дубль події ніколи не створять другий чек.
Задача.
Наша діагностика показала, що 69 з останніх 77 замовлень не мали жодного фіскального документа. Виданий чек не можна скасувати, тож рішення мало бути точним з першого разу.
Що ми зробили.
- Слухач журналу замовлень маркетплейсу, який реагує на оплату, а не на відправку, тож чек виходить вчасно.
- Покупці-компанії з податковим номером пропускаються автоматично; дата відсічки не дає пробити старі замовлення вдруге.
- Перерахунок валют за курсом центробанку на попередній робочий день, межі доби за варшавським часом.
- Оплата при отриманні, вебхук статусів і сповіщення в Telegram, коли потрібна людина.
- Податкові коди масово проставлені на 219 товарах через API сервісу рахунків.
Рішення, які варто пояснити.
Навмисно маленьке
Близько 1700 рядків на стандартній бібліотеці та SQLite. Менше рухомих частин означає менше місць для поломки в системі, що працює з податковими документами.
У цифрах.
69 / 77замовлень були без чека до мосту
924подій маркетплейсу розібрано на першому живому запуску
219товарів отримали правильні податкові коди за один прохід
0шансів на дубль чека за конструкцією
Стек
- Python 3.12
- SQLite
- Allegro REST API
- OAuth Device Flow
- e-paragony API
- NBP API
- Fakturownia API
- Ubuntu
- nginx
Потрібно щось подібне?
Опишіть свій процес. Скажемо, які частини цієї системи вам підходять і скільки це коштуватиме.