Гид по интеграции: 1С и Структура
Полное руководство по настройке двустороннего обмена данными между платформой «СТРУКТУРА» и учетными системами 1С:Предприятие 8.3. От конфигурации до отладки API.
Подготовка среды
Перед началом настройки убедитесь, что ваша инфраструктура соответствует минимальным требованиям для стабильного обмена данными по протоколу REST/JSON.
Активный доступ к API
Модуль интеграции доступен на тарифах «Бизнес» и «Корпоративный». Убедитесь, что в личном кабинете активирован доступ к разделу «Настройки API».
Версия и Платформа
Поддерживаются конфигурации 1С:УПП, 1С:ERP 2.5, 1С:УТ 11. Платформа 1С:Предприятие версии 8.3.20 и выше. Требуется режим «Толстый клиент» или веб-сервер.
Открытые порты
Ваш сервер 1С должен иметь доступ к внешнему API СТРУКТУРЫ. Необходимо открыть исходящие соединения на порт 443 (HTTPS) для домена api.struktura.ai.
Роли и права
Создайте в 1С отдельную учетную запись «Интеграция СТРУКТУРА» с правами «Администратор» или минимальным набором прав на чтение/запись справочников и документов.
Пошаговое подключение
Процесс занимает от 10 до 20 минут. Выполняйте шаги строго в указанном порядке.
Генерация токена
В панели управления СТРУКТУРА перейдите в Настройки -> Безопасность -> API Keys. Нажмите «Создать ключ», скопируйте строку (она появится один раз). Сохраните его как STRUCTURA_API_KEY.
Настройка обмена
В 1С откройте Администрирование -> Обмен данными -> Внешние источники данных. В поле URL вставьте https://api.struktura.ai/v2/sync. Вставьте ваш токен в поле авторизации.
Синхронизация справочников
Запустите процедуру «Первичная отрисовка». Система подтянет контрагентов, номенклатуру и валюты. Это может занять до 15 минут в зависимости от объема базы.
Тестовая транзакция
Создайте документ «Реализация товаров» в 1С с суммой 1000 руб. В панели СТРУКТУРА в разделе «Синхронизация» вы должны увидеть статус SYNC_OK в течение 60 секунд.
Решение типовых ошибок
Если интеграция не работает, проверьте журнал событий в панели администратора. Ниже приведены решения для кодов ошибок HTTP, которые возвращает наш API.
Неверный ключ доступа
Проверьте, не скопировали ли вы лишние пробелы при вставке токена. Если ключ старый, сгенерируйте новый в личном кабинете. Старый ключ деактивируется автоматически через 24 часа.
Ошибка валидации JSON
Чаще всего возникает из-за неверного формата даты (требуется ISO 8601: YYYY-MM-DDTHH:mm:ss) или передачи пустых обязательных полей.
Превышение лимита
Вы отправили слишком много запросов за короткое время. Лимит: 100 запросов в минуту. Дождитесь сброса счетчика или оптимизируйте пакетную отправку данных.
Внутренняя ошибка
Проблема на стороне СТРУКТУРЫ. Подождите 5 минут и попробуйте снова. Если ошибка повторяется более 3 раз, отправьте скриншот лога на support@struktura.ai.
Рекомендации по качеству данных
Точность прогнозов ИИ напрямую зависит от чистоты входящих данных. Следуйте этим правилам, чтобы избежать «мусора» в аналитике.
Используйте дату документа
Всегда передавайте дату фактического события, а не дату проведения. Это критично для расчета DSO (Days Sales Outstanding) и анализа кассовых разрывов.
Единый формат валют
Передавайте валюты в формате ISO 4217 (RUB, USD, EUR). Не используйте текстовые описания типа «Рубли» или «Доллары США» — это вызовет ошибку парсинга.
Уникальные ID контрагентов
Не создавайте дубликаты контрагентов. Используйте ИНН как уникальный идентификатор при первичной синхронизации, чтобы ИИ мог корректно агрегировать историю платежей.