🧑‍🏫

【Shopify.dev和訳】API Examples/Shipping

2021/09/18に公開約70,800字

この記事について

この記事は、API Examples/Shippingの記事を和訳したものです。

記事内で使用する画像は、公式ドキュメント内の画像を引用して使用させていただいております。

Shopify アプリのご紹介

Shopify アプリである、「商品ページ発売予告アプリ | リテリア Coming Soon」は、商品ページを買えない状態のまま、発売日時の予告をすることができるアプリです。Shopify で Coming Soon 機能を実現することができます。

https://apps.shopify.com/shopify-application-314?locale=ja&from=daniel

Shopify アプリである、「らくらく日本語フォント設定|リテリア Font Picker」は、ノーコードで日本語フォントを使用できるアプリです。日本語フォントを導入することでブランドを演出することができます。

https://apps.shopify.com/font-picker-1?locale=ja&from=daniel

デリバリープロファイルで高度な配送情報を管理する

Shopify では、配送プロファイルを使って高度な配送情報を管理することができます。配送プロファイルを使用しているショップは、商品の種類や場所ごとに配送料を設定することができます。

配送プロファイル

配送プロファイルは、特定の商品に適用される配送方法と料金に関する情報を保存します。

配送を必要とする商品は、配送プロファイル内のロケーショングループ、配送ゾーン、配送方法に関連付けられます。

名前 説明
配送プロファイル 一連の製品バリエーションに対する一連の配送設定を表します。例えば、重量のある商品と壊れやすい商品の配送プロファイルを設定することができます。
ロケーショングループ 製品のバリアントを同じ配送ゾーンに出荷するロケーションのセットを表します。たとえば、アメリカ大陸ではカナダとドイツに配送するロケーショングループがあり、ヨーロッパではカナダとドイツに配送するロケーショングループがあるとします。
デリバリーゾーン デリバリープロファイルのバリアントが出荷される国のグループを表します。例えば、カナダに製品を出荷する場合などがこれにあたります。
配送方法 配送方法は、配送ゾーンの静的な料金または運送業者が計算した料金(参加者)を指定します。静的レートには、特定の条件を満たした場合にのみ適用される条件付きレートを設定できます。例えば、カートの合計金額が 100 ドル以上の場合に送料無料を適用するという条件を指定できます。配送料金は、チェックアウト時にお客様に表示されます。

クエリのウォークスルー

以下のクエリウォークスルーでは、配送プロファイルのさまざまな部分について説明しています。

配送プロファイル

次のクエリは、配送プロファイルの ID、名前、デフォルト設定を返します。製品バリアントは、他の配送プロファイルに追加されるまで、デフォルトプロファイルに留まります。レスポンス例では、デフォルトプロファイルが返されることを示しています。

POST /admin/api/unstable/graphql.json

query {
  deliveryProfiles(first: 1) {
    edges {
      node {
        id
        name
        default
      }
    }
  }
}
json response
{
  "data": {
    "deliveryProfiles": {
      "edges": [
        {
          "node": {
            "id": "gid://shopify/DeliveryProfile/4227128",
            "name": "Default",
            "default": true
          }
        }
      ]
    }
  },
  ...
}

プロファイルアイテム

製品のバリアントは、profileItems オブジェクトを使用して配送プロファイルに関連付けられます。各プロファイルアイテムは、各オブジェクトが製品と関連するバリアントのリストを含むオブジェクトの配列を含むことができます。

POST /admin/api/unstable/graphql.json

