खाता-लेवल टैक्स और शिपिंग

Content API की मदद से, टैक्स और शिपिंग की जानकारी दी जा सकती है. यह जानकारी, shippingsettings और accounttax सेवाओं के ज़रिए, किसी खाते में मौजूद सभी प्रॉडक्ट पर लागू होगी. अगर आपको ज़्यादा सटीक जानकारी देनी है, तो products सेवा के ज़रिए, आइटम-लेवल पर टैक्स और शिपिंग की जानकारी दी जा सकती है.

Google की नीतियों और टैक्स और शिपिंग की जानकारी देने के सभी विकल्पों के बारे में जानने के लिए, सहायता केंद्र के ये लेख पढ़ें:

• टैक्स और शिपिंग
• खाते के लेवल पर शिपिंग की सेटिंग कॉन्फ़िगर करना

ध्यान दें कि tax एट्रिब्यूट और इसलिए accounttax सेवा का इस्तेमाल, सिर्फ़ अमेरिका को टारगेट करने वाले प्रॉडक्ट के लिए किया जा सकता है.

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 की 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"
    }
    // ...
  ]
}

ध्यान दें: कैरियर की दरें सिर्फ़ अमेरिका, जर्मनी, और ऑस्ट्रेलिया में उपलब्ध हैं. फ़िलहाल, लोकेशन ग्रुप की सुविधा अमेरिका और ऑस्ट्रेलिया में उपलब्ध है.

शिपिंग के जटिल नियम: दो डाइमेंशन वाली टेबल और सबटेबल

अमेरिका में 700 रुपये की शिपिंग छूट तय करने के लिए, इस कोड का इस्तेमाल करें: NYC में 10 पाउंड से ज़्यादा वज़न वाले ऑर्डर के लिए, ऑर्डर की कीमत के आधार पर 300 रुपये या 500 रुपये की छूट तय करने के लिए, इस कोड का इस्तेमाल करें: 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" }
      ]
    }
  ]
}

शिपिंग के मुश्किल नियम: शिपिंग लेबल को सेवाओं के हिसाब से बांटना

shippingSettings में, हर शिपिंग सेवा में ज़्यादा से ज़्यादा 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 के लिए रेफ़रंस दस्तावेज़ देखें.