Прежде чем применять настройки - внимательно читаем. От этого зависит работоспособность системы


Система позволяет настроить сопряжение, практически, с любой редакцией 1С по протоколу OData

Настройка на стороне 1С

  1. Опубликуйте информационную базу на веб-сервере. При публикации обязательно установите галочку "Публиковать стандартный интерфейс OData".
  2. В самой 1С создайте пользователя (например, `system`) с правами администратора или полными правами на чтение/запись справочников и документов.
  3. Проверьте доступность API через браузер: `http://<IP-адрес-1С>:<Порт>/<Имя-Базы>/odata/standard.odata/` Должен появиться запрос логина и пароля, а затем XML/JSON со списком сущностей.

Описания настройки в вебинтерфейсе

Войдите в веб-интерфейс биллинговой системы под учетной записью администратора (с правами на конфигурацию модуля `Docs`).

Перейдите в меню "Настройка -> Документы -> Конфигурация" (или соответствующий раздел конфигурации модуля `Docs`).

Откройте вкладку "1C (OData)".

Заполните следующие поля:

  • "URL OData API": Полный путь к API вашей базы (например, `http://100.64.9.1:8080/1C_UNF/odata/standard.odata/`). Обратите внимание на слэш в конце.
  • "Логин (User)": Имя пользователя 1С (например, `system`).
  • "Пароль (Password)": Пароль пользователя 1С.

Установите галочки для требуемых типов синхронизации:

  • "Синхронизировать Физлиц (B2C)": Разрешает обмен физическими лицами. (в разработке)
  • "Синхронизировать Компании (B2B)": Разрешает обмен юридическими лицами (Контрагентами). (в разработке)
  • "Включить отладку": Рекомендуется включить на этапе первоначальной настройки. Логи будут писаться в файл `/usr/abills/var/log/Docs/1c_odata.log`.

Номенклатура 1С по умолчанию для модулей.

