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

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

 Список счетов виден в карточке сделки, возможность распечатать счет из карточки сделки. Связь с 1С происходит в реал-тайме без какой-либо задержки.

 Вы можете скачать инструкцию и необходимые файлы здесь

Инструкция по интеграции предприятие и amoCRM

 

требования

  1. Платформа 1С – версии только 8.2
  2. Совместимые конфигурации1:
  • Управление производственным предприятием – версии 1.2 и 1.3;

  • Управление торговлей – версия 10;

  • Комплексная автоматизация – версия 1.1;

  • Бухгалтерия предприятие 1.6, 2.0

  • Тип базы данных 1С – как серверный, так и файловый

  • Наличие установленного компонента 1С: «Модули расширения веб-сервера»

  • Веб сервер – Apache 2.2 с поддержкой OpenSSL

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

Назначение и возможности

Данный модуль позволяет выписывать счета из карточки сделки amoCRM, а также создавать новых контрагентов в 1С. При выписке счета происходит автоматический поиск контрагента из карточки сделки в базе 1С, и в случае успешного поиска в счет подставляется найденный контрагент и договор. Если же в 1С нет данного контрагента, то из карточки сделки можно создать нового контрагента в 1С. В счете также есть возможность указывать номенклатуру из базы данных 1С.

При записи счета из amoCRM в 1С создается документ «Заказ покупателя» с заполненными реквизитами и номенклатурой.

Принцип взаимодействия

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

 Таким образом, настройка взаимодействия 1С и amoCRM состоит из следующих этапов:

 

  1. Настройка веб сервера
  2. Настройка 1С
  3. Публикация веб сервисов 1с и развертывание приложения amoCRM
  4. Подключение виджета 1С в системе amoCRM

 

Настройка веб сервера (пример)

За пример выбран рекомендуемый нами сервер Apache. Дальнейшая установка будет рассматриваться именно на нем. Другие сервера могут быть использованы, но конфигурирование может отличаться. Главной целью установки является обеспечение HTTPS-доступа из браузеров пользователей, которые будут осуществлять выставление счетов в amoCRM до скриптов связи с

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

  1. Для начала скачиваем дистрибутив Apache с официального сайта: http://httpd.apache.org/download.cgi. Выбираем и скачиваем версию Apache 2.2.x с поддержкой openssl (это обязательно, так как нам нужен протокол https) – примерhttpd/apache_x.x.x-win32-x86-openssl-x.x.x.msi.Теперь запускаем установщик (пользователь должен обладать правами администратора). Проходим экран приветствия, принятие соглашения.
  2. Следующим шагом необходимо ввести параметры сервера. Необходимо использовать домены второго уровня (onec.loc, к примеру), т.к. некоторые браузеры могут блокировать домены вроде localhost. Эти данные нужны для создания базового конфигурационного файла. Под текстовыми полями одна из самых важных настроек — установить Apache как службу или как обычную программу. Выбираем «for All Users, on port 80, as a Service — Recommended» — установить как службу:
  3. Тип установки. Выбираем Custom (выборочная). Далее компоненты установки оставляем по умолчанию, настраиваем удобное место установки.
  4. Завершаем установку.
  5. Проверяем работоспособность. Открываем браузер, и в адресной строке вводим http://onec.loc/. Если все правильно, должна открыться страница с надписью «It works»!
  6. Теперь нам нужно настроить Apache на работу через протокол HTTPS. Первым этапом будет создание самоподписанного криптографического ключа. Обратите внимание, что по политике безопасности браузер конечных пользователей будет предупреждать об использовании самоподписанного сертификата и просить добавить исключение. Таким образом на каждом компьютере для работы с виджетом необходимо принять сертификат, либо использовать достоверный, подписанный независимыми сервисами, к примеру http://www.startssl.com/
  7. Для первичной настройки системы возможно использовать самоподписанный сертификат, как указано в инструкции далее. Для генерации запускаем командную консоль Windows (пуск \ выполнить – набираем cmd)
  8. В консоли вводим cd "C:\Program Files\Apache Software Foundation\Apache2.2\bin"
  9. Далее set OPENSSL_CONF=C:\Program Files\Apache Software Foundation\Apache2.2\conf\openssl.cnf – этим действием мы устанавливаем системную переменную, указывающую на файл конфигурации openssl
  10. Теперь генерируем новый сертификат командной openssl req -new -out server.csr
  11. Далее система запросит ввод информации о сертификате 
  12. Можно указывать любую информацию. Единственное при запросе ввода пароля – укажите свой пароль (PEM pass phrase) и при запросе Common Name: укажите название вашего официального сайта или localhost. 
  13.   Далее выполняем команду openssl rsa -in privkey.pem -out server.key
  14. Теперь устанавливаем срок действие ключа – год:
  15. Генерация ключей завершена. Теперь нам надо подключить сгенерированные ключи. Для этого из папки C:\Program Files\Apache Software Foundation\Apache2.2\bin копируем файлы "server.cert" и "server.key" в папку C:\Program Files\Apache Software Foundation\Apache2.2\conf
  16. Далее нам надо донастроить Apache, чтобы включить работу через https. Для этого блокнотом открываем файл C:\Program Files\Apache Software Foundation\Apache2.2\conf\httpd.conf
  17. В нем находим строчку LoadModule ssl_module modules/mod_ssl.so. Если перед ней стоит знак #, то его нужно убрать. Далее ищем Include conf/extra/httpd-ssl.conf и также при наличии # удаляем его. Сохраняем файл.
  18. Далее открываем файл C:\Program Files\Apache Software Foundation\Apache2.2\conf\extra\httpd-ssl.conf
  19. В этом файле нужно найти строку по ключевому слову SSLCertificateFile. Заменить эту строку на SSLCertificateFile "C:/Program Files/Apache Software Foundation/Apache2.2/conf/server.cert"
  20. Далее ищем по ключевому слову SSLCertificateKeyFile и заменяем на SSLCertificateKeyFile "C:/Program Files/Apache Software Foundation/Apache2.2/conf/server.key"
  21. Сохраняем файл.
  22. Далее нужно убедиться, что в брэндмауэре Windows открыт 443 порт. Сделать также, как и мы открывали 80 порт (см выше).
  23. Теперь нужно перезапустить Apache – можно в трее нажать на значек Apache – restart или же в службах Windows перезапустить службу Apache.
  24. Для теста нужно открыть https://onec.loc/ в браузере и принять исключение сертификата. Если страница открылась, значит настройки произведены верно.
  25. На этом настройка веб сервера окончена.

