Подключение 1С:БО (бухгалтерское обслуживание)

Коротко

В 1С:БО базу клиента ведёт бухгалтерская фирма, и живёт эта база в облаке. Своего сервера у вас нет, и публиковать OData не нужно: в облаке он уже включён. Получите пользователя, который видит базу клиента, затем подключите её в свóдно и выберите юрлицо для синхронизации.

Адрес, который нужен в итоге, выглядит так: https://app.1cbo.ru/a/sbp/<номер базы>/odata/standard.odata. Дальше это обычный OData 1С, те же справочники, документы и регистры, авторизация на каждом запросе.

Сроки по нашему опыту: из трёх баз две открыли за день. Узкое место одно, это администратор бухгалтерской фирмы. Без него доступ не выдаётся.

Что понадобится

• Свой пользователь в панели бухгалтерской фирмы, которая ведёт клиента в 1С:БО.
• Администратор или руководитель этой фирмы, который добавит вас в ответственные по клиенту.
• Номер базы клиента, шесть цифр.

Шаг 1. Свой пользователь в панели фирмы

Попросите бухгалтерскую фирму завести вас как сотрудника. Чужой логин не берите: доступ именной, вход идёт через OpenID, и в журнале видно, кто выгружал данные.

Панель фирмы живёт по адресу app.1cbo.ru/a/sufa/<номер фирмы>/ru_RU/. Другого входа в неё нет ни у вас, ни у клиента: кабинет клиента на cabinet.1cbo.ru доступами к базе не управляет.

Логин и почта в 1С:БО хранятся в разных полях, пароль фирма задаёт отдельно. Требования к паролю: от семи символов, буквы и цифры, строчные и заглавные. Этот же пароль пойдёт в настройки интеграции, так что запросите его сразу в нормальном виде.

Шаг 2. Узнать номер базы клиента

В панели фирмы откройте: Справочники → Контрагенты → карточка клиента → «Открыть как» → «Клиент 1С БО». Пункт стоит справа, в верхней половине списка.

Посередине открывшейся формы стоит ссылка вида app.1cbo.ru/a/sbp/000000. Цифры в конце и есть номер базы.

В базе знаний 1С:БО тот же путь записан через меню разделов: 1С:БухОбслуживание → Клиенты 1С:БО → Контрагенты → Контрагент → «Ещё» → «Открыть как» → «Клиент 1С:БО». Оба варианта ведут в одну форму.

Шаг 3. Попросить администратора выдать доступ

Номер базы сам по себе доступа не даёт. Напишите администратору фирмы одной строкой: «Добавьте, пожалуйста, пользователя <ваш логин> в ответственные по клиенту <название>, чтобы он появился в базе <номер>. Доступ нужен на чтение, для выгрузки данных».

Что делает администратор со своей стороны: открывает карточку клиента, вкладка «Основное», блок «Ответственные», поле «Рабочая группа». Дальше идёт в Сервис → Управление приложениями клиентов и нажимает «Применить роли». Порядок описан в базе знаний 1С:БО.

Сколько ждать: документация обещает применение ролей за пятнадцать минут, у нас доступ появился через пару часов. Признак успеха на стороне администратора: зелёный индикатор в «Управлении приложениями клиентов». Красный означает, что пользователь не идентифицирован и в базу не войдёт.

Про роль. У нас сработала роль уровня главного бухгалтера, хватит ли роли попроще, мы не проверяли. И тут вылезает расхождение с документацией: для работы по OData 1С:Фреш требует полные права в базе либо отдельную роль удалённого доступа, а профиля «Только просмотр» ей мало. В 1С:БО главного бухгалтера хватило. Похоже, состав объектов OData в базах сети настроен централизованно, но подтвердить это нечем. Так что если фирма упрётся, просите полные права.

Шаг 4. Проверить, что доступ появился

Проверяйте тем же логином и паролем, что пойдут в интеграцию. Бейте в корень OData-сервиса: именно этот запрос свóдно потом использует для проверки связи.

Команда целиком: curl -u '<логин>:<пароль>' 'https://app.1cbo.ru/a/sbp/<номер>/odata/standard.odata/?$format=json'

Пришёл 200 и длинный список имён сущностей, значит доступ есть: у живой базы их несколько тысяч. Второй запрос показывает, что читаются и сами данные: curl -u '<логин>:<пароль>' 'https://app.1cbo.ru/a/sbp/<номер>/odata/standard.odata/Catalog_Организации?$top=1&$format=json'. Название организации в ответе значит, что можно идти подключать.

Отдельный случай: 401 приходит и тогда, когда у пользователя стоят ограничения на часть данных. Если логин точно верный, а 401 держится, просите роль пошире.

Шаг 5. Подключить в свóдно

Настройки → Интеграции → «1С: Бухгалтерия». Отдельной карточки для 1С:БО нет и не нужно: в облаке работает та же «Бухгалтерия предприятия».

• Адрес OData-сервиса: https://app.1cbo.ru/a/sbp/<номер>/odata/standard.odata
• Логин: ваш пользователь в 1С:БО
• Пароль: его пароль

Ниже выберите дату, с которой грузить историю, и состав справочников: контрагентов, банковские счета и статьи ДДС. Для синхронизации нужно привязать источник к юрлицу. Успешная проверка связи ещё не означает, что юрлицо привязано. Порядок выбора описан ниже.

Выберите юрлицо источника

Сохраните адрес OData, логин и пароль. После успешной проверки связи откройте источник и нажмите «Редактировать».

В поле «Юрлицо для синхронизации» переключитесь на «Из этой базы 1С». Выберите организацию по названию или ИНН и нажмите «Сохранить». Свóдно создаст карточку выбранного юрлица, если её ещё нет, и привяжет источник к ней. Остальные организации из базы при этом не добавляются.

Готовую карточку можно выбрать в режиме «Из Сводно». Чтобы добавить юрлицо из 1С, нужно право редактировать справочники. Если его нет, попросите владельца аккаунта добавить нужную организацию.

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

При смене адреса, логина или пароля сначала сохраните новые реквизиты, затем заново откройте источник и список из 1С. Если организация уже была выбрана из прежнего подключения, переключитесь на «Из Сводно», чтобы сбросить выбор перед сохранением.

Если сохранение не удалось после добавления юрлица, его карточка уже может быть в Сводно. Обновите страницу и повторите привязку через «Из Сводно».

Кнопка «Проверить» на карточке источника после успешной проверки также пробует импортировать весь справочник организаций. Чтобы добавить только выбранное юрлицо, используйте форму «Из этой базы 1С».

О чём помнить дальше

У полномочий представителя есть срок действия. Это главный риск для постоянной выгрузки: срок истекает, доступ пропадает, синхронизация встаёт. В свóдно это видно как ошибка авторизации на карточке источника, но узнаете вы об этом уже постфактум, когда данные перестанут обновляться. Поэтому сразу спросите у фирмы, на какой срок выданы полномочия, и попросите продлевать заранее.

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

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

У клиента может быть несколько юрлиц. В 1С:БО их ведут или в разных базах, или в одной через клиент-группу. Если организаций в базе несколько, выбирайте нужную при разметке источника.

Состав базы бывает урезанным. Тогда часть разделов приедет пустыми, и это не поломка подключения.

Если не получилось