Почему обмен с 1С встаёт на второй неделе

Формулировка почти всегда одна: «чтобы счета из Битрикса появлялись в 1С, а оплаты возвращались обратно в сделку». Звучит как одна задача с двумя стрелками, и по первому впечатлению это пара скриптов на вебхуках.

На практике задач здесь три, и они разного размера: передать документ, вернуть факт оплаты и — самое трудоёмкое — договориться, кто из двух систем считается хозяином карточки контрагента.

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

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

Третья — отсутствие журнала. Когда сумма в сделке не совпадает с суммой в документе, без записи запроса и ответа причину не найти: остаётся сверять руками то, что должно было сверяться автоматически.

Сопоставление ведут не по названию, а по идентификатору: у записи в портале хранится ссылка на объект 1С, у объекта 1С — ссылка обратно. Название компании меняется, ИНН дублируется у разных юрлиц, а пара идентификаторов переживает и то, и другое.

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

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

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

Кто хозяин карточки контрагента — портал или 1С. Ответ «оба» означает ручную сверку навсегда.

Что происходит с документом, который изменили в 1С после выгрузки: обновляется сделка или создаётся новая версия.

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