Настройка 1С предприятие

  1. Перед началом работы вам необходимо создать резервную копию базы. Для этого заходим в конфигуратор. Далее главное меню \ Администрирование \ Выгрузить информационную базу. Укажите название файла и место, куда сохранить копию базы.
  2. Далее нужно убедиться, что у вас установлены «Модули расширения веб-сервера». Для этого смотрим Главное меню \ Администрирование \ Публикация на веб сервере – если этот пункт не виден или недоступен, то нужно дополнить установку 1С. Для этого переходим в Панель управления \ Программы и компоненты\Удалить изменить программу. В списке находим 1С (текущую версию) и нажимаем «Изменить». В списке устанавливаемых компонентов нужно выбрать Модули расширения веб-сервера:
  3. Нажимаем далее и завершаем установку.
  4. Далее необходимо в текущую конфигурацию добавить модули amoCRM. Если конфигурация ни разу не изменялась, то скорей всего редактирование конфигурации запрещено. Поэтому сперва нажимаем Главное меню\Конфигурация\Открыть конфигурация. После открытии конфигурации идем Главное меню \ Конфигурация\Поддержка\Настройка поддержки. В открывшемся окне нажать «Включить возможность изменения»
  5. Программа предупреждает о том, что изменение режима приведет к невозможности выполнять обновление конфигурации полностью автоматически. Мы это понимаем, и нажимаем Да:
  6. Выставляем правила для изменения объектов: Редактируется с сохранением поддержки, если нет необходимости полностью снимать конфигурацию с поддержки и нажимаем ОК:
     
  7. В окне «Настройка поддержки» кликаем «Закрыть».
  8. Далее нужно объединить текущую конфигурацию с поставкой модулей amoCRM. Для этого идем главное меню \ Конфигурация \ Сравнить и объединить с конфигурацией из файла. В открывшемся окне выбираем файл из каталога поставки – папка 1С\1Сv8.cf
  9. В открывшемся диалоговом окне о возможности объединения с поставкой на поддержку нажимает ДА.
  10. Далее в открывшемся окне нужно снять выделение со всех объектов в конфигурации приемнике (нажать галку, обведенную красным на рисунке)
     
  11. После этого внизу формы нажать на кнопку «Действия» и в списке выбрать «Отметить по подсистемам файла».
  12. В открывшемся списке выбрать «amoCRM», как на рисунке выше, и нажать «Установить». После этого нажимаем «Выполнить»
  13. В открывшемся окне нужно проставить переключатели так, как указано на рисунке
  14. Нажимаем ок, после чего появится сообщение об успешном объединении. После этого жмем на Главное меню\Конфигурация\Обновить конфигурацию базы данных. Далее жмем везде утвердительно.
  15. Далее нам нужно в 1С добавить информацию о сертификате, который мы создали, когда настраивали веб сервер. Для этого открываем в блокноте файл c:\Program Files\Apache Software Foundation\Apache2.2\conf\server.cert копируем все его содержимое в буфер обмена. Далее открываем в блокноте c:\Program Files\1cv82\8.2.x.x\bin\cacert.pem и в конец файла вставляем из буфера обмена скопированный ключ. Записываем.
  16. На этом настройка 1С завершена.

 

