Content API की मदद से, shippingsettings और accounttax सेवाओं के ज़रिए, टैक्स और शिपिंग की जानकारी दी जा सकती है. यह जानकारी, खाते के सभी प्रॉडक्ट पर लागू होगी. अगर आपको ज़्यादा सटीक जानकारी देनी है, तो products सेवा की मदद से, आइटम-लेवल पर टैक्स और शिपिंग की जानकारी दी जा सकती है.
Google की नीतियों और टैक्स और शिपिंग की जानकारी देने के सभी विकल्पों के बारे में जानने के लिए, सहायता केंद्र के ये लेख पढ़ें:
ध्यान दें कि tax एट्रिब्यूट और इसलिए, accounttax सेवा का इस्तेमाल सिर्फ़ अमेरिका को टारगेट करने वाले प्रॉडक्ट पर लागू होता है.
accounttax और shippingsettings Content API की सेवाएं, Merchant Center के यूज़र इंटरफ़ेस (यूआई) की सुविधाओं को दिखाती हैं.
आसान उदाहरण
फ़्रांस में शिपिंग के लिए खरीदार से लिए जाने वाले शुल्क के तौर पर 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*" }
]
}
]
}ध्यान दें कि जगह के आईडी का इस्तेमाल, प्रशासनिक इलाकों को दिखाने के लिए किया जा सकता है.
इसके बाद, टैक्स के शुल्क कॉन्फ़िगर करें:
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"
}
// ...
]
}ध्यान दें: कैरियर की तय की गई दरें सिर्फ़ अमेरिका, जर्मनी, और ऑस्ट्रेलिया में उपलब्ध हैं. फ़िलहाल, जगह के हिसाब से ग्रुप बनाने की सुविधा अमेरिका और ऑस्ट्रेलिया में उपलब्ध है.
शिपिंग के जटिल नियम: दो-आयामी टेबल और सबटेबल
अमेरिका में शिपिंग के लिए 70 रुपये, न्यूयॉर्क शहर में 10 पाउंड से ज़्यादा वज़न वाले ऑर्डर के लिए 30 रुपये या 50 रुपये का प्रमोशन तय करने के लिए, ऑर्डर की कीमत के आधार पर यह तय करें. इसके अलावा, 10 पाउंड से कम वज़न वाले ऑर्डर के लिए शिपिंग के लिए कोई शुल्क नहीं लिया जाएगा. इसके लिए, इस फ़ॉर्मैट का इस्तेमाल करें:
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 यूनीक दरें तय की जा सकती हैं.
ध्यान दें: अगर आपके पास एक से ज़्यादा सेवाएं हैं, तो किसी देश के लिए हर प्रॉडक्ट की शिपिंग की संभावित दरों का हिसाब लगाने के लिए, उस देश के लिए उपलब्ध सभी शिपिंग सेवाओं की जांच की जाती है. अगर एक ही प्रॉडक्ट के लिए, एक से ज़्यादा सेवाएं अलग-अलग दरें दिखाती हैं, तो सबसे कम दर का इस्तेमाल किया जाएगा.
नीचे दिए गए उदाहरण में, दो अलग-अलग सेवाओं के लिए, शिपिंग के 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 के लिए रेफ़रंस दस्तावेज़ देखें.