Связь между 1С и Битрикс24 может работать без ошибок соединения, но передавать неправильные сведения. В одной системе обновили телефон, в другой возник второй контакт; серия документа потеряла начальный ноль; изменение статуса вернулось обратно и затёрло ручную правку. Такие ситуации лечатся проверкой модели обмена, а не постоянным повтором загрузки.
Уточните, какой обмен используется
Под словом «интеграция» могут скрываться стандартный модуль, приложение, собственная обработка или отдельный сервис. Сначала запишите название решения, версии платформы и конфигурации 1С, редакцию Битрикс24 и объекты обмена. Для стандартного варианта полезна официальная инструкция по модулю интеграции. Наличие модуля не означает, что любое пользовательское поле уже сопоставлено.
Затем составьте таблицу: объект, исходная система, получатель, направление передачи и ответственный за корректность. Для контрагентов источником может быть 1С, для первого обращения — CRM. Важно определить владельца каждого поля. Два независимых источника, которые одновременно изменяют одно значение, создают конфликт даже при технически исправном обмене.
Проверьте типы и формат значений
Частая причина искажений — несоответствие типов. Номер документа лучше рассматривать как строку, если у него бывают ведущие нули или буквы. Дату нужно передавать в согласованном формате, а числовое значение — с понятными единицами измерения. Десятичная запятая, пустая строка и отсутствие поля не всегда означают для получателя одно и то же.
Для составного реквизита опишите структуру отдельно. Если в одной системе документ хранится несколькими полями, а в другой одной строкой, нужны правила сборки и обратного разбора. Простое объединение значений пробелами может оказаться неоднозначным. На тестовых данных проверьте длинные значения, редкие символы, пустые части и повторное изменение уже переданной записи.
Не добавляйте чувствительные сведения в обмен только потому, что их можно выгрузить. Для паспортных и иных персональных данных сначала определяют обоснованную цель обработки и необходимый состав полей. Техническую диагностику проводите на синтетических примерах: они позволяют проверить формат без копирования реальных документов в журналы, переписку или тестовый портал.
Сопоставляйте записи по устойчивому ключу
Название компании или имя человека могут меняться и совпадать. Поэтому для повторного обмена нужен устойчивый идентификатор связи между объектами. Заранее решите, где он хранится и как восстанавливается после сбоя. Иначе каждая повторная отправка будет выглядеть как создание нового клиента, а исправление дублей станет постоянной ручной работой.
До первой массовой синхронизации сравните уже существующие записи. У Битрикс24 есть рекомендации по минимизации дублей в начале интеграции. Практическая задача заказчика — согласовать спорные соответствия. Автоматическое объединение только по похожему названию может связать разные юридические лица, поэтому неоднозначные пары лучше вывести в отдельный список проверки.
Разбирайте сбой на одном объекте
Выберите конкретную запись и зафиксируйте её состояние до передачи. Сопоставьте отправленные данные, ответ получателя и итоговые значения в карточке. Если передача вообще не выполнялась, проверяют запуск задания и доступность сервиса. Если ответ успешный, а поле неверное, исследуют преобразование значений, обработчики и последующую перезапись другим процессом.
В журнале полезны время, идентификатор объекта, направление, код результата и номер попытки. Содержимое секретов и полные чувствительные реквизиты туда попадать не должны. Стандартный коннектор предусматривает настройку истории взаимодействий; для собственного обмена аналогичный журнал нужно спроектировать отдельно. Без него трудно отличить потерю события от задержки очереди.
Повторяйте передачу без создания дублей
Повторный запуск должен обновлять тот же объект по ключу связи. Проверяйте это не только при обычном успехе, но и при обрыве соединения после отправки: получатель мог уже сохранить запись, хотя отправитель не получил подтверждение. Перед повтором запросите текущее состояние либо используйте предусмотренный интеграцией механизм защиты от повторной обработки.
После исправления сначала прогоните небольшой набор тестов: создание, изменение, очистка необязательного поля, повтор той же операции и конфликт двух правок. Согласуйте, какие значения должны остаться в каждой системе. Затем обработайте ограниченную часть накопившейся очереди и сравните результаты, прежде чем снимать ограничения со всего обмена.
Когда работу можно считать завершённой
Критерий восстановления — не исчезновение сообщения об ошибке, а совпадение согласованных данных, отсутствие новых дублей и понятное состояние очереди. Зафиксируйте правила сопоставления и владельцев полей в документации. При обращении в AutoBIT24 достаточно передать описание интеграции и обезличенный пример расхождения: по нему можно определить следующую проверку без раскрытия клиентских документов.
