Как синхронизировать данные Salesforce с товарными чеками QuickBooks?
Обзор
Многим организациям необходим удобный способ синхронизации данных о пожертвованиях из Salesforce с данными о товарных чеках в QuickBooks, обеспечивающий при этом точность информации о клиентах, позициях и транзакциях. Поскольку Salesforce и QuickBooks не предоставляют встроенной автоматизации для создания товарных чеков из записей Salesforce, интеграция miniOrange с QuickBooks предлагает удобное решение. Этот пакет заполняет этот пробел, обеспечивая настройку с минимальным использованием кода, с помощью сопоставления объектов и потоков Salesforce.
Пакет интеграции miniOrange с QuickBooks позволяет определять сопоставления между объектами Salesforce и соответствующими сущностями QuickBooks, такими как клиенты, позиции товарных чеков и товарные чеки. Настраивая эти сопоставления объектов и полей и создавая потоки, запускаемые записями, данные Salesforce автоматически преобразуются и синхронизируются с QuickBooks без написания пользовательского кода.
Предварительные условия: доступ и настройка.
Перед началом настройки аутентификации в QuickBooks убедитесь, что у вас есть следующее:
- Доступ к Портал разработчиков Intuit
- A Песочница QuickBooks or Счет производства
- Доступ администратора Salesforce
- Пакет интеграции miniOrange с QuickBooks установлен в Salesforce
Шаги настройки
Шаг 1: Создайте подключенное приложение в QuickBooks.
- Войти в Портал разработчиков Intuit.
- Выбрать Рабочее пространство затем перейдите к Мини аппы меню.
- Нажмите + кнопку для создания новой заявки.
- Нажмите Свяжитесь с нами .
- Введите Имя приложения по вашему выбору и нажмите Следующая.
- Проверить com.intuit.quickbooks.accounting и com.intuit.quickbooks.payment разрешения, затем нажмите Готово .
- Включите Предъявите документы для просмотра Идентификатор клиента разработки и Секрет клиента.
Примечание: Если вы используете тестовую среду QuickBooks, вы можете использовать учетные данные тестовой среды. Для рабочей среды выполните следующие шаги, чтобы сгенерировать учетные данные для рабочей среды.
- Нажмите Открыть приложение для доступа к панели управления приложения.
- В панели управления приложения откройте Ключи и учетные данные Затем выберите Постановка в качестве типа учетных данных.
- Заполните анкету QuickBooks, чтобы разблокировать доступ к производственным данным.
- По завершении нажмите Предъявите документы. Скопируйте идентификатор клиента и Секрет клиента и надежно хранить их для использования в Salesforce.
Именованные учетные данные
- Войдите в свою учетную запись Salesforce и перейдите по ссылке: Установка.
- В Быстрый поиск ящик, найди Именованные учетные данные.
- Нажмите Именованные учетные данные меню.
- Именованные учетные данные: Учетные данные QuickBooks
- Внешние учетные данные: moQuickBooksExternalCredential
- Внешний поставщик идентификации для аутентификации: moQuickBooksExternalAuthProvider
Следующие записи предоставляются пакетом miniOrange:
Настройка учетных данных внешних поставщиков идентификации для аутентификации.
- Нажмите Внешние поставщики аутентификации идентификационных данных вкладки и Редактировать moQuickBooksExternalAuthProvider записи.
- Введите идентификатор клиента и Секрет клиента Скопировано из QuickBooks. Нажмите на Сохранено.
- Откройте запись снова, прокрутите до URL-адреса поставщиков идентификационных данных раздел и скопируйте URL обратного вызова использовать в URI перенаправления QuickBooks.
Добавить URI перенаправления в QuickBooks
- Вернуться в Портал разработчиков Intuit и откройте панель управления приложения.
- Перейдите в Настройки >> URI перенаправления.
- Выбрать Разработка or Постановка в зависимости от вашей среды.
- Нажмите Добавить URI.
- Вставьте URL обратного вызова (сгенерировано на предыдущем шаге:) Учетные данные внешнего поставщика аутентификации).
- Нажмите Сохранено.
Предоставление доступа к профилю для внешних учетных данных
- В Salesforce Установка, ищи Профили в поле быстрого поиска.
- Перейдите в Профиль >> Системный администратор профиль.
- Наведите указатель мыши на Включен внешний доступ к учетным данным участника и нажмите на Редактировать .
- Затем выберите moQuickBooksExternalCredincial - Connection и нажмите на Сохранено.
Подтвердите подключение к QuickBooks.
- В разделе «Настройка» перейдите к Именованные учетные данные >> Внешние учетные данные.
- Открыто moQuickBooksExternalCredential записи.
- Выделите Принципалы раздел, для Связь запись и в Действия столбец, нажмите Проверять подлинность.
- Вы будете перенаправлены на страницу входа в QuickBooks. Выберите рабочую область, использованную при создании приложения, затем нажмите Следующая.
- Введите учетные данные QuickBooks и пройдите аутентификацию. После аутентификации вы будете перенаправлены обратно на Salesforce.
Настройка параметров компании QuickBooks
- In Установка, ищи Пользовательские типы метаданных.
- Открыто Пользовательские типы метаданных меню.
- Нажмите Управление записями близко к Настройки QuickBooks.
- Нажмите на Редактировать для По умолчанию Запись.
- Введите Идентификатор компании Salesforce QuickBooks в Идентификатор компании поле.
- Нажмите Сохранено .
Шаг 2: Сопоставление полей или объектов
- Войдите в Salesforce и перейдите в раздел Установка меню.
- Нажмите Запуск приложения и Смотреть все чтобы открыть окно запуска приложений.
- Найдите Интеграция с QuickBooks от miniOrange.
- Откройте приложение, чтобы получить доступ к Панель интеграции miniOrange с QuickBooks.
Сопоставление объектов для чека и клиента
- Чтобы добавить новое сопоставление объектов, нажмите Новое сопоставление объектов .
- Из издания Объект QuickBooks В выпадающем списке выберите «Клиент».
- Из издания Объект Salesforce В выпадающем списке выберите объект, используемый для синхронизации данных о клиентах. (В данном случае) аккаунт выбрано)
- Нажмите Создать сопоставление .
- Нажмите Настройка сопоставления полей для вновь созданного сопоставления объектов.
- Нажмите Новое сопоставление полей.
- В Поле Salesforce В выпадающем списке выберите поле, содержащее имя клиента. (В этом руководстве по настройке, Имя пользователя выбрано).
- В Поле QuickBooks выпадающий, выберите Отображаемое имя.
- In Тип поля, наведите на Основной ключ Если вы хотите, чтобы QuickBooks проверял наличие существующих клиентов и предотвращал дублирование, оставьте значение по умолчанию.
- Нажмите Создать сопоставления для сохранения конфигурации.
Сопоставление объектов для позиций товарного чека
- Нажмите Новое сопоставление объектов.
- Из издания Объект QuickBooks выпадающий, выберите Позиции в товарном чеке.
- Из издания Объект Salesforce В раскрывающемся списке выберите объект, используемый для синхронизации данных позиций заказа. (В этом руководстве по настройке) пожертвование_c выбрано).
- Нажмите Создать сопоставление.
- Нажмите Настройка сопоставления полей для созданного сопоставления объектов.
- Нажмите Новое сопоставление полей.
- Из издания Продукт / Услуга В раскрывающемся списке выберите продукт или услугу QuickBooks, которые необходимо синхронизировать в качестве позиции заказа.
- В Поле Salesforce Для ввода укажите имя API поля Salesforce, содержащего сумму, в следующем формате: ${Salesforce_Field_API_Name}
- Если значение получено из связанного объекта, используйте следующий формат: ${Related_Object_API_Name.Related_Field_API_Name}
- Нажмите Создать сопоставления для сохранения конфигурации.
Сопоставление объектов для товарного чека
- Нажмите Новое сопоставление объектов.
- Из издания Объект QuickBooks В выпадающем списке выберите «Товарный чек».
- Из издания Объект Salesforce В раскрывающемся списке выберите объект, используемый для синхронизации данных товарных чеков. (В этом руководстве по настройке) пожертвование_c выбрано).
- Нажмите Создать сопоставление.
- Нажмите Настройка сопоставления полей для созданного сопоставления объектов.
- Нажмите Новое сопоставление полей.
- В Поле ввода SalesforceВведите значение поля Salesforce, используя следующий формат: ${Salesforce_Field_API_Name}
- Для полей связанных объектов используйте: ${Related_Object_API_Name.Related_Field_API_Name}
- Из издания Поле QuickBooks В выпадающем списке выберите поле QuickBooks, значение которого должно быть синхронизировано.
- Нажмите Создать сопоставления для сохранения конфигурации.
Шаг 3: Потоки Salesforce
Создайте поток обработки, запускаемый записью, для объекта «Пожертвование».
- Перейдите в Установка вкладка в Salesforce.
- В поле быстрого поиска найдите «Потоки».
- Перейдите в Потоки >> Новый поток.
- Выбрать Поток, запускаемый записью.
- Из издания объект выпадающий, выберите Пожертвовать.
- Под Настроить триггер, наведите на Создается запись..
- Прокрутите вниз и включите Добавить асинхронный путь переключиться под Данный процесс осуществляет внешний вызов или подключается к внешней системе?
Добавить элемент потока — создать клиента QuickBooks и способ оплаты
- В Выполнять асинхронно путь, нажмите + значку.
- Найдите и выберите Создание клиента и способа оплаты в QuickBooks.
- Введите этикетка и Имя API.
- Под Установка входных значений В этом разделе настройте следующее:
- ID записи: Выберите идентификатор текущей записи о пожертвовании, которое было активировано.
- Включите Идентификатор записи клиента и выберите поле, ссылающееся на Аккаунт объект
- Включите Название способа оплаты и выберите поле, содержащее способ оплаты.
- Включите Дата транзакции и выберите поле «Дата транзакции пожертвования».
- Нажмите Сохранено Затем нажмите активировать для активации потока.
Создайте поток, запускаемый записью, для ссылки на клиента и способ оплаты в QuickBooks.
- Перейдите в Потоки >> Новый поток .
- Выбрать Поток, запускаемый записью.
- Из издания объект выпадающий, выберите Справочник по клиентам и способам оплаты QB.
- Под Настроить триггер, наведите на Создается запись. опцию.
- Включите Добавить асинхронный путь переключения.
Добавить элемент потока – Создать позиции в товарном чеке
- В Выполнять асинхронно путь, нажмите + значку.
- Найдите и выберите Создание позиций в товарном чеке для QuickBooks.
- Введите этикетка и Имя API.
- Под Установка входных значенийПередайте идентификатор текущей записи, вызвавшей срабатывание, в качестве параметра. Идентификатор записи Salesforce.
Добавить элемент потока — Создание товарного чека в QuickBooks
- Нажмите + Снова нажмите на значок, чтобы добавить еще один элемент потока.
- Найдите и выберите Создание товарного чека в QuickBooks.
- Введите этикетка и Имя API.
- Под Установка входных значений, настройте следующее:
- Идентификатор клиента: Передайте идентификатор клиента QuickBooks из записи «Клиент и способ оплаты» в QuickBooks.
- JSON-данные по позициям заказа: Передайте выходные данные позиций из предыдущего элемента потока.
- Идентификатор записи Salesforce: Передайте идентификатор записи Salesforce из объекта-ссылки.
- Нажмите Сохранено .
- Нажмите активировать для активации потока.
Протестируйте конфигурацию
- Создать новый Пожертвовать запись в Salesforce.
- Процесс запускается автоматически и создает Квитанция продажи в QuickBooks.
- Проверьте запись о пожертвовании в Salesforce и соответствующую запись о товарном чеке в QuickBooks.
Статьи по теме
Спасибо за ваш ответ. Мы свяжемся с вами в ближайшее время.
Что-то пошло не так. Пожалуйста, отправьте запрос ещё раз.
