Подключение 1С

Ваш ассистент может работать напрямую с базой 1С — теми же данными учёта и торговли, которыми вы пользуетесь каждый день. Когда она подключена, вы просто пишете обычными словами («создай счёт для этого покупателя», «сделай акт сверки за первый квартал») и получаете готовые документы, не открывая 1С самостоятельно.

Это работает с облачной 1С (когда базу для вас держит онлайн провайдер) и с локальной 1С, доступной по сети. Подключение использует встроенный в 1С интерфейс OData — стандартную «дверь» для чтения и записи данных, которая поставляется вместе с 1С. Ничего устанавливать не нужно; это настройка, которую включает ваш администратор 1С.

Другие страницы про 1С. Эта — про подключение. Когда оно готово:

• Работа с 1С через OData — механика чтения и записи: что разрешено интеграционному пользователю, как понять, что документ уже существует, как безопасно создать новый и какие ограничения сервера стоит учитывать. Читайте перед написанием любого скрипта для 1С.
• Разноска банковской выписки в 1С — полный казахстанский регламент: арифметический контроль, классификация операций, налоги и пени по КНП/КБК и пять платежей в фонды, требующих списков сотрудников.
• Готовые скрипты для 1С — рабочие скрипты, реализующие обе страницы. Проверьте их наличие, прежде чем писать код для 1С.

Что ассистент умеет, когда 1С подключена

• Находить товары и номенклатуру — цены, артикулы, наименования, единицы. Он может найти покупателя по имени, коду или БИН/ИИН, так что вам не придётся искать внутренние идентификаторы.
• Проверять остатки по вашим складам.
• Создавать счёта на оплату покупателю («Счёт на оплату покупателю»). Вы описываете заказ словами — покупатель, товары, количество, цена — а ассистент сопоставляет каждую позицию с нужной записью в 1С и собирает счёт. Он создаётся как непроведённый черновик, чтобы вы могли проверить его в 1С перед проведением.
• Выгружать счёт в PDF и в Excel — включая PDF, оформленный как ваша стандартная печатная форма 1С, с печатью и подписью.
• Формировать акт сверки («Акт сверки взаиморасчётов») с контрагентом за любой период. Ассистент собирает документы продаж, оплат и возвратов из 1С, рассчитывает текущее сальдо и готовит и Excel, и PDF в стиле 1С.

Готовые счёта и акты сохраняются как файлы в вашем рабочем пространстве, так что их можно скачать, отправить или распечатать.

Что нужно подготовить перед подключением

Подключение состоит из двух разовых шагов в 1С — обычно их выполняет тот, кто администрирует вашу базу (ваш партнёр по 1С, хостинг-провайдер или ваш ИТ-специалист). Когда они сделаны, повторять их не придётся.

1. Включите интерфейс OData. В 1С это называется публикация стандартного интерфейса OData (standard.odata). В облачной/хостинговой 1С попросите провайдера включить публикацию OData для вашей базы. В локальной установке администратор публикует его на веб-сервере. В результате получается веб-адрес такого вида:

   https://your-1c-host/your-database/odata/standard.odata
   

2. Создайте логин для ассистента — и попросите полную роль. Добавьте отдельного пользователя 1С с паролем. Просите полный набор прав: чтение, создание, изменение, удаление / пометку на удаление и проведение. Отдельный логин по-прежнему делает доступ понятным и легко отзываемым — но именно невыданные права чаще всего превращают вроде бы работающую настройку в наполовину бесполезную через неделю.

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

   Выданное право проведения не означает, что ассистент будет проводить документы сам — он этого не делает по замыслу (см. «Как это защищает вас» ниже). Оно означает, что когда вы сами скажете «проведи», он сможет это сделать.

Совет: если вы не уверены, доступен ли OData, откройте адрес вашего веб-клиента 1С, добавьте к нему /odata/standard.odata и попробуйте открыть. Запрос логина или сообщение «не авторизован» означает, что интерфейс существует и ему просто нужны ваши учётные данные — это хороший знак.

Если адрес OData не работает

Чаще всего дело не в неправильном адресе, а в том, что OData включили лишь наполовину. Есть два независимых переключателя, и хостинг-провайдеры регулярно включают только первый:

1. Внутри 1С — Администрирование → «Состав стандартного интерфейса OData», где выбирается, какие объекты доступны. Обычно именно это провайдер имеет в виду, когда говорит «OData включён».
2. В публикации на веб-сервере — в файле default.vrd вашей базы должно быть publishStandardOData="true" (галочка «Публиковать стандартный интерфейс OData» в Публикации на веб-сервере). Без второго переключателя адрес OData никуда не ведёт, как бы правильно он ни был написан.

Осторожно с «дружелюбной» страницей об ошибке. Облачный хостинг 1С может ответить на неопубликованный адрес OData кодом 200 и своей HTML-страницей («Ваша база отключена», «База не найдена») вместо честного 404. Не читайте текст буквально — это отвечает front-end провайдера, а не 1С, и такая же страница появляется на любой незнакомый провайдеру адрес.

Решающая проверка. Сравните адрес OData с маршрутом HTTP-сервисов 1С на той же базе:

<база>/hs/                     → 401, заголовок: WWW-Authenticate: Basic realm="1C:Enterprise 8.3"
<база>/odata/standard.odata/   → должен так же запросить пароль либо вернуть XML

