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

Приложение 1С:Управление торговлей подключает стандартный OData-интерфейс базы УТ. Агент работает с опубликованными документами продаж и закупок, номенклатурой, ценами, складами и регистрами остатков.

Назначение

Используйте приложение для сводок по реализации и закупкам, контроля заказов, анализа товарных остатков и цен, а также для подготовки согласованных изменений в торговой базе.

Подключение

1. В конфигураторе включите публикацию стандартного OData-интерфейса.
2. Заполните Состав стандартного интерфейса OData: добавьте только нужные Catalog_*, Document_*, AccumulationRegister_* и InformationRegister_*.
3. Создайте пользователя интеграции с ролью УдаленныйДоступOData и минимально необходимыми правами.
4. Опубликуйте базу по HTTPS.
5. В приложении введите адрес публикации, логин и пароль.

Promto добавляет /odata/standard.odata/ к адресу и проверяет $metadata до сохранения подключения. Пароль остаётся на сервере. Подключением управляет владелец рабочего стола.

Интерфейс и данные

Главная страница содержит сценарии Что доступно в базе, Продажи за период, Выборка данных и Подключить базу.

Настройки показывают публикацию, пользователя, маску пароля, количество и список опубликованных EntitySet. Состав можно перечитать кнопкой Обновить состав ($metadata). Там же владелец разрешает доступ агенту или отключает базу.

Возможности агента

Инструмент — promto_onec_trade. Агент начинает с list_entities, затем использует describe_entity и query.

Обычно полезны:

• Document_* — реализации, поступления и заказы;
• AccumulationRegister_* — остатки и движения товаров, продажи и взаиморасчёты;
• InformationRegister_* — цены и настройки;
• Catalog_* — номенклатура, склады и контрагенты.

Это ориентиры, а не гарантированные имена. Источник истины — $metadata вашей базы.

После подтверждения агент может вызывать create_object, update_object, delete_object, post_document и unpost_document.

Сценарии

Продажи за месяц

Через promto_onec_trade найди в list_entities фактический документ реализации, проверь поля через describe_entity и собери продажи за последний месяц с суммой и контрагентом. Только чтение.

Остатки на складах

Через promto_onec_trade найди опубликованный регистр остатков, уточни его измерения и ресурсы и покажи остатки по выбранным складам и товарам.

Ограничения и подтверждения

• Состав и названия объектов зависят от релиза и расширений УТ.
• Запрашивайте только нужные поля и не поднимайте $top выше необходимого; максимум — 1000 строк за вызов.
• Создание и изменение заказа, реализации, поступления или справочника требует явного подтверждения.
• Проведение документа изменяет остатки и взаиморасчёты; post_document и unpost_document защищены отдельным подтверждением.
• Удаление через OData — физическое удаление, не пометка.
• Каждая из семи 1С-программ Promto хранит отдельное подключение, поэтому база УТ не подменяет подключение Бухгалтерии или ERP.

Если что-то не работает

• Нет нужного документа или регистра. Добавьте его в состав OData и обновите $metadata в настройках.
• 403. Проверьте права пользователя на чтение конкретного справочника, документа или регистра.
• Пустая выборка. Сначала проверьте реальные имена и типы полей через describe_entity, затем фильтр и период.
• Слишком большой ответ. Добавьте $select, сузьте $filter и используйте $skip для страниц.
• Конфликт 412. Перечитайте объект перед повторным обновлением.

Связанные материалы

• Интеграции
• Агенты
• Настройки Promto