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

Skip to end of metadata
Go to start of metadata
Вы просматриваете старую версию данной страницы. Смотрите текущую версию. Сравнить с текущим  |   просмотр истории страницы

Требования

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

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

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

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

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

Пароль для доступа к api можно посмотреть в настройке биллинга (в файле)

Так же необходимо добавить IP-адрес компьютера, на котором будет запущена внешняя обработка 1С, в соответствующий список как на скриншоте.

После добавления адресов, нажмите кнопку "Сохранить" и выполните следующую команду в консоли:

chroot /app/asr_billing/
/etc/init.d/admin_web_server restart 

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

1. Настроить доступ к API биллинга

Для этого зайти в биллинг Настройки - Настройки в файле - network - Список IP адресов машин, работающих через API
Вводить адреса нужно через пробел.

2. Настроить в биллинге доступ с сервера 1С

Указывается в веб-интерфейсе биллинга в строке через пробел: Платежные системы -> Настройки сети -> АДРЕСА СЕРВЕРОВ ПЛАТЕЖНЫХ СИСТЕМ
Указывать можно в формате, совместимом с iptables (конкретный ip-адрес, ip-адрес подсети с указанием маски в формате CIDR, доменное имя)
После этого нажать кнопку "Сохранить и применить"
С этих адресов в firewall будет разрешен обмен пакетами по портам 1443 и 1444.

3. Скачать модуль на ПК с 1С.

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

4. Обязательно сделать копию БД 1С и сначала проверять на ней!

5. Пометить в БД какие старые операции не нужно синхронизировать

Установите поле sync1c=1

Через ib_expert CTRL+f11:

update FINANCE_OPERATIONS set  sync1c=1,  code1c='old'  where FINANCE_OPERATIONS.op_date<'01.01.2011'

или из консоли рута/помощника:

 sqlexec "update FINANCE_OPERATIONS set  sync1c=1,  code1c='old'  where FINANCE_OPERATIONS.op_date<'01.01.2011'"

6. Отладка

Сделать тестовую группу, завести тестовых абонентов.

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

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

 

sqlexec "delete from FINANCE_OPERATIONS where FINANCE_OPERATIONS.OP_ID > 200000"

sqlexec "update USERS set USERS.SYNC1C = null, USERS.CODE1C = null"

sqlexec "update FINANCE_OPERATIONS set SYNC1C = null, CODE1C = null"

7. Тестирование

Пробовать работать с модулем синхронизации на реальной БД 1С, предварительно сделав резервные копии БД 1С и БД Carbon Billing 5.

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

Если что-то не получается, обратитесь в техническую поддержку.

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

Работа с модулем.

При открытии модуля нужно использовать толстый клиент. Посмотреть какой клиент используется можно в "Справка" -> "О программе"
Столбец "Выгружать" - выгрузка данных из 1С в биллинг.
Столбец "Загружать" - загрузка данных из биллинга в 1С.

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

  • "Период с:", "По:"- даты для фильтрации ПКО при выгрузке.
    Выгрузка происходит по дату НЕ включительно, т.е. для выгрузки ПКО за 1 месяц необходимо указывать период с 1 числа по 1 число.
  • "Пароль к системному API:" - задается в биллинге
  • "Адрес сервера:" - адрес по которому досупна администраторская панель с компьютера который запускает обработку
  • "Организация:" - необходима для создания Абонентов в 1С
  • "id группы" - это id группы в биллинге, для всех абонентов которой проводится синхронизация платежей.
  • "id группы:" - получается из биллинга путем открытия группы в администраторской панели(последняя цифра)  
  • "Загружать контрагентов" - загружает ранее не синхронизированных абонентов (пометка в биллинге)
  • "Загружать ПКО" - загружает Операции с типом "Приход", только по выгруженным в 1С контрагентам. Механизм загрузки следующий: Обработчик запрашивает с биллинга все операции с типом "Приход" без выставленного флага "sync1c" и загружает их в 1с, после чего выставляет у операции в биллинге флаг sync1c и добавляет code1c данной операции. Код состоит из года и номера операции
  • "Загружать акты" - загружает Операции с типом "Акт", только по выгруженным в 1С контрагентам
    Загружаются с опцией "НДС включено в сумму"
  • "Выгружать ПКО" - создает в биллинге Операции с типом "Приход" у синхронизированных абонентов.

Бухгалтерия предприятия 3.0

По-умолчанию, конфигурация БП 3.0 загружается в режиме "управляемого приложения". Наш модуль не оптимизирован для данного режима, потому для обмена данными с биллингом необходимо запустить 1С в режиме "обычного приложения".
Для этого выполните следующее:

  1. В интерфейсе запуска 1С нажмите кнопку "Добавить"
  2. Выберите "Добавление в список существующей информационной базы"
  3. Укажите параметры доступа к Вашей конфигцрации 1С Бухгалтерия предприятия 3.0
  4. На последнем шаге укажите режим запуска "Толстый клиент" и напишите следующее в поле "Параметры запука", как показано на скришноте:

    /DisableStartupMessages /RunModeOrdinaryApplication



  5. Нажмите "Готово" и запустите приложение.

Дальнейшие шаги идентичны запуску обработки в Бухгалтерии 2.0 платформы 1С 8.2

Полезные команды

1. Сброс синхронизации всех приходов

sqlexec "update FINANCE_OPERATIONS set sync1c=0, code1c=NULL where op_type=2 and code1c is not null"

2.Сброс синхронизации всех актов

sqlexec "update FINANCE_OPERATIONS set sync1c=0, code1c=NULL where op_type=1 and code1c is not null"

3. Сброс синхронизации конкретной операции

sqlexec "update FINANCE_OPERATIONS set sync1c=0, code1c=NULL where code1c ='<год операции>_<номер операции в 1с>'"

sqlexec "update FINANCE_OPERATIONS set sync1c=0, code1c=NULL where code1c ='2015_ВА0000003432'"
Введите метки, чтобы добавить к этой странице:
Please wait 
Ищите метку? просто начните печатать.