アカウント単位の税金と送料

Content API では、shippingsettings サービスと accounttax サービスを使用して、アカウント内のすべての商品に適用される税金と送料を指定できます。より正確に指定したい場合は、products サービスを使用して、商品アイテム単位で税金と送料を指定できます。

Google のポリシーと、税金と送料を指定するすべてのオプションについて詳しくは、以下のヘルプセンターの記事をご覧ください。

なお、tax 属性(したがってアカウント税サービスの使用)は米国を対象とする商品にのみ適用されます。

accounttax サービスと shippingsettings の Content API サービスは、Merchant Center の UI の機能を反映しています。

簡単な例

フランスでの送料が 8 ユーロの場合、米国の運送業者の送料に基づいて計算されます。各配送サービスで配達に 3 ~ 7 日かかります。

PUT /content/v2.1/<merchant_id>/shippingsettings/<account_id>
{
 
"accountId": <account_id>,
 
"services": [
   
{
     
"name": "Livraison Prioritaire",
     
"deliveryCountry": "FR",
     
"currency": "EUR",
     
"rateGroups": [
       
{
         
"singleValue": {
           
"flatRate": { "currency": "EUR", "value": "8" }
         
}
       
}
     
],
     
"active": true,
     
"deliveryTime": { "minTransitTimeInDays": 3, "maxTransitTimeInDays": 7 }
   
},
   
{
     
"name": "UPS in US",
     
"deliveryCountry": "US",
     
"currency": "USD"
     
"rateGroups": [
       
{
         
"singleValue": { "carrierRateName": "ups" },
         
"carrierRates": [
           
{
             
"name": "ups",
             
"carrierName": "UPS",
             
"carrierService": "Ground",
             
"originPostalCode": "10011"
           
}
         
]
       
}
     
],
     
"active": true,
     
"deliveryTime": { "minTransitTimeInDays": 3, "maxTransitTimeInDays": 7 },
   
}
 
]
}

利用可能な携帯通信会社の名前とサービスを取得するには、getsupportedcarriers メソッドを使用します。

複雑な例

ニューヨーク周辺の州で送料無料のプロモーションを作成するには(送料を請求しない)、米国のその他の州には UPS を使用し、米国の州ごとに異なる税金を適用するには、Content API の口座税サービスと配送設定サービスに対するリクエストを次のように使用します。最初に配送設定を行います。

PUT /content/v2.1/<merchant_id>/shippingsettings/<account_id>
{
 
"accountId": <account_id>,
 
"services": [
   
{
     
"name": "Eligible for free shipping",
     
"deliveryCountry": "US",
     
"rateGroups": [
       
{
         
"mainTable": {
           
"rowHeaders": {
             
"locations": [
               
{ "locationIds": ["21167"] }, // NY
               
{ "locationIds": ["21164", "21139"] }  // NJ, CT
             
]
           
},
           
"rows": [
             
{
               
"cells": [
                 
{
                   
"flatRate": { "currency": "USD", "value": "0" }
                 
}
               
]
             
},
             
{
               
"cells": [
                 
{
                   
"flatRate": { "currency": "USD", "value": "0" }
                 
}
               
]
             
}
           
]
         
}
       
}
     
],
     
"active": true,
     
"deliveryTime": { "minTransitTimeInDays": 3, "maxTransitTimeInDays": 7 },
     
"currency": "USD"
   
},
   
{
     
"name": "UPS in US",
     
"deliveryCountry": "US",
     
"rateGroups": [
       
{
         
"singleValue": { "carrierRateName": "UPS mainland" },
         
"carrierRates": [
           
{
             
"name": "UPS mainland",
             
"carrierName": "UPS",
             
"carrierService": "Ground",
             
"originPostalCode": "10011",  // currently only US, AU, and DE postal codes
             
"percentageAdjustment": "1.05",
             
"flatAdjustment": { "currency": "USD", "value": "0.75" }
           
}
         
]
       
}
     
],
     
"active": true,
     
"deliveryTime": { "minTransitTimeInDays": 3, "maxTransitTimeInDays": 7 },
     
"currency": "USD"
   
}
   
],
 
"postalCodeGroups": [
   
{
     
"name": "More cities",  // An alternative using postal codes
     
"country": "US",
     
"postalCodeRanges": [
       
{ "postalCodeRangeBegin": "94041" },
       
{ "postalCodeRangeBegin": "94042" },
       
{ "postalCodeRangeBegin": "94043", "postalCodeRangeEnd": "94045" },
       
{ "postalCodeRangeBegin": "9405*" },
       
{ "postalCodeRangeBegin": "9406*", "postalCodeRangeEnd": "9408*" }
     
]
   
}
 
]
}

