# 1С:Управление торговлей

Держите остатки, продажи и дебиторку под рукой в чате

Управление продажами, закупками и складом через OData

## Как агент работает с 1С:Управление торговлей

Управление торговлей подключается через стандартный REST-сервис OData: агент обращается к опубликованной базе по её адресу и работает поверх типовой модели данных 1С, без внешних обработок и без выгрузок в файл. Отбор, сортировка и постраничность собираются в самом URL запроса, поэтому выборка по датам, складам и контрагентам считается на стороне 1С, а не выкачиванием таблицы целиком. Публикацию разумно держать за VPN или reverse-proxy, а не выставлять в открытый интернет: пара логин-пароль здесь единственный барьер.

Перед первым обращением агент запрашивает /$metadata и получает прикладные имена именно вашей базы: документы реализации и заказов покупателей, справочники номенклатуры и партнёров, регистры накопления по остаткам и продажам. Доработанные под ваш процесс реквизиты и табличные части приходят в схеме наравне с типовыми, поэтому дописанные поля агент тоже видит и умеет по ним отбирать.

На этом фундаменте собираются ответы, за которыми в УТ обычно лезут в отчёты: остатки по складам, сопоставленные со скоростью продаж и очередью на дозаказ; продажи по номенклатуре, менеджерам и покупателям за период; взаиморасчёты с просроченной дебиторской задолженностью по контрагентам; движения по складу против отгрузок с пересортицей и расхождениями. Остатки и обороты берутся из виртуальных таблиц регистров накопления, а не пересчитываются по документам.

Границу видимости задают роль пользователя 1С и состав публикации: агент читает ровно то, что разрешено этой учётной записи. Права на запись через OData позволяют создать заказ или реализацию, но по умолчанию подключение работает на чтение и аналитику — а созданный документ остаётся непроведённым, пока его не провели отдельным шагом, так что молча изменить учёт агент не может.

## Сценарии интеграции

### Остатки и потребность в закупках
Агент проверит остатки по складам в 1С, сопоставит их со скоростью продаж и покажет, какие позиции пора дозаказывать, чтобы не уйти в минус.

### Анализ продаж по номенклатуре и контрагентам
Агент сведёт продажи из 1С по товарам, менеджерам и покупателям за период и выделит, что растёт, а что проседает.

### Контроль дебиторки и просроченных оплат
Агент соберёт взаиморасчёты, найдёт просроченную дебиторскую задолженность по контрагентам и подготовит список на обзвон.

### Сверка складских остатков с продажами
Агент сверит движения по складу с отгрузками, найдёт расхождения и пересортицу и покажет, где учёт разошёлся с фактом.

### Что с заказами покупателей
Агент пройдёт по заказам покупателей, сопоставит их с реализациями и покажет, какие заказы отгружены не полностью и сколько по ним осталось.

### Свои поля в схеме базы
Агент прочитает /$metadata вашей базы, найдёт дописанные под ваш процесс реквизиты и табличные части и покажет, по каким из них можно отбирать и группировать.

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

**Перед подключением**

- Права администратора в базе 1С и доступ к конфигуратору
- Веб-сервер (IIS или Apache) рядом с базой 1С
- Сетевой доступ к адресу публикации — надёжнее через VPN

### Опубликуйте OData на веб-сервере
Конфигуратор: «Администрирование» → «Публикация на веб-сервере…» → флажок «Публиковать стандартный интерфейс OData» → «Опубликовать» и перезапуск веб-сервера.

### Откройте нужные объекты в составе OData
«НСИ и администрирование» → «Синхронизация данных» → «Настройка состава стандартного интерфейса OData»: отметьте нужные объекты, по умолчанию состав пуст.

### Заведите отдельного пользователя в 1С
«НСИ и администрирование» → «Настройки пользователей и прав» → «Пользователи» → «Создать»: логин латиницей, вход разрешён, пароль задан.

### Выдайте пользователю доступ к OData
Профилю нужна роль «УдаленныйДоступOData» плюс права на чтение отмеченных объектов. Без роли веб-сервер отвечает 401, без прав на объект — 401 на запрос.

### Проверьте адрес и вход в браузере
Откройте https://ваш-сервер/имя-публикации/odata/standard.odata/$metadata и войдите новым логином — вернётся XML. Часть адреса до /odata и есть адрес базы.

## Частые вопросы

### Как подключить 1С:Управление торговлей?
Через стандартный интерфейс OData: в 1С публикуется REST-сервис (OData), а вы указываете адрес публикации, логин и пароль пользователя. Права пользователя в 1С определяют, что увидит агент.

### Нужно ли что-то настраивать на стороне 1С?
Да, один раз: администратор публикует стандартный OData-интерфейс на веб-сервере 1С и заводит пользователя для интеграции. После этого агент подключается по адресу и учётным данным.

### Какие данные видит агент?
Справочники, документы продаж и закупок, остатки, взаиморасчёты и отчёты, доступные через OData — в рамках прав пользователя, чьи данные подключены.

### Может ли агент менять данные в 1С?
Только если у пользователя есть права на запись через OData. По умолчанию агент работает на чтение и аналитику; для безопасности можно завести пользователя с ограниченной ролью.

[Открыть 1С:Управление торговлей](https://v8.1c.ru/tekhnologii/obmen-dannymi-i-integratsiya/protokol-odata/)