Content API, bir hesaptaki tüm ürünler için geçerli olacak vergi ve gönderim bedelini, shippingsettings ve accounttax hizmetleri aracılığıyla belirtmenize olanak tanır. Daha kesin bilgi vermek istiyorsanız products hizmeti aracılığıyla öğe düzeyinde vergi ve gönderim bedeli belirtebilirsiniz.
Google politikaları ve vergi ile gönderim bedelini belirtmeye ilişkin tüm seçenekler hakkında bilgi için aşağıdaki Yardım Merkezi makalelerini inceleyin:
tax özelliğinin ve dolayısıyla hesap vergisi hizmetinin kullanımının yalnızca ABD'yi hedefleyen ürünler için geçerli olduğunu unutmayın.
accounttax ve shippingsettings Content API hizmetleri, Merchant Center kullanıcı arayüzünün işlevlerini yansıtır.
Basit örnek
Her bir kargo hizmetinin 3-7 gün içinde teslim edildiği, Fransa'da 8 avro olan gönderim ücretleri ve ABD'deki kargo ücretlerine göre:
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 },
}
]
}Kullanılabilir operatör adlarını ve hizmetlerini almak için getsupportedcarriers yöntemini kullanın.
Karmaşık örnek
New York eyaletlerinde ücretsiz kargo promosyonu oluşturmak (kargo ücreti almayarak) ABD'nin geri kalanında UPS'i, ABD eyaletlerinin her biri için farklı bir vergi uygulamak için Content API'nin accounttax ve shippingsettings hizmetleriyle ilgili istekleri aşağıdaki şekilde kullanın. İlk olarak gönderim ayarlarını yapılandırın:
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*" }
]
}
]
}
Konum kimliklerinin idari bölgeleri temsil etmek için kullanılabileceğini unutmayın.
Ardından, vergi ücretlerini yapılandırın:
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"
}
// ...
]
}Not: Kargo ücretleri yalnızca ABD, Almanya ve Avustralya'da geçerlidir. Yer grupları şu anda ABD ve Avustralya'da desteklenmektedir.
Karmaşık kargo kuralları: iki boyutlu tablolar ve alt tablolar
Siparişin fiyatına bağlı olarak ABD'de 7 ABD doları, New York'ta 10 libreden ağır siparişler için 3 ABD doları veya 5 ABD doları tutarında bir kargo promosyonu tanımlamak ve bu ağırlığın altındaki ücretsiz ürünleri kullanmak için aşağıdakileri kullanın:
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" } ] } ] }
Karmaşık gönderim kuralları: gönderi etiketlerini hizmetlere ayırma
Kargo ayarlarında her kargo hizmeti en fazla 20 kargo içerebilir. kargo ücreti gruplarına ekleyin. Kargo ücreti grupları, etiketleri kullanarak yalnızca 20 kargo ücretinin geçerli olduğunu Benzersiz kargo ücretleri, kargo etiketleriyle uygulanabilir. Ancak, Ülke başına 20 adede kadar kargo hizmetiniz olmalıdır. Ücretleri bölerek aynı ülke için birden fazla hizmete göre gönderi etiketlerine göre ayırt edilir, Gönderi etiketleriyle 400 adede kadar benzersiz kargo ücreti ayırt edebilirsiniz.
Not: Birden fazla hizmetiniz varsa her hizmet ürün, ilgili ülkedeki tüm kargo hizmetleri ile karşılaştırılarak kontrol edilir. ülke seçeneğini belirleyin. Birden fazla hizmet geri gelirse için en düşük ücret kullanılır.
Aşağıdaki örnekte, benzersiz ücretler kullanan 40 gönderi etiketi ikiye farklı hizmetler. Bu örnekte kargoyla ilgili diğer ayrıntılar gizlenmektedir. gerçek oranları gibi değerleri hesaplamalarına olanak tanır.
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": [ ... ]
}
Kargo etiketlerinin ücret grupları arasında bu şekilde bölünmesi de gerekebilir
gönderi etiketleri aynı kargo ücretini paylaşsa bile. Çünkü her bir ücret
grubun içinde yalnızca 30 gönderi etiketi olabilir
applicableShippingLabels alanı boş bırakılamaz. Uç bir örnek vermek gerekirse
Tüm kargo etiketleri aynı ücret yapısını paylaşıyorsa
shippingsettings, en fazla
Tek bir ülke için 12.000 gönderi etiketi: Ücret başına 30 gönderi etiketi
grubu, kargo hizmeti başına 20 ücret grubu ve her müşteri için 20 kargo hizmeti
ülke.
Daha fazla bilgi için accounttax ve shippingsettings referans belgelerine bakın.