Разделы базы знаний
Данные TRB-005

Проблемы синхронизации и расхождения данных

Диагностика зависших и ошибочных прогонов, нулевых результатов и отличий от Bitrix24.

При несвежих данных проверьте сразу расписание, последний прогон и доставку событий.

Быстрая проверка

  1. Убедитесь, что расписание включено.
  2. Сравните время последней успешной синхронизации с ожидаемым.
  3. Откройте журнал и найдите ошибки или остановленные прогоны.
  4. Проверьте время последнего webhook-события.
  5. Запустите ручную синхронизацию для контрольной сверки.

Дополнительно

Если проблема повторяется, передайте поддержке номер контрольного прогона.

Данные отличаются от Bitrix24

Разница с Bitrix24 обычно связана со свежестью, выбранным периодом или порядком этапов загрузки.

Быстрая проверка

  1. Сравнивайте данные на один и тот же момент времени.
  2. Проверьте дату последней успешной синхронизации.
  3. Убедитесь, что запись попадает в глубину загрузки.
  4. Дождитесь завершения всех зависимых этапов.
  5. Для удалённых записей проверьте webhook и последующую сверку.

Дополнительно

Зафиксируйте безопасный ID записи и номер прогона; не присылайте клиентские контакты.

Синхронизация долго выполняется

Первая или глубокая синхронизация может идти долго из-за объёма и последовательных зависимых этапов.

Быстрая проверка

  1. Проверьте, меняется ли текущий этап или время последнего ответа.
  2. Посмотрите количество уже загруженных записей.
  3. Учтите, что общий процент не показывается, пока CRM поэтапно сообщает объём.
  4. Не запускайте второй прогон того же источника.
  5. Если прогресс и heartbeat долго не меняются, запишите номер прогона.

Дополнительно

Реальная проблема отличается от большого объёма отсутствием новых ответов и переходов между этапами.

Синхронизация завершилась с ошибкой

Ошибка прогона требует проверки конкретного этапа в журнале.

Быстрая проверка

  1. Откройте запись запуска.
  2. Найдите последнюю сущность или этап с ошибкой.
  3. Проверьте состояние подключения и права webhook.
  4. Устраните причину и запустите повторно.
  5. Если ошибка повторяется, передайте поддержке номер прогона, время и название этапа.

Дополнительно

Секрет webhook и пароль CRM для диагностики не требуются.

Почему в журнале по сущности стоит 0

Ноль в строке сущности может быть нормальным результатом: за период не было изменений.

Быстрая проверка

  1. Проверьте выбранную глубину и время прогона.
  2. Сверьте, были ли изменения этой сущности в CRM.
  3. Посмотрите, не помечен ли этап как пропущенный.
  4. Проверьте права webhook на эту группу данных.
  5. Убедитесь, что предыдущий зависимый этап завершился.

Дополнительно

Оценивайте ноль вместе со статусом и пояснением строки.

Что отправить поддержке при проблеме с синхронизацией

Для диагностики синхронизации поддержке нужен контекст запуска, а не секреты доступа.

Как выполнить

  1. Укажите название организации и источник.
  2. Сообщите примерное время проблемы.
  3. Скопируйте номер прогона.
  4. Назовите этап или сущность и опишите ожидаемый результат.
  5. Приложите скриншот статуса без PII и секретных адресов.

Как понять, что всё получилось

Никогда не отправляйте пароль, токен, полный входящий или исходящий webhook.

Безопасный скриншот

Журнал запусков без персональных данных и секретов