Если /hs/ запрашивает пароль, а /odata/standard.odata отдаёт HTML-страницу без запроса авторизации — значит запросы до 1С доходят, а OData просто не опубликован в этой публикации. Это разные флаги одной и той же публикации, поэтому никакой другой адрес не поможет — изменить может только ваш провайдер.

Что попросить у провайдера (отправьте как есть):

Для базы <название> включите публикацию стандартного интерфейса OData на веб-сервере (publishStandardOData="true" в default.vrd) — не только состав OData в настройках конфигурации. Сейчас /hs/ отвечает 401 WWW-Authenticate: Basic realm="1C:Enterprise 8.3", а /odata/standard.odata отдаёт HTML-страницу с кодом 200 и без запроса авторизации — значит запрос до 1С не доходит. Проверка: $metadata должен вернуть XML либо запросить логин и пароль.

Также заведите отдельного пользователя для интеграции с полной ролью: чтение, создание, изменение, удаление и пометка на удаление, проведение документов. Роли «только чтение и создание» недостаточно: ошибочный черновик, созданный через OData, невозможно ни исправить, ни удалить, ни довести до конца без ручной работы в 1С.

Единственный случай, когда адрес действительно другой: в 1С:Фреш (1cfresh) он выглядит как https://<хост>/a/<приложение>/<зона>/odata/standard.odata, а не <хост>/<база>/odata/standard.odata. У баз Фреш нет собственного имени публикации — если у вашей базы оно есть и маршрут /hs/ работает, значит у вас обычная публикация и стандартный вид адреса верен.

Когда у хостинга свой вход перед 1С

Некоторые провайдеры спрашивают свой логин и пароль ещё до 1С — в веб-клиенте вы видите два окна входа. Проверка подключения (check-access.py) говорит, какой из двух отказал:

• «The hosting provider's own login refused these credentials» — адрес ждёт логин провайдера, а не пользователя 1С. Его выдаёт провайдер.
• «Two logins stand in front of this base and they share ONE Authorization header» — вход провайдера прошёл, но в 1С нет пользователя с тем же логином и паролем. Подключение может передать только один логин, поэтому нужен один из двух вариантов (делает тот, кто администрирует базу; ни один не ослабляет ничей вход):
  1. завести отдельного пользователя 1С для ассистента с точно такими же логином и паролем, как у входа провайдера, и только с нужными ассистенту правами; или
  2. попросить провайдера исключить /odata/standard.odata из своего входа (с ограничением по IP), чтобы логин пользователя 1С доходил до 1С напрямую.

Двухфакторный вход и единый вход (SSO). Сам интерфейс OData в 1С принимает обычные логин и пароль — код из SMS или приложения может требовать только слой перед ним. Ассистент никогда не запрашивает, не читает и не переиспользует такой код, а отключить второй фактор на своей учётной записи — не решение. Попросите у провайдера неинтерактивный вход для интеграции: отдельную учётную запись, освобождённую от второго фактора их политикой и ограниченную нужными правами. Если входить действительно должен человек каждый раз — используйте доступ через браузер: вы входите сами, ассистент работает внутри этой сессии и вашего пароля не видит.

Подключение

Когда OData включён и у вас есть логин, подключение выполняется простым сообщением ассистенту в чате. Передайте ему три вещи:

• адрес OData (ссылка .../odata/standard.odata выше),
• имя пользователя и
• пароль.

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

Затем он выполняет быструю проверку доступа: читает каталог доступных данных вашей базы и сообщает, сколько наборов данных он видит (у исправного подключения их обычно сотни). Если что-то не так — неверный адрес, неверный пароль или OData ещё не опубликован — он скажет об этом простыми словами, чтобы вы точно знали, что исправить.

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

Как это защищает вас

• Только чтение, пока вы не попросите иного. Поиск товаров, остатков и документов ничего не меняет в 1С.
• Запись происходит только по вашей команде. Когда вы просите счёт, ассистент готовит его и создаёт как непроведённый черновик. По собственной инициативе он не проводит никогда — только если вы явно об этом попросите; в остальных случаях вы проверяете и проводите в 1С сами.
• Логин под вашим контролем. Поскольку ассистент использует отдельного пользователя 1С, вы определяете его права и можете в любой момент сменить пароль или удалить его, чтобы мгновенно перекрыть доступ.

Полезно знать

• Он понимает язык ваших данных. Базы 1С обычно на русском, и ассистент работает с русскими названиями полей и документов напрямую — переводить ничего не нужно.
• Документы выглядят как родные. PDF-счёта и акты оформляются так, чтобы напоминать ваши стандартные печатные формы 1С, включая изображения печати и подписи, и готовы к отправке покупателю.
• Никаких внутренних идентификаторов для вас. Вы называете покупателей, товары, склады и договоры их обычными именами, кодами или БИН/ИИН — ассистент сам сопоставляет их с нужными записями в 1С.
• Конфигурации. Это работает с конфигурациями 1С, которые публикуют стандартные документы через OData (счёта покупателям, продажи, оплаты, возвраты). Если какая-то форма не опубликована в вашей базе, ассистент сообщит об этом и подскажет, что попросить включить вашего администратора 1С.

См. также: Автоматизации, чтобы ассистент формировал документы по расписанию или в ответ на входящий заказ, и Результаты работы о том, как создаются и передаются готовые файлы.