この記事について
この記事は、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
methodDefinitionsToCreaterateDefinitionを使って静的なレートを指定するか、またはparticipantを使ってキャリアが提供するレートを指定します。
mutation {
deliveryProfileCreate (
profile : {
name : "My Fulfillment Service's Profile "
variantsToAssociate : [ "gid://shopify/ProductVariant/13672596209720" ]
locationGroupsToCreate : {
locations : [
"gid://shopify/Location/17225842744"
]
zonesToCreate : [
{
name : "Canada "
countries : [ { code : CA } ]
methodDefinitionsToCreate : [
{
name : "my_carrier_service_name "
active : true
participant : {
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" : [ ]
}
} ,
...
}
国/地域および州のコードのリスト
この表には、zoneToCreateのcountriesフィールドで使用する、すべての国/地域とその下位区分の 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 コード
安徽省
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 コード
アディゲヤ共和国
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のプレビューを有効にした開発者プレビューストアを使用します。
手順は以下の通りです。
関税が適用されることが予想されるすべての商品に調和システムコード を設定します。
ストアで、サポートを予定しているすべての国の配送料 が設定されていることを確認します。
開発用ストアでテストオーダー ができるように設定されていることを確認します。
ストアフロントからチェックアウトを完了します。配送先のステップでは、商品が配送される国とは異なる国を入力する必要があります。注文に関税が適用されている場合は、送料ビューと注文サマリーに表示されます。
!
注意
注文に適用された関税を取得する
注文を照会する際に、currentTotalDutiesSetフィールドを使用して適用された関税の合計を取得できます。各ラインアイテムに適用された関税を取得したい場合は、lineItems 接続に duties フィールドを含めることができます。
{
order ( id : "gid://shopify/Order/3" ) {
currentTotalDutiesSet {
shopMoney {
amount
}
}
lineItems ( first : 10 ) {
edges {
node {
id
refundableQuantity
duties {
id
harmonizedSystemCode
price {
shopMoney {
amount
}
}
}
}
}
}
}
}
json response
{
"data" : {
"order" : {
"currentTotalDutiesSet" : {
"shopMoney" : {
"amount" : "668.19"
}
} ,
"lineItems" : {
"edges" : [
{
"node" : {
"id" : "gid://shopify/LineItem/2" ,
"refundableQuantity" : 5 ,
"duties" : [
{
"id" : "gid://shopify/Duty/1" ,
"harmonizedSystemCode" : "520100" ,
"price" : {
"shopMoney" : {
"amount" : "668.19"
}
}
}
]
}
}
]
}
}
}
}
関税を含む注文のプレビューと払い戻し
suggestedRefundクエリを使用して返金をプレビューし、返金を作成する準備ができたらrefrundCreatemutation を使用することができます。
suggestedRefundとrefundCreateの両方とも、入力タイプRefundDutyInputを使用します。これにはdutyIdと、関税の払い戻し方法を指定するrefundTypeが必要です。サポートされている返金タイプは、比例型 と全額型 の 2 種類です。
比例 返金タイプは、返金したいラインアイテムの数量に比例して関税を返金します。比例返金型タイプを選択した場合、還付する関税の部分を計算するために、還付ラインアイテムも渡さなければなりません。
全額 返金タイプでは、ある関税 ID に関連するすべての関税が返金されます。全額返金タイプを使用している場合は、返金行項目を含める必要はありません。
比例関税還付のプレビュー
suggestedRefund クエリに、関税 ID、還付タイプ、および還付のプレビューを行う行アイテムの ID と数量を含めます。
query suggestedRefund {
order ( id : "gid://shopify/Order/3" ) {
suggestedRefund (
refundLineItems : [ { lineItemId : "gid://shopify/LineItem/2" , quantity : 1 } ]
refundDuties : [ { dutyId : "gid://shopify/Duty/1" , refundType : PROPORTIONAL } ]
) {
refundDuties {
amountSet {
shopMoney {
amount
currencyCode
}
}
originalDuty {
id
}
}
totalDutiesSet {
shopMoney {
amount
currencyCode
}
}
}
}
}
json response
{
"data" : {
"order" : {
"suggestedRefund" : {
"refundDuties" : [
{
"amountSet" : {
"shopMoney" : {
"amount" : "133.65" ,
"currencyCode" : "CAD"
}
} ,
"originalDuty" : {
"id" : "gid://shopify/Duty/1"
}
}
] ,
"totalDutiesSet" : {
"shopMoney" : {
"amount" : "133.65" ,
"currencyCode" : "CAD"
}
}
}
}
}
}
全額返金のプレビュー
全額 返金タイプをプレビューする際に、注文のラインアイテムを含める必要はありません。
query suggestedRefund {
order ( id : "gid://shopify/Order/3" ) {
suggestedRefund ( refundDuties : [ { dutyId : "gid://shopify/Duty/1" , refundType : FULL } ] ) {
refundDuties {
amountSet {
shopMoney {
amount
currencyCode
}
}
}
totalDutiesSet {
shopMoney {
amount
currencyCode
}
}
}
}
}
json response
{
"data" : {
"order" : {
"suggestedRefund" : {
"refundDuties" : [
{
"amountSet" : {
"shopMoney" : {
"amount" : "668.19" ,
"currencyCode" : "CAD"
}
}
}
] ,
"totalDutiesSet" : {
"shopMoney" : {
"amount" : "668.19" ,
"currencyCode" : "CAD"
}
}
}
}
}
}
関税を含む払い戻しの作成
払い戻しを作成する準備ができたら、 refundCreate mutation に以下の入力パラメータを含めます。
注文 ID
払い戻しを行うラインアイテムの ID と数量
義務 ID
払い戻しタイプ
mutation
mutation refundIncludingDuties {
refundCreate ( input : { orderId : "gid://shopify/Order/3" , refundLineItems : [ { lineItemId : "gid://shopify/LineItem/2" , quantity : 1 } ] , refundDuties : [ { dutyId : "gid://shopify/Duty/1" , refundType : PROPORTIONAL } ] } ) {
refund {
duties {
originalDuty {
id
}
amountSet {
shopMoney {
amount
}
}
}
}
}
}
json response
{
"data" : {
"refundCreate" : {
"refund" : {
"duties" : [
{
"originalDuty" : {
"id" : "gid://shopify/Duty/1"
} ,
"amountSet" : {
"shopMoney" : {
"amount" : "133.65"
}
}
}
]
}
} ,
"userErrors" : [ ]
}
}
追加情報
注文に関する追加情報は、GraphQL Admin API リファレンス を参照してください。
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
Discussion