--- title: "Интеграция 1С:Предприятие: контрагенты, заказы и номенклатура" nav_title: "1С:Предприятие" url: https://docs.tuk-tuk.online/integrations/onec markdown: https://docs.tuk-tuk.online/integrations/onec.md section: "Интеграции" description: "Как подключить 1С:Предприятие к tuk-tuk.online через стандартный OData-интерфейс с Basic Auth: справочники контрагентов, номенклатуры, складов и организаций, заказы покупателей, создание контрагентов и заказов из мессенджеров." keywords: ["1С интеграция", "1С CRM мессенджер", "1С Предприятие API", "1С OData", "1С подключить Telegram", "1С контрагенты", "1С заказы", "1С интеграция чат-бот", "1С автоматизация"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Интеграция 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. > > Связанные страницы: https://docs.tuk-tuk.online/integrations, https://docs.tuk-tuk.online/integrations/retailcrm, https://docs.tuk-tuk.online/integrations/bitrix24, https://docs.tuk-tuk.online/chains/blocks/webhook, https://docs.tuk-tuk.online/ai/sales-assistant # Интеграция 1С:Предприятие Интеграция открывает справочники и документы 1С мессенджерам. Клиент спрашивает «есть ли товар в наличии?», AI-ассистент проверяет номенклатуру в 1С. Менеджер пишет имя клиента, платформа находит контрагента и показывает его заказы. Подключение идёт через стандартный OData-интерфейс 1С с авторизацией по логину и паролю. ## Что синхронизируется | Объект 1С | OData-сущность | Чтение | Запись | |---|---|---|---| | Контрагенты | `Catalog_Контрагенты` | Список, поиск по наименованию | Создание с ИНН, КПП и контактами | | Номенклатура | `Catalog_Номенклатура` | Список товаров и услуг, поиск по названию | Нет | | Заказы покупателей | `Document_ЗаказПокупателя` | Список с фильтром по проведённости | Создание заказа | | Склады | `Catalog_Склады` | Список складов и филиалов | Нет | | Организации | `Catalog_Организации` | Список ваших юрлиц | Нет | ## Что нужно на стороне 1С - Информационная база, опубликованная на веб-сервере (Apache или IIS) с включённым стандартным интерфейсом OData. - В публикации OData разрешены объекты из таблицы выше: без этого справочник вернёт ошибку «не найден». - Отдельный пользователь 1С для интеграции с правами на чтение нужных справочников и документов и на запись контрагентов и заказов. - Доступ к серверу 1С из интернета напрямую или через VPN и туннель. ## Как подключить ![Подключение 1С:Предприятие](https://docs.tuk-tuk.online/assets/screens/integrations/onec.webp) 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. Откройте раздел [Интеграции](https://lk.tuk-tuk.online/integrations), выберите 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С перегружен или база большая: сузьте поиск по наименованию и повторите позже |