イタリア・サルデーニャの 「県」定義アップデート
原題: Updates to Italy's Sardinian province definitions
- Admin
- Checkout
- Address API
- Markets
- GraphQL
- Italy
- Sardinia
- 改善
図解 : イタリア・サルデーニャ州の県定義アップデート Admin / Improvement イタリア・サルデーニャの 「県」定義アップデート 2025年6月に行われたサルデーニャ州の行政区画の復元を反映。新しい県「Gallura Nord-Est Sardegna(OT)」が選択可能になり、旧「Carbonia-Iglesias(CI)」は「Sulcis Iglesiente」に改名されました。 このページの構成 30秒で理解 : 何が変わったのか 変更内容のビフォー / アフター 背景 : サルデーニャ州の行政区画復元 影響を受ける場所 : Checkout と住所 API マーチャント/パートナー別の影響 技術者が押さえるべき5つのポイント 業務に活かせる3つのユースケース 提案で使える1行サマリ 1 30秒で理解 : 何が変わったのか Shopify がイタリアの サルデーニャ州の県(province)定義 を、2025年6月に施行された行政区画の 復元(restoration) に合わせて更新した。 新しい県「 Gallura Nord-Est Sardegna(OT) 」が選択肢に追加され、旧「 Carbonia-Iglesias(CI) 」は新名称「 Sulcis Iglesiente 」に改名されている。 + 追加 Gallura Nord-Est Sardegna 省略コード OT 。今回から Shopify のチェックアウト等で県として選択できるようになった。 名称変更 Carbonia-Iglesias → Sulcis Iglesiente 省略コード CI 。復元後の正式県名「Sulcis Iglesiente」に合わせて表記が変わった。 対象 サルデーニャ宛配送 + 住所 API サルデーニャ向けに発送するマーチャントは Checkout で名称変更を目にする。住所 API 利用パートナーは県割当の精度が改善する。 2 変更内容のビフォー / アフター BEFORE(〜2026/05/13) Carbonia-Iglesias code: CI AFTER(2026/05/14〜) Sulcis Iglesiente code: CI(コードは据え置き) BEFORE (選択肢に存在しなかった) — AFTER Gallura Nord-Est Sardegna code: OT 原文に明記されているのは 表示名(display name)の追加・改名 。コード値(CI / OT)が今回変わったかどうかについて元記事は 記載なし 。本ページではカッコ内に元記事記載のコード値をそのまま掲載している。 3 背景 : サルデーニャ州の行政区画復元 ※ 行政区画再編の詳細(具体的にどの旧県が復元・統合されたかの全容)は元記事には 記載なし 。Shopify が反映したのは上記2件のみが本リリースの内容。 4 影響を受ける場所 : Checkout と住所 API Checkout の住所入力 サルデーニャ宛に発送するマーチャントの チェックアウト画面の県プルダウン に、更新された県名が表示される。買い手側に追加の手続きは無し。 住所 検証/補完 API アドレス バリデーション/オートコンプリート API を使うパートナー連携で、 サルデーニャ住所の県割当がより正確になる 。 具体的な対象 API 名(GraphQL Admin の AddressInput/Storefront の checkout API 等)の列挙は元記事に 記載なし 。「address validation」「autocomplete」という機能カテゴリで言及されている。 5 マーチャント/パートナー別の影響 立場 影響 対応の必要性 サルデーニャに配送するマーチャント Checkout の県名表示が更新される。新県「Gallura Nord-Est Sardegna」を選ぶ顧客が出てくる。 基本不要 Shopify が反映済み 住所データを自社 DB に保存しているストア 過去注文の「Carbonia-Iglesias」と新規注文の「Sulcis Iglesiente」が混在する可能性。 確認推奨 名寄せロジック点検 住所 API を使うパートナー/アプリ サルデーニャ住所の県割当精度が向上。新コード OT がレスポンスに現れる場合あり。 要確認 県コードのホワイトリスト 配送ラベル/OMS/会計連携 連携先システム(配送業者・税務)の県マスタが旧定義のまま残っている可能性。 要点検 突合キー(県名 or コード)次第 6 技術者が押さえるべき5つのポイント 1. 影響範囲は「イタリア・サルデーニャ州」限定 他州や他国の県定義には変更なし。グローバル展開ストアでも、サルデーニャ宛配送が無ければ実質影響は出ない。 2. 過去注文の県名は遡及されない 通常この種の改名は将来分のみ反映されるため、過去注文に「Carbonia-Iglesias」表記が残る前提でレポートを作る。元記事に遡及の明示は 記載なし 。 3. プロビンスコード(OT/CI)をキーにせよ 県名は時間と共に変わる。住所マッチング・税務マスタ連携は 表示名ではなくコードで突合 するのが堅い設計。 4. 住所バリデーション/オートコンプリートが対象 パートナーが利用する住所検証 API /補完 API の応答に新定義が乗る。テスト住所を 1 件用意して回帰確認しておくと安全。 5. 旧名称「Carbonia-Iglesias」を扱う既存コードは要点検 フロント/管理画面/カスタムアプリで 県名文字列をハードコードしている箇所 (バリデーション、ラベル印字、住所表示、地域別税率設定など)は「Sulcis Iglesiente」追加対応が要る。新県「Gallura Nord-Est Sardegna」を未許可リスト扱いしてしまわないかも合わせて確認。 7 業務に活かせる3つのユースケース USE CASE 1 イタリア向け EC ストアの「住所まわりの軽量メンテ」 課題 イタリア宛の購入が一定あるが、サルデーニャからの注文が来たときに県名のズレや「該当県が選べない」苦情に繋がるリスクを潰したい。 打ち手 Shopify 標準の県プルダウンに任せ、カスタムテーマで上書きしている県リストや住所バリデーションの正規表現を一度棚卸し。新県「Gallura Nord-Est Sardegna」と新名称「Sulcis Iglesiente」を許可リストに反映。 効果 サルデーニャからの注文の住所入力エラー・配送遅延の予防。 技術メモ テーマやアプリで address.province を扱う箇所を `grep` で洗い出すのが早い。 USE CASE 2 外部 OMS/会計/配送システムの「県マスタ同期」 課題 Shopify と連携する OMS/配送業者管理/会計 SaaS が、それぞれ独自に県マスタを持っている。Shopify 側の名称変更が転送先に伝わらないと、注文同期で県不一致エラーが出る。 打ち手 連携の突合キーが「県名」になっていないかを点検。 ISO 風プロビンスコード(CI / OT)ベースの突合 に切り替え、新コード OT を全システムのホワイトリストに追加。 効果 地名変更や行政再編の都度発生する「同期エラー対応」工数の削減。 技術メモ 具体的な API 名は元記事に 記載なし のため、Admin GraphQL の `MailingAddress.provinceCode` /注文 Webhook ペイロードの実値を sandbox で実測してから移行。 USE CASE 3 越境配送 BPO / 物流パートナーへの「県マスタ更新通知」 課題 欧州配送代行・通関代理を担う 3PL/フォワーダーが、未更新の県マスタに基づいてラベル印字や通関書類を作っていると、住所不一致で差し戻しになる可能性がある。 打ち手 本リリースを根拠に、契約 3PL・通関業者に「Sulcis Iglesiente(旧 CI)」「Gallura Nord-Est Sardegna(OT)」のマスタ反映依頼書を共有。同梱の配送ラベルテンプレート(PDF)に新名称が反映されているか実物で確認。 効果 サルデーニャ便の住所不一致による差し戻し・再配達コストの削減。コンプライアンス向上。 技術メモ 2025年6月の現地行政区画復元から約1年遅れで Shopify 側が追いついた形。同じ理由で 3PL 側も対応が遅れている可能性が高いので、能動的に確認するのが安全。 8 提案で使える1行サマリ 「サルデーニャ州の行政区画復元(2025年6月)に Shopify が追従。 新県「Gallura Nord-Est Sardegna(OT)」が選択可能化、旧「Carbonia-Iglesias(CI)」は「Sulcis Iglesiente」へ改名。 マーチャント側の作業は不要だが、住所 API・OMS・3PL を使う案件は 県コード突合と外部システムのマスタ反映 を点検するのが吉。」 source : changelog.shopify.com / italy-s-sardinian-province-definitions-updated generated 2026-05-23