地域 ID は行政区域を表すために使用できます。

次に、税金を構成します。

PUT /content/v2.1/<merchant_id>/accounttax/<account_id>
{
 
"accountId": <account_id>,
 
"rules": [
   
{
     
"country": "US",  // currently only US is supported, may be omitted
     
"locationId": 21167,
     
"useGlobalRate": true,
     
"shippingTaxed": false
   
},
   
{
     
"locationId": 21137,
     
"useGlobalRate": false,
     
"shippingTaxed": true,
     
"ratePercent": "2.15"
   
}
   
// ...
 
]
}

注: 運送業者の送料は、米国、ドイツ、オーストラリアでのみご利用いただけます。地域グループは現在、米国とオーストラリアでサポートされています。

複雑な送料ルール: 2 次元の表とサブテーブル

米国では 7 ドル、ニューヨーク市では重量が 4 kg を超える注文については、注文の価格に応じて 3 ドルまたは 5 ドルとし、その重量を下回ると無料配送のプロモーションを定義するには、次のように記述します。

PUT /content/v2.1/<merchant_id>/shippingsettings/<account_id>
{
 
"accountId": <account_id>,
 
"services": [
   
{
     
"name": "Custom shipping rules",
     
"deliveryCountry": "US",
     
"rateGroups": [
       
{
         
"mainTable": {
           
"rowHeaders": {
             
"postalCodeGroupNames": [ "NYC", "all other locations" ]
           
},
           
"columnHeaders": {
             
"weights": [
               
{ "unit": "lb", "value": "10" },
               
{ "unit": "lb", "value": "infinity" }
             
]
           
},
           
"rows": [
             
{
               
"cells": [
                 
{ "flatRate": { "value": "0", "currency": "USD" } },
                 
{ "subtableName": "NYC large packages" }
               
]
             
},
             
{
               
"cells": [
                 
{ "flatRate": { "value": "7", "currency": "USD" } },
                 
{ "flatRate": { "value": "7", "currency": "USD" } }
               
]
             
}
           
]
         
},
         
"subtables": [
           
{
             
"name": "NYC large packages",
             
"rowHeaders": {
               
"prices": [
                 
{"value": "100", "currency": "USD"},
                 
{"value": "infinity", "currency": "USD"}]
             
},
             
"rows": [
               
{
                 
"cells": [
                   
{ "flatRate": { "value": "3", "currency": "USD" } }
                 
]
               
},
               
{
                 
"cells": [
                   
{ "flatRate": { "value": "5", "currency": "USD" } }
                 
]
               
}
             
]
           
}
         
]
       
}
     
],
     
"active": true,
     
"currency": "USD",
     
"deliveryTime": { "minTransitTimeInDays": 3, "maxTransitTimeInDays": 7 }
   
}
 
],
 
"postalCodeGroups": [
   
{
     
"name": "NYC",  // Approximation of NYC using postal codes
     
"country": "US",
     
"postalCodeRanges": [
       
{ "postalCodeRangeBegin": "10000", postalCodeRangeEnd: "11999" }
     
]
   
}
 
]
}

複雑な配送ルール: 配送ラベルをサービスごとに分割する

配送設定では、各配送サービスに含めることができるのは 20 個までです。 送料グループを作成します送料グループは この場合、20 行しかないように見えるかもしれませんが、 固有の送料レートを送料ラベルで適用できます。ただし、 国ごとに最大 20 件の配送サービスがあるレートの分割 同一国向けの複数のサービスで配送ラベルで区別される 送料ラベルを使用して、最大 400 件の一意の送料を区別できます。

注: 複数のサービスがある場合は、 特定の国の商品が、その国のすべての配送サービスと照合され、 送料レートを計算します。複数のサービスから 同じ商品に異なるレートが適用される場合は、最も低いレートが使用されます。

次の例では、2 つの一意の送料を使用して 40 個の配送ラベルを分割します 提供します。この例では、送料に関するその他の情報を非表示にします。 省略記号で囲まれた実際の料金などのリソースを確認できます。

