Dynamics 365のBusiness CentralでShopify Connectorを使っている場合、2026年5月20日の「Dynamics 365 documentation update: Correct Shopify SKU mapping and stock calculation option names to match BC UI captions」は、機能追加ではなく公式ドキュメント上の選択肢名をBusiness CentralのUI表記に合わせる修正です。結論から言うと、管理者がすぐ確認すべきなのは、SKU MappingのBar Code表記と、在庫同期で使うStock Calculationの2つの選択肢名です。設定値そのものを急いで変更する話ではありませんが、手順書、運用マニュアル、テストケース、開発者向けドキュメントでは表記ゆれが障害調査や引き継ぎミスにつながります。(GitHub)
Dynamics 365 documentation updateで何が変わったのか
今回の更新は、Dynamics 365 Business CentralのShopify Connectorに関するMicrosoft公式ドキュメントで、Business Centralの画面に表示される選択肢名と記事内の表記が一致していなかった箇所を修正したものです。GitHub上のPRでは、1つのMarkdownファイルに対して3追加・3削除の差分が示され、2026年5月20日にMicrosoftDocsのmainブランチへマージされています。(GitHub)
| 対象 | 修正前のドキュメント表記 | 修正後の表記 | 実務上の意味 |
|---|---|---|---|
| SKU Mapping | Barcode | Bar Code | Business CentralのUIキャプションに合わせた表記へ修正 |
| Stock Calculation | Projected Available Balance at date | Projected Available Balance at Today | 在庫計算方法の選択肢名をUI表示に合わせた修正 |
| Stock Calculation | Free Inventory (Not reserved) | Free Inventory (not reserved) | 大文字・小文字を含めてUI表示に合わせた修正 |
特に重要なのは、BarcodeとBar Codeの違いです。どちらも意味としてはバーコードに関係しますが、Business CentralのSKU Mappingの選択肢として公式ドキュメント上で使うべき表記はBar Codeです。PRの説明では、ShpfySKUMapping.Enum.alのvalue 5がCaption = 'Bar Code'であること、またStock CalculationはShpfyStockCalculation.Enum.alのキャプションに合わせたことが示されています。(GitHub)
機能変更ではなく、UI表記との整合が目的
今回のDynamics 365 documentation updateは、Shopify Connectorの同期ロジック、API仕様、データベース構造を変更するものではありません。PRの差分はドキュメント内の表記修正であり、少なくともこの更新情報から読み取れる範囲では、テナントのアップグレード、データ移行、拡張機能の再デプロイを要求する変更ではありません。(GitHub)
ただし、運用上の影響は小さく見積もらないほうが安全です。Business CentralとShopifyの連携では、SKU、バーコード、在庫数量、ロケーション、予約在庫が絡むため、手順書の選択肢名が画面表示と違うだけでも、初回設定や障害対応で迷いが生じます。特に外部ベンダー、情シス、倉庫担当、EC運用担当が同じ資料を使う環境では、表記統一がそのまま作業品質に影響します。
影響を受けやすい対象者
今回の修正で最も影響を受けやすいのは、Business CentralのShopify Connectorを設定・運用している管理者と、AL拡張や自動テストを管理している開発者です。
| 対象者 | 影響 | すぐ確認すべきこと |
|---|---|---|
| Business Central管理者 | 画面で選ぶ項目名と手順書の表記がずれる可能性 | Shopify Shop、Shopify Shop Locations、SKU Mapping、Stock Calculation |
| EC運用担当 | SKUやバーコードを使った商品同期の説明が分かりにくくなる可能性 | Shopify側のSKU、Barcode、Business Central側のItem Reference |
| 開発者 | UIキャプションを参照するテストやドキュメントに表記ゆれが残る可能性 | AL拡張、テストコード、画面キャプチャ、リリースノート |
| サポート担当 | 問い合わせ時のキーワードが旧表記と新表記で割れる可能性 | FAQ、ナレッジベース、障害切り分け手順 |
Can Update Shopify Productsが有効な場合、SKU Mappingフィールドの変更は次回同期後にShopify Productsページ上の対象商品・バリアントへ反映されると公式ドキュメントに説明されています。つまり、今回の修正自体は表記修正でも、実際の画面でSKU Mappingを変更する作業を誤って行うと、Shopify側のSKU更新につながる可能性があります。(Microsoft Learn)
SKU Mappingの「Bar Code」はどの設定か
SKU Mappingは、ShopifyのSKU値をBusiness Centralの商品・バリアントの照合や作成にどう使うかを決める設定です。公式ドキュメントでは、Business CentralからShopifyへ商品をエクスポートする際の選択肢として、Item No.、Item No.+ Variant Code、Item Vendor No.、Bar Codeが説明されています。Bar Codeは、Item Referenceのバーコード種別を使う選択肢です。(Microsoft Learn)
ここで混同しやすいのは、Shopify側にはSKUとBarcodeが別の項目として存在する点です。SKU MappingでBar Codeを選ぶ場合は、「ShopifyのSKUフィールドに何を入れるか」「Shopifyから取り込んだSKUをBusiness Central側の何と照合するか」という文脈でバーコードを使います。一方、ShopifyのBarcodeフィールド自体の扱いは別に説明されており、Business Central側ではバーコード種別のItem Referenceとして検索・保存されます。(Microsoft Learn)
SKU Mappingの選び方
| 選択肢 | 向いているケース | 注意点 |
|---|---|---|
| Item No. | ShopifyのSKUにBusiness Centralの商品番号を入れている | バリアントがある商品では、SKU設計を事前に統一する |
| Item No. + Variant Code | SKUを1000/REDのように商品番号とバリアントコードで構成している | SKU Field Separatorの設定が重要 |
| Item Vendor No. | 仕入先品番をSKUとして使っている | Item Card上のItem Vendor No.ではなく、Item Vendor Catalog側の値が関係する説明がある |
| Bar Code | バーコードをSKU照合の軸にしたい | Barcodeではなく、UIキャプションとしてはBar Codeと表記する |
たとえば、ShopifyのSKUが1000/001で、Business Centralの商品番号を1000、バリアントコードを001として扱いたい場合は、SKU MappingをItem No. + Variant Codeにし、SKU Field Separatorに/を指定します。公式ドキュメントでは、1000/001/111のように区切りが複数ある場合、商品番号は1000、バリアントコードは001として扱われ、後続部分は無視される例が示されています。(Microsoft Learn)
Stock Calculationの2つの名称変更で見るべきポイント
在庫同期では、Business Central側で計算した在庫数量をShopifyへ反映します。公式ドキュメントでは、Shopifyへの在庫同期には、Shopify側の商品で在庫追跡が有効であること、Business Central側でShopify Locationsの在庫同期が有効であることが条件として説明されています。(Microsoft Learn)
今回修正されたStock Calculationの標準選択肢は、次の2つです。
| 修正後の選択肢 | 考え方 | 向いている運用 |
|---|---|---|
| Projected Available Balance at Today | 今日時点の予定利用可能在庫をもとに判断する | 受注残や出荷予定を考慮して、売り越しを抑えたい場合 |
| Free Inventory (not reserved) | 予約済み在庫を差し引いた自由在庫をもとに判断する | 予約引当を重視して在庫を見せたい場合 |
Projected Available Balance at Todayは、単純な手持ち在庫だけを見る設定ではありません。公式ドキュメントの例では、手持ち在庫10個に対して出荷予定の販売注文がある場合、同期実行日によってShopifyへ更新される在庫数量が変わります。火曜日に同期すれば月曜日出荷分を差し引いて9、金曜日に同期すれば月曜日分と木曜日分を差し引いて7になる例が示されています。(Microsoft Learn)
Free Inventory (not reserved)は、予約済み在庫をどう扱うかがポイントです。公式ドキュメントの例では、手持ち在庫10個と複数の未処理販売注文がある状況で、Item Ledger Entryから予約されている販売注文分のみを差し引き、Shopifyへ更新する数量が9になる例が示されています。日付よりも予約状態を重視する運用では、こちらの考え方が合いやすい場合があります。(Microsoft Learn)
管理者が確認すべき設定
今回の更新後に、管理者がまず見るべき場所は3つです。
Shopify Shop CardのSKU Mapping
Shopify Shop Cardや商品同期設定で、SKU Mappingがどの選択肢になっているかを確認します。Bar Codeを使っている場合は、社内手順書や画面キャプチャが旧表記のBarcodeになっていないかを見直してください。
このとき、設定を変更する必要があるかどうかは別問題です。すでに同期が正しく動いている環境では、表記修正だけを理由に値を変更しないほうが安全です。確認作業では「現在の値を記録する」「手順書の表記を直す」「必要なら検証環境で同期結果を見る」の順に進めると、意図しないShopify側のSKU更新を避けやすくなります。
Shopify Shop LocationsのStock Calculation
在庫同期を使っている場合は、Shopify Shop LocationsでStock Calculationの選択肢を確認します。公式ドキュメントでは、Shopify ShopからLocationsを開き、Shopify Locationsを取得し、必要に応じてLocation Filterを設定したうえで、対象ロケーションの在庫計算方法を選ぶ流れが説明されています。(Microsoft Learn)
複数倉庫、店舗在庫、3PL、Business Central Fulfillment Serviceを使っている環境では、ロケーションごとに在庫数量の見え方が変わります。Projected Available Balance at TodayとFree Inventory (not reserved)のどちらを使うかは、ECサイトに「販売可能に見せたい数量」の定義を先に決めてから選ぶべきです。
Shopify側の商品でTrack quantityが有効か
在庫同期が動かない場合、Business Central側の設定だけを見ても原因を見落とします。公式ドキュメントのトラブルシューティングでは、Shopify管理画面の商品またはバリアントでTrack quantityが有効か、対象ロケーションがInventoryセクションに表示されているか、Business Central側のShopify VariantがItem No.やVariant No.に正しくリンクしているかを確認するよう案内されています。(Microsoft Learn)
開発者が確認すべきポイント
開発者は、まずリポジトリ内で旧表記を検索してください。対象になりやすい文字列は、Barcode、Projected Available Balance at date、Free Inventory (Not reserved)です。ドキュメント、README、テスト仕様書、UIテスト、翻訳ファイル、サポート用テンプレートに残っている可能性があります。
AL拡張を開発している場合は、キャプション文字列そのものに依存しない設計になっているかを確認します。画面操作の自動テストで表示名を直接指定している場合は、今回のようなUIキャプション整合でテストが失敗することがあります。可能であれば、enum値、フィールド、ページ構造、テスト用の安定した識別子を使い、キャプション変更の影響を最小化してください。
在庫計算を独自拡張している場合も確認が必要です。Microsoft Learnでは、Shpfy Stock Calculation enumを拡張して独自の選択肢を追加し、Shpfy Stock Calculation interfaceの実装を追加する方法が示されています。標準例として、手持ち在庫を計算する例や、Free Inventory (not reserved)のキャプションを持つ非予約在庫計算の例が掲載されています。(Microsoft Learn)
移行・展開時の注意点
今回の更新だけを理由に、Business Centralの本番環境で設定変更や再同期を急ぐ必要はありません。優先すべきなのは、設定値の変更ではなく、表記の棚卸しです。
展開時は、次の順で確認すると安全です。
| 順番 | 作業 | 目的 |
| -: | —————————————— | ——————- |
| 1 | 本番環境の現在値を記録する | 意図しない設定変更を防ぐ |
| 2 | 手順書・FAQ・運用マニュアルを新表記へ修正する | UIと資料の不一致をなくす |
| 3 | 検証環境でSKU MappingとStock Calculationの表示を確認する | 画面キャプチャや教育資料を更新する |
| 4 | UI自動テストや受け入れテストを修正する | キャプション差異によるテスト失敗を防ぐ |
| 5 | 次回メンテナンス時に運用担当へ共有する | 問い合わせ時の用語を統一する |
特に注意したいのは、Can Update Shopify Productsが有効な状態でSKU Mappingを不用意に変更することです。公式ドキュメントでは、このフィールドの変更が次回同期後にShopify側へ反映されると説明されています。表記確認のつもりで値まで変えてしまうと、Shopify上のSKUが想定外に更新される可能性があります。(Microsoft Learn)
よくある失敗と回避策
「Bar Code」と「Barcode」を別機能だと思い込む
今回の修正は、SKU Mappingの選択肢名をUIキャプションに合わせるものです。Bar Codeという表記を見て、新しい同期方式が追加されたと判断しないようにしてください。設定の意味は、バーコードをSKUマッピングの軸として使うことです。
在庫同期の計算結果を単純な手持ち在庫と比較してしまう
Projected Available Balance at TodayやFree Inventory (not reserved)は、単純にItemのInventoryだけを見る設定ではありません。販売注文、出荷予定、予約の状態によって、Shopifyへ送られる数量が変わります。差異を調べるときは、Business Centralの在庫、予約、販売注文、ロケーションフィルターをセットで確認してください。(Microsoft Learn)
UoM as Variant利用時に在庫数が期待とずれる
単位をバリアントとして扱う運用では、在庫数量の見え方に注意が必要です。公式ドキュメントでは、Business Centralは可用性を単位ではなく item / item variant 単位で計算するため、PCSとBoxのような単位バリアントでShopify側の在庫表示が期待と異なるケースがあると説明されています。(Microsoft Learn)
新しいShopifyロケーションを追加したのに在庫同期されない
Shopifyで新しいロケーションを追加しても、既存の商品・バリアントに対する在庫レコードが自動で用意されるとは限りません。公式ドキュメントでは、ロケーションがInventoryセクションに表示されない場合、在庫レベルが定義されていない可能性があると説明されています。Business Central側だけでなく、Shopify管理画面のロケーションと商品側の在庫設定も確認してください。(Microsoft Learn)
障害対応で見るべきログと確認箇所
在庫同期やSKUマッピングで期待どおりに動かない場合は、画面上の選択肢名だけで判断せず、次の順に確認します。
| 症状 | 確認箇所 | 見るポイント |
|---|---|---|
| 商品が既存Itemにマッピングされない | Shopify Products / Shopify Variants | Item No.、Variant No.、SKU、Barcode、Item Reference |
| 在庫がShopifyへ反映されない | Shopify Shop Locations | Stock Calculation、Location Filter、Default Product Location |
| Shopify側の在庫数が合わない | Shopify Inventory FactBox | Shopify stockとBusiness Centralの最終計算在庫 |
| 同期エラーが出る | Shopify Log Entries | Has Error、Request Preview、Response Data、userErrors |
公式ドキュメントでは、在庫同期のトラブルシューティングとして、Stock Calculationの値、Shopify側のTrack quantity、ロケーションの在庫定義、Shopify VariantとBusiness Central Itemのリンク、Shopify Inventory FactBox、Shopify Log Entriesを確認する流れが案内されています。(Microsoft Learn)
まず実施すべきこと
今回のDynamics 365 documentation updateは、Business CentralとShopify Connectorの機能変更ではなく、公式ドキュメントの表記をBC UI captionsに合わせる修正です。とはいえ、SKU MappingとStock Calculationは、商品マッピングと在庫同期に直結する重要設定です。
まずは、社内ドキュメントと検証環境を見直し、Barcodeを選択肢名として書いている箇所はBar Codeへ、Projected Available Balance at dateはProjected Available Balance at Todayへ、Free Inventory (Not reserved)はFree Inventory (not reserved)へ修正してください。そのうえで、現在の本番設定を記録し、SKUや在庫数量に関係する設定変更は必ず検証環境で同期結果を確認してから展開するのが安全です。
コメント