Как подключить WooCommerce к Dynamics 365 Business Central?
Обзор
WooCommerce помогает управлять вашим интернет-магазином, а Dynamics 365 Business Central объединяет данные о клиентах, товарах, заказах на продажу и счетах-фактурах в одном месте. Многие компании используют обе платформы для обработки онлайн-заказов и управления соответствующими бизнес-записями в Business Central. Когда эти две платформы работают раздельно, командам часто приходится обращаться к нескольким источникам, чтобы понять суть заказа, клиента или продукта. Информация может устаревать, а последующие действия могут занимать больше времени.
Мини-Апельсин Интеграция плагина Dynamics 365 CRM Этот инструмент объединяет WooCommerce и Business Central, обеспечивая упорядоченное и понятное перемещение информации. После настройки заказы WooCommerce могут создавать заказы на продажу в Business Central, товары могут импортироваться из Business Central в WooCommerce, а клиенты могут быть зарегистрированы как учетные записи WordPress. Вы также можете обновлять статус заказа WooCommerce после выставления счета в Business Central.
В этом руководстве сначала мы рассмотрим подключение к Business Central. После этого вам нужно будет настроить каждый элемент на вкладке «Синхронизация WooCommerce».
Предварительные условия: Загрузка и установка.
Прежде чем настраивать синхронизацию WooCommerce с Business Central, убедитесь, что у вас есть следующее:
- Доступ к клиенту Microsoft Entra, связанному с вашей учетной записью Business Central.
- Разрешение на регистрацию приложения в Microsoft Entra ID.
- Административный доступ к Business Central.
- Получите доступ к среде Business Central, которую вы хотите подключить.
- Разрешение на создание и настройку приложения Microsoft Entra в Business Central.
- miniOrange Интеграция плагина Dynamics 365 CRM установлен и активирован на вашем сайте WordPress.
- На том же сайте WordPress установлен и активно используется WooCommerce.
Шаги настройки
Шаг 1: Настройка подключения к Business Central
Выполните эту настройку один раз, прежде чем настраивать какой-либо элемент на вкладке «Синхронизация WooCommerce». Она состоит из трех частей. Во-первых, зарегистрируйте приложение в Microsoft Entra ID. Затем предоставьте этому приложению доступ к Business Central. После этого введите учетные данные в плагине.
Зарегистрируйте приложение в Microsoft Entra ID
- Войдите в Центр администрирования Microsoft Entra.
- Перейдите на Регистрация приложений и нажмите Новая регистрация.
- Введите название приложения и нажмите Зарегистрировать филиал.
Создать секрет клиента
- Откройте приложение, в котором вы только что зарегистрировались.
- Перейдите на Сертификаты и секреты и нажмите Секрет нового клиента.
- Введите Описание и выберите Истечет, затем нажмите Добавить.
- Скопируйте сгенерированное секретное значение. Оно понадобится вам позже в плагине.
Настройка разрешений API
- Перейдите на Разрешения API, нажмите Добавить разрешение, а затем выберите API Microsoft.
- Выбрать Dynamics 365 Business Central.
- Выбрать Разрешения приложений.
- Выберите необходимые разрешения, например: Автоматизация.ЧтениеЗапись.Всеи нажмите Добавить разрешение.
Согласие администратора гранта
- На Разрешения API страница, нажмите Предоставить согласие администратора и подтвердите.
- Теперь в разделе разрешений должен отображаться статус. Предоставленный.
Настройте приложение в Business Central.
- В Business Central выполните поиск Приложения Microsoft Entra и нажмите Новое.
- Введите Идентификатор приложения (клиента) из Microsoft Entra добавить Описаниеи установить Область в Включено.
- Под Наборы разрешений пользователей, добавлять Автобус D365 с полным доступом и выберите свою компанию.
Настройте плагин
- В административной панели WordPress откройте miniOrange Интеграция плагина Dynamics 365 CRM.
- Перейдите на сайт Управление приложением вкладка, набор Тип соединения в Бизнес-центри нажмите Сохранено.
- Под Настройка арендатора и среды, введите Идентификатор арендатора и Имя среды, затем нажмите Сохранено.
Примечание: Введите точное имя среды, отображаемое в Центре администрирования Business Central. В URL-адресе Business Central это значение, которое отображается сразу после идентификатора клиента, например, Testing . Не вводите тип среды, например, Sandbox или Production.
- Под Настройка соединения, введите Идентификатор приложения (клиента) и Секрет клиента, затем нажмите Сохранено.
- Под Проверьте соединение и выберите компанию., нажмите Проверить подключение и выберите компанию.
После выполнения описанных выше шагов соединение между WordPress и Business Central успешно установлено. Теперь вы можете настроить вкладку синхронизации WooCommerce.
Прежде чем ты начнешь
Схема
- Строка состояния в верхней части Синхронизация WooCommerce На вкладке отображается информация о том, загружена ли схема Business Central.
- Нажмите Обновить схему после публикации новой сущности или поля в Business Central.
Типы поверхностей сущностей
Для некоторых плиток необходимо выбрать способ доступа плагина к сущности Business Central.
Вы можете выбрать один из трех вариантов:
- Стандартная сущность (современный API/v2.0): Подключается к встроенному REST API Business Central. Выберите этот параметр, если необходимая сущность доступна через стандартный API.
- Пользовательская сущность API: Подключается к пользовательскому API, опубликованному в Business Central. Введите Издатель, В группе, Версия API и Название набора сущностей.
- Классический веб-сервис (OData v4): Подключается к сущности, опубликованной в качестве веб-сервиса Business Central. Введите Имя службы для настройки соединения.
Как работает картирование полей
Для сопоставления значений с полями Business Central в полях Customer Mapping , Order Mapping и Customer Provisioning используется один и тот же процесс. Для каждого поля выберите тип сопоставления и укажите необходимое значение:
- Поле WooCommerce: Сопоставляет значение из поля заказа или поля клиента WooCommerce.
- Статическое значение: Добавляет одно и то же фиксированное значение при каждой синхронизации.
- Поиск и разрешение через сущность: Сопоставляет идентификатор записи Business Central уже синхронизированного клиента или продукта.
Примечание: В таблице всегда отображаются все три строки ввода. Заполните только ту строку, которая соответствует выбранному типу сопоставления . Каждое поле Business Central может иметь только одно сопоставление. Чтобы изменить существующее сопоставление, сначала удалите его, а затем добавьте новое.
Шаг 2: Ключ для поиска товара
Плитка «Ключ поиска товара» определяет, как товары в позициях заказа WooCommerce сопоставляются с существующими товарами в Business Central. Она не создает и не обновляет товары.
- Выберите поверхность объекта и заполните соответствующие поля, затем нажмите кнопку. Сохранено.
- До Стандартная организацияВыберите целевой объект из выпадающего списка.
- До Пользовательская сущность API, войти Издатель, В группе, Версия API и Название набора сущностей.
- До Классический веб-сервис, введите Имя службы, Такие, как Параметр.
- Выберите Основной ключ (обязательно) и Вторичный ключ (Дополнительный резервный вариант). Используйте только поля с обычными значениями для обоих ключей.
Примечание: Если для позиции заказа нет аналога, синхронизация всего заказа пропускается.
Шаг 3: Составление карты клиента
Вкладка «Сопоставление клиентов» сопоставляет каждый заказ WooCommerce с существующим клиентом в Business Central. Если подходящий клиент не найден, плагин может создать новую запись о клиенте.
- Настройте целевую сущность, используя стандартную сущность, пользовательскую сущность API или классический веб-сервис, затем нажмите Сохранено.
- Установить Основной ключ и, при необходимости, Вторичный ключ Таким образом, заказы можно сопоставлять, например, с существующим клиентом Business Central по электронной почте.
- Держите Если совпадение не найдено, создайте новую запись о клиенте. Переключатель выбран (по умолчанию включен). При необходимости измените настройку, затем нажмите. Сохранено.
Примечание: Если вы не хотите, чтобы плагин создавал клиентов, оставьте эту опцию отключенной.
- Под Сопоставление полейсопоставьте поля Business Central, используя Поле WooCommerce, Статическое значение или ПоискВ разделе «Поля WooCommerce» представлены поля для выставления счетов WooCommerce как для заказов гостей, так и для заказов зарегистрированных пользователей.
Шаг 4: Сопоставление заказов
Вкладка «Сопоставление заказов» создает новый заказ на продажу в Business Central для каждого синхронизируемого заказа WooCommerce. В отличие от «Ключа поиска товара» и «Сопоставления клиентов», эта вкладка не требует соответствующего ключа.
Заголовок заказа
- Настройте целевой объект и нажмите Сохранено.
- Сопоставьте необходимые поля, такие как платежные и адресные данные. Номер для заказа, Примечание клиента, Валюта ордера и Порядок Дата.
- Пользовательский ИД поле автоматически сопоставляется с Поиск и решение проблем через клиента..
Позиции заказа
Раздел «Позиции заказа» появляется после сохранения целевого объекта «Заголовок заказа».
- Настройте целевой объект, затем нажмите Сохранено.
- Сопоставьте необходимые поля, такие как Наименование, SKU, Количество, Line Subtotal, Итого по строке, Сумма налога за строку, Цена за ед и Сумма скидки.
- itemId поле автоматически сопоставляется с Поиск, разрешение проблем через продукт.
Синхронизирующий триггер
Этот раздел появляется после сохранения целевого объекта заголовка заказа.
- Выберите один или несколько статусов заказа для запуска синхронизации: В ожидании оплаты, Переработка, На удерживании или Завершена.
- На шаге 6 вы можете запустить или остановить синхронизацию в реальном времени: Управление синхронизацией заказов.
Шаг 5: Проверка синхронизации заказа
Плитка «Тестовая синхронизация заказов» позволяет синхронизировать отдельный заказ WooCommerce и проверить сопоставление полей перед началом синхронизации в реальном времени.
- Представляем WooCommerce Код заказа и нажмите Запустить тестовую синхронизацию.
- Результат может быть Успех (Отображается номер заказа на продажу в системе Business Central), Пропущено (заказ уже синхронизирован), или Отменено (Отображается причина сбоя синхронизации).
Тест запускается немедленно, независимо от того, запущена ли синхронизация в реальном времени или остановлена на шаге 6: Управление синхронизацией заказов.
Примечание: Перед применением к рабочему магазину протестируйте свою конфигурацию на тестовых данных. Запуск тестов в песочнице Business Central поможет избежать влияния тестовых данных на ваши рабочие записи.
Шаг 6: Управление синхронизацией заказов
Плитка «Управление синхронизацией заказов» управляет синхронизацией заказов в режиме реального времени. Сохранение настроек или запуск тестовой синхронизации на шаге 5: «Тестовая синхронизация заказов» не запускает синхронизацию в режиме реального времени.
- Нажмите Запуск синхронизации в реальном времени Для начала. После запуска синхронизации кнопка изменится на Остановить синхронизацию в реальном времении статус показывает Бег or Остановлена.
- Во время синхронизации заказы автоматически синхронизируются при переходе в один из статусов, выбранных в разделе Синхронизирующий триггер на шаге 4: Сопоставление заказов.
Шаг 7: Импорт товаров из Business Central
Плитка «Импорт товаров из Business Central» импортирует товары из Business Central в WooCommerce и сопоставляет их с помощью настроенного артикула (SKU). Сначала настройте шаг 2: «Ключ поиска товара» , поскольку эта плитка использует ту же целевую сущность и первичный ключ.
Сопоставления полей
- Сопоставьте необходимые поля продукта, включая: Наименование, Обычная Цена, Описание, Количество на складе, Изображение продукта и Категория продукта.
- Выберите подходящий Поле D365 для каждого сопоставления. Плагин автоматически сохраняет изменения в этом выделении.
- Карта Изображение продукта для сопоставления с изображением или полем навигации, а для всех остальных сопоставлений выберите поля с обычными значениями.
Категория товара (перевод ценности)
- Поставьте трансформация в Замещение стоимостиПри желании можно добавить Отступать значение, затем нажмите Сохранено.
- Включите Автоматический поиск, затем введите Имя сущности, Поле кода и Поле описания. Нажмите Обновить сейчас для получения значений кода и описания.
- Под Ручной резервный вариантдобавить вручную Значение BC в Название категории сопоставления. Плагин применяет эти сопоставления только в том случае, если автоматический поиск не может определить значение.
B2BKing Visibility Mapping
- Убедитесь, что плагин B2BKing активен.
- Поставьте трансформация в B2BKing Visibility Mapping, затем нажмите Сохранено.
- Карта а Идентификатор атрибута BC к Группа клиентов B2BKing, затем нажмите Добавить сопоставление.
- Плагин включает сопоставленную группу клиентов, когда значение разрешенного атрибута равно... Да.
Источник значения атрибута элемента
- Выбрать Включить поиск значений атрибутов элемента.
- На шаге 1 введите Surface, Имя сущности, Поле элемента, Поле идентификатора атрибута и Поле идентификатора значения.
- На шаге 2 введите Surface, Имя сущности, Поле идентификатора атрибута, Поле идентификатора значения и Текстовое поле значения.
- Нажмите Сохранено.
Надбавка за опасные химические вещества
- Выбрать Включить синхронизацию надбавки за опасные химические вещества.
- Введите Идентификатор атрибута BC, затем нажмите Сохранено.
- Плагин назначает надбавка за опасные химические вещества класс доставки, когда полученное значение точно равно LQ.
Маркетинговый текст – описание
- Выбрать Включить синхронизацию маркетинговых сообщений.
- Введите Surface, Имя сущности, Поле элемента и Текстовое поле, затем нажмите Сохранено.
- Если поле «Маркетинговый текст» содержит значение, оно переопределяет сопоставление поля «Описание».
Импорт одного товара
- Введите значение поля «SKU» в настройках, затем нажмите кнопку. Импортировать сейчас.
- Результат может быть Создано, обновлено, Пропущено или Oшибка с сообщением об ошибке.
Массовая синхронизация
- Нажмите Начать массовую синхронизацию Чтобы начать импорт товаров оптом, во время синхронизации вы можете пауза, Продолжить или Сброс Сброс требует подтверждения и не затрагивает уже импортированные товары.
- Отслеживайте синхронизацию с помощью подробной информации о ходе выполнения, которая отображает текущий статус, запланированные, завершенные и ожидающие записи, а также количество созданных, обновленных и пропущенных записей, предполагаемое время завершения и обратный отсчет до следующего прохода.
- Выберите интервал ожидания между проходами: 15 минут, 30 минут, ежечасно, каждые 6 часов или ежедневно. Затем нажмите Сохранено.
Шаг 8: Предоставление доступа клиентам (перенос клиентов Business Central в WordPress)
Плитка «Создание учетных записей клиентов» создает или обновляет учетные записи WordPress на основе записей клиентов Business Central. Она работает независимо от сопоставления клиентов на шаге 3 и не зависит от заказа.
- Настройте исходную сущность, используя стандартную сущность, пользовательскую сущность API или классический веб-сервис, затем нажмите Сохранено.
- Выберите Поле уникального идентификатора, Такие, как Номер клиента, затем нажмите Сохранено.
Поля учетной записи WordPress
- Нажмите + Добавить атрибут Для сопоставления полей учетной записи WordPress с полями Business Central. Доступные поля включают: Имя, Фамилия, Никнейм, Display Name, Bio, Вебсайт, Эл. адрес и Имя пользователя.
- Плагин применяет Имя пользователя Только при создании новой учетной записи, если она впоследствии не обновляется.
Поля для ввода платежного адреса в WooCommerce
- Сопоставьте поля платежного адреса WooCommerce, используя тот же метод сопоставления полей.
- Плагин сопоставляет эти поля только с основным адресом карточки клиента в Business Central. Он не извлекает значения из адреса доставки.
Адреса доставки и выпадающее меню оформления заказа Koala.
- Настройте поверхность объекта для Адрес доставки.
- Установить Поле, ведущее обратно к клиенту. и Поле «Код адреса», затем нажмите Сохранено.
- При использовании классического веб-сервиса плагин автоматически заполняет таблицу сопоставления Koala после того, как будут заданы оба поля ссылок. Перед продолжением проверьте сопоставления.
- На карте отображаются фиксированные поля Koala, включая Имя, O компании, Страна, Область, Адрес 1, Адрес 2, Город, Почтовый индекс, Телефон и Эл. адресв соответствующие поля Business Central. Вы также можете нажать Автоматическое сопоставление оставшихся полей, затем нажмите Сохранено.
- Если оба Имя и Фамилия При сопоставлении с тем же полем в Business Central плагин автоматически разделяет объединенное значение "Имя".
Отправить электронное письмо с инструкциями по настройке учетной записи
- Включите переключатель, чтобы отправлять электронное письмо с инструкциями по настройке учетной записи при создании плагином новой учетной записи клиента. Этот параметр выбран по умолчанию и применяется только к вновь созданным учетным записям.
Предоставление услуг одному клиенту
- Введите значение идентификатора клиента и нажмите Импортировать сейчас.
- Результат будет Создано, обновлено, Пропущено (отсутствие идентификатора, недоступного адреса электронной почты или конфликт адресов электронной почты) или сбой с ошибкой.
Массовая синхронизация
- Нажмите Начать массовую синхронизацию Для начала. Нажмите Сброс Для остановки паса в движении. Эта кнопка не включает функции «Пауза» или «Возобновление», а для сброса требуется подтверждение.
- Индикатор выполнения соответствует процессу импорта товара.
Каких клиентов импортировать
- Для работы этого фильтра требуется Поле уникального идентификатора это будет числовое поле клиента.
- Выберите Группы для размещения объявлений общего характера Включить. Если вы не выберете ни одной группы, плагин импортирует всех клиентов. Нажмите Сохранено.
- Под Расширенная фильтрацияПри необходимости введите исходное выражение фильтра Business Central. Плагин применит последний сохраненный фильтр.
Ожидание между завершенными проходами
- Выберите один из тех же вариантов интервала, что и в разделе «Импорт продукта». Это расписание выполняется независимо.
Шаг 9: Синхронизация статуса заказа
Плитка «Синхронизация статуса заказа» обновляет статус заказа WooCommerce после того, как Business Central помечает соответствующий заказ как выставленный счет. Она работает в обратном направлении по сравнению с сопоставлением заказов на шаге 4, поэтому сначала настройте шаг 4.
Субъект счета-фактуры продажи
- Настройте сущность «Счет-фактура» с помощью стандартной сущности, пользовательской сущности API или классического веб-сервиса.
Сопоставление статусов
- Выберите статус WooCommerce, который будет применяться при выставлении счета в Business Central. По умолчанию используется статус WooCommerce. Завершена. Нажмите Сохранено.
Проверить интервал
- Настройте частоту проверки плагином наличия выставленных счетов в Минут or ЧасовПо умолчанию установлено 30 минут. Нажмите Сохранено.
Проверить отдельный заказ
- Введите WooCommerce Код заказа, затем нажмите Узнать сейчас.
- Плагин отображает тот же пошаговый трассировочный вывод, что и Test Order Sync, и заканчивается либо... Успех или Отменено результат, имеющий обоснование.
Управление синхронизацией
- Нажмите Начать синхронизацию статуса заказа or Синхронизация статуса стоп-ордера Переключатель позволяет управлять синхронизацией. Статус показывает, выполняется ли синхронизация. Бег or Остановлена.
Необходимо провести проверку руководства по потребностям.
- В этом списке отображаются до 50 заказов, которые плагин не смог найти в разделе «Заказы на продажу» или «Счета-фактуры» в Business Central.
- Нажмите Принять Удалить заказ из списка задач. Это не меняет статус заказа.
Вы успешно настроили синхронизацию WooCommerce для Dynamics 365 Business Central.
Шаг 10: Проверка и тестирование
После завершения настройки запустите тест, чтобы убедиться в корректности передачи данных:
- Импортируйте один товар из Business Central и убедитесь, что он отображается в WooCommerce с ожидаемыми значениями.
- Создайте учетную запись для одного клиента и убедитесь, что данные учетной записи WordPress и платежные реквизиты соответствуют настроенным сопоставлениям.
- Создайте или выберите образец заказа WooCommerce, а затем запустите его. Синхронизация тестового заказаУбедитесь, что Business Central создает заказ на продажу с указанием ожидаемого клиента, товаров и стоимости позиций.
- Если синхронизация статуса заказа включена, выставьте счет за тестовый заказ в Business Central и нажмите кнопку. Узнать сейчас чтобы подтвердить, что WooCommerce обновляет статус заказа.
- Если данные отображаются не так, как ожидалось, проверьте сопоставление полей, настройки поверхности сущностей, разрешения API и выбор компании. После внесения изменений повторно проверьте соединение.
Примечание: Всегда проводите тестирование с использованием тестовых данных, прежде чем переносить изменения на рабочий сайт. Выполнение проверок в песочнице Business Central снижает риск влияния на рабочие записи.
Часто задаваемые вопросы (FAQ)
Дополнительные часто задаваемые вопросы ➔Можно ли синхронизировать заказы WooCommerce с Dynamics 365 Business Central?
Да, настройка синхронизации WooCommerce в плагине miniOrange Integrate Dynamics 365 CRM позволяет синхронизировать данные заказов WooCommerce с Business Central. Вы можете настроить сопоставление полей и автоматически отправлять заказы в Business Central.
Создаются ли товары в Business Central при синхронизации заказа?
Нет, ключ поиска товара сопоставляет только позиции заказа WooCommerce с существующими товарами в Business Central. Если плагин не может найти соответствующий товар, он пропускает синхронизацию заказа. Для импорта товаров в WooCommerce настройте импорт товаров из Business Central.
Включает ли сохранение настроек синхронизацию заказов в режиме реального времени?
Нет, сохранение сопоставлений полей или запуск тестовой синхронизации заказов не запускают синхронизацию в реальном времени. После проверки конфигурации перейдите в раздел «Управление синхронизацией заказов» и нажмите «Запустить синхронизацию в реальном времени».
Можно ли создавать пользователей WordPress из числа клиентов Business Central?
Да, функция Customer Provisioning позволяет создавать или обновлять учетные записи WordPress непосредственно из записей клиентов Business Central. Этот процесс работает независимо от функции Customer Mapping, которая сопоставляет или создает клиента Business Central при синхронизации заказа WooCommerce.
Статьи по теме
Спасибо за ваш ответ. Мы свяжемся с вами в ближайшее время.
Что-то пошло не так. Пожалуйста, отправьте запрос ещё раз.

Регистрация