Содержание статьи
Когда документ действительно потерян
Документ не найден в интерфейсе 1С — ещё не доказательство потери. Он может ждать обработки, быть записан в другой организации, скрываться отбором, иметь другой номер или быть отклонён по правилам учёта.
Для сверки определите ожидаемый результат: запись объекта, проведение или передача на следующий участок. Входящий заказ CRM не обязательно должен автоматически стать проведённым документом 1С.
Назовём исключением объект, который должен был попасть в согласованный результат к определённому сроку, но пока не имеет подтверждения. Такой список и нужно расследовать. HTTP-семантика подробно разобрана в статье про API 200. Здесь сосредоточимся на сверке документов.
Задать границы сверки
Выберите направление CRM → 1С, период и тип документа. Затем зафиксируйте организации, базы, статусы, правила отмены и максимальную допустимую задержку. Если отборы источника и получателя различаются, список расхождений будет недостоверным.
Используйте устойчивый ключ: source_system + source_id + контекст базы/tenant. При обновлениях добавьте версию операции. Номер документа и сумма сами по себе не уникальны.
Пример: внешняя операция crm-main/order-1542/v3 создаёт или обновляет конкретный объект в erp-main. Операция передачи этого же заказа из 1С в WMS имеет свой ID, а общий correlation_id связывает процесс.
Собрать два сопоставимых набора данных
| Источник | Минимальные данные | Зачем |
|---|---|---|
| CRM | ID, версия, статус, время изменения, организация | Определить ожидаемые операции |
| 1С | Внешний ключ, внутренний ID, состояние записи/проведения | Подтвердить соответствие |
| Обмен | operation_id, attempt_id, время, исход попытки | Объяснить расхождение |
| Наблюдение | Время получения события и здоровье источника | Проверить полноту картины |
Чтение выполняйте через поддерживаемый интерфейс, отчёт или согласованную выгрузку. Структура таблиц 1С и внутренние DB IDs не являются универсальным стабильным API. Способ доступа зависит от конфигурации и прав.
Если выгрузки сняты в разное время, учитывайте временной сдвиг и документы в пути. Не помечайте свежие операции потерянными раньше согласованного срока. Отдельно проверьте пагинацию: забытая вторая страница создаст искусственную «потерю».
Алгоритм поиска исключений
- Отобрать документы CRM, которые по договорённым правилам должны передаваться.
- Исключить операции, чей срок подтверждения ещё не наступил.
- Получить подтверждения 1С с теми же ключами и контекстом.
- Вычислить отсутствующие, повторяющиеся и несовпадающие версии.
- Для каждого исключения сохранить последний подтверждённый этап и ссылку на исходный объект.
Псевдокод ниже описывает логику, а не готовый запрос к базе 1С:
Ожидаемые = документы CRM, прошедшие правила передачи и срок ожидания
Подтвержденные = объекты 1С с сопоставимым внешним ключом и версией
НетПодтверждения = Ожидаемые MINUS Подтвержденные
Дубли = ключи с несколькими целевыми объектами
ВерсияНеСовпала = ключ найден, но результат относится к прежнему изменениюСовпадение общего количества документов недостаточно: один лишний объект может скрыть один отсутствующий. Совпадение ключа тоже не подтверждает корректность всех полей — состав существенных значений нужно согласовать отдельно.
Пример сверки пяти заказов
| Заказ CRM | Наблюдение в 1С | Результат разбора |
|---|---|---|
| 1542 / v3 | Ключ найден, актуальная версия | Подтверждён |
| 1543 / v1 | Ключ не найден; срок ещё не наступил | Ожидание |
| 1544 / v2 | Ключ не найден; срок прошёл | Исключение для проверки |
| 1545 / v1 | Два внутренних объекта | Подозрение на дубль |
| 1546 / v4 | Найдена только v3 | Не подтверждено обновление |
Это учебный пример. «Исключение» означает необходимость расследования, а не установленную причину. Если источник подтверждений остановился, все пять состояний могут быть оценены неправильно.
Для заказа 1544 сначала найдите попытку передачи и ответ принимающей стороны. Для 1546 проверьте, должна ли v4 менять целевой объект: не каждое изменение карточки CRM обязано выгружаться.
События дополняют периодическую сверку
Событийное наблюдение быстрее показывает остановку известной операции. Но если первое событие вообще не отправилось, монитор не узнает о ней только по тайм-ауту. Периодическая сверка ожидаемых ключей закрывает этот пробел.
10:02 CRM: операция 1544/v2 сформирована
10:02 Шлюз: запрос принят
10:03 1С: ошибка соответствия склада
10:17 Контроль: срок подтверждения записи прошёл
10:25 1С: после исправления объект записан
10:26 Сверка: внешний ключ связан с внутренним IDВремя и события условные. Если ошибка получена в 10:03, оповещение о ней не нужно откладывать до 10:17. Сохраняйте и время события, и время его получения; синхронизация часов важна для расследования.
Контроль источника обязателен: отсутствие heartbeat или задержка отправки событий должны отличаться от задержки самого заказа.
Восстановить только необходимую операцию
Если запись могла произойти, повтор сначала требует поиска по внешнему ID. При найденном документе продолжайте со следующего незавершённого этапа. При подтверждённом отсутствии проверьте условия идемпотентности и повторите нужную версию операции.
Не пытайтесь автоматически удалять «лишние» документы по одному отчёту. У них могут быть движения, ссылки и учётные последствия. Для дублей нужен согласованный порядок исправления и аудит.
После восстановления сохраните связь source ID → target ID и повторите сверку проблемного периода. Закрытие инцидента по доступности API вместо конечного подтверждения оставляет риск незавершённых операций.
Если требуется первичная диагностика, используйте чек-лист причин остановки обмена 1С.
Что проверить на пилоте контроля документов
Если обменов несколько и ошибки обнаруживаются только после жалоб сотрудников, настройте централизованный мониторинг.
ModernERP Integration Monitor создаётся как SaaS на серверах ModernERP: получает согласованные события существующих обменов и помогает видеть задержку и последний подтверждённый этап. Состав пилота и готовность функций фиксируются заранее; универсальный адаптер 1С, сверка через API и безопасный повтор относятся к планам V2.
Посмотреть схему подключения · Запросить демонстрацию или обсудить пилот
Универсальная автоматическая сверка через API получателя относится к V2 Monitor. Для пилота нужно отдельно определить доступные подтверждения и способ получить список ожидаемых документов. Учебные алгоритмы этой статьи не являются заявлением о готовой функции сервиса.
- Успешная передача даёт проверяемую связь двух ID.
- Ошибка справочника показывает причину и ответственного.
- Тайм-аут после записи не приводит к повторному созданию.
- Отмена и новая версия корректно меняют ожидание.
- Остановка источника событий показывает неполноту наблюдения.
- Потеря первого события обнаруживается согласованной сверкой.
Критерий результата — команда находит конкретное исключение и подтверждает восстановление. Стоимость и состав доработок оцениваются до подключения.
Частые вопросы
Можно искать по номеру и сумме?
Как вспомогательный ручной способ — да. Для автоматической сверки нужен устойчивый внешний ключ и контекст: номера и суммы повторяются.
Сверка каждые пять минут гарантирует отсутствие потерь?
Нет. Нужны полнота выборки, корректные ключи, согласованные правила и доступность источников. Частота сама по себе не доказывает качество.
Мониторинг устранит проблему без доработки обмена?
Он помогает обнаружить и объяснить отклонение. Запись, идемпотентность и восстановление зависят от реализации интеграции.
Материал от 20 ноября 2026 года. Все документы и события учебные; состав данных определяется конкретной конфигурацией.