Подключение 1С
Один защищённый протокол Kontrum и отдельные adapters для конкретных типовых конфигураций.
Protocol 2.0 / Schema 1.0 · обновлено 16.08.20261. Выберите целевую конфигурацию
| Семейство | Поколение | Статус | Проверенные релизы |
|---|---|---|---|
| Управление торговлей для Казахстана | 2.0 | Готовится | Пока не подтверждены |
| Управление торговлей для Казахстана | 3.0 | Готовится | Пока не подтверждены |
| Розница для Казахстана | 2.0 | Готовится | Пока не подтверждены |
| Розница для Казахстана | 3.0 | Готовится | Пока не подтверждены |
| Управление нашей фирмой для Казахстана | 2.0 | Готовится | Пока не подтверждены |
| Управление нашей фирмой для Казахстана | 3.0 | Готовится | Пока не подтверждены |
Не выбирайте расширение только по цифре 2.0/3.0: перед установкой сравните полное название и точный релиз конфигурации с полем «Проверено на» у артефакта.
2. Установка готового `.cfe`
- Сделайте проверенную резервную копию базы.
- Убедитесь, что скачан артефакт именно для вашей конфигурации и релиза.
- Откройте раздел администрирования расширений конфигурации.
- Добавьте `.cfe` и подтвердите подключение.
- Перезапустите сеанс 1С, если это указано в инструкции конкретного артефакта.
3. Подключение по одноразовому коду
- Откройте в Kontrum «Подключение 1С».
- Нажмите «Создать код подключения».
- В настройках расширения укажите адрес Kontrum, если он не задан автоматически.
- Введите одноразовый код и подтвердите подключение.
- Дождитесь статуса «Подключено».
Код ограничен по времени и используется один раз. Постоянный connector token сохраняется расширением; tenant credentials не хранятся в исходном коде.
4. Первичная и фоновая синхронизация
Утверждённый connector protocol поддерживает profile, пакетную передачу canonical entities, очередь команд, retry и heartbeat. Набор сущностей зависит от реально проверенного adapter. Не запускайте повторную полную синхронизацию без необходимости.
- После pairing проверьте profile и heartbeat.
- Запустите первичную синхронизацию из интерфейса расширения или существующего запроса Kontrum.
- Дождитесь успешного завершения.
- Проверьте заказы, клиентов, товары и другие заявленные артефактом сущности.
- Оставьте фоновый incremental exchange включённым.
5. Что означают статусы
- Подключено — heartbeat поступает, connector доступен.
- Нет связи — heartbeat давно не поступал; проверьте сеть и фоновые задания.
- Ошибка обмена — последнее подтверждённое действие завершилось ошибкой.
- Требуется обновление — версия connector больше не соответствует поддерживаемому контракту.
6. Обновление расширения
- Сделайте backup базы.
- Скачайте расширение для того же target и версии конфигурации.
- Замените текущую версию штатным механизмом расширений 1С.
- Перезапустите сеанс, если указано в release notes.
- Проверьте connector version, heartbeat и тестовый обмен.
При protocol-compatible обновлении identity сохраняется и повторный pairing не требуется.
7. Отключение и удаление
- Отключите обмен в настройках расширения.
- Отзовите подключение в Kontrum, если база больше не должна иметь доступ.
- Отключите или удалите расширение штатным механизмом 1С.
Исторические данные Kontrum не удаляются автоматически вместе с extension или connection.
8. Диагностика
- Проверьте точное время последнего контакта и последней успешной синхронизации.
- Убедитесь, что сервер 1С может открыть HTTPS API Kontrum.
- Проверьте фоновые задания и локальный журнал расширения без секретов.
- Не прикладывайте connector token к обращению в поддержку.