query {
  deliveryProfiles(first: 1) {
    edges {
      node {
        profileItems(first: 2) {
          edges {
            node {
              product {
                id
                handle
              }
              variants(first: 2) {
                edges {
                  node {
                    id
                    title
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}
json response
{
  "data": {
    "deliveryProfiles": {
      "edges": [
        {
          "node": {
            "profileItems": {
              "edges": [
                {
                  "node": {
                    "product": {
                      "id": "gid://shopify/Product/8092548998",
                      "handle": "ajtestproduct"
                    },
                    "variants": {
                      "edges": [
                        {
                          "node": {
                            "id": "gid://shopify/ProductVariant/26669237382",
                            "title": "1"
                          }
                        },
                        {
                          "node": {
                            "id": "gid://shopify/ProductVariant/27700365318",
                            "title": "2"
                          }
                        }
                      ]
                    }
                  }
                },
                {
                  "node": {
                    "product": {
                      "id": "gid://shopify/Product/8104668422",
                      "handle": "burton-custom-freestlye-151"
                    },
                    "variants": {
                      "edges": [
                        {
                          "node": {
                            "id": "gid://shopify/ProductVariant/26756068422",
                            "title": "First"
                          }
                        },
                        {
                          "node": {
                            "id": "gid://shopify/ProductVariant/26756068550",
                            "title": "Second"
                          }
                        }
                      ]
                    }
                  }
                }
              ]
            }
          }
        }
      ]
    }
  },
  ...
}

プロフィールロケーショングループ

プロファイルロケーショングループは、配送プロファイル内で共通の配送プロパティを持つオリジンロケーションのグループを表します。

POST /admin/api/unstable/graphql.json

query {
  deliveryProfiles(first: 1) {
    edges {
      node {
        profileLocationGroups {
          locationGroup {
            id
            locations(first: 3) {
              edges {
                node {
                  id
                  name
                }
              }
            }
          }
        }
      }
    }
  }
}
json response
{
  "data": {
    "deliveryProfiles": {
      "edges": [
        {
          "node": {
            "profileLocationGroups": [
              {
                "locationGroup": {
                  "id": "gid://shopify/DeliveryLocationGroup/3014712",
                  "locations": {
                    "edges": [
                      {
                        "node": {
                          "id": "gid://shopify/Location/45141830",
                          "name": "99 chemin mahon"
                        }
                      },
                      {
                        "node": {
                          "id": "gid://shopify/Location/9562054",
                          "name": "mahon"
                        }
                      }
                    ]
                  }
                }
              },
              {
                "locationGroup": {
                  "id": "gid://shopify/DeliveryLocationGroup/6946872",
                  "locations": {
                    "edges": [
                      {
                        "node": {
                          "id": "gid://shopify/Location/17225842744",
                          "name": "downtown location"
                        }
                      }
                    ]
                  }
                }
              }
            ]
          }
        }
      ]
    }
  },
  ...
}

ロケーショングループゾーン

locationGroupZonesオブジェクトは、製品の出荷先となる 1 つまたは複数の配送ゾーンを表します。各プロファイルのロケーショングループは、複数のロケーショングループゾーンを持つことができます。

POST /admin/api/unstable/graphql.json

query {
  deliveryProfiles(first: 1) {
    edges {
      node {
        profileLocationGroups {
          locationGroupZones(first: 2) {
            edges {
              node {
                zone {
                  id
                  name
                  countries {
                    name
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}
json response
{
  "data": {
    "deliveryProfiles": {
      "edges": [
        {
          "node": {
            "profileLocationGroups": [
              {
                "locationGroupZones": {
                  "edges": [
                    {
                      "node": {
                        "zone": {
                          "id": "gid://shopify/DeliveryZone/9961528",
                          "name": "Domestic",
                          "countries": [
                            {
                              "name": "Canada"
                            }
                          ]
                        }
                      }
                    },
                    {
                      "node": {
                        "zone": {
                          "id": "gid://shopify/DeliveryZone/10027064",
                          "name": "Europe",
                          "countries": [
                            {
                              "name": "United Kingdom"
                            }
                          ]
                        }
                      }
                    }
                  ]
                }
              },
              {
                "locationGroupZones": {
                  "edges": [
                    {
                      "node": {
                        "zone": {
                          "id": "gid://shopify/DeliveryZone/15368248",
                          "name": "germany",
                          "countries": [
                            {
                              "name": "Germany"
                            }
                          ]
                        }
                      }
                    }
                  ]
                }
              }
            ]
          }
        }
      ]
    }
  },
  ...
}

配送方法の定義

配送方法の定義は、配送プロファイル、ロケーショングループ、およびゾーンのコンテキスト内で配送方法を表します。各配送方法の定義には、チェックアウト時にお客様に表示される配送方法の名前を表すnameプロパティが含まれています。

POST /admin/api/unstable/graphql.json

query {
  deliveryProfiles(first: 1) {
    edges {
      node {
        profileLocationGroups {
          locationGroupZones(first: 3) {
            edges {
              node {
                methodDefinitions(first: 3) {
                  edges {
                    node {
                      id
                      name
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}
json response
{
  "data": {
    "deliveryProfiles": {
      "edges": [
        {
          "node": {
            "profileLocationGroups": [
              {
                "locationGroupZones": {
                  "edges": [
                    {
                      "node": {
                        "methodDefinitions": {
                          "edges": [
                            {
                              "node": {
                                "id": "gid://shopify/DeliveryMethodDefinition/24739896",
                                "name": "Standard Shipping"
                              }
                            },
                            {
                              "node": {
                                "id": "gid://shopify/DeliveryMethodDefinition/24772664",
                                "name": "Heavy Goods Shipping"
                              }
                            },
                            {
                              "node": {
                                "id": "gid://shopify/DeliveryMethodDefinition/24805432",
                                "name": "carrier service app"
                              }
                            }
                          ]
                        }
                      }
                    },
                    {
                      "node": {
                        "methodDefinitions": {
                          "edges": [
                            {
                              "node": {
                                "id": "gid://shopify/DeliveryMethodDefinition/24641592",
                                "name": "price based"
                              }
                            }
                          ]
                        }
                      }
                    },
                    {
                      "node": {
                        "methodDefinitions": {
                          "edges": [
                            {
                              "node": {
                                "id": "gid://shopify/DeliveryMethodDefinition/24674360",
                                "name": "International Shipping"
                              }
                            },
                            {
                              "node": {
                                "id": "gid://shopify/DeliveryMethodDefinition/24707128",
                                "name": "carrier service app"
                              }
                            }
                          ]
                        }
                      }
                    }
                  ]
                }
              },
              {
                "locationGroupZones": {
                  "edges": [
                    {
                      "node": {
                        "methodDefinitions": {
                          "edges": []
                        }
                      }
                    }
                  ]
                }
              }
            ]
          }
        }
      ]
    }
  },
  ...
}

配送方法の条件

配送方法の条件は、特定の条件が適用されたときにチェックアウト時に料金を表示するために使用できます。たとえば、価格ベースの条件を設定して、カートの合計が価格のしきい値を超えたときにのみ料金を表示することができます。配送方法条件は、静的に定義されたレートにのみ適用できます。

POST /admin/api/unstable/graphql.json

query {
  deliveryProfiles(first: 1) {
    edges {
      node {
        profileLocationGroups {
          locationGroupZones(first: 2) {
            edges {
              node {
                methodDefinitions(first: 2) {
                  edges {
                    node {
                      methodConditions {
                        id
                        operator
                        conditionCriteria {
                          ... on Weight {
                            value
                          }
                          ... on MoneyV2 {
                            amount
                            currencyCode
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}
json response
{
  "data": {
    "deliveryProfiles": {
      "edges": [
        {
          "node": {
            "profileLocationGroups": [
              {
                "locationGroupZones": {
                  "edges": [
                    {
                      "node": {
                        "methodDefinitions": {
                          "edges": [
                            {
                              "node": {
                                "methodConditions": [
                                  {
                                    "id": "gid://shopify/DeliveryCondition/19595320",
                                    "operator": "GREATER_THAN_OR_EQUAL_TO",
                                    "conditionCriteria": {
                                      "value": 0
                                    }
                                  },
                                  {
                                    "id": "gid://shopify/DeliveryCondition/19628088",
                                    "operator": "LESS_THAN_OR_EQUAL_TO",
                                    "conditionCriteria": {
                                      "value": 5
                                    }
                                  }
                                ]
                              }
                            },
                            {
                              "node": {
                                "methodConditions": [
                                  {
                                    "id": "gid://shopify/DeliveryCondition/19660856",
                                    "operator": "GREATER_THAN_OR_EQUAL_TO",
                                    "conditionCriteria": {
                                      "value": 5
                                    }
                                  },
                                  {
                                    "id": "gid://shopify/DeliveryCondition/19693624",
                                    "operator": "LESS_THAN_OR_EQUAL_TO",
                                    "conditionCriteria": {
                                      "value": 20
                                    }
                                  }
                                ]
                              }
                            }
                          ]
                        }
                      }
                    },
                    {
                      "node": {
                        "methodDefinitions": {
                          "edges": [
                            {
                              "node": {
                                "methodConditions": [
                                  {
                                    "id": "gid://shopify/DeliveryCondition/19464248",
                                    "operator": "GREATER_THAN_OR_EQUAL_TO",
                                    "conditionCriteria": {
                                      "amount": "0.0",
                                      "currencyCode": "USD"
                                    }
                                  },
                                  {
                                    "id": "gid://shopify/DeliveryCondition/19497016",
                                    "operator": "LESS_THAN_OR_EQUAL_TO",
                                    "conditionCriteria": {
                                      "amount": "100.0",
                                      "currencyCode": "USD"
                                    }
                                  }
                                ]
                              }
                            }
                          ]
                        }
                      }
                    }
                  ]
                }
              },
              {
                "locationGroupZones": {
                  "edges": [
                    {
                      "node": {
                        "methodDefinitions": {
                          "edges": []
                        }
                      }
                    }
                  ]
                }
              }
            ]
          }
        }
      ]
    }
  },
  ...
}

レートプロバイダー

チェックアウト時に表示されるレートは、rateProviderオブジェクトの中にあります。Shopify は 2 種類のレートをサポートしています。

  • DeliveryRateDefinition: 静的なレートで、Shopify 内に保存されています。
  • DeliveryParticipant: ダイナミックレート。動的なレートで、CarrierService API で取得します。
    以下の例では、静的レートと動的レートの両方を返します。

POST /admin/api/unstable/graphql.json

query {
  deliveryProfiles(first: 1) {
    edges {
      node {
        profileLocationGroups {
          locationGroupZones(first: 3) {
            edges {
              node {
                methodDefinitions(first: 3) {
                  edges {
                    node {
                      rateProvider {
                        ... on DeliveryRateDefinition {
                          id
                          price {
                            amount
                          }
                        }
                        ... on DeliveryParticipant {
                          id
                          fixedFee {
                            amount
                            currencyCode
                          }
                          percentageOfRateFee
                          participantServices {
                            active
                            name
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}
json response
{
  "data": {
    "deliveryProfiles": {
      "edges": [
        {
          "node": {
            "profileLocationGroups": [
              {
                "locationGroupZones": {
                  "edges": [
                    {
                      "node": {
                        "methodDefinitions": {
                          "edges": [
                            {
                              "node": {
                                "rateProvider": {
                                  "id": "gid://shopify/DeliveryRateDefinition/13172792",
                                  "price": {
                                    "amount": "8.0"
                                  }
                                }
                              }
                            },
                            {
                              "node": {
                                "rateProvider": {
                                  "id": "gid://shopify/DeliveryRateDefinition/13205560",
                                  "price": {
                                    "amount": "18.0"
                                  }
                                }
                              }
                            },
                            {
                              "node": {
                                "rateProvider": {
                                  "id": "gid://shopify/DeliveryParticipant/11567160",
                                  "fixedFee": {
                                    "amount": "0.0",
                                    "currencyCode": "USD"
                                  },
                                  "percentageOfRateFee": 0,
                                  "participantServices": []
                                }
                              }
                            }
                          ]
                        }
                      }
                    },
                    {
                      "node": {
                        "methodDefinitions": {
                          "edges": [
                            {
                              "node": {
                                "rateProvider": {
                                  "id": "gid://shopify/DeliveryRateDefinition/13107256",
                                  "price": {
                                    "amount": "5.0"
                                  }
                                }
                              }
                            }
                          ]
                        }
                      }
                    },
                    {
                      "node": {
                        "methodDefinitions": {
                          "edges": [
                            {
                              "node": {
                                "rateProvider": {
                                  "id": "gid://shopify/DeliveryRateDefinition/13140024",
                                  "price": {
                                    "amount": "18.0"
                                  }
                                }
                              }
                            },
                            {
                              "node": {
                                "rateProvider": {
                                  "id": "gid://shopify/DeliveryParticipant/11534392",
                                  "fixedFee": {
                                    "amount": "0.0",
                                    "currencyCode": "USD"
                                  },
                                  "percentageOfRateFee": 0,
                                  "participantServices": []
                                }
                              }
                            }
                          ]
                        }
                      }
                    }
                  ]
                }
              },
              {
                "locationGroupZones": {
                  "edges": [
                    {
                      "node": {
                        "methodDefinitions": {
                          "edges": []
                        }
                      }
                    }
                  ]
                }
              }
            ]
          }
        }
      ]
    }
  },
  ...
}

配送プロファイルの作成

配送プロファイルを作成するには、profile引数を入力として受け付ける deliveryProfileCreate mutation を使用します。

次の mutation は、1 つの場所からカナダの新しい配送ゾーンに出荷される製品の配送プロファイルを作成します。

次のリストは、入力オブジェクトの重要なフィールドを説明しています。

  • locationGroupsToCreate
    含まれるゾーンのためにグループ化されるロケーションを定義します。
  • zonesToCreate
    ゾーンの国と配送方法を定義します。
  • methodDefinitionsToCreate
    rateDefinitionを使って静的なレートを指定するか、またはparticipantを使ってキャリアが提供するレートを指定します。
    POST /admin/api/unstable/graphql.json
mutation {
  deliveryProfileCreate(
    profile: {
      name: "My Fulfillment Service's Profile"
      variantsToAssociate: ["gid://shopify/ProductVariant/13672596209720"]
      locationGroupsToCreate: {
        locations: [
          # your location id
          "gid://shopify/Location/17225842744"
        ]
        zonesToCreate: [
          {
            name: "Canada"
            countries: [{ code: CA }]
            methodDefinitionsToCreate: [
              {
                name: "my_carrier_service_name"
                active: true
                participant: {
                  # your carrier service id
                  carrierServiceId: "gid://shopify/DeliveryCarrierService/11499270"
                }
              }
            ]
          }
        ]
      }
    }
  ) {
    profile {
      id
      name
      profileLocationGroups {
        locationGroup {
          id
          locations(first: 1, includeLegacy: true) {
            edges {
              node {
                id
                name
              }
            }
          }
        }
        locationGroupZones(first: 1) {
          edges {
            node {
              zone {
                name
                countries {
                  name
                }
              }
              methodDefinitions(first: 1) {
                edges {
                  node {
                    id
                    name
                    active
                    rateProvider {
                      ... on DeliveryParticipant {
                        id
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
    userErrors {
      field
      message
    }
  }
}
json response
{
  "data": {
    "deliveryProfileCreate": {
      "profile": {
        "id": "gid://shopify/DeliveryProfile/7372856",
        "name": "My Fulfillment Service's Profile",
        "profileLocationGroups": [
          {
            "locationGroup": {
              "id": "gid://shopify/DeliveryLocationGroup/6094904",
              "locations": {
                "edges": [
                  {
                    "node": {
                      "id": "gid://shopify/Location/45141830",
                      "name": "150 Elgin"
                    }
                  }
                ]
              }
            },
            "locationGroupZones": {
              "edges": [
                {
                  "node": {
                    "zone": {
                      "name": "Canada",
                      "countries": [
                        {
                          "name": "Canada"
                        }
                      ]
                    },
                    "methodDefinitions": {
                      "edges": [
                        {
                          "node": {
                            "id": "gid://shopify/DeliveryMethodDefinition/35684408",
                            "name": "my_carrier_service_name",
                            "active": true,
                            "rateProvider": {
                              "id": "gid://shopify/DeliveryParticipant/13664312"
                            }
                          }
                        }
                      ]
                    }
                  }
                }
              ]
            }
          }
        ]
      },
      "userErrors": []
    }
  },
  ...
}

国/地域および州のコードのリスト

この表には、zoneToCreatecountriesフィールドで使用する、すべての国/地域とその下位区分の ISO コードが含まれています。

国・地域名 ISO コード
アフガニスタン AF
アランド諸島 AX
アルバニア AL
アルジェリア DZ
アンドラ AD
アンゴラ AO
アングィラ AI
アンティグア・バーブーダ共和国 AG
アルゼンチン AR
地方
名称 ISO コード
ブエノスアイレス B
カタマルカ K
チャコ H
チュブット U
ブエノスアイレス自治市 C
コルドバ X
コリエンテス W
アントレ・リオス E
フォルモサ P
フフイ Y
ラ・パンパ L
ラ・リオハ F
メンドーサ M
ミシオネス N
ネウケン Q
リオ・ネグロ R
サルタ A
サンファン J
サンルイ D
サンタクルーズ Z
サンタフェ s
サンティアゴ・デル・エステロ G
ティエラデルフエゴ V
トゥクマン T
国・地域名 ISO コード
アルメニア AM
アルバ AW
オーストラリア AU
州と準州
名称 ISO コード
オーストラリア首都特別地域 ACT
ニューサウスウェールズ州 NSW
ノーザンテリトリー NT
クイーンズランド州 QLD
南オーストラリア州 SA
タスマニア TAS
ビクトリア州 VIC
西オーストラリア州 WA
国・地域名 ISO コード
オーストリア AT
アゼルバイジャン AZ
バハマ BS
バーレーン BH
バングラデシュ BD
バルバドス BB
ベラルーシ BY
ベルギー BE
ベリーズ BZ
ベナン BJ
バミューダ BM
ブータン BT
ボリビア BO
ボネール、シント・ユースタティウス、サバ BQ
ボスニア・ヘルツェゴビナ BA
ボツワナ BW
ブーベ島 BV
ブラジル BR
名前 ISO コード
エーカー AC
アラゴス AL
アマパ AP
アマゾナス AM
バイーア BA
セアラ CE
連邦直轄区 DF
エスピリト・サント ES
ゴイアス GO
マラニャン MA
マットグロッソ MT
マトグロッソドスル MS
ミナス・ジェライス MG
パラ PA
パライーバ PB
パラナ PR
ペルナンブコ PE
ピアウイ PI
リオグランデ・ド・ノルテ RN
リオ・グランデ・ド・スル RS
リオデジャネイロ RJ
ロンドニア RO
ロライマ RR
サンタ・カタリーナ SC
サンパウロ SP
セルジッペ SE
トカンチンス TO
国・地域名 ISO コード
イギリス領インド洋地域 IO
ブルネイ BN
ブルガリア BG
ブルキナファソ BF
ブルンジ BI
カンボジア KH
カナダ CA
州・準州
名称 ISO コード
アルバータ州 AB
ブリティッシュコロンビア州 BC
マニトバ州 MB
ニューブランズウィック NB
ニューファンドランド・ラブラドール州 NL
ノースウエスト準州 NT
ノバスコシア州 NS
ヌナブト準州 NU
オンタリオ州 ON
プリンスエドワード島 PE
ケベック州 QC
サスカチュワン州 SK
ユーコン YT
国・地域名 ISO コード
カーボベルデ CV
ケイマン諸島 KY
中央アフリカ共和国 CF
チャド TD
チリ CL
地方
名称 ISO コード
アントファガスタ AN
アラウカニア AR
アリカとパリナコータ AP
アタカマ AT
アイセン AI
ビオビオ BI
コキンボ CO
ロス ラゴス LL
ロス リオス LR
マガジャネス・イ・デ・ラ・アンタルティカ・チレーナ MA
マウレ ML
ニュブレ NB
オヒギンズ LI
サンティアゴ RM
タラパカ TA
バルパライソ VS
国・地域名 ISO コード
中国 CN
名称 ISO コード
安徽省 AH
北京 BJ
重慶 CQ
福建省 FJ
甘粛省 GS
広東省 GD
広西 GX
貴州 GZ
海南省 HI
河北省 HE
黒龍江 HL
河南 HA
湖北省 HB
湖南 HN
内蒙古 NM
江蘇省 JS
江西省 JX
吉林省 JL
遼寧 LN
寧夏 NX
青海 QH
陝西省 SN
山東 SD
上海 SH
山西省 SX
四川省 SC
天津 TJ
新疆ウイグル自治区 XJ
チベット自治区 YZ
雲南省 YN
浙江省 ZJ
国・地域名 ISO コード
クリスマス島 CX
ココス(キーリング)諸島 CC
コロンビア CO
部署
名称 ISO コード
アマゾナス AMA
アンティオキア ANT
アラウカ ARA
アトランティコ県 ATL
ボゴタ D.C. DC
ボリーバル県 BOL
ボヤカ BOY
カルダス CAL
カケタ CAQ
カサナレ CAS
カウカ CAU
セサール CES
チョコ CHO
コルドバ COR
クンディナマルカ CUN
グアイニア GUA
グアビアーレ県 GUV
フイラ HUI
ラ・グアヒーラ LAG
マグダレナ MAG
メタ MET
ナリーニョ NAR
ノルテ・デ・サンタンデール NSA
プトゥマヨ PUT
キンディオ QUI
リサラルダ RIS
サン・アンドレス・プロビデンシア・サンタ・カタリナ SAP
サンタンデール SAN
スクレ SUQ
トリマ TOL
バジェ・デル・カウカ VAC
バウペス VAU
ビチャダ VID
国・地域名 ISO コード
コモロ KM
コンゴ CG
コンゴ民主共和国 CD
クック諸島 CK
コスタリカ CR
クロアチア HR
キューバ CU
キュラソー島 CW
キプロス CY
チェコ共和国 CZ
コートジボワール CI
デンマーク DK
ジブチ DJ
ドミニカ DM
ドミニカ共和国 DO
エクアドル EC
エジプト EG
総督府
名称 ISO コード
10 月 6 日市 SU
アル シャルキヤ SHR
アレキサンドリア ALX
アスワン ASN
アシュート AST
ベヘイラ BH
ベニースーフ BNS
カイロ C
ダカーリア DK
ダミエッタ DT
ファイユーム・オアシス FYM
ガルビア GH
ギザ GZ
ヘルワン HU
イスマイリア IS
カフル・アッシャイフ KFS
ルクソール LX
マトルーフ MT
ミニヤー MN
モヌフィア MNF
ニューバレー WAD
北シナイ SIN
ポートサイド PTS
カリュビア KB
ケーナ KN
紅海 BA
ソハグ SHG
南シナイ JS
スエズ SUZ
国・地域名 ISO コード
エルサルバドル SV
赤道ギニア GQ
エリトリア ER
エストニア GF
フランス領ポリネシア PF
フランス領南方地域 TF
ガボン GH
ジブラルタル GI
ギリシャ GR
グリーンランド GL
グレナダ GD
グアドループ GP
グアテマラ GT
department
名称 ISO コード
アルタ・ベラパス AVE
バハベラパス BVE
チマルテナンゴ CMT
チキムラ CQM
エル・プログレソ EPR
エスクイントラ ESC
グァテマラ GUA
ウェウェテナンゴ HUE
イサバル IZA
ハラパ JAL
フティアパ JUT
ペテン PET
ケツァルテナンゴ QUE
キチェ QUI
レタルウレウ RET
サカテペケス SAC
サンマルコス SMA
サンタローザ SRO
ソロラ SOL
スチテペケス SUC
トトニカパン TOT
サカパ ZAC
国・地域名 ISO コード
ガーンジー GG
ギニア GN
ギニアビサウ GW
ガイアナ GY
ハイチ HT
ハード島とマクドナルド諸島 HM
ローマ法王庁(バチカン市国) VA
ホンジュラス HN
香港特別行政区 HK
地方
名称 ISO コード
香港島 HK
カオルーン KL
ニューテリトリー NT
国・地域名 ISO コード
ハンガリー HU
アイスランド IS
インド IN
州と準州
名称 ISO コード
アンダマン・ニコバル AN
アンドラ・プラデシュ州 AP
アルナーチャル・プラデーシュ AR
アッサム AS
ビハール州 BR
チャンディーガル CH
チャッティスガル CG
ダドラ・ナガル・ハベリ DN
ダマン・ディーウ連邦直轄領 DD
デリー DL
ゴア GA
グジャラート GA
グジャラート GJ
ハリヤナ HR
ヒマチャル プラデシュ HP
ジャンムー・カシミール JK
ジャールカンド JH
カルナータカ KA
ケーララ KL
ラクシャドウィープ LD
マディヤ・プラデーシュ MP
マハラシュトラ州 MH
マニプール MN
メガラヤ ML
ミゾラム MZ
ナガランド NL
オリッサ OR
ポンディシェリ PY
パンジャブ PB
ラージャスターン RJ
シッキム SK
タミル·ナードゥ TN
テランガーナ TS
トリプラ TR
ウッタル・プラデーシュ UP
ウッタランチャル UK
西ベンガル WB
国・地域名 ISO コード
インドネシア 州 ID
名称 ISO コード
アチェ AC
バリ島 BA
バンカ ビリトン BB
バンテン BT
ベンクール BE
ゴロンタロ GO
ジャカルタ JK
ジャンビ JA
ジャワ・バラ JB
ジャワ・テンガ JT
ジャワ・ティムール JI
カリマンタン・バラット KB
カリマンタン・セラタン KS
カリマンタン・テンガ KT
カリマンタン・ティムール KI
カリマンタン・ウタラ KU
リアウ KR
ランプン LA
マルク MA
マルク ウタラ MU
ヌサ・トゥンガラ・バラット NB
ヌサ・トゥンガラ・ティムール NT
パプア PA
パプアバラット PB
リアウ州 RI
スラウェシ・バラット SR
スラウェシ・セラタン SN
スラウェシ・テンガ ST
スラウェシ・テンガラ SG
スラウェシ・ウタラ SA
スマトラ・バラット SB
スマトラ・セラタン SS
スマトラ・ウタラ SU
ジョグジャカルタ YO
国・地域名 ISO コード
イラン・イスラム共和国 IR
イラク IQ
アイルランド IE
名称 ISO コード
カーロウ CW
キャバン CN
クレア CE
コーク CO
ドネガル DL
ダブリン D
ガルウェイ G
ケリー KY
キルデア KE
キルケニー KK
ラオス LS
リートリム LM
リムリック LK
ロングフォード LD
リートリム LH
マヨ MO
ミース MH
モナハン MN
オファリー OY
ロスコン RN
スライゴ SO
ティペラリー TA
ウォーターフォード WD
ウェストミース WH
ウェックスフォード WX
ウィックロー WW
国・地域名 ISO コード
マン島 IM
イスラエル IL
イタリア 州 IT
名称 ISO コード
アグリジェント AG
アレッサンドリア AL
アンコナ AN
アオスタ AO
アレッツォ AR
アスコリ・ピチェーノ AP
アスティ AT
アベリノ AV
バリ BA
バレッタ-アンドリア-トラニ BT
ベルーノ BL
ベネヴェント BN
ベルガモ BG
ビエッラ BI
ボローニャ BO
ボルツァーノ BZ
ブレシア BS
ブリンディジ BR
カリアリ CA
カルタニッセッタ CL
カンポバッソ CB
カルボニア-イグレシアス CI
カゼルタ CE
カターニア CT
カタンザーロ CZ
キエーティ CH
コモ CO
コセンツァ CS
クレモナ CR
クロトーネ KR
クネオ CN
エナ EN
フェルモ FM
フェラーラ FE
フローレンス FI
フォッジア FG
フォルリ-チェゼーナ FC
フロジノーネ FR
ジェノバ GE
ゴリツィア GO
グロッセート GR
インペリア IM
イゼルニア IS
ラキラ AQ
ラ・スペツィア SP
ラティーナ LT
レッチェ LE
レッコ LC
リヴォルノ LI
ロディ LO
ルッカ LU
マセラータ MC
マンチュア MN
マッサ-カッラーラ MS
マテラ MT
メディオカンピダーノ VS
メッシーナ ME
ミラン MI
モデナ MO
モンツァとブリアンザ MB
ネイプルズ NA
ノバラ NO
ヌオラ NU
オグリアストラ OG
オルビア-テンピオ OT
オリスターノ OR
パドバ PD
パレルモ PA
パルマ PR
パビア PV
ペルージャ PG
ペーザロとウルビーノの PU
ペスカーラ PE
ピアチェンツァ PC
ピサ PI
ピストイア PT
ポルデノン PN
ポテンザ PZ
プラート PO
ラグーザ RG
ラベンナ RA
レッジョ・カラブリア RC
レッジョ・エミリア RE
リーティ RI
リミニ RN
ローマ RM
ロヴィゴ RO
サレルノ SA
サッサリ SS
サボナ SV
シエナ SI
シラクーサ SR
ソンドリオ SO
タラント TA
テラモ TE
テルニ TR
トリノ TO
トラーパニ TP
トレント TN
トレビゾ TV
トリエステ TS
ウディネ UD
バレーズ VA
ベニス VE
ヴェルバーノ・カシオ・オソラ VB
ヴェルチェッリ VC
ヴェローナ VR
ビボ・バレンティア VV
ヴィチェンツァ VI
ヴィテルボ VT
国・地域名 ISO コード
ジャマイカ JM
日本 JP
都道府県
名称 ISO コード
北海道 JP-01
青森県 JP-02
岩手県 JP-03
宮城県 JP-04
秋田県 JP-05
山形県 JP-06
福島県 JP-07
茨城県 JP-08
栃木県 JP-09
群馬県 JP-10
埼玉県 JP-11
千葉県 JP-12
Tōkyō JP-13
神奈川県 JP-14
新潟県 JP-15
富山県 JP-16
石川県 JP-17
福井県 JP-18
山梨県 JP-19
長野県 JP-20
岐阜県 JP-21
静岡県 JP-22
愛知県 JP-23
三重県 JP-24
滋賀県 JP-25
京都府 JP-26
大阪府 JP-27
兵庫県 JP-28
奈良県 JP-29
和歌山県 JP-30
鳥取県 JP-31
島根県 JP-32
岡山県 JP-33
広島県 JP-34
山口県 JP-35
徳島県 JP-36
香川県 JP-37
愛媛県 JP-38
高知県 JP-39
福岡県 JP-40
佐賀県 JP-41
長崎県 JP-42
熊本県 JP-43
大分県 JP-44
宮崎県 JP-45
鹿児島県 JP-46
沖縄県 JP-47
国・地域名 ISO コード
ジャージー JE
ヨルダン JO
カザフスタン KZ
ケニア KE
キリバス KI
韓国 KP
コソボ XK
クウェート KW
キルギス KG
ラオス人民民主共和国 LA
ラトビア LV
レバノン LB
レソト LS
リベリア LR
リビア・アラブ・ジャマーヒリーヤ LY
リヒテンシュタイン LI
リトアニア LT
ルクセンブルク LU
マカオ MO
マケドニア共和国 MK
マダガスカル共和国 MG
マラウイ MW
マレーシア MY
州と準州
名前 ISO コード
ジョホール JHR
ケダウ KDH
クランタン KTN
クアラルンプール KUL
ラブアン LBN
マラッカ MLK
ネゲリセンビラン NSN
パハン PHG
ペラック PRK
パーリス PLS
ピナン島 PNG
プトラジャヤ PJY
サバ州 SBH
サラワク SWK
セランゴール SGR
トレンガヌ TRG
国・地域名 ISO コード
モルディブ MV
マリ ML
マルタ MT
マルティニーク MQ
モーリタニア MR
モーリシャス MU
メイヨット YT
メキシコ MX
名称 ISO コード
アグアスカリエンテス AGS
バハ・カリフォルニア BC
バハ・カリフォルニア・スル BCS
カンペチェ CAMP
チアパス州 CHIS
チワワ CHIH
メキシコシティ DF
クアウイラ COAH
コリマ COL
デュランゴ DGO
グアナフアト GTO
ゲレロ GRO
ヒダルゴ HGO
ハリスコ JAL
メキシコ MEX
ミショアカン MICH
モレロス MOR
ナヤリト NAY
ヌエボ・レオン NL
オアハカ OAX
プエブラ PUE
ケレタロ QRO
キンタナ・ロー Q ROO
サン・ルイス・ポトシ SLP
Sinaloa SIN
ソノラ SON
タバスコ TAB
タマウリパス州 TAMPS
トラスカラ TLAX
ベラクルス VER
ユカタン YUC
サカテカス ZAC
国・地域名 ISO コード
モルドバ共和国 MD
モナコ MC
モンゴル MN
モンテネグロ ME
モンセラート MS
モロッコ MA
モザンビーク MZ
ミャンマー MM
ナミビア NA
ナウル NR
ネパール NP
オランダ NL
オランダ領アンティル AN
ニューカレドニア NC
ニュージーランド NZ
地域
名称 ISO コード
オークランド AUK
ベイ・オブ・プレンティ BOP
カンタベリー CAN
ギズボーン GIS
ホークスベイズベイ HKB
マナワツ・ワンガヌイ MWT
マールボロ MBH
ネルソン NSN
ノースランド NTL
オタゴ OTA
サウスランド STL
タラナキ TKI
タスマン TAS
ワイカト WKO
ウェリントン WGN
西海岸 WTC
国・地域名 ISO コード
ニカラグア NI
ニジェール NE
ナイジェリア NG
名称 ISO コード
アビア AB
アブジャ連邦首都特別地域 FC
アダマワ AD
アクワ・イボム州 AK
アナンブラ AN
バウチ BA
バイエルサ BY
ベニュー BE
ボーノ BO
クロスリバー CR
デルタ DE
エボニー EB
エド ED
エキチ EK
エムグ EN
ゴムべ GO
アイモ IM
ジガワ JI
カドゥナ KD
カノ KN
カツィナ KT
ケビ州 KE
コビ KO
クワラ KW
ラゴス LA
ナサラワ NA
ニジェール NI
オグン OG
オンドー ON
オスン OS
オヨ OY
プラトー PL
リバーズ RI
ソコト SO
タラバ州 TA
ヨーべ YO
ザムファラ ZA
国・地域名 ISO コード
ニウエ NU
ノーフォーク島 NF
ノルウェー NO
オマーン OM
パキスタン PK
パレスチナ自治区、占領下 PS
パナマ 州 PA
州名 ISO コード
ボカスデルトロ PA-1
チリキ PA-4
コクレ PA-2
コロン
ダリエン PA-5
エンベラ PA-EM
エレーラ PA-6
クナヤラ PA-KY
ロスサントス PA-7
ノベ・ブグレ PA-NB
パナマ PA-8
西パナマ PA-10
ベラグアス PA-9
国・地域名 ISO コード
パプアニューギニア PG
パラグアイ PY
ペルー PE
名称 ISO コード
アマゾナス PE-AMA
アンカッシュ PE-ANC
アプリーマック PE-APU
アレキパ PE-ARE
アヤクーチョ PE-AYA
カハマルカ PE-CAJ
カルラオ PE-CAL
クスコ PE-CUS
フアンカベリカ PE-HUV
フアスコ PE-HUC
アイカ PE-ICA
フニン PE-JUN
ラ・リベルタ PE-LAL
ランバイエケ PE-LAM
リマ(部門) PE-LIM
リマ(州) PE-LMA
ロレト PE-LOR
マドレ・デ・ディオス PE-MDD
モケグァ PE-MOQ
パスコ PE-PAS
ピウラ PE-PIU
プーノ PE-PUN
サンマルティン PE-SAM
タクナ PE-TAC
タンベス PE-TUM
ウカイヤリ PE-UCA
国・地域名 ISO コード
フィリピン PH
ピトケアン PN
ポーランド PL
ポルトガル PT
名称 ISO コード
アゾレス PT-20
アヴェイロ PT-01
ベジャ PT-02
ブラガ PT-03
ブルガンカ PT-04
カステロ・ブランコ PT-05
コインブラ PT-06
エヴォラ PT-07
ファーロ PT-08
ガイド PT-09
レイリア PT-10
リスボア PT-11
マデイラ PT-30
ポルタレグレ PT-12
ポルト PT-13
サンタレン PT-14
セトゥーバル EN-15
ビアナ・ド・カステロ EN-16
ビラ・レアル EN-17
ヴィセウ EN-18
国・地域名 ISO コード
カタール QA
カメルーン共和国 CM
レユニオン RE
ルーマニア RO
地域
名称 ISO コード
アルバ AB
アラド AR
アルゲリッチ AG
バカウ BC
ビホルダー BH
ビストリタ-ナサウド BN
ボトラーニ BT
ブラシュオヴ BV
ブレイラ BR
ブカレスト B
ブザウ BZ
カララシ CLv
カラシュ・セベリン CS
クルージュ CJ
コンスタンツァ CT
コバスナ CV
ダンボヴィア DB
ドルジ DJ
ガラティ GL
ギュルギュー GR
ゴルジ GJ
ハルヒタ HR
フネドアラ HD
イアシ IS
イアロミタ IL
イルフォブ IF
マラムレス MM
メヘディンティ MH
ミュール MS
ニームト NT
オルト OT
プラホバ PH
サラジャ SJ
サツマレ SM
シビウ SB
スチャバ SV
テリオルマン TR
ティミス TM
トゥルセア TL
バルセア VL
バスクリン VS
ヴランシア VN
国・地域名 ISO コード
ロシア RU
名称 ISO コード
アディゲヤ共和国 AD
アルタイ共和国 AL
アルタイ・クライ ALT
アムール オブスト AMU
アルハンゲリスク州 ARK
アストラハン州 AST
バシコルトスタン共和国 BA
ベルゴロド州 BEL
ブリャンスク州 BRY
ブリヤート共和国 BU
チェチェン共和国 CE
チェリャビンスク州 CHE
チュコトカ自治管区 CHU
チュバシュ共和国 CU
ダゲスタン共和国 DA
イングーシェティア共和国 IN
イルクーツク州 IRK
イワノボ・オブラヴ IVA
ユダヤ人自治州 YEV
カバルディノ・バルカリア共和国 KB
カリーニングラード州 KGD
カルムイキア共和国 KL
カルーガ州 KLU
カムチャッカ Krai KAM
カラチャイ-チェルケス共和国 KC
カレリア共和国 KR
ケメロボ州 KEM
ハバロフスク地方 KHA
ハカッシア共和国 KK
ハンティマンシ自治管区 KHM
キーロフ・オブラヴ KIR
コミ共和国 KO
コストロマ州 KOS
クラスノダール Krai KDA
クラスノヤルスク・クライスラーイ KYA
クルガン・オブラート KGN
クルスク・オブラスト KRS
レニングラード・オブラヴ LEN
リペツク州 LIP
マガダン州 MAG
マリ・エル・リパブリック ME
モルドヴィア共和国 MO
モスクワ MOW
モスクワ州 MOS
ムルマンスク・オブラート MUR
ニジニ・ノヴゴロド州 NIZ
ノヴゴロド州 NGR
ノボシビルスク州 NVS
オムスク・オブラート OMS
オレンブルク州 ORE
オリョール州 ORL
ペンザオブラスト PNZ
ペルミ地方 PER
沿海地方 PRI
プスコフ州 PSK
ロストフ州 ROS
リャザン州 RYA
サンクトペテルブルク SPE
サハ共和国(ヤクーチア) SA
サハリン・オブラスター SAK
サマラ州 SAM
サラトフ州 SAR
北オセチア・アラニア共和国 SE
スモレンスク・オブラヴ SMO
スタヴロポリ地方 STA
スヴェルドロフスク州 SVE
タンボフ州 TAM
タタルスタン共和国 TA
トムスク・オブラート TOM
トゥラオブラスト TUL
トヴェリ州 TVE
チュメニ州 TYU
タイバ共和国 TY
ウドムルト UD
ウリヤノフスク州 ULY
ウラジーミル州 VLA
ヴォルゴグラード州 VGG
ヴォログダ州 VLG
ヴォロネジ州 VOR
ヤマロ・ネネツ自治管区 YAN
ヤロスラヴリ州 YAR
ザバイカリエ地方 ZAB
国・地域名 ISO コード
ルワンダ RW
サン・バルテルミー島 BL
セイントヘレナ SH
セントクリストファー・ネイビス KN
セント・ルシア LC
セント・マーチン MF
サンピエール島・ミクロン島 PM
サモア WS
サンマリノ SM
サントメ・プリンシペ ST
サウジアラビア SA
セネガル SN
セルビア RS
セーシェル SC
シエラレオネ SL
シンガポール SG
セント・マーチン SX
スロバキア SK
スロベニア SI
ソロモン諸島 SB
ソマリア SO
南アフリカ共和国 ZA
名称 ISO コード
東ケープ州 EC
フリーステート FS
ガウテン州 GT
クワズールー・ナタール NL
リンポポ LP
ムプマランガ州 MP
北西部 NW
北ケープ州 NC
西ケープ州 WC
国・地域名 ISO コード
サウスジョージア島と南サンドイッチ諸島 GS
南朝鮮 KR
名称 ISO コード
釜山 KR-26
チュンブク KR-43
忠南 KR-44
大邱 KR-27
テジョン KR-30
江原道 KR-42
光州 KR-29
慶北 KR-47
京畿道 KR-41
慶南 KR-48
仁川 KR-28
済州島 KR-49
全北 KR-45
全南 KR-46
世宗 KR-50
ソウル KR-11
蔚山 KR-31
国・地域名 ISO コード
南スーダン SS
スペイン ES
名称 ISO コード
ア コルーニャ C
アラバ VI
アルバセーテ AB
アリカンテ A
アルメリア AL
アストゥリアス O
アビラ AV
バダボス BA
バレアレス PM
バルセロナ B
ブルゴス BU
カセレス CC
カティス CA
カンタブリア S
カステリョン CS
セウタ CE
シウダードレアル CR
コロドバ CO
クエンカ CU
ジローナ GI
グラナダ GR
グアダラハラ GU
ギプスコア SS
ウエルバ H
ウエスカ HU
ハエン J
ラ・リオハ LO
ラスパルマス GC
レオン LE
ラ・リオハ L
ルーゴ LU
マドリッド M
マラガ MA
メリージャ ML
ムルシア MU
ナバラ NA
オウレンセ OR
パレンシア P
ポンテベドラ PO
サラマンカ SA
サンタ・クルス・デ・テネリフェ TF
セゴビア SG
セビル SE
ソリア SO
タラゴナ T
テルエル TE
トレド TO
バレンシア V
バリャドリッド VA
ビスカヤ BI
サモラ ZA
サラゴサ Z
国・地域名 ISO コード
スリランカ LK
セントビンセント VC
スーダン SD
スリナム SR
スバールバル諸島とヤンマイエン島 SJ
スワジランド SZ
スウェーデン SE
スイス CH
シリア SY
台湾 TW
タジキスタン TJ
タンザニア連合共和国 TZ
タイ TH
地方
名称 ISO コード
アムナートチャロン TH-37
アントン TH-15
バンコク TH-10
ブンカン TH-38
ブリーラム TH-31
チャチューンサオ TH-24
チャイナット TH-18
チャイヤプーン TH-36
チャンタブリー TH-22
チェンマイ TH-50
チェンライ TH-57
チョンブリ TH-20
チュンポン TH-86
カラシン TH-46
カンフェンペット TH-62
カンチャナブリ TH-71
コーンケーン TH-40
クラビ TH-81
ランパン TH-52
ランフン TH-51
ルーイ TH-42
ロップリ TH-16
メーホンソン TH-58
マハサラカム TH-44
ムクダハン TH-49
ナコンナヨック TH-26
ナコン・パトム TH-73
ナコーンパノム TH-48
ナコンラチャシマ TH-30
ナコンサワン TH-60
ナコンシータマラート TH-80
ナン TH-55
ナラーティワート TH-96
ノンブアラムプー TH-39
ノーンカーイ TH-43
ノンタブリ TH-12
パトムタニ TH-13
パッタニー TH-94
パタヤ TH-S
パンガー TH-82
パッタルン TH-93
パヤオ TH-56
ペッチャブーン TH-67
ペッチャブリー TH-76
ピチット TH-66
ピッサヌローク TH-65
プラ・ナコーン・シー・アユタヤ TH-14
プレー TH-54
プーケット TH-83
プラチンブリー TH-25
プラチュアップ・キリ・カーン TH-77
ラノーン TH-85
ラーチャブリー TH-70
ラヨーン TH-21
ローイエット TH-45
サカエオ TH-27
サコンナコーン TH-47
サムットプラカーン TH-11
サムットサコーン TH-74
サムットソンクラーム TH-75
サラブリ TH-19
サトゥーン TH-91
シンブリー TH-17
シサケット TH-33
ソンクラー TH-90
スコータイ TH-64
スパンブリー TH-72
スラートターニー TH-84
スリン TH-32
タク TH-63
トラン TH-92
トラート TH-23
ウボン・ラーチャターニー TH-34
ウドンターニー TH-41
ウタイタニ TH-61
ウッタラディット TH-53
ヤーラ TH-95
ヤソトン TH-35
国・地域名 ISO コード
東ティモール TL
トーゴ TG
トケラウ島 TK
トンガ TO
トリニダード・トバゴ TT
チュニジア TN
トルコ TR
トルクメニスタン TM
タークス・カイコス諸島 TC
ツバル TV
ウガンダ UG
ウクライナ UA
アラブ首長国連邦 AE
地方
名称 ISO コード
アブダビ AZ
アジュマーン AJ
ドバイ DU
フジャイラ FU
ラスアルハイマ RK
シャルジャ SH
ウンム・アル・クワイン UQ
国・地域名 ISO コード
イギリス GB
アメリカ合衆国 US
米国
名称 ISO コード
アラバマ AL
アラスカ AK
アメリカ領サモア AS
アリゾナ州 AZ
アーカンソー州 AR
カリフォルニア州 CA
コロラド CO
コネチカット州 CT
デラウェア DE
コロンビア特別区 DC
ミクロネシア連邦 FM
フロリダ州 FL
ジョージア GA
グアム GU
ハワイ HI
アイダホ ID
イリノイ州 IL
インディアナ州 IN
アイオワ IA
カンザス州 KS
ケンタッキー州 KY
ルイジアナ州 LA
メイン ME
マーシャル諸島 MH
メリーランド MD
マサチューセッツ州 MA
ミシガン州 MI
ミネソタ州 MN
ミシシッピ MS
ミズーリ州 MO
モンタナ MT
ネブラスカ NE
ネバダ州 NV
ニューハンプシャー NH
ニュージャージー州 NJ
ニューメキシコ州 NM
ニューヨーク NY
ノースカロライナ州 NC
ノースダコタ州 ND
北マリアナ諸島 MP
オハイオ OH
オクラホマ OK
オレゴン OR
パラオ PW
ペンシルバニア PA
プエルトリコ PR
ロードアイランド州 RI
サウスカロライナ州 SC
サウスダコタ SD
テネシー州 TN
テキサス州 TX
ウター UT
バーモント州 VT
バージニア州 VA
ワシントン州 WA
ウエストバージニア WV
ウィスコンシン州 WI
ワイオミング WY
ヴァージン諸島 VI
アメリカ軍 AA
軍隊ヨーロッパ AE
太平洋軍 AP
国・地域名 ISO コード
米国のマイナーな離島 UM
ウルグアイ UY
ウズベキスタン UZ
バヌアツ VU
ベネズエラ VE
ベトナム VN
英領バージン諸島 VG
ウォリス・アンド・フツナ WF
西サハラ EH
イエメン YE
ザンビア ZM
ジンバブエ ZW

条件付きレートの作成

次の deliveryProfileCreate mutation は、価格を条件とする配送プロファイルの静的なレートを指定します。このレートは、100 ドル以上の注文のチェックアウト時に表示されます。mutation のためのプロファイル入力オブジェクトには、rateDefinitionと条件の基準を示すmethodDefinitionsToCreate配列が含まれています。

POST /admin/api/unstable/graphql.json

mutation {
  deliveryProfileCreate(
    profile: {
      name: "A condition profile"
      variantsToAssociate: ["gid://shopify/ProductVariant/13672596242488"]
      locationGroupsToCreate: {
        locations: ["gid://shopify/Location/9562054"]
        zonesToCreate: [
          {
            name: "United States"
            countries: [{ code: US }]
            methodDefinitionsToCreate: [
              {
                name: "conditional_rate"
                active: true
                rateDefinition: { price: { amount: 20.5, currencyCode: USD } }
                priceConditionsToCreate: {
                  criteria: { amount: 100.00, currencyCode: USD }
                  operator: GREATER_THAN_OR_EQUAL_TO
                }
              }
            ]
          }
        ]
      }
    }
  ) {
    profile {
      id
      name
      profileLocationGroups {
        locationGroup {
          id
          locations(first: 1, includeLegacy: true) {
            edges {
              node {
                id
                name
              }
            }
          }
        }
        locationGroupZones(first: 1) {
          edges {
            node {
              zone {
                name
                countries {
                  name
                }
              }
              methodDefinitions(first: 1) {
                edges {
                  node {
                    id
                    name
                    active
                    rateProvider {
                      ... on DeliveryParticipant {
                        id
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
    userErrors {
      field
      message
    }
  }
}
json response
{
  "data": {
    "deliveryProfileCreate": {
      "profile": {
        "id": "gid://shopify/DeliveryProfile/7929912",
        "name": "A conditional profile",
        "profileLocationGroups": [
          {
            "locationGroup": {
              "id": "gid://shopify/DeliveryLocationGroup/6651960",
              "locations": {
                "edges": [
                  {
                    "node": {
                      "id": "gid://shopify/Location/9562054",
                      "name": "Elgin"
                    }
                  }
                ]
              }
            },
            "locationGroupZones": {
              "edges": [
                {
                  "node": {
                    "zone": {
                      "name": "United States",
                      "countries": [
                        {
                          "name": "United States"
                        }
                      ]
                    },
                    "methodDefinitions": {
                      "edges": [
                        {
                          "node": {
                            "id": "gid://shopify/DeliveryMethodDefinition/36077624",
                            "name": "conditional_rate",
                            "active": true,
                            "rateProvider": {}
                          }
                        }
                      ]
                    }
                  }
                }
              ]
            }
          }
        ]
      },
      "userErrors": []
    }
  },
  ...
}

配送プロファイルの使用例

配送プロファイルを検索することは、さまざまなシナリオで有用です。

ある商品がどの配送プロファイルに属しているかを調べる

次の例では、バリアント ID を使って配送プロファイル ID を返しています。

POST /admin/api/unstable/graphql.json

{
  productVariant(id: "gid://shopify/ProductVariant/21788692185193") {
    id
    deliveryProfile {
      id
      name
    }
  }
}
json response
{
  "data": {
    "productVariant": {
      "id": "gid://shopify/ProductVariant/21788692185193",
      "deliveryProfile": {
        "id": "gid://shopify/DeliveryProfile/7897144",
        "name": "My Other Fulfillment Service's Profile"
      }
    }
  },
  ...
}

製品に適用されるレートを決定する

次の例では、ロケーショングループと配送ゾーンを使って、バリアントの配送プロファイルに関連する料金を確認しています。

POST /admin/api/unstable/graphql.json

query {
  productVariant(id: "gid://shopify/ProductVariant/21788698476649") {
    deliveryProfile {
      profileLocationGroups {
        locationGroupZones(first: 3) {
          edges {
            node {
              zone {
                name
                countries {
                  name
                }
              }
              methodDefinitions(first: 3) {
                edges {
                  node {
                    id
                    name
                    methodConditions {
                      id
                      operator
                      conditionCriteria {
                        ... on Weight {
                          value
                        }
                        ... on MoneyV2 {
                          amount
                          currencyCode
                        }
                      }
                    }
                    rateProvider {
                      ... on DeliveryRateDefinition {
                        id
                        price {
                          amount
                          currencyCode
                        }
                      }
                      ... on DeliveryParticipant {
                        id
                        fixedFee {
                          amount
                          currencyCode
                        }
                        percentageOfRateFee
                        participantServices {
                          active
                          name
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}
json response
{
  "data": {
    "productVariant": {
      "deliveryProfile": {
        "profileLocationGroups": [
          {
            "locationGroupZones": {
              "edges": [
                {
                  "node": {
                    "zone": {
                      "name": "Canada",
                      "countries": [
                        {
                          "name": "Canada"
                        }
                      ]
                    },
                    "methodDefinitions": {
                      "edges": [
                        {
                          "node": {
                            "id": "gid://shopify/DeliveryMethodDefinition/36044856",
                            "name": "my_carrier_service_name",
                            "methodConditions": [],
                            "rateProvider": {
                              "id": "gid://shopify/DeliveryParticipant/13697080",
                              "fixedFee": {
                                "amount": "0.0",
                                "currencyCode": "USD"
                              },
                              "percentageOfRateFee": 0,
                              "participantServices": []
                            }
                          }
                        }
                      ]
                    }
                  }
                }
              ]
            }
          }
        ]
      }
    }
  },
  ...
}

レート・プロバイダーの返却

以下のクエリを使用して、配送プロファイルの配送方法に適用されるレートプロバイダを返すことができます。

POST /admin/api/unstable/graphql.json

query {
  deliveryProfiles(first: 1) {
    edges {
      node {
        profileLocationGroups {
          locationGroupZones(first: 3) {
            edges {
              node {
                methodDefinitions(first: 3) {
                  edges {
                    node {
                      rateProvider {
                        ... on DeliveryRateDefinition {
                          id
                          price {
                            amount
                          }
                        }
                        ... on DeliveryParticipant {
                          id
                          fixedFee {
                            amount
                            currencyCode
                          }
                          percentageOfRateFee
                          participantServices {
                            active
                            name
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}
json response
{
  "data": {
    "deliveryProfiles": {
      "edges": [
        {
          "node": {
            "profileLocationGroups": [
              {
                "locationGroupZones": {
                  "edges": [
                    {
                      "node": {
                        "methodDefinitions": {
                          "edges": [
                            {
                              "node": {
                                "rateProvider": {
                                  "id": "gid://shopify/DeliveryRateDefinition/13172792",
                                  "price": {
                                    "amount": "8.0"
                                  }
                                }
                              }
                            },
                            {
                              "node": {
                                "rateProvider": {
                                  "id": "gid://shopify/DeliveryRateDefinition/13205560",
                                  "price": {
                                    "amount": "18.0"
                                  }
                                }
                              }
                            },
                            {
                              "node": {
                                "rateProvider": {
                                  "id": "gid://shopify/DeliveryParticipant/11567160",
                                  "fixedFee": {
                                    "amount": "0.0",
                                    "currencyCode": "USD"
                                  },
                                  "percentageOfRateFee": 0,
                                  "participantServices": []
                                }
                              }
                            }
                          ]
                        }
                      }
                    },
                    {
                      "node": {
                        "methodDefinitions": {
                          "edges": [
                            {
                              "node": {
                                "rateProvider": {
                                  "id": "gid://shopify/DeliveryRateDefinition/13107256",
                                  "price": {
                                    "amount": "5.0"
                                  }
                                }
                              }
                            }
                          ]
                        }
                      }
                    },
                    {
                      "node": {
                        "methodDefinitions": {
                          "edges": [
                            {
                              "node": {
                                "rateProvider": {
                                  "id": "gid://shopify/DeliveryRateDefinition/13140024",
                                  "price": {
                                    "amount": "18.0"
                                  }
                                }
                              }
                            },
                            {
                              "node": {
                                "rateProvider": {
                                  "id": "gid://shopify/DeliveryParticipant/11534392",
                                  "fixedFee": {
                                    "amount": "0.0",
                                    "currencyCode": "USD"
                                  },
                                  "percentageOfRateFee": 0,
                                  "participantServices": []
                                }
                              }
                            }
                          ]
                        }
                      }
                    }
                  ]
                }
              }
            ]
          }
        }
      ]
    }
  },
  ...
}

GraphQL Admin API による返金業務

API バージョン 2020-04 以降

このガイドでは、GraphQL Admin API を使用して職務のプレビューと払い戻しを行う方法について説明します。関税を管理するには、Duties and Taxes の開発者プレビューを有効にした開発ストアが必要です。

関税はラインアイテムごとに計算され、Admin API のLineItem オブジェクトのフィールドとして表示されます。refundCreate mutation で関税を還付する前に、suggestedRefund クエリで還付をプレビューできます。

注文と払い戻しに関連するオブジェクトとミューテーションの詳細については、GraphQL Admin API リファレンスを参照してください。

アクセススコープ

GraphQL Admin API を使用して関税を返金するには、アプリが Shopify ストアの write_order アクセススコープを要求する必要があります。アプリのインストール時にアクセススコープを要求する方法については、「OAuth」を参照してください。

デューティチャージのあるオーダーの作成

チュートリアルを完了する前に、関税を適用した国際注文を作成する必要があります。関税を適用した国際注文を作成するには、duties and taxesのプレビューを有効にした開発者プレビューストアを使用します。

手順は以下の通りです。

  1. 関税が適用されることが予想されるすべての商品に調和システムコードを設定します。

  2. ストアで、サポートを予定しているすべての国の配送料が設定されていることを確認します。

  3. 開発用ストアでテストオーダーができるように設定されていることを確認します。

  4. ストアフロントからチェックアウトを完了します。配送先のステップでは、商品が配送される国とは異なる国を入力する必要があります。注文に関税が適用されている場合は、送料ビューと注文サマリーに表示されます。

Discussion

ログインするとコメントできます