Интеграция с 1С

{toc}

h1. Требования

* 1С Предприятие 8.x
* Конфигурация "Бухгалтерия предприятия, редакция 2.0" или "Бухгалтерия предприятия, редакция 3.0"

Для работы обработки в 1С Предприятие 8.3 необходимо запускать "Толстый клиент (обычный режим)"

h1. Общая информация

В составе АСР имеется модуль для синхронизации платежей и актов по контрагентам. Вы можете загрузить его в разделе "*Помощь*" Вашего биллинга

Интеграция 1С построена по принципу работы через [API|http://docs.carbonsoft.ru/display/CarbonBilling/API+REST+v2.0]

Логи api запросов от 1с обработчика можно посмотреть в */app/asr_billing/var/log/admin_web_server.log | grep api_1c*
{info}

h2. Настройка интеграции биллинга с 1С

{tip}{*}Время выполнения инструкции*: 10-15 минут, при необходимости исключить часть операций из теста на пятом шаге, время теста может увеличиться

{info}Если биллинг и компьютеры с 1С находятся в разных подсетях, вероятно клиентские запросы будут проходить NAT-трансляцию - в таком случае укажите конечный IP-адрес с которого будут приходит обращения к биллингу{info}


Вводить адреса нужно через пробел.

В этом же меню Вы можете узнать и задать пароль доступа к API, он потребуется Вам в дальнейшем в интерфейсе обработки 1С.

{info}Старайтесь использовать в паролях только латинский алфавит, подчеркивания и цифры. Кириллицу и спецсимволы лучше не использовать, они могут некорректно обрабатываться или передаваться.
Например:
* *Подходящий пароль*: {color:green}zBxnaRBrxM_27dJHW{color}
* *Нерабочий пароль*: D1kfGbdE{color:red}#%{color}A0d
{info}


!Unnamed image (2).png|border=1,width=600!


После добавления адресов, нажмите кнопку "*Сохранить*" и выполните следующую команду в консоли:
{code}chroot /app/asr_billing/
/etc/init.d/admin_web_server restart

Указывать можно в формате, совместимом с iptables (конкретный ip-адрес, ip-адрес подсети с указанием маски в формате CIDR, доменное имя)
После этого нажать кнопку "Сохранить и применить"

*Для 1С 8 версии*
Заходите в администраторскую панель *Помощь* \-> *Cписок онлайн документации*

{code}
sqlexec "set list; select op_id from finance_operations where sync1c<>1 and op_type<=2 and op_date<'01.05.2019'" | awk '$2{print $2}' | while read opid; do curl "http://169.254.80.82:8082/rest_api/v2/FinanceOperations/" -d 'method1=objects.get&arg1={"pk":'$opid'}&method2=set&arg2={"sync1c":1,"code1c":"old"}&method3=save'; done

Провести тестовые испытания синхронизации в обе стороны по тестовым абонентам убедиться что все работает как вам нужно.

Очистите предыдущие тестовые синхронизации, если нужно:

{code}
sqlexec "update abonents set SYNC1C=0, CODE1C=''"

sqlexec "update FINANCE_OPERATIONS set SYNC1C=0, CODE1C=''"

*В нашем обработчике синхронизация абонентов в биллинге с контрагентами в 1с происходит по полю ИНН в 1с и реквизиту ИНН в биллинге.*

При успешной синхронизации абонента будет заполнено поле "Код в 1С". Дальнейшие синхронизации финансовых операций будут производиться по этому коду.


!1c_01.png|border=1!

Столбец "Загружать" - загрузка данных из биллинга в 1С.{info}

Для открытия модуля, выберите меню *"Файл" \-> "Открыть"* и укажите путь к модулю.

* "Период с:", "По:"\- даты для фильтрации ПКО при выгрузке.
{color:#ff0000}Выгрузка происходит по дату НЕ включительно, т.е. для выгрузки ПКО за 1 месяц необходимо указывать период с 1 числа по 1 число.{color}
* "Пароль к системному API:" - задается в биллинге
* "Адрес сервера:" - адрес, по которому доступна администраторская панель с компьютера, который запускает обработку
* "Организация:" - необходима для создания Абонентов в 1С
* "id группы" - это id группы в биллинге, для всех абонентов которой проводится синхронизация платежей.
* "id группы:" - получается из биллинга путем открытия группы в администраторской панели(последняя цифра) &nbsp; !Selection_060.png|border=0!
* "Загружать контрагентов" - загружает ранее не синхронизированных абонентов (пометка в биллинге)
* "Загружать ПКО" - загружает Операции с типом "Приход", только по выгруженным в 1С контрагентам. Механизм загрузки следующий: Обработчик запрашивает с биллинга все операции с типом "Приход" без выставленного флага "sync1c" и загружает их в 1с, после чего выставляет у операции в биллинге флаг sync1c и добавляет code1c данной операции. Код состоит из года и номера операции
* "Загружать акты" - загружает Операции с типом "Акт" только по выгруженным в 1С контрагентам
{color:#ff0000}Загружаются с опцией "НДС включено в сумму"{color}
* "Выгружать ПКО" - создает в биллинге Операции с типом "Приход" у синхронизированных абонентов.
* "Выгружать выписки" - создает в биллинге Операции с типом "Приход" у синхронизированных абонентов по платежным поручениям из 1с.

h3. Как сопоставить абонента в биллинге и в 1С

* Биллинг:
!Интеграция 1С, абонент в биллинге, основные поля.png|border=0,width=1000!
!Интеграция 1С, абонент в биллинге, учетная запись.png|border=0,width=300!
!Интеграция 1С, абонент в биллинге, код в 1С.png|border=0,width=470!

* 1С
!Интеграция 1С, абонент в 1С, общие.png|border=0,width=450! !Интеграция 1С, абонент в 1С, адреса и телефоны.png|border=0,width=450!
!Интеграция 1С, абонент в 1С, счета и договоры.png|border=0,width=450!


h3. Как сопоставить операцию в биллинге и в 1С

* Биллинг:
!Selection_355.png|border=1,width=800! \\ \\
* 1С
!Selection_356.png|border=1,width=550!

|| Биллинг || 1С ||
| Код 1С | Год и Номер |
| * *Для всех операций*:
** Номер документа (number)
** Баланс(бух) (balance_buh)
* *Только для платежей (служебные поля в БД)*:
** Номер карты оплаты (op_card_id)
** Название платёжной системы (operator_name)
** Статус платежа в платёжной системе (operator_result)

a.id,
a.sync1c,
a.code1c,
a.name,
v.ATTRIBUTE_VALUE as INN

/app/asr_billing/var/log/django/system_api.log
{code}