Docs + 1С

Настройка на стороне 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С и отмечает соответствующие счета в биллинге как "Оплаченные".

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

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

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

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

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