Content API를 사용하면 shippingsettings 및 accounttax 서비스를 통해 계정 내의 모든 제품에 적용할 세금 및 배송을 지정할 수 있습니다. 보다 정확한 정보를 원하는 경우 products 서비스를 통해 상품 수준에서 세금 및 배송을 지정하면 됩니다.
Google 정책 및 세금 및 배송 지정을 위한 모든 옵션에 대한 자세한 내용은 다음 고객센터 도움말을 참고하세요.
tax 속성 및 그에 따른 계정세 서비스 사용은 미국을 타겟팅하는 제품에만 적용됩니다.
accounttax 및 shippingsettings Content API 서비스는 판매자 센터 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의 accounttax 및 shippingsettings 서비스에 대한 요청을 사용하세요. 먼저 배송 설정을 구성합니다.
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달러, 뉴욕에서는 10파운드를 초과하는 주문에 대해 3달러, 5달러, 주문 가격에 따라 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 필드 내에 배송물 라벨 30개만 사용할 수 있으므로 배송물 라벨이 동일한 배송비를 공유하는 경우에도 배송비 그룹 간에 배송물 라벨을 분할해야 할 수 있습니다. 극단적인 예로 모든 배송물 라벨이 동일한 배송비 구조를 공유하는 경우 shippingsettings는 한 국가에서 최대 12,000개의 배송물 라벨을 처리할 수 있습니다. 즉, 배송비 그룹당 배송물 라벨 30개, 배송 서비스당 배송비 그룹 20개, 국가당 배송 서비스 20개를 처리할 수 있습니다.
자세한 내용은 accounttax 및 shippingsettings의 참조 문서를 확인하세요.