1С:Управление нашей фирмой

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

Назначение

Подключение рассчитано на оперативные задачи малого бизнеса: показать незакрытые заказы, собрать продажи за период, проверить остатки и подготовить изменения после согласования.

Подключение

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

Promto добавит OData-суффикс и проверит $metadata. Подключение сохраняется даже при пустом составе, но в этом случае приложение явно сообщит, что база пока не отдаёт объектов. Управление подключением доступно владельцу рабочего стола.

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

На главной есть сценарии Что доступно в базе, Заказы покупателей, Выборка данных и подключение.

В настройках видны публикация, логин, маска пароля, число и имена объектов. Можно перечитать $metadata, отключить доступ агента или полностью удалить подключение.

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

Инструмент — promto_onec_small. Агент исследует базу действиями list_entities и describe_entity, затем читает данные через query и get_object.

Чаще всего полезны:

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

Имена зависят от релиза и расширений УНФ, поэтому не считаются фиксированными.

Сценарии

Незакрытые заказы

Через promto_onec_small найди в list_entities документы заказов покупателей, проверь поля через describe_entity и покажи незакрытые заказы с датой, суммой и ответственным. Только чтение.

Остатки товаров

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

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

• Запрашивайте только опубликованные объекты и фактические поля вашей базы.
• query ограничен 1000 объектами за вызов; используйте фильтры и пагинацию.
• Создание и изменение заказа, счёта, оплаты или справочника требует confirm=true.
• Проведение документов меняет остатки и деньги, поэтому требует отдельного явного согласия.
• Удаление через OData не является пометкой на удаление.
• Права агента не шире прав пользователя 1С.

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

• Публикация отвечает, но объектов нет. Заполните состав стандартного OData и обновите его в настройках.
• 403. Проверьте роль и доступ к конкретному объекту.
• Заказы не находятся. Сверьте настоящее имя документа и его поля через list_entities и describe_entity.
• Фильтр возвращает ошибку. Проверьте тип поля в $metadata и синтаксис OData v3.
• Изменение конфликтует. При 412 перечитайте запись перед повтором.

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

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