Интеграция с 1C: различия между версиями
Olga (обсуждение | вклад) Нет описания правки |
Artem (обсуждение | вклад) Нет описания правки |
||
(не показано 38 промежуточных версий 2 участников) | |||
Строка 5: | Строка 5: | ||
|description=Как настроить интеграцию ПланФикс и 1С | |description=Как настроить интеграцию ПланФикс и 1С | ||
}} | }} | ||
<div style="background:#ffbaba;padding:10px;border:1px solid #ff9b9b;">В тестовом режиме поддерживается обмен данными с типовыми конфигурациями на базе 1С:Предприятие 8.3.</div> | |||
Сейчас между ПланФиксом и 1С поддерживается обмен контактами. Скачать файл модуля интеграции можно по [https://github.com/planfix/planfix-1c/releases ссылке] | |||
== Оглавление == | |||
*[[#Настройка интеграции |Настройка интеграции]] | |||
*[[#Настройка модуля интеграции |Настройка модуля]] | |||
**[[#Настройка обмена контактами |Настройка обмена контактами]] | |||
**[[#Принципы работы обмена контактами |Принципы работы обмена контактами]] | |||
**[[#Выполнение обмена |Выполнение обмена]] | |||
*[[#Отладка, тестирование, доработка |Отладка, тестирование, доработка]] | |||
== Поддерживаемые конфигурации == | == Поддерживаемые конфигурации == | ||
*Управление торговлей 11 | *Управление торговлей 11 | ||
*Комплексная автоматизация 2 | *Комплексная автоматизация 2 | ||
*Комплексная автоматизация для Беларуси 2 | |||
*ERP Управление предприятием 2 | *ERP Управление предприятием 2 | ||
*Управление нашей фирмой 1.6 | *Управление нашей фирмой 1.6 | ||
*Бухгалтерия 3.0 | |||
*УНФ для Украины 1.6 | |||
== | == Настройка интеграции == | ||
*Перейдите в '''Управление аккаунтом''' — '''Интеграции''' — '''Другие сервисы и приложения''' — '''1С:Предприятие 8''' | *Перейдите в '''Управление аккаунтом''' — '''Интеграции''' — '''Другие сервисы и приложения''' — '''1С:Предприятие 8''': | ||
https://p.pfx.so/pf/fh/BimIRJ.png | https://p.pfx.so/pf/fh/BimIRJ.png | ||
*Нажмите '''Добавить''' | *Нажмите кнопку '''Добавить''': | ||
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 | ||
Строка 34: | Строка 47: | ||
*Добавленная конфигурация должна появиться в перечне конфигураций: | *Добавленная конфигурация должна появиться в перечне конфигураций: | ||
https://p.pfx.so/pf/ma/SS0Sf8.png | https://p.pfx.so/pf/ma/SS0Sf8.png | ||
Если в вашей конфигурации 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 | ||
Строка 74: | Строка 85: | ||
Второй вариант | Второй вариант использования модуля. | ||
Открыть обработку через '''Меню''' — '''Файл''' — '''Открыть'''. В данном случае файл обработки должен храниться в локальной или общедоступной папке. | |||
== | == Настройка модуля интеграции == | ||
*Скопируйте адрес для принятия запросов и токен авторизации из настроек Планфикса и вставьте их в настройки интеграции в 1С. | |||
*Скопируйте адрес для принятия запросов и токен авторизации из настроек Планфикса и вставьте их в настройки интеграции в 1С | *Нажмите '''Тест подключения''', в сообщениях должно появиться — '''Запрос успешно выполнен''': | ||
*Нажмите '''Тест подключения''', в сообщениях должно появиться | |||
https://p.pfx.so/pf/Ve/ialagW.png | https://p.pfx.so/pf/Ve/ialagW.png | ||
* | == Настройка обмена контактами == | ||
* | *Перейдите во вкладку '''Контакты'''. | ||
* | *Выберите шаблон для создания контакта в ПланФиксе. | ||
* | *Выберите шаблон для создания компании в ПланФиксе. | ||
* | *Установите опцию параметров импорта. | ||
*Если в конфигурации используются контактные лица, то можно установить флаг выгрузки их в контакты компаний. | *Выберите поле, по совпадению которого определяется, что контакт существует. Обратите внимание, это поле может быть пользовательским. | ||
*Укажите поле по умолчанию, которое будет использоваться, если контакт или компания не будут найдены по заданным ранее условиям. | |||
*Если в конфигурации используются контактные лица, то можно установить флаг выгрузки их в контакты компаний. Можно установить флаг выгрузки помеченных на удаление объектов: | |||
https://p.pfx.so/pf/y2/tMXneB.png | |||
В таблице слева | В таблице слева при необходимости сопоставьте пользовательские поля ПланФикса с реквизитами справочника 1С. В зависимости от настроек CRM и маркетинга в 1С, используется справочник '''Контрагенты''' или справочник '''Партнеры'''. Это дополнительный функционал, настраивать сопоставление необязательно: | ||
https://p.pfx.so/pf/f3/fkgvAk.png | https://p.pfx.so/pf/f3/fkgvAk.png | ||
В правой части окна располагаются параметры импорта контактов в 1С: | В правой части окна располагаются параметры импорта контактов в 1С: | ||
*Обновлять данные существующих контактов (если нужно) | *Обновлять данные существующих контактов (если нужно). | ||
*Создавать при загрузке новых контрагентов/партнеров | *Создавать при загрузке новых контрагентов/партнеров. | ||
*Опция позволяющая создавать и обновлять контактные лица партнеров из контактов компаний в | *Опция, позволяющая создавать и обновлять контактные лица партнеров из контактов компаний в ПланФиксе. | ||
*Поля, по совпадению которых определяется что компания/контакт существует | *Поля, по совпадению которых определяется, что компания/контакт существует. | ||
*Поле по умолчанию, если контакт/компания не найдены по заданному правилу выше: | *Поле по умолчанию, если контакт/компания не найдены по заданному правилу выше: | ||
Строка 110: | Строка 124: | ||
Для правильного обмена телефонами, необходимо выполнить сопоставление видов телефонов для различных групп контактной информации в 1С | Для правильного обмена телефонами, необходимо выполнить сопоставление видов телефонов для различных групп контактной информации в 1С: | ||
https://p.pfx.so/pf/T6/bxVS1b.png | https://p.pfx.so/pf/T6/bxVS1b.png | ||
Строка 119: | Строка 133: | ||
Не забудьте сохранить настройки. | |||
== Принципы работы обмена контактами == | |||
'''Общие''' | |||
*Контакты компаний из ПланФикс в 1С загружаются только как контактные лица для партнеров/контрагентов. Из 1С в ПланФикс выгружаются контактные лица только от партнеров/контрагентов, являющихся компаниями (юр. лицами). | |||
*Если в настройках включена опция «Выгружать объекты, помеченные на удаление», то при обмене, помеченный на удаление контакт в 1С, в ПланФикс будет перемещен в корзину. И будет удалено соответствие идентификаторов из базы данных для того, чтобы, если этот объект удалят из 1С, можно было сопоставлять контакт ПланФикса с другими объектами 1С (если его восстановят из корзины). Если же пометка на удаление снята, то при следующем обмене контакт восстанавливается из корзины, и сопоставление идентификаторов добавляется снова в базу данных. | |||
'''Управление небольшой фирмой (УНФ)''' | |||
*Контакты компании — в 1С основное контактное лицо контрагента (компании) устанавливаем первое контактное лицо из списка контактов компаний в ПланФиксе. | |||
'''Управление торговлей, Комплексная автоматизация, ERP Управление предприятием''' | |||
*Если в конфигурации установлена опция «Независимо вести партнеров и контрагентов», то в качестве основного справочника для обмена выступает справочник контрагентов. Информация из справочника партнеры добавляется к контрагенту по принципу — если наименование партнера и контрагента совпадают или схожи, и у партнера только один контрагент (одна сущность), тогда к данным контрагента добавляются данные партнера: день рождения партнёра и пол, доп/прочая информация. Аналогично происходит при обратном обмене: данные о дне рождении, поле и доп/прочая информация обновляются из контакта ПланФикса у партнера, который считается одной сущностью с контрагентом. | |||
*Если в 1С один партнер и несколько контрагентов у этого партнера — в ПланФикс будет выгружено несколько контактов, заполненных данными контрагентов. Если один из контрагентов определен как одна сущность с партнером, то по нему будут выгружены общие данные с партнером (день рождения партнёра, пол и доп/прочая информация). При обратной загрузке, данные партнера обновятся только из контакта, в который были выгружены данные партнера и контрагента как единой сущности (день рождения партнёра, пол и доп/прочая информация). | |||
'''Общие рекомендации и разъяснения''' | |||
*Первый обмен контактами рекомендуется делать из 1С в ПланФикс, т. к. сопоставление и хранение связей данных между системами происходит на стороне ПланФикса. Это позволит минимизировать образование дублей. | |||
*Если вам понадобится контакт, который является контактным лицом компании как контрагент/партнер, необходимо его создать в 1С, тогда в ПланФикс он загрузится как отдельный контакт (дубль). | |||
== Выполнение обмена == | == Выполнение обмена == | ||
<div style="background-color:#ffcaca; border: 1px solid #fd9292;padding:10px;"> Перед выполнением обмена обязательно сделайте бэкап информационной базы.</div> | |||
Так как сопоставление и хранение информации о связи между объектами ПланФикса и базой 1С происходит на стороне ПланФикса, первым этапом рекомендуется выполнить выгрузку контактов в ПланФикс, нажав кнопку '''Отправить данные'''. Произойдет отправка всех контрагентов/партнеров/контактных лиц в ПланФикс, где будет произведен импорт согласно настроек. | |||
При первом обмене получите все данные из ПланФикса, нажав кнопку '''Получить все данные'''. При последующих обменах можно получать только измененные данные кнопкой '''Получить данные (только измененные)'''. | |||
При использовании механизма '''Дополнительных обработок''', можно настроить автоматический обмен по расписанию, выбрав только выгрузку или загрузку, либо двусторонний обмен: | |||
https://p.pfx.so/pf/1E/9vFWCr.png | https://p.pfx.so/pf/1E/9vFWCr.png | ||
== Отладка | == Отладка, тестирование, доработка == | ||
Исходный код модуля открыт для редактирования, поэтому при необходимости можно дорабатывать | *Исходный код модуля открыт для редактирования, поэтому при необходимости его можно дорабатывать. В этом случае последующие обновления модуля необходимо выполнять в ручном режиме. | ||
*Во вкладке '''Отладка и тестирование''' можно выполнять тестовые команды. | |||
== Перейти == | |||
*[[Интеграции]] |
Текущая версия от 14:22, 11 ноября 2021
Сейчас между ПланФиксом и 1С поддерживается обмен контактами. Скачать файл модуля интеграции можно по ссылке
Оглавление
Поддерживаемые конфигурации
- Управление торговлей 11
- Комплексная автоматизация 2
- Комплексная автоматизация для Беларуси 2
- ERP Управление предприятием 2
- Управление нашей фирмой 1.6
- Бухгалтерия 3.0
- УНФ для Украины 1.6
Настройка интеграции
- Перейдите в Управление аккаунтом — Интеграции — Другие сервисы и приложения — 1С:Предприятие 8:
- Нажмите кнопку Добавить:
- Задайте и сохраните имя интеграции. Рекомендуем назвать её по имени типовой конфигурации, с которой будет производиться обмен:
- Добавленная конфигурация должна появиться в перечне конфигураций:
Если в вашей конфигурации 1С включена опция «Дополнительные отчеты и обработки», то встроить модуль в интерфейс программы можно следующим образом:
- Перейдите в раздел НСИ и Администрирование — Печатные формы, отчеты и обработки:
- Нажмите на Дополнительные отчеты и обработки:
- Кликните на Добавить из файла, выберите файл обработки, загруженный по ссылке ранее:
- Нажмите на кнопку Записать (иконка в виде дискеты).
- Разместите обработку в нужном разделе программы.
- Настройте быстрый доступ к команде Открыть форму настроек обмена с ПланФикс для пользователей:
В результате такой настройки, у выбранных пользователей в указанном разделе программы появится возможность открывать форму обработки:
Второй вариант использования модуля.
Открыть обработку через Меню — Файл — Открыть. В данном случае файл обработки должен храниться в локальной или общедоступной папке.
Настройка модуля интеграции
- Скопируйте адрес для принятия запросов и токен авторизации из настроек Планфикса и вставьте их в настройки интеграции в 1С.
- Нажмите Тест подключения, в сообщениях должно появиться — Запрос успешно выполнен:
Настройка обмена контактами
- Перейдите во вкладку Контакты.
- Выберите шаблон для создания контакта в ПланФиксе.
- Выберите шаблон для создания компании в ПланФиксе.
- Установите опцию параметров импорта.
- Выберите поле, по совпадению которого определяется, что контакт существует. Обратите внимание, это поле может быть пользовательским.
- Укажите поле по умолчанию, которое будет использоваться, если контакт или компания не будут найдены по заданным ранее условиям.
- Если в конфигурации используются контактные лица, то можно установить флаг выгрузки их в контакты компаний. Можно установить флаг выгрузки помеченных на удаление объектов:
В таблице слева при необходимости сопоставьте пользовательские поля ПланФикса с реквизитами справочника 1С. В зависимости от настроек CRM и маркетинга в 1С, используется справочник Контрагенты или справочник Партнеры. Это дополнительный функционал, настраивать сопоставление необязательно:
В правой части окна располагаются параметры импорта контактов в 1С:
- Обновлять данные существующих контактов (если нужно).
- Создавать при загрузке новых контрагентов/партнеров.
- Опция, позволяющая создавать и обновлять контактные лица партнеров из контактов компаний в ПланФиксе.
- Поля, по совпадению которых определяется, что компания/контакт существует.
- Поле по умолчанию, если контакт/компания не найдены по заданному правилу выше:
Для правильного обмена телефонами, необходимо выполнить сопоставление видов телефонов для различных групп контактной информации в 1С:
Не забудьте сохранить настройки.
Принципы работы обмена контактами
Общие
- Контакты компаний из ПланФикс в 1С загружаются только как контактные лица для партнеров/контрагентов. Из 1С в ПланФикс выгружаются контактные лица только от партнеров/контрагентов, являющихся компаниями (юр. лицами).
- Если в настройках включена опция «Выгружать объекты, помеченные на удаление», то при обмене, помеченный на удаление контакт в 1С, в ПланФикс будет перемещен в корзину. И будет удалено соответствие идентификаторов из базы данных для того, чтобы, если этот объект удалят из 1С, можно было сопоставлять контакт ПланФикса с другими объектами 1С (если его восстановят из корзины). Если же пометка на удаление снята, то при следующем обмене контакт восстанавливается из корзины, и сопоставление идентификаторов добавляется снова в базу данных.
Управление небольшой фирмой (УНФ)
- Контакты компании — в 1С основное контактное лицо контрагента (компании) устанавливаем первое контактное лицо из списка контактов компаний в ПланФиксе.
Управление торговлей, Комплексная автоматизация, ERP Управление предприятием
- Если в конфигурации установлена опция «Независимо вести партнеров и контрагентов», то в качестве основного справочника для обмена выступает справочник контрагентов. Информация из справочника партнеры добавляется к контрагенту по принципу — если наименование партнера и контрагента совпадают или схожи, и у партнера только один контрагент (одна сущность), тогда к данным контрагента добавляются данные партнера: день рождения партнёра и пол, доп/прочая информация. Аналогично происходит при обратном обмене: данные о дне рождении, поле и доп/прочая информация обновляются из контакта ПланФикса у партнера, который считается одной сущностью с контрагентом.
- Если в 1С один партнер и несколько контрагентов у этого партнера — в ПланФикс будет выгружено несколько контактов, заполненных данными контрагентов. Если один из контрагентов определен как одна сущность с партнером, то по нему будут выгружены общие данные с партнером (день рождения партнёра, пол и доп/прочая информация). При обратной загрузке, данные партнера обновятся только из контакта, в который были выгружены данные партнера и контрагента как единой сущности (день рождения партнёра, пол и доп/прочая информация).
Общие рекомендации и разъяснения
- Первый обмен контактами рекомендуется делать из 1С в ПланФикс, т. к. сопоставление и хранение связей данных между системами происходит на стороне ПланФикса. Это позволит минимизировать образование дублей.
- Если вам понадобится контакт, который является контактным лицом компании как контрагент/партнер, необходимо его создать в 1С, тогда в ПланФикс он загрузится как отдельный контакт (дубль).
Выполнение обмена
Так как сопоставление и хранение информации о связи между объектами ПланФикса и базой 1С происходит на стороне ПланФикса, первым этапом рекомендуется выполнить выгрузку контактов в ПланФикс, нажав кнопку Отправить данные. Произойдет отправка всех контрагентов/партнеров/контактных лиц в ПланФикс, где будет произведен импорт согласно настроек.
При первом обмене получите все данные из ПланФикса, нажав кнопку Получить все данные. При последующих обменах можно получать только измененные данные кнопкой Получить данные (только измененные).
При использовании механизма Дополнительных обработок, можно настроить автоматический обмен по расписанию, выбрав только выгрузку или загрузку, либо двусторонний обмен:
Отладка, тестирование, доработка
- Исходный код модуля открыт для редактирования, поэтому при необходимости его можно дорабатывать. В этом случае последующие обновления модуля необходимо выполнять в ручном режиме.
- Во вкладке Отладка и тестирование можно выполнять тестовые команды.