Публикация веб сервисов 1С и развертывание приложения amoCRM

  1. Для публикации веб сервисов в конфигураторе нажимаем Главное меню\Администрирование\Публикация на веб сервере:
  2. В этом окне нужно ввести следующее:
  • Имя – amocrm

  • Веб сервер – Apache 2.x

  • Каталог – должен быть строго по указанному пути: C:\Program Files\Apache Software Foundation\Apache2.2\htdocs\point. Папку «point» нужно предварительно создать в папке htdocs.

  • Снимаем галку «Публиковать тонкий клиент и веб-клиент»

  • Ставим галку Публиковать веб сервисы

  • В списке веб сервисов выбираем amocrm

  1. Нажимает «Опубликовать». После публикации 1С запросит перезагрузку веб сервера – нажимаем да. Перезагрузить веб сервер нужно обязательно, чтобы 1С прописала в конфигурации Apache свои настройка и подключила свой модуль.
  2. Закрываем окно настроек публикации.
  3. Далее, для того, чтобы при попытке подключиться к веб сервису 1С не появлялось окно запроса авторизации, нужно в файле публикации веб сервиса прописать авторизационные данные.
  4. Для этого сначала создадим отдельного пользователя, от имени которого будут вноситься изменения в базу. Для этого в конфигураторе идем Главное меню\Администрирование\Пользователи. В списке пользователей нажимаем «Добавить». В поле Имя пишем webuser, пароль – придумываем свой пароль. Можно снять галку
  5. «Показывать в списке выбора».
  6. На вкладке прочие – добавить одну роль «Полные права». Нажимаем ок.
  7. Далее открываем в блокноте файл C:\Program Files\Apache Software Foundation\Apache2.2\htdocs\point\ default.vrd
  8. Находим строчку, которая начинается c «ib=» (это путь к базе, здесь же прописываются авторизационные данные). В эту строчку до закрывающей кавычки надо дописать Usr="webuser";Pwd="ВАШ_ПАРОЛЬ";
  9. ВАШ_ПАРОЛЬ нужно заменить на пароль, который вы придумали для пользователя webuser.

В конечном счете должен получиться следующий пример: ib="File="D:\1C\bases\amocrm";Usr="webuser";Pwd="123&qu ot;;" (в этом примере используется файловый вариант базы).

Записываем файл.

  1. Ну и наконец, нужно скопировать в папку C:\Program Files\Apache Software Foundation\Apache2.2\htdocs содержимое папки «web» из комплекта поставки. То есть содержимое папки htdocs должно быть следующее:

Примечание: Если вы установили веб клиент (папку app) не в папку по умолчанию (по умолчанию - C:\Program Files\Apache Software Foundation\Apache2.2\htdocs), тогда Вам нужно в изменить путь к «app». Для этого заходим в в обычном режиме (не конфигуратор),

Главное меню\Операции\Регистры сведений\ (Amo CRM) Настройки. Если в регистре нет записи с ключом «ПутьКВебПриложению», то добавить новую строчку, иначе изменить имеющуюся.

В поле Значение настройки пишем правильный путь до папки app. Строчка не должна иметь в конце слеш. По умолчанию данная настройка имеет значение C:\Program Files\Apache Software Foundation\Apache2.2\htdocs\app

На этом настройка модуля интеграции 1С и amoCRM завершена. Чтобы убедиться в том, что все корректно работает, нужно перейти по ссылке https://onec.loc/app/bill.html.Должна появиться форма созданиянового счета. Первый запуск создает кеш и может занять некоторое время.

Заходим в папку C:\Program Files\Apache Software Foundation\Apache2.2\htdocs\app\js\app\core\model1C.js и изменяем в третьей строке параметр this.url исправив домен, на указанный вами при установке Apache.

Далее нужно подключить виджет 1С в системе amoCRM.

 

Подключение виджета 1С в amoCRM

  1. Вам нужно зайти в свой эккаунт в amoCRM. Переходим по ссылке АДРЕС_ВАШЕГО_ЭККАУНТА.amocrm.ru/private/account/widgets.php (сперва подставте адрес вашего эккаунта).
  2. В списке виджетов находим «Интеграция с 1С». Вводим путь https://onec.loc/app/bill.htmlНажимаем на виджет и кликаем – включить виджет.

На этом подключение завершено.

Чтобы воспользоваться данным модулем, нужно открыть карточку сделки и в самом низу окна появится форма ввода счета покупателя.

Еще есть вопросы? Отправить запрос
На базе технологии Zendesk