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. Внизу вкладки конфигурации **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

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