Dynamics 365 Business CentralでShopify Connectorを使っている場合、今回の「Dynamics 365 documentation update: Correct Shopify customer and company mapping type option names to match BC UI captions」は、機能追加や仕様変更ではなく、Microsoft Learnの説明文にある選択肢名をBusiness Centralの画面表示に合わせるためのドキュメント修正です。
結論から言うと、Shopify連携の同期ロジック、マッピング方式、移行手順そのものが変わる更新ではありません。ただし、管理者向け手順書、社内マニュアル、検証項目、画面キャプチャ、問い合わせ対応テンプレートでは、「By Email/Phone」と「By EMail/Phone」のような表記差が原因で混乱しやすくなります。特にShopifyの顧客・会社データをBusiness Centralへ取り込む運用では、設定名を正確にそろえておくことが重要です。
Dynamics 365 documentation updateは何が変わったのか
今回の更新は、MicrosoftDocsのDynamics 365 SMBドキュメントリポジトリにあるPull Requestとして、2026年5月20日にmainブランチへマージされました。対象ファイルはBusiness CentralのShopify Connectorに関する「Synchronize customers and companies」のドキュメントで、GitHub上では1ファイルに対して4件の追加・4件の削除が確認できます。(GitHub)
修正の目的は、Shopifyの顧客マッピングと会社マッピングの説明に出てくるオプション名を、Business CentralのUIキャプションと一致させることです。PRの説明では、Business Central側のAL EnumであるShpfyCustomerMapping.Enum.alとShpfyCompanyMapping.Enum.alに対して確認された内容として、顧客・会社の両方で選択肢名がUI表示と一致していなかったことが示されています。(GitHub)
重要なのは、これは「設定値の意味が変わった」更新ではなく、「画面に表示される選択肢名とドキュメントの表記を合わせた」更新だという点です。したがって、既存のShopify Connector設定を急いで変更する必要は通常ありません。ただし、社内文書や運用手順で旧表記を使っている場合は、現場の画面確認時に迷いが出ないよう修正しておくべきです。
修正されたオプション名の違い
今回のポイントは、英単語として自然かどうかではなく、Business CentralのUIキャプションと一致しているかです。特にEMailの大文字小文字は、一般的な英語表記のEmailとは異なるため、手順書を作る人ほど見落としやすい箇所です。
| 対象 | 旧ドキュメント表記 | 修正後の表記 | 実務上の見方 |
|---|---|---|---|
| Customer Mapping Type | By Email/Phone | By EMail/Phone | UI上の表記に合わせる。Emailへ独自に直さない |
| Customer Mapping Type | Always Take the Default Customer | Always take the default customer | 文頭以外を小文字にしたsentence case |
| Company Mapping Type | By Email/Phone | By EMail/Phone | 顧客側と同じくEMail表記 |
| Company Mapping Type | Always Take the Default Company | Always take the default Company | CompanyのCは大文字のまま |
Microsoft Learnの該当ページでも、DTC顧客の取り込み設定ではCustomer Mapping Typeの選択肢としてBy EMail/Phone、By Bill-to Info、Always take the default customerが説明されています。B2B会社の取り込み設定では、Company Mapping Typeの選択肢としてBy EMail/Phone、Always take the default Company、By Tax IDが説明されています。(Microsoft Learn)
影響範囲はShopify Connectorの顧客・会社マッピング
Dynamics 365 Business CentralのShopify Connectorは、ShopifyストアとBusiness Centralを連携し、商品、在庫、注文、顧客、会社などの同期を扱う機能です。Microsoft Learnでは、顧客と会社の双方向同期、電話番号やメールによる顧客マッピング、税番号・登録番号によるB2B会社マッピングなどが機能として説明されています。(Microsoft Learn)
今回のドキュメント修正で主に影響を受けるのは、以下のような人です。
| 対象者 | 影響を受ける場面 | 確認すべきこと |
|---|---|---|
| Business Central管理者 | Shopify Shop Cardや同期設定を確認する場面 | 画面の選択肢名と手順書の表記が一致しているか |
| EC運用担当者 | Shopifyから顧客・会社を取り込む運用 | どのマッピング方式を使っているか |
| 開発者・パートナー | AL拡張、テスト、運用ドキュメント整備 | UIキャプションを文字列比較に使っていないか |
| サポート担当者 | 問い合わせ対応、画面案内、FAQ作成 | 「Email」と「EMail」の表記ゆれを説明できるか |
| 情シス・PM | 本番展開、教育、移行リハーサル | 既存手順書・チェックリストの表記更新 |
特に注意したいのは、選択肢名を「意味」で理解している管理者よりも、画面の文字列をそのまま探す初心者や運用代行チームのほうが混乱しやすい点です。手順書に「By Email/Phoneを選択」と書かれていて、画面には「By EMail/Phone」と表示されていると、慣れていない担当者は別の設定だと誤解する可能性があります。
管理者が確認すべきBusiness Centralの設定
今回の更新を受けて、管理者がまず確認すべきなのは、既存の同期設定を変更することではありません。優先すべきは、現在どのマッピング方式を採用しているかを確認し、運用資料の表記を画面表示に合わせることです。
DTC顧客のCustomer Mapping Typeを確認する
DTC、つまり一般消費者向けのShopify注文や顧客情報をBusiness Centralへ取り込む場合、Customer Mapping Typeの設定が重要です。Microsoft Learnでは、Shopifyから顧客を一括インポートする場合や、注文インポート時に顧客情報を取り込む場合に、この設定がマッピング方法を決めると説明されています。(Microsoft Learn)
主な選択肢の意味は次のとおりです。
| 選択肢 | 使う場面 | 注意点 |
|---|---|---|
| By EMail/Phone | メールアドレスや電話番号でShopify顧客とBusiness Central顧客を照合したい場合 | メール・電話の重複や未入力があると期待通りに一致しないことがある |
| By Bill-to Info | 請求先住所情報を使って既存顧客へマッピングしたい場合 | 住所表記ゆれ、法人名表記ゆれの影響を受けやすい |
| Always take the default customer | すべての注文を既定顧客に紐づけたい場合 | 顧客別売上分析や個別与信管理には向きにくい |
Shopify Can Update Customersを有効にしている場合、該当するマッピング方式で見つかった顧客をコネクタが更新するため、既存顧客マスタをShopify側の情報で更新してよいかを確認しておく必要があります。Microsoft Learnでは、この設定がBy EMail/PhoneまたはBy Bill-to Info選択時に見つかった顧客の更新に関係すると説明されています。(Microsoft Learn)
また、Auto Create Unknown Customersを使う場合は、Shopify顧客に少なくとも1つの住所が必要です。Shopify POS経由の注文では住所情報が不足することがあるため、自動作成を有効にしない場合は、手動で顧客を作成してShopify顧客へリンクする必要があります。(Microsoft Learn)
B2B会社のCompany Mapping Typeを確認する
B2B運用では、Shopifyの会社情報とBusiness Centralの顧客エンティティの関係を理解しておく必要があります。Shopifyにはcustomerとcompanyの2つのエンティティがありますが、Business Central側ではcustomerエンティティを中心に扱うため、同期時のマッピング設計が重要になります。Microsoft Learnでは、B2BではShopify customerがcompanyにリンクされ、Business Central側ではShopify customerとShopify companyが取り込まれ、顧客へリンクまたは変換されると説明されています。(Microsoft Learn)
Company Mapping Typeの主な選択肢は次のとおりです。
| 選択肢 | 使う場面 | 注意点 |
|---|---|---|
| By EMail/Phone | 会社のメインコンタクトのメール・電話で照合したい場合 | メインコンタクトの情報品質が低いと照合精度が下がる |
| Always take the default Company | 既定の会社顧客を使いたい場合 | 会社別の取引管理を重視する場合は慎重に使う |
| By Tax ID | 税番号などの税務情報で会社を照合したい場合 | Company Tax ID Mappingの保存先設定も合わせて確認する |
B2B会社の取り込みでは、会社にメインコンタクトがない場合はコネクタが会社をスキップします。また、顧客作成・更新時には最も古いロケーションが情報元として使われ、インポートされるのはメインコンタクトのみです。(Microsoft Learn)
この仕様を踏まえると、B2Bのマッピング確認では、単にCompany Mapping Typeの表示名を確認するだけでは不十分です。Shopify側で会社にメインコンタクトが設定されているか、税番号をどこに保存するか、会社ロケーションの情報がBusiness Centralの顧客マスタに反映されても問題ないかまで確認する必要があります。
今回の更新で「変更しなくてよい」もの
このドキュメント更新を、製品アップデートや移行作業と混同しないことが大切です。GitHubのPRはMicrosoftDocsのドキュメントファイルを修正するものであり、確認できる範囲ではBusiness Central本体の同期処理、Shopify ConnectorのAPI仕様、データベース構造、既存設定値の変換を伴う変更ではありません。(GitHub)
そのため、通常は次の対応は不要です。
| 項目 | 対応要否 | 理由 |
|---|---|---|
| 既存のCustomer Mapping Typeを変更する | 原則不要 | 選択肢の意味が変わったわけではない |
| 既存のCompany Mapping Typeを変更する | 原則不要 | ドキュメント表記の整合性修正が中心 |
| データ移行を実施する | 不要 | 顧客・会社データの構造変更ではない |
| Shopify連携を停止する | 通常不要 | 本番同期の停止を要する更新ではない |
| 拡張機能を即時改修する | 条件付き | UI文字列を直接参照している場合のみ点検が必要 |
ただし、画面キャプチャ付きの操作マニュアル、研修資料、サポートFAQ、テスト仕様書では、旧表記のままだと問い合わせや作業ミスにつながります。特に「By Email/Phone」で社内文書検索している場合は、「By EMail/Phone」も検索対象に追加して修正漏れを防ぐとよいでしょう。
開発者・パートナーが確認すべきポイント
開発者や導入パートナーは、単にドキュメント名を直すだけでなく、実装やテストでUIキャプションに依存していないかを確認してください。
UI表示名をロジックの判定に使っていないか
避けたいのは、画面表示名の文字列をそのまま条件分岐に使う実装です。たとえば、テスト自動化や運用スクリプトで「By Email/Phone」という表示テキストを探している場合、Business CentralのUIが「By EMail/Phone」であれば検出に失敗する可能性があります。
望ましい考え方は次のとおりです。
| 確認対象 | 避けたい例 | 推奨される考え方 |
|---|---|---|
| 自動テスト | 画面文字列By Email/Phoneに完全一致させる | 可能なら内部値、フィールド、安定した識別子を使う |
| 手順書生成 | 旧ドキュメントの文言をそのまま再利用する | 現行UIに合わせて表記を確認する |
| サポート回答 | 「Email/Phoneを選んでください」と曖昧に案内する | 画面上はBy EMail/Phoneと表示されると明記する |
| 翻訳・ローカライズ | 英語UIの表記を独自に自然な英語へ修正する | 製品UIのキャプションを優先する |
特にEMailは、英語として自然なEmailに直したくなる表記です。しかし今回の修正意図は、自然な英語表記への統一ではなく、Business CentralのUIキャプションとの一致です。社内資料では「誤字のように見えるが、画面ではこの表記」と注記しておくと、レビュー時の不要な修正を防げます。
AL拡張やイベント購読の確認
今回のPR自体はドキュメント修正ですが、Shopify Connector周辺をカスタマイズしている環境では、念のため次の点を確認しておくと安全です。
| 確認項目 | 見るべき場所 | 判断基準 |
|---|---|---|
| 顧客マッピング方式の参照 | AL拡張、テストコード、設定移行スクリプト | UIキャプションではなくEnum値や安定した値で扱っているか |
| エラー説明の文言 | サポートツール、FAQ、問い合わせテンプレート | 現行UIの選択肢名と一致しているか |
| E2Eテスト | Playwright、Selenium、RSAT相当の画面操作テスト | 旧表記に完全一致して失敗しないか |
| 教育コンテンツ | 導入手順書、動画台本、画面キャプチャ | By EMail/Phoneの表記になっているか |
| 変更管理 | リリースノート、展開チェックリスト | 「仕様変更」と誤記していないか |
実装面で最も避けたいのは、「今回の更新で機能が変わった」と誤解して不要な設定変更を行うことです。ドキュメント更新をきっかけに設定を見直すのは有効ですが、変更理由を「UI表記の整合性確認」と「業務上のマッピング方針の見直し」に分けて管理しましょう。
展開・移行時のチェックリスト
本番環境でShopify Connectorを運用している場合、今回のような小さな表記修正でも、展開作業や教育資料では確認漏れが起きがちです。以下の順番で確認すると、作業範囲を広げすぎずに対応できます。
| 順番 | 作業 | 確認ポイント |
| -: | —————- | —————————————————————————————— |
| 1 | 現在の設定を確認 | Customer Mapping TypeとCompany Mapping Typeの選択値を記録する |
| 2 | 社内資料を検索 | By Email/Phone、Always Take the Default Customer、Always Take the Default Companyを検索する |
| 3 | 表記を修正 | 画面表示に合わせてBy EMail/Phoneなどへ更新する |
| 4 | 手順書のスクリーンショットを確認 | 旧UI表記や旧説明文が残っていないかを見る |
| 5 | テスト項目を更新 | 文字列完全一致のテストが旧表記に依存していないか確認する |
| 6 | 運用チームへ共有 | 「仕様変更ではなく表記整合」と明記して周知する |
| 7 | 必要に応じて同期ログを確認 | 顧客・会社の取り込み結果に想定外の更新や自動作成がないか見る |
トラブルシューティング時は、Shopify Shop Cardでバックグラウンド実行をオフにして同期を前景実行し、エラー発生時に詳細をコピーして確認できます。また、Logging Modeではエラーのみ、またはリクエスト・レスポンスを含む詳細ログを取得する設定が用意されています。詳細ログを常時有効にするとBusiness Centralの負荷やログ量に影響するため、調査時に限定して使うのが現実的です。(Microsoft Learn)
ありがちな誤解と対処法
「By EMail/Phone」は誤字だから直してよい？
社内資料で自然な英語表記に整える目的ならEmailと書きたくなりますが、操作手順では画面表示と一致させるほうが安全です。今回のPRは、まさにBusiness CentralのUIキャプションに合わせるための修正です。(GitHub)
実務では、次のように書くと混乱を避けられます。
Customer Mapping Typeでは、画面に表示される
By EMail/Phoneを選択します。一般的な英語表記の
今回の更新で顧客の自動作成ルールは変わった？
確認できる範囲では、顧客の自動作成ルールが変わった更新ではありません。Auto Create Unknown Customersは、By EMail/PhoneまたはBy Bill-to Infoを使う場合に不足顧客を作成する設定として説明されています。作成時にはShopify Shop CardまたはShopify Customer Templateページで定義されたテンプレートが使われ、Shopify顧客には少なくとも1つの住所が必要です。(Microsoft Learn)
つまり、見直すべきなのは「表記」と「現在の運用が意図に合っているか」です。自動作成を使っている場合は、Customer Template Code、国・地域別の顧客設定、税関連項目が正しく設定されているかをあわせて確認しましょう。
会社マッピングでも顧客が作成されるのはなぜ？
Business Central側では、Shopifyの会社情報もBusiness Centralの顧客エンティティへリンクまたは変換される流れで扱われます。Microsoft Learnでも、Shopifyにはcustomerとcompanyがある一方、Business Centralにはcustomerエンティティがあるため同期の仕組みに影響すると説明されています。(Microsoft Learn)
そのため、B2B会社の設定では、Company Mapping Typeだけでなく、既定会社番号、税番号の保存先、顧客/会社テンプレート、メインコンタクトの有無までセットで確認する必要があります。
今回の更新をきっかけに見直したい運用設計
この更新は小さな表記修正ですが、Shopify Connectorの運用設計を見直すよいタイミングです。特に、顧客や会社のマッピングは売上計上、請求、税計算、与信、顧客別分析に影響するため、単なる同期設定として軽く扱わないほうがよい領域です。
既定顧客を使うか、個別顧客を作るか
Always take the default customerやAlways take the default Companyは、運用をシンプルにしたい場合に便利です。一方で、すべての注文が既定顧客へ集約されると、顧客別の購買履歴や法人別の売上分析はしにくくなります。
判断基準は次のように整理できます。
| 方針 | 向いている運用 | 向いていない運用 |
|---|---|---|
| 既定顧客を使う | ゲスト購入が多い、会計処理を簡素化したい、小規模DTC | 顧客別分析、個別請求、与信管理を重視する |
| 個別顧客を作成・更新する | CRM連携、リピート分析、法人別管理を重視する | マスタ重複を避ける体制がない |
| 税番号でB2B会社を照合する | 法人取引、税務情報を重視するB2B | 税番号の入力品質が低い、国ごとの運用差が大きい |
現場でよくある失敗は、「まずは既定顧客で簡単に始める」方針のまま本格運用に入り、後から顧客別分析ができないことに気づくケースです。Shopify連携を本番展開する前に、受注処理だけでなく、請求、会計、分析、サポート対応まで含めてマッピング方針を決めておきましょう。
自動作成を有効にする前にテンプレートを確認する
顧客や会社を自動作成する場合、テンプレートの設定品質がそのまま作成データの品質になります。Microsoft Learnでは、自動作成に使うテンプレートにはGen. Business Posting Group、Customer Posting Group、VATや税関連フィールドなどの必須項目を含める必要があると説明されています。(Microsoft Learn)
実務では、以下を確認してから自動作成を有効にするのが安全です。
| 確認項目 | 確認理由 |
|---|---|
| Customer Template Code | 自動作成される顧客の会計・税設定の土台になる |
| Customer/Company Template Code | B2B会社の顧客化に使われる |
| 国・地域別の顧客設定 | 税計算や地域別処理に影響する |
| 住所情報の有無 | Shopify POS注文などで住所不足が起きる可能性がある |
| 重複判定ルール | メール、電話、請求先、税番号のどれで照合するかを明確にする |
次に取るべき対応
今回のDynamics 365 documentation updateは、表面的には小さな表記修正です。しかし、Shopify Connectorのように日々の受注・顧客同期に関わる機能では、選択肢名の表記ゆれが運用ミスや問い合わせ増加につながります。
まず実施すべきことは、既存設定を変更することではなく、次の3点です。
- Business CentralのShopify関連画面で、
Customer Mapping TypeとCompany Mapping Typeの現在値を確認する - 社内手順書、FAQ、テスト仕様書から旧表記を検索し、UIキャプションに合わせて更新する
- 自動作成、更新、B2B会社マッピングを使っている環境では、テンプレート、税設定、メインコンタクト、ログ確認手順まであわせて点検する
特にBy EMail/Phoneは、一般的な英語表記と違うため、レビュー時に「誤字」として戻されやすい表記です。操作手順ではBusiness Centralの画面表示を優先し、今回の更新は「仕様変更」ではなく「UIキャプションと公式ドキュメントの表記合わせ」として扱うのが、管理者・開発者の双方にとって最も安全です。
コメント