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, 000원에 해당하는 20개의 배송물 라벨을 통해 고유한 배송비 요율을 적용할 수 있습니다. 하지만 Cloud Shell에서 국가당 최대 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": [ ... ]
}
배송비 그룹에서 배송물 라벨을 분할해야 할 수도 있습니다.
배송물 라벨이 동일한 배송비 요율을 공유하더라도 동일한 배송비 요율에
한 그룹에는 30개의 배송물 라벨만 포함할 수 있습니다.
applicableShippingLabels 필드 극단적인 예로,
모든 배송물 라벨이 동일한 배송비 구조를 공유하는 경우
shippingsettings에서 최대
단일 국가의 배송물 라벨 12,000개: 배송비당 배송물 라벨 30개
그룹, 배송 서비스당 배송비 그룹 20개, 배송 서비스당 20개 배송 서비스
있습니다.
자세한 내용은 accounttax 및 shippingsettings의 참조 문서를 확인하세요.