PUT /content/v2.1/<merchant_id>/shippingsettings/<account_id>
{
 
"accountId": <account_id>,
 
"services": [
   
{
     
"name": "labels_0_19",
     
"deliveryCountry": "US",
     
"active": true,
     
"currency": "USD",
     
"deliveryTime": { "minTransitTimeInDays": 3, "maxTransitTimeInDays": 7 }
     
"rateGroups": [
       
{ "applicableShippingLabels": ["shipping_label_0"], ... }
       
{ "applicableShippingLabels": ["shipping_label_1"], ... }
       
{ "applicableShippingLabels": ["shipping_label_2"], ... }
       
{ "applicableShippingLabels": ["shipping_label_3"], ... }
       
{ "applicableShippingLabels": ["shipping_label_4"], ... }
       
{ "applicableShippingLabels": ["shipping_label_5"], ... }
       
{ "applicableShippingLabels": ["shipping_label_6"], ... }
       
{ "applicableShippingLabels": ["shipping_label_7"], ... }
       
{ "applicableShippingLabels": ["shipping_label_8"], ... }
       
{ "applicableShippingLabels": ["shipping_label_9"], ... }
       
{ "applicableShippingLabels": ["shipping_label_10"], ... }
       
{ "applicableShippingLabels": ["shipping_label_11"], ... }
       
{ "applicableShippingLabels": ["shipping_label_12"], ... }
       
{ "applicableShippingLabels": ["shipping_label_13"], ... }
       
{ "applicableShippingLabels": ["shipping_label_14"], ... }
       
{ "applicableShippingLabels": ["shipping_label_15"], ... }
       
{ "applicableShippingLabels": ["shipping_label_16"], ... }
       
{ "applicableShippingLabels": ["shipping_label_17"], ... }
       
{ "applicableShippingLabels": ["shipping_label_18"], ... }
       
{ "applicableShippingLabels": ["shipping_label_19"], ... }
     
]
   
},
   
{
     
"name": "labels_20_39",
     
"deliveryCountry": "US",
     
"active": true,
     
"currency": "USD",
     
"deliveryTime": { "minTransitTimeInDays": 3, "maxTransitTimeInDays": 7 }
     
"rateGroups": [
       
{ "applicableShippingLabels": ["shipping_label_20"], ... }
       
{ "applicableShippingLabels": ["shipping_label_21"], ... }
       
{ "applicableShippingLabels": ["shipping_label_22"], ... }
       
{ "applicableShippingLabels": ["shipping_label_23"], ... }
       
{ "applicableShippingLabels": ["shipping_label_24"], ... }
       
{ "applicableShippingLabels": ["shipping_label_25"], ... }
       
{ "applicableShippingLabels": ["shipping_label_26"], ... }
       
{ "applicableShippingLabels": ["shipping_label_27"], ... }
       
{ "applicableShippingLabels": ["shipping_label_28"], ... }
       
{ "applicableShippingLabels": ["shipping_label_29"], ... }
       
{ "applicableShippingLabels": ["shipping_label_30"], ... }
       
{ "applicableShippingLabels": ["shipping_label_31"], ... }
       
{ "applicableShippingLabels": ["shipping_label_32"], ... }
       
{ "applicableShippingLabels": ["shipping_label_33"], ... }
       
{ "applicableShippingLabels": ["shipping_label_34"], ... }
       
{ "applicableShippingLabels": ["shipping_label_35"], ... }
       
{ "applicableShippingLabels": ["shipping_label_36"], ... }
       
{ "applicableShippingLabels": ["shipping_label_37"], ... }
       
{ "applicableShippingLabels": ["shipping_label_38"], ... }
       
{ "applicableShippingLabels": ["shipping_label_39"], ... }
     
]
   
}
 
],
 
"postalCodeGroups": [ ... ]
}

送料ラベルを料金グループに分割する必要もある 送料ラベルの送料が同じでも 各グループで使用できる配送ラベルは applicableShippingLabels フィールド。極端な例を挙げると すべての送料ラベルが同じ送料構造を共有する場合、 shippingsettings は最大で 1 つの国に 12,000 個の配送ラベル: 料金ごとに 30 個の配送ラベル グループ、配送サービスあたり 20 の送料グループ、および 20 の配送サービス 国によって異なります。

詳しくは、accounttaxshippingsettings のリファレンス ドキュメントをご覧ください。