Для пропавшей офлайн-покупки найдите три подтверждения: чек есть в выгрузке кассы, его приняла интеграция, операция связана с нужным участником программы. Отсутствие баллов в приложении не говорит, на каком участке произошёл разрыв. Не начисляйте их вручную до сверки: запоздалая кассовая очередь может позже провести тот же чек автоматически.
Начните с синтетической покупки в тестовой точке и устойчивого идентификатора чека. Отдельно фиксируйте результат идентификации участника. Продажа без предъявленной карты и продажа с картой, которую импорт не смог сопоставить, — разные случаи. Право привязать покупку задним числом определяется правилами программы и подтверждением принадлежности, а не совпадением суммы.
Маршрут чека удобнее общего журнала ошибок
| Этап | Подтверждение | Если его нет |
|---|---|---|
| Касса сформировала запись | Ключ источника и чека | Разбирать выгрузку кассы |
| Интеграция приняла | Время приёма и контроль формата | Разбирать доставку или схему |
| Участник найден | Безопасная ссылка на внутренний счёт | Уточнять сопоставление карты |
| Правило применено | Основание начисления либо отказа | Разбирать условия покупки |
| Эффект записан | Уникальная операция по чеку | Проверять обработку и отображение |
Ответ HTTP об успешном приёме не всегда означает, что начисление уже выполнено. Контракт интеграции должен различать постановку в очередь и завершённый эффект. Для отказа сохраняйте понятный код: неизвестная карта, неподходящий статус, неподдерживаемый формат или уже обработанный документ. Общий статус «не учтено» заставляет поддержку снова проходить весь маршрут.
Номер чека уникален только в своём пространстве
Условный составной ключ, уточняется по кассовой системе:
источник + торговая точка + терминал + документ
не: только печатный номер чека
тот же ключ, то же содержимое -> известный повтор
тот же ключ, другое содержимое -> конфликт на разбор
возврат -> собственный документ со связью с покупкойПечатный номер может повторяться в другой кассе или периоде. Используйте документированное устойчивое поле источника либо согласованный составной ключ, включая нужную область нумерации. PostgreSQL поддерживает уникальность комбинации колонок; документация проверена 20 октября 2026 года. Колонки ключа должны иметь предусмотренное поведение для NULL: пустая часть идентичности не должна молча создавать неограниченные повторы.
Не превращайте телефон клиента в технический ключ продажи. Он может измениться и является персональными данными. Сопоставление карты с участником выполняется в разрешённой области с проверкой принадлежности. В общие логи достаточно внутренних безопасных ссылок и кодов результата; кассовый экспорт с реальными контактами не нужен для воспроизведения ошибки формата.
Поздняя выгрузка не должна менять правила незаметно
Определите, по какому времени выбирается редакция программы: момент покупки или момент приёма. Сохраните оба времени и часовой пояс источника. При восстановлении связи после сбоя система должна применить согласованную политику поздних документов. Иначе одинаковые покупки в одной акции получат разные результаты только из-за времени доставки файла.
- Загрузить тестовый чек дважды и получить один эффект.
- Загрузить такой же печатный номер от другой кассы.
- Передать покупку с неизвестной картой и увидеть явный исход.
- Восстановить задержанную выгрузку после смены акции.
- Передать связанный возврат и проверить отсутствие повторного начисления.
После исправления сопоставления повторно обрабатывают только проверенный набор отклонённых чеков, сохраняя исходный ключ. Не переименовывайте документы ради обхода дедупликации. Если ручная компенсация уже была, свяжите её с покупкой до повтора, иначе восстановление создаст двойной эффект.
Практический результат диагностики — один чек с понятным последним состоянием и ответственным участком интеграции. На разбор передайте обезличенный формат записи, схему ключа, времена покупки и приёма, код отказа. Это позволяет восстановить конкретную покупку и проверить очередь, не выгружая всю кассовую базу и не меняя чужие бонусные счета.