Интеграция с 1C: различия между версиями
Artem (обсуждение | вклад) Нет описания правки |
Artem (обсуждение | вклад) Нет описания правки |
||
(не показано 10 промежуточных версий этого же участника) | |||
Строка 8: | Строка 8: | ||
Сейчас между ПланФиксом и 1С поддерживается обмен контактами. Скачать файл модуля интеграции можно по [https://github.com/planfix/planfix-1c/releases | Сейчас между ПланФиксом и 1С поддерживается обмен контактами. Скачать файл модуля интеграции можно по [https://github.com/planfix/planfix-1c/releases ссылке] | ||
Строка 14: | Строка 14: | ||
*[[#Настройка интеграции |Настройка интеграции]] | *[[#Настройка интеграции |Настройка интеграции]] | ||
*[[#Настройка модуля интеграции |Настройка модуля]] | *[[#Настройка модуля интеграции |Настройка модуля]] | ||
*[[#Настройка обмена контактами |Настройка обмена контактами]] | **[[#Настройка обмена контактами |Настройка обмена контактами]] | ||
*[[#Выполнение обмена |Выполнение обмена]] | **[[#Принципы работы обмена контактами |Принципы работы обмена контактами]] | ||
**[[#Выполнение обмена |Выполнение обмена]] | |||
*[[#Отладка, тестирование, доработка |Отладка, тестирование, доработка]] | *[[#Отладка, тестирование, доработка |Отладка, тестирование, доработка]] | ||
Строка 22: | Строка 23: | ||
*Управление торговлей 11 | *Управление торговлей 11 | ||
*Комплексная автоматизация 2 | *Комплексная автоматизация 2 | ||
*Комплексная автоматизация для Беларуси 2 | |||
*ERP Управление предприятием 2 | *ERP Управление предприятием 2 | ||
*Управление нашей фирмой 1.6 | *Управление нашей фирмой 1.6 | ||
Строка 85: | Строка 87: | ||
Второй вариант использования модуля. | Второй вариант использования модуля. | ||
Открыть обработку через '''Меню''' — '''Файл''' — '''Открыть'''. В данном случае файл обработки должен храниться в локальной или общедоступной папке | Открыть обработку через '''Меню''' — '''Файл''' — '''Открыть'''. В данном случае файл обработки должен храниться в локальной или общедоступной папке. | ||
Строка 102: | Строка 102: | ||
*Выберите шаблон для создания компании в ПланФиксе. | *Выберите шаблон для создания компании в ПланФиксе. | ||
*Установите опцию параметров импорта. | *Установите опцию параметров импорта. | ||
*Выберите поле, по совпадению которого определяется, что контакт существует. | *Выберите поле, по совпадению которого определяется, что контакт существует. Обратите внимание, это поле может быть пользовательским. | ||
*Укажите поле по умолчанию, которое будет использоваться, если контакт или компания не будут найдены по заданным ранее условиям. | |||
*Если в конфигурации используются контактные лица, то можно установить флаг выгрузки их в контакты компаний. Можно установить флаг выгрузки помеченных на удаление объектов: | *Если в конфигурации используются контактные лица, то можно установить флаг выгрузки их в контакты компаний. Можно установить флаг выгрузки помеченных на удаление объектов: | ||
https://p.pfx.so/pf/ | https://p.pfx.so/pf/y2/tMXneB.png | ||
Строка 133: | Строка 134: | ||
Не забудьте сохранить настройки. | Не забудьте сохранить настройки. | ||
== Принципы работы обмена контактами == | |||
'''Общие''' | |||
*Контакты компаний из ПланФикс в 1С загружаются только как контактные лица для партнеров/контрагентов. Из 1С в ПланФикс выгружаются контактные лица только от партнеров/контрагентов, являющихся компаниями (юр. лицами). | |||
*Если в настройках включена опция «Выгружать объекты, помеченные на удаление», то при обмене, помеченный на удаление контакт в 1С, в ПланФикс будет перемещен в корзину. И будет удалено соответствие идентификаторов из базы данных для того, чтобы, если этот объект удалят из 1С, можно было сопоставлять контакт ПланФикса с другими объектами 1С (если его восстановят из корзины). Если же пометка на удаление снята, то при следующем обмене контакт восстанавливается из корзины, и сопоставление идентификаторов добавляется снова в базу данных. | |||
'''Управление небольшой фирмой (УНФ)''' | |||
*Контакты компании — в 1С основное контактное лицо контрагента (компании) устанавливаем первое контактное лицо из списка контактов компаний в ПланФиксе. | |||
'''Управление торговлей, Комплексная автоматизация, ERP Управление предприятием''' | |||
*Если в конфигурации установлена опция «Независимо вести партнеров и контрагентов», то в качестве основного справочника для обмена выступает справочник контрагентов. Информация из справочника партнеры добавляется к контрагенту по принципу — если наименование партнера и контрагента совпадают или схожи, и у партнера только один контрагент (одна сущность), тогда к данным контрагента добавляются данные партнера: день рождения партнёра и пол, доп/прочая информация. Аналогично происходит при обратном обмене: данные о дне рождении, поле и доп/прочая информация обновляются из контакта ПланФикса у партнера, который считается одной сущностью с контрагентом. | |||
*Если в 1С один партнер и несколько контрагентов у этого партнера — в ПланФикс будет выгружено несколько контактов, заполненных данными контрагентов. Если один из контрагентов определен как одна сущность с партнером, то по нему будут выгружены общие данные с партнером (день рождения партнёра, пол и доп/прочая информация). При обратной загрузке, данные партнера обновятся только из контакта, в который были выгружены данные партнера и контрагента как единой сущности (день рождения партнёра, пол и доп/прочая информация). | |||
'''Общие рекомендации и разъяснения''' | |||
*Первый обмен контактами рекомендуется делать из 1С в ПланФикс, т. к. сопоставление и хранение связей данных между системами происходит на стороне ПланФикса. Это позволит минимизировать образование дублей. | |||
*Если вам понадобится контакт, который является контактным лицом компании как контрагент/партнер, необходимо его создать в 1С, тогда в ПланФикс он загрузится как отдельный контакт (дубль). | |||
== Выполнение обмена == | == Выполнение обмена == | ||
<div style="background-color:#ffcaca; border: 1px solid #fd9292;padding:10px;"> Перед выполнением обмена | <div style="background-color:#ffcaca; border: 1px solid #fd9292;padding:10px;"> Перед выполнением обмена обязательно сделайте бэкап информационной базы.</div> | ||
Текущая версия от 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С происходит на стороне ПланФикса, первым этапом рекомендуется выполнить выгрузку контактов в ПланФикс, нажав кнопку Отправить данные. Произойдет отправка всех контрагентов/партнеров/контактных лиц в ПланФикс, где будет произведен импорт согласно настроек.
При первом обмене получите все данные из ПланФикса, нажав кнопку Получить все данные. При последующих обменах можно получать только измененные данные кнопкой Получить данные (только измененные).
При использовании механизма Дополнительных обработок, можно настроить автоматический обмен по расписанию, выбрав только выгрузку или загрузку, либо двусторонний обмен:
Отладка, тестирование, доработка
- Исходный код модуля открыт для редактирования, поэтому при необходимости его можно дорабатывать. В этом случае последующие обновления модуля необходимо выполнять в ручном режиме.
- Во вкладке Отладка и тестирование можно выполнять тестовые команды.