Выбираем номенклатуру 1С (услуга/запас/товар), которая будет использована по умолчанию для генерации счетов и актов

  • Генерировать PDF локально (на стороне биллинга) (создание PDF счетов и актов и привязка их к абоненту (компании), автоматическое сохранение в папке /../../ACP/templates/attach/docs/
  • Расширение шаблонов: (в разработке)
  • Загрузить шаблон Счета (1c_invoice): (в разработке)
  • Загрузить шаблон УПД/Акта (1c_upd): (в разработке)


Нажмите кнопку "Изменить" для сохранения настроек.

Предварительный просмотр и ручная синхронизация (Тестовая проверка)

Чтобы не испортить текущую базу клиентов, предусмотрен режим предпросмотра:

1. Внизу вкладки конфигурации "1C (OData)" нажмите кнопку "Предпросмотр синхронизации с 1С".

2. Система выполнит тестовый запрос к 1С и загрузит список Контрагентов.

3. В открывшейся таблице будет показано сравнение данных из 1С и текущих данных в биллинге:

  • Если контрагент не найден в биллинге (по ИНН), он будет помечен как "Новый клиент" красным цветом.
  • Если контрагент уже существует, будет предложено обновить его данные.

4. Нажмите "Импорт" или "Обновить" в строке нужного контрагента.

5. Откроется карточка детального сравнения (Поле в 1С -> Текущее поле в Биллинге). Если всё корректно, нажмите **Подтвердить синхронизацию**. Данные будут сохранены в базу биллинга.

Автоматическая синхронизация (Периодические процессы)

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

Он уже добавлен в файл `ACP/modules/Docs/config` и будет вызываться ежедневно (`daily`).

Что делает автоматическая синхронизация:

1. Выгружает новые выставленные счета (Invoices) и акты (Acts) из биллинга в 1С.

2. Проверяет новые поступления на расчетный счет в 1С и отмечает соответствующие счета в биллинге как "Оплаченные".

Убедитесь, что cron на сервере настроен на запуск `periodic` биллинговой системы (по умолчанию это настроено при установке).

Соответствие полей (Справочник "Компании")

При синхронизации юридических лиц (B2B) система автоматически сопоставляет следующие поля между 1С (Catalog_Контрагенты) и Биллингом (таблица `companies`):

  • НаименованиеПолное -> `NAME` (Название компании)
  • ИНН -> `TAX_NUMBER` (ИНН)
  • КПП -> `KPP` (КПП)
  • ОГРН -> `OGRN` (ОГРН)
  • Телефон -> `PHONE` (Контактный телефон)
  • Юр. Адрес -> `LEGAL_ADDRESS` (Юридический адрес)
  • ФИО (Представитель) -> `REPRESENTATIVE` (ФИО директора/представителя)




Описания параметров конфигурации (config.pl) или модуля Config

ПараметрПримерОписание
DOCS_1C_URL$conf{DOCS_1C_URL} = 'http://100.64.9.1:8080/1C_UNF/odata/standard.odata/';Базовый URL для OData API 1С (например, 'http://100.64.9.1:8080/1C_UNF/odata/standard.odata/').
DOCS_1C_USER$conf{DOCS_1C_USER} = '1c_api';Логин пользователя 1С, у которого есть права на OData API (например, 'system').
DOCS_1C_PASS$conf{DOCS_1C_PASS} = 'verysecretpass';Пароль пользователя 1С.
DOCS_1C_SYNC_USERS$conf{DOCS_1C_SYNC_USERS} = 0;Включает авто-выгрузку/синхронизацию физических лиц (пользователей) в 1С.
DOCS_1C_SYNC_COMPANIES$conf{DOCS_1C_SYNC_COMPANIES} = 0;Включает авто-выгрузку/синхронизацию юридических лиц (компаний) в 1С.
DOCS_1C_DEBUG$conf{DOCS_1C_DEBUG} = 0;Включает режим отладки для запросов к 1С (логирование в файлы и на экран).
DOCS_1C_PRICE_TYPE_GUID$conf{DOCS_1C_PRICE_TYPE_GUID} = '3027725f-1f9c-11ee-add3-f55d7643e200';GUID "Вида цены" из 1С ('Catalog_ВидыЦен'), который используется по умолчанию при выгрузке номенклатуры (товаров/оборудования) и привязке к ним цен в регистр сведений 'InformationRegister_ЦеныНоменклатуры'. (Приходит из 1С и сохраняется оттуду-же)
DOCS_1C_NOMENCLATURE_INTERNETДанные параметры хранят GUID карточек 'Catalog_Номенклатура' в 1С. При формировании счетов для услуг из соответствующих модулей биллинга, система будет подставлять этот GUID, а оригинальное название тарифа передавать как текстовое описание строки счётаGUID номенклатуры по умолчанию для модуля Internet.
DOCS_1C_NOMENCLATURE_TVДанные параметры хранят GUID карточек 'Catalog_Номенклатура' в 1С. При формировании счетов для услуг из соответствующих модулей биллинга, система будет подставлять этот GUID, а оригинальное название тарифа передавать как текстовое описание строки счётаGUID номенклатуры по умолчанию для модуля TV.
DOCS_1C_NOMENCLATURE_ABONДанные параметры хранят GUID карточек 'Catalog_Номенклатура' в 1С. При формировании счетов для услуг из соответствующих модулей биллинга, система будет подставлять этот GUID, а оригинальное название тарифа передавать как текстовое описание строки счётаGUID номенклатуры по умолчанию для модуля Abon (периодические начисления / доп. услуги).
DOCS_1C_NOMENCLATURE_VOIPДанные параметры хранят GUID карточек 'Catalog_Номенклатура' в 1С. При формировании счетов для услуг из соответствующих модулей биллинга, система будет подставлять этот GUID, а оригинальное название тарифа передавать как текстовое описание строки счётаGUID номенклатуры по умолчанию для модуля VoIP (телефония).

Дополнительная информация