Для пропавшей офлайн-покупки найдите три подтверждения: чек есть в выгрузке кассы, его приняла интеграция, операция связана с нужным участником программы. Отсутствие баллов в приложении не говорит, на каком участке произошёл разрыв. Не начисляйте их вручную до сверки: запоздалая кассовая очередь может позже провести тот же чек автоматически.

Начните с синтетической покупки в тестовой точке и устойчивого идентификатора чека. Отдельно фиксируйте результат идентификации участника. Продажа без предъявленной карты и продажа с картой, которую импорт не смог сопоставить, — разные случаи. Право привязать покупку задним числом определяется правилами программы и подтверждением принадлежности, а не совпадением суммы.

Маршрут чека удобнее общего журнала ошибок

ЭтапПодтверждениеЕсли его нет
Касса сформировала записьКлюч источника и чекаРазбирать выгрузку кассы
Интеграция принялаВремя приёма и контроль форматаРазбирать доставку или схему
Участник найденБезопасная ссылка на внутренний счётУточнять сопоставление карты
Правило примененоОснование начисления либо отказаРазбирать условия покупки
Эффект записанУникальная операция по чекуПроверять обработку и отображение

Ответ HTTP об успешном приёме не всегда означает, что начисление уже выполнено. Контракт интеграции должен различать постановку в очередь и завершённый эффект. Для отказа сохраняйте понятный код: неизвестная карта, неподходящий статус, неподдерживаемый формат или уже обработанный документ. Общий статус «не учтено» заставляет поддержку снова проходить весь маршрут.

Номер чека уникален только в своём пространстве

Условный составной ключ, уточняется по кассовой системе:
источник + торговая точка + терминал + документ
не: только печатный номер чека
тот же ключ, то же содержимое -> известный повтор
тот же ключ, другое содержимое -> конфликт на разбор
возврат -> собственный документ со связью с покупкой

Печатный номер может повторяться в другой кассе или периоде. Используйте документированное устойчивое поле источника либо согласованный составной ключ, включая нужную область нумерации. PostgreSQL поддерживает уникальность комбинации колонок; документация проверена 20 октября 2026 года. Колонки ключа должны иметь предусмотренное поведение для NULL: пустая часть идентичности не должна молча создавать неограниченные повторы.

Не превращайте телефон клиента в технический ключ продажи. Он может измениться и является персональными данными. Сопоставление карты с участником выполняется в разрешённой области с проверкой принадлежности. В общие логи достаточно внутренних безопасных ссылок и кодов результата; кассовый экспорт с реальными контактами не нужен для воспроизведения ошибки формата.

Поздняя выгрузка не должна менять правила незаметно

Определите, по какому времени выбирается редакция программы: момент покупки или момент приёма. Сохраните оба времени и часовой пояс источника. При восстановлении связи после сбоя система должна применить согласованную политику поздних документов. Иначе одинаковые покупки в одной акции получат разные результаты только из-за времени доставки файла.

  1. Загрузить тестовый чек дважды и получить один эффект.
  2. Загрузить такой же печатный номер от другой кассы.
  3. Передать покупку с неизвестной картой и увидеть явный исход.
  4. Восстановить задержанную выгрузку после смены акции.
  5. Передать связанный возврат и проверить отсутствие повторного начисления.

После исправления сопоставления повторно обрабатывают только проверенный набор отклонённых чеков, сохраняя исходный ключ. Не переименовывайте документы ради обхода дедупликации. Если ручная компенсация уже была, свяжите её с покупкой до повтора, иначе восстановление создаст двойной эффект.

Практический результат диагностики — один чек с понятным последним состоянием и ответственным участком интеграции. На разбор передайте обезличенный формат записи, схему ключа, времена покупки и приёма, код отказа. Это позволяет восстановить конкретную покупку и проверить очередь, не выгружая всю кассовую базу и не меняя чужие бонусные счета.

Проверенные источники