Интеграции

Интеграция 1С:Предприятие

Кратко
Открыть .mdСпросить ChatGPTСпросить Claude

Интеграция 1С:Предприятие подключается к стандартному OData-интерфейсу базы по логину и паролю (Basic Auth): чтение контрагентов, номенклатуры, заказов покупателей, складов и организаций, создание контрагентов и заказов из мессенджеров.

  • Где: «Интеграции» → 1С:Предприятие → «Подключить»; поля «URL базы 1С» (адрес публикации без /odata/standard.odata), «Пользователь», «Пароль».
  • Предусловие: база опубликована на веб-сервере с включённым OData, объекты Catalog_Контрагенты, Catalog_Номенклатура, Document_ЗаказПокупателя, Catalog_Склады, Catalog_Организации входят в публикацию.
  • Проверка при подключении: GET {URL базы}/odata/standard.odata/$metadata.
  • Списки читаются по 50 записей ($top=50, $skip); заказы фильтруются по Posted eq true/false.
  • Запись: POST Catalog_Контрагенты и POST Document_ЗаказПокупателя.
  • Авторизация Basic Auth в каждом запросе; рекомендуется отдельный пользователь 1С с минимальными правами и HTTPS.
ИнтеграцииRetailCRMБитрикс24WebhookАссистент продаж
На этой странице

Интеграция открывает справочники и документы 1С мессенджерам. Клиент спрашивает «есть ли товар в наличии?», AI-ассистент проверяет номенклатуру в 1С. Менеджер пишет имя клиента, платформа находит контрагента и показывает его заказы.

Подключение идёт через стандартный OData-интерфейс 1С с авторизацией по логину и паролю.

#Что синхронизируется

Объект 1СOData-сущностьЧтениеЗапись
КонтрагентыCatalog_КонтрагентыСписок, поиск по наименованиюСоздание с ИНН, КПП и контактами
НоменклатураCatalog_НоменклатураСписок товаров и услуг, поиск по названиюНет
Заказы покупателейDocument_ЗаказПокупателяСписок с фильтром по проведённостиСоздание заказа
СкладыCatalog_СкладыСписок складов и филиаловНет
ОрганизацииCatalog_ОрганизацииСписок ваших юрлицНет

#Что нужно на стороне 1С

  • Информационная база, опубликованная на веб-сервере (Apache или IIS) с включённым стандартным интерфейсом OData.
  • В публикации OData разрешены объекты из таблицы выше: без этого справочник вернёт ошибку «не найден».
  • Отдельный пользователь 1С для интеграции с правами на чтение нужных справочников и документов и на запись контрагентов и заказов.
  • Доступ к серверу 1С из интернета напрямую или через VPN и туннель.

#Как подключить

Подключение 1С:Предприятие
  1. URL базы 1С с включённым OData.
  2. Пользователь.
  3. Пароль.
  4. Кнопка подключения.

#Настроить OData в 1С

  1. Откройте базу в конфигураторе и включите публикацию стандартного интерфейса OData для нужных справочников и документов.
  2. Опубликуйте базу на веб-сервере: появится адрес вида https://my1c.company.ru/base.
  3. Создайте пользователя 1С для интеграции и выдайте ему минимальные права.
  4. Проверьте в браузере адрес https://my1c.company.ru/base/odata/standard.odata/$metadata под этим пользователем: откроется XML с описанием объектов.

#Подключить в tuk-tuk.online

  1. Откройте раздел Интеграции, выберите 1С:Предприятие и нажмите «Подключить»: появится форма с тремя полями.
  2. В поле «URL базы 1С» введите адрес публикации базы без /odata/standard.odata, например https://my1c.company.ru/base: путь к OData платформа добавляет сама.
  3. Заполните «Пользователь» и «Пароль» пользователя 1С.
  4. Нажмите «Подключить»: платформа запросит $metadata и при успехе отметит карточку «Интеграция подключена». При неверных данных форма покажет «Неверный логин или пароль 1С».

#Проверить, что работает

  1. Нажмите «Управлять» и откройте страницу 1С в кабинете: работает «Поиск контрагента», список подгружается страницами по 50 записей.
  2. Откройте номенклатуру и найдите товар через «Поиск номенклатуры»: карточка найдётся.
  3. Создайте тестового контрагента: он появится в справочнике 1С.

#Что происходит после подключения

ДействиеЗапрос к 1С
Список и поиск контрагентовGET /odata/standard.odata/Catalog_Контрагенты?$format=json&$top=50&$skip=N
Список товаровGET /odata/standard.odata/Catalog_Номенклатура?$format=json&$top=50
Список заказовGET /odata/standard.odata/Document_ЗаказПокупателя?$format=json&$orderby=Date desc
Только проведённые заказытот же запрос с $filter=Posted eq true
Склады и организацииGET .../Catalog_Склады, GET .../Catalog_Организации
Создание контрагентаPOST /odata/standard.odata/Catalog_Контрагенты
Создание заказаPOST /odata/standard.odata/Document_ЗаказПокупателя

Каждый запрос уходит с заголовком Authorization: Basic (логин и пароль в base64).

#Ограничения

  • Только стандартный OData-интерфейс 1С; HTTP-сервисы собственной разработки не используются.
  • Списки читаются страницами по 50 записей.
  • Логин и пароль передаются в каждом запросе: публикуйте базу только по HTTPS.
  • Названия объектов фиксированы (Catalog_Контрагенты, Document_ЗаказПокупателя и другие из таблицы): конфигурации без этих объектов интеграция не поддерживает.
  • Фильтр заказов работает по признаку проведения (Posted).

#Частые проблемы

ПроблемаЧто делать
«Не удалось подключиться»Проверьте, что база опубликована, OData включён и адрес открывается из интернета; в поле «URL базы 1С» не должно быть /odata/standard.odata
401 Unauthorized, «Неверный логин или пароль 1С»Сверьте учётные данные пользователя 1С, попробуйте войти ими в веб-клиент
Справочник не найденВключите нужный объект в состав публикации OData в конфигураторе
Нет данныхВыдайте пользователю 1С права на чтение справочника или документа
Медленный ответСервер 1С перегружен или база большая: сузьте поиск по наименованию и повторите позже