Интеграция с 1C: различия между версиями

Материал из Planfix
Перейти к: навигация, поиск
Нет описания правки
Нет описания правки
 
(не показана 31 промежуточная версия 2 участников)
Строка 8: Строка 8:




Сейчас между ПланФикс и 1С поддерживается обмен контактами.
Сейчас между ПланФиксом и 1С поддерживается обмен контактами. Скачать файл модуля интеграции можно по [https://github.com/planfix/planfix-1c/releases ссылке]
 
 
== Оглавление  ==
*[[#Настройка интеграции |Настройка интеграции]]
*[[#Настройка модуля интеграции |Настройка модуля]]
**[[#Настройка обмена контактами |Настройка обмена контактами]]
**[[#Принципы работы обмена контактами |Принципы работы обмена контактами]]
**[[#Выполнение обмена |Выполнение обмена]]
*[[#Отладка, тестирование, доработка |Отладка, тестирование, доработка]]




Строка 14: Строка 23:
*Управление торговлей 11
*Управление торговлей 11
*Комплексная автоматизация 2
*Комплексная автоматизация 2
*Комплексная автоматизация для Беларуси 2
*ERP Управление предприятием 2
*ERP Управление предприятием 2
*Управление нашей фирмой 1.6
*Управление нашей фирмой 1.6
*Бухгалтерия 3.0
*УНФ для Украины 1.6




Строка 24: Строка 36:




*Нажмите '''Добавить'''
*Нажмите кнопку '''Добавить''':


https://p.pfx.so/pf/qs/YPAcQV.png
https://p.pfx.so/pf/qs/YPAcQV.png




*Задайте и сохраните имя интеграции (логично назвать по имени типовой конфигурации, с которой будет производиться обмен):
*Задайте и сохраните имя интеграции. Рекомендуем назвать её по имени типовой конфигурации, с которой будет производиться обмен:


https://p.pfx.so/pf/SX/9mFgbC.png
https://p.pfx.so/pf/SX/9mFgbC.png
Строка 35: Строка 47:


*Добавленная конфигурация должна появиться в перечне конфигураций:
*Добавленная конфигурация должна появиться в перечне конфигураций:
https://p.pfx.so/pf/ma/SS0Sf8.png
https://p.pfx.so/pf/ma/SS0Sf8.png




Скачайте файл модуля интеграции по ссылке.


Если в вашей конфигурации 1С включена опция «Дополнительные отчеты и обработки», то встроить модуль в интерфейс программы можно следующим образом:


== На стороне 1С ==
*Перейдите в раздел '''НСИ и Администрирование''' '''Печатные формы, отчеты и обработки''':
 
Если в вашей конфигурации включена опция «Дополнительные отчеты и обработки», то встроить модуль в интерфейс программы можно следующим образом:
*Перейдите в раздел '''НСИ и Администрирование''' - '''Печатные формы, отчеты и обработки''':


https://p.pfx.so/pf/L5/erWY2L.png
https://p.pfx.so/pf/L5/erWY2L.png




*нажмите на '''Дополнительные отчеты и обработки''':
*Нажмите на '''Дополнительные отчеты и обработки''':


https://p.pfx.so/pf/I6/jzPhRb.png
https://p.pfx.so/pf/I6/jzPhRb.png




*Кликните на '''Добавить из файла''', выберите файл обработки, загруженный по ссылке выше:
*Кликните на '''Добавить из файла''', выберите файл обработки, загруженный по ссылке ранее:


https://p.pfx.so/pf/KS/8lfPCV.png
https://p.pfx.so/pf/KS/8lfPCV.png
Строка 75: Строка 85:




Второй вариант, как можно использовать модуль: открыть обработку через '''Меню''' - '''Файл''' - '''Открыть'''. В данном случае файл обработки должен храниться в локальной или общедоступной папке :
Второй вариант использования модуля.


https://p.pfx.so/pf/LA/xCynJ7.png
Открыть обработку через '''Меню''' — '''Файл''' — '''Открыть'''. В данном случае файл обработки должен храниться в локальной или общедоступной папке.




== '''Настройка интеграции''' ==
== Настройка модуля интеграции ==
Настройка модуля интеграции:
*Скопируйте адрес для принятия запросов и токен авторизации из настроек Планфикса и вставьте их в настройки интеграции в 1С.
*Скопируйте адрес для принятия запросов и токен авторизации из настроек Планфикса и вставьте их в настройки интеграции в 1С
*Нажмите '''Тест подключения''', в сообщениях должно появиться '''Запрос успешно выполнен''':
*Нажмите '''Тест подключения''', в сообщениях должно появиться - '''Запрос успешно выполнен'''


https://p.pfx.so/pf/Ve/ialagW.png
https://p.pfx.so/pf/Ve/ialagW.png




*Переходите во вкладку '''Контакты'''
== Настройка обмена контактами ==
*Выбираете шаблон для создания контакта в Планфикс.
*Перейдите во вкладку '''Контакты'''.
*Выбираете шаблон для создания компании в Планфикс.
*Выберите шаблон для создания контакта в ПланФиксе.
*Устанавливаете опцию параметров импорта.
*Выберите шаблон для создания компании в ПланФиксе.
*Выбираете поле, по совпадению которого определяется, что контакт существует.
*Установите опцию параметров импорта.
*Если в конфигурации используются контактные лица, то можно установить флаг выгрузки их в контакты компаний. Также есть возможность установить флаг выгрузки помеченных на удаление объектов.
*Выберите поле, по совпадению которого определяется, что контакт существует. Обратите внимание, это поле может быть пользовательским.
*Укажите поле по умолчанию, которое будет использоваться, если контакт или компания не будут найдены по заданным ранее условиям.
*Если в конфигурации используются контактные лица, то можно установить флаг выгрузки их в контакты компаний. Можно установить флаг выгрузки помеченных на удаление объектов:


https://p.pfx.so/pf/6v/W36EZG.png
https://p.pfx.so/pf/y2/tMXneB.png


В таблице слева есть возможность сопоставить пользовательские поля Планфикса реквизитам справочника 1С. В зависимости от настроек CRM и маркетинга в 1С, используется справочник '''Контрагенты''' или справочник '''Партнеры'''. Это дополнительный функционал, настраивать сопоставление необязательно.
 
В таблице слева при необходимости сопоставьте пользовательские поля ПланФикса с реквизитами справочника 1С. В зависимости от настроек CRM и маркетинга в 1С, используется справочник '''Контрагенты''' или справочник '''Партнеры'''. Это дополнительный функционал, настраивать сопоставление необязательно:


https://p.pfx.so/pf/f3/fkgvAk.png
https://p.pfx.so/pf/f3/fkgvAk.png


В правой части окна располагаются параметры импорта контактов в 1С:
В правой части окна располагаются параметры импорта контактов в 1С:
*Обновлять данные существующих контактов (если нужно)
*Обновлять данные существующих контактов (если нужно).
*Создавать при загрузке новых контрагентов/партнеров
*Создавать при загрузке новых контрагентов/партнеров.
*Опция позволяющая создавать и обновлять контактные лица партнеров из контактов компаний в Планфикс
*Опция, позволяющая создавать и обновлять контактные лица партнеров из контактов компаний в ПланФиксе.
*Поля, по совпадению которых определяется что компания/контакт существует
*Поля, по совпадению которых определяется, что компания/контакт существует.
*Поле по умолчанию, если контакт/компания не найдены по заданному правилу выше:
*Поле по умолчанию, если контакт/компания не найдены по заданному правилу выше:


Строка 111: Строка 124:




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


https://p.pfx.so/pf/T6/bxVS1b.png
https://p.pfx.so/pf/T6/bxVS1b.png
Строка 120: Строка 133:




Не забудьте сохранить настройки.
== Принципы работы обмена контактами ==
'''Общие'''
*Контакты компаний из ПланФикс в 1С загружаются только как контактные лица для партнеров/контрагентов. Из 1С в ПланФикс выгружаются контактные лица только от партнеров/контрагентов, являющихся компаниями (юр. лицами).
*Если в настройках включена опция «Выгружать объекты, помеченные на удаление», то при обмене, помеченный на удаление контакт в 1С, в ПланФикс будет перемещен в корзину. И будет удалено соответствие идентификаторов из базы данных для того, чтобы, если этот объект удалят из 1С, можно было сопоставлять контакт ПланФикса с другими объектами 1С (если его восстановят из корзины). Если же пометка на удаление снята, то при следующем обмене контакт восстанавливается из корзины, и сопоставление идентификаторов добавляется снова в базу данных.
'''Управление небольшой фирмой (УНФ)'''
*Контакты компании — в 1С основное контактное лицо контрагента (компании) устанавливаем первое контактное лицо из списка контактов компаний в ПланФиксе.
'''Управление торговлей, Комплексная автоматизация, ERP Управление предприятием'''
*Если в конфигурации установлена опция «Независимо вести партнеров и контрагентов», то в качестве основного справочника для обмена выступает справочник контрагентов. Информация из справочника партнеры добавляется к контрагенту по принципу — если наименование партнера и контрагента совпадают или схожи, и у партнера только один контрагент (одна сущность), тогда к данным контрагента добавляются данные партнера: день рождения партнёра и пол, доп/прочая информация. Аналогично происходит при обратном обмене: данные о дне рождении, поле и доп/прочая информация обновляются из контакта ПланФикса у партнера, который считается одной сущностью с контрагентом.
*Если в 1С один партнер и несколько контрагентов у этого партнера — в ПланФикс будет выгружено несколько контактов, заполненных данными контрагентов. Если один из контрагентов определен как одна сущность с партнером, то по нему будут выгружены общие данные с партнером (день рождения партнёра, пол и доп/прочая информация). При обратной загрузке, данные партнера обновятся только из контакта, в который были выгружены данные партнера и контрагента как единой сущности (день рождения партнёра, пол и доп/прочая информация).
'''Общие рекомендации и разъяснения'''
*Первый обмен контактами рекомендуется делать из 1С в ПланФикс, т. к. сопоставление и хранение связей данных между системами происходит на стороне ПланФикса. Это позволит минимизировать образование дублей.
*Если вам понадобится контакт, который является контактным лицом компании как контрагент/партнер, необходимо его создать в 1С, тогда в ПланФикс он загрузится как отдельный контакт (дубль).


После необходимо нажать на Сохранить настройки.


== Выполнение обмена ==
== Выполнение обмена ==
<div style="background-color:#ffcaca; border: 1px solid #fd9292;padding:10px;"> Перед выполнением обмена обязательно сделайте бэкап информационной базы.</div>


<div style="background-color:#ffcaca; border: 1px solid #fd9292;padding:10px;"> Перед выполнением обмена настоятельно рекомендуется сделать backup информационной базы.</div>
Так как сопоставление и хранение информации о связи между объектами ПланФикса и базой 1С происходит на стороне ПланФикса, первым этапом рекомендуется выполнить выгрузку контактов в ПланФикс, нажав кнопку '''Отправить данные'''. Произойдет отправка всех контрагентов/партнеров/контактных лиц в ПланФикс, где будет произведен импорт согласно настроек.


Так как сопоставление и хранение информации о связи между объектами Планфикса и базой 1С, происходит на стороне Планфикса, первым этапом рекомендуется выполнить выгрузку контактов в Планфикс, нажать на кнопку '''Отправить данные'''. Произойдет отправка всех контрагентов/партнеров/контактных лиц в Планфикс, где будет произведен импорт согласно настроек.
При первом обмене получите все данные из ПланФикса, нажав кнопку '''Получить все данные'''. При последующих обменах можно получать только измененные данные кнопкой '''Получить данные (только измененные)'''.   
После этого при первом обмене нужно получить все данные из Планфикс, нажатием кнопки '''Получить все данные''', далее при последующих обменах можно получать только измененные данные с момента последнего обмена, кнопкой '''Получить данные (только измененные)'''.   
 
При использовании механизма Дополнительных обработок, есть возможность настроить автоматический обмен по расписанию. Можно настроить только выгрузку или только загрузку или двусторонний обмен.
При использовании механизма '''Дополнительных обработок''', можно настроить автоматический обмен по расписанию, выбрав только выгрузку или загрузку, либо двусторонний обмен:


https://p.pfx.so/pf/1E/9vFWCr.png
https://p.pfx.so/pf/1E/9vFWCr.png




== Отладка и тестирование и доработка ==
== Отладка, тестирование, доработка ==
Исходный код модуля открыт для редактирования, поэтому при необходимости можно дорабатывать его под свои нужды. В этом случае последующие обновления модуля придется выполнять в ручном режиме, если они будут вам необходимы.
*Исходный код модуля открыт для редактирования, поэтому при необходимости его можно дорабатывать. В этом случае последующие обновления модуля необходимо выполнять в ручном режиме.
Также на форме обработки есть вкладка '''Отладка и тестирование''', где можно выполнять тестовые команды.
 
*Во вкладке '''Отладка и тестирование''' можно выполнять тестовые команды.
 
 
== Перейти ==
*[[Интеграции]]

Текущая версия от 14:22, 11 ноября 2021

В тестовом режиме поддерживается обмен данными с типовыми конфигурациями на базе 1С:Предприятие 8.3.


Сейчас между ПланФиксом и 1С поддерживается обмен контактами. Скачать файл модуля интеграции можно по ссылке


Оглавление


Поддерживаемые конфигурации

  • Управление торговлей 11
  • Комплексная автоматизация 2
  • Комплексная автоматизация для Беларуси 2
  • ERP Управление предприятием 2
  • Управление нашей фирмой 1.6
  • Бухгалтерия 3.0
  • УНФ для Украины 1.6


Настройка интеграции

  • Перейдите в Управление аккаунтомИнтеграцииДругие сервисы и приложения1С:Предприятие 8:

BimIRJ.png


  • Нажмите кнопку Добавить:

YPAcQV.png


  • Задайте и сохраните имя интеграции. Рекомендуем назвать её по имени типовой конфигурации, с которой будет производиться обмен:

9mFgbC.png


  • Добавленная конфигурация должна появиться в перечне конфигураций:

SS0Sf8.png


Если в вашей конфигурации 1С включена опция «Дополнительные отчеты и обработки», то встроить модуль в интерфейс программы можно следующим образом:

  • Перейдите в раздел НСИ и АдминистрированиеПечатные формы, отчеты и обработки:

erWY2L.png


  • Нажмите на Дополнительные отчеты и обработки:

jzPhRb.png


  • Кликните на Добавить из файла, выберите файл обработки, загруженный по ссылке ранее:

8lfPCV.png


  • Нажмите на кнопку Записать (иконка в виде дискеты).
  • Разместите обработку в нужном разделе программы.
  • Настройте быстрый доступ к команде Открыть форму настроек обмена с ПланФикс для пользователей:

yQNC55.png

LqzFcJ.png


В результате такой настройки, у выбранных пользователей в указанном разделе программы появится возможность открывать форму обработки:

tzHuwW.png

1qTqjs.png


Второй вариант использования модуля.

Открыть обработку через МенюФайлОткрыть. В данном случае файл обработки должен храниться в локальной или общедоступной папке.


Настройка модуля интеграции

  • Скопируйте адрес для принятия запросов и токен авторизации из настроек Планфикса и вставьте их в настройки интеграции в 1С.
  • Нажмите Тест подключения, в сообщениях должно появиться — Запрос успешно выполнен:

ialagW.png


Настройка обмена контактами

  • Перейдите во вкладку Контакты.
  • Выберите шаблон для создания контакта в ПланФиксе.
  • Выберите шаблон для создания компании в ПланФиксе.
  • Установите опцию параметров импорта.
  • Выберите поле, по совпадению которого определяется, что контакт существует. Обратите внимание, это поле может быть пользовательским.
  • Укажите поле по умолчанию, которое будет использоваться, если контакт или компания не будут найдены по заданным ранее условиям.
  • Если в конфигурации используются контактные лица, то можно установить флаг выгрузки их в контакты компаний. Можно установить флаг выгрузки помеченных на удаление объектов:

tMXneB.png


В таблице слева при необходимости сопоставьте пользовательские поля ПланФикса с реквизитами справочника 1С. В зависимости от настроек CRM и маркетинга в 1С, используется справочник Контрагенты или справочник Партнеры. Это дополнительный функционал, настраивать сопоставление необязательно:

fkgvAk.png


В правой части окна располагаются параметры импорта контактов в 1С:

  • Обновлять данные существующих контактов (если нужно).
  • Создавать при загрузке новых контрагентов/партнеров.
  • Опция, позволяющая создавать и обновлять контактные лица партнеров из контактов компаний в ПланФиксе.
  • Поля, по совпадению которых определяется, что компания/контакт существует.
  • Поле по умолчанию, если контакт/компания не найдены по заданному правилу выше:

m5Pjss.png


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

bxVS1b.png

PmGFHG.png

eFEpeO.png


Не забудьте сохранить настройки.


Принципы работы обмена контактами

Общие

  • Контакты компаний из ПланФикс в 1С загружаются только как контактные лица для партнеров/контрагентов. Из 1С в ПланФикс выгружаются контактные лица только от партнеров/контрагентов, являющихся компаниями (юр. лицами).
  • Если в настройках включена опция «Выгружать объекты, помеченные на удаление», то при обмене, помеченный на удаление контакт в 1С, в ПланФикс будет перемещен в корзину. И будет удалено соответствие идентификаторов из базы данных для того, чтобы, если этот объект удалят из 1С, можно было сопоставлять контакт ПланФикса с другими объектами 1С (если его восстановят из корзины). Если же пометка на удаление снята, то при следующем обмене контакт восстанавливается из корзины, и сопоставление идентификаторов добавляется снова в базу данных.


Управление небольшой фирмой (УНФ)

  • Контакты компании — в 1С основное контактное лицо контрагента (компании) устанавливаем первое контактное лицо из списка контактов компаний в ПланФиксе.


Управление торговлей, Комплексная автоматизация, ERP Управление предприятием

  • Если в конфигурации установлена опция «Независимо вести партнеров и контрагентов», то в качестве основного справочника для обмена выступает справочник контрагентов. Информация из справочника партнеры добавляется к контрагенту по принципу — если наименование партнера и контрагента совпадают или схожи, и у партнера только один контрагент (одна сущность), тогда к данным контрагента добавляются данные партнера: день рождения партнёра и пол, доп/прочая информация. Аналогично происходит при обратном обмене: данные о дне рождении, поле и доп/прочая информация обновляются из контакта ПланФикса у партнера, который считается одной сущностью с контрагентом.
  • Если в 1С один партнер и несколько контрагентов у этого партнера — в ПланФикс будет выгружено несколько контактов, заполненных данными контрагентов. Если один из контрагентов определен как одна сущность с партнером, то по нему будут выгружены общие данные с партнером (день рождения партнёра, пол и доп/прочая информация). При обратной загрузке, данные партнера обновятся только из контакта, в который были выгружены данные партнера и контрагента как единой сущности (день рождения партнёра, пол и доп/прочая информация).


Общие рекомендации и разъяснения

  • Первый обмен контактами рекомендуется делать из 1С в ПланФикс, т. к. сопоставление и хранение связей данных между системами происходит на стороне ПланФикса. Это позволит минимизировать образование дублей.
  • Если вам понадобится контакт, который является контактным лицом компании как контрагент/партнер, необходимо его создать в 1С, тогда в ПланФикс он загрузится как отдельный контакт (дубль).


Выполнение обмена

Перед выполнением обмена обязательно сделайте бэкап информационной базы.


Так как сопоставление и хранение информации о связи между объектами ПланФикса и базой 1С происходит на стороне ПланФикса, первым этапом рекомендуется выполнить выгрузку контактов в ПланФикс, нажав кнопку Отправить данные. Произойдет отправка всех контрагентов/партнеров/контактных лиц в ПланФикс, где будет произведен импорт согласно настроек.

При первом обмене получите все данные из ПланФикса, нажав кнопку Получить все данные. При последующих обменах можно получать только измененные данные кнопкой Получить данные (только измененные).

При использовании механизма Дополнительных обработок, можно настроить автоматический обмен по расписанию, выбрав только выгрузку или загрузку, либо двусторонний обмен:

9vFWCr.png


Отладка, тестирование, доработка

  • Исходный код модуля открыт для редактирования, поэтому при необходимости его можно дорабатывать. В этом случае последующие обновления модуля необходимо выполнять в ручном режиме.
  • Во вкладке Отладка и тестирование можно выполнять тестовые команды.


Перейти