অ্যাকাউন্ট-স্তরের ট্যাক্স এবং শিপিং

আমরা মার্চেন্ট API- এর বিটা সংস্করণ চালু করতে চাই। এটি কেনাকাটা এবং ভবিষ্যতের জন্য সামগ্রী API-এর নতুন সংস্করণ৷

কিভাবে মার্চেন্ট এপিআই আপনার ইন্টিগ্রেশনকে উন্নত করতে পারে এবং কিভাবে আপনি ভবিষ্যৎ গঠনে সাহায্য করতে পারেন সে সম্পর্কে তথ্যের জন্য, মার্চেন্ট এপিআই বিটা ঘোষণা করা দেখুন।

বিষয়বস্তু API আপনাকে ট্যাক্স এবং শিপিং নির্দিষ্ট করতে সক্ষম করে যা শিপিং সেটিংস এবং অ্যাকাউন্টট্যাক্স পরিষেবাগুলির মাধ্যমে একটি অ্যাকাউন্টের মধ্যে সমস্ত পণ্যগুলিতে প্রযোজ্য হবে৷ আপনি যদি আরও সুনির্দিষ্ট হতে চান তবে আপনি পণ্য পরিষেবার মাধ্যমে একটি আইটেম-স্তরে ট্যাক্স এবং শিপিং নির্দিষ্ট করতে পারেন।

Google নীতি এবং ট্যাক্স এবং শিপিং নির্দিষ্ট করার বিকল্পগুলির সম্পূর্ণ পরিসর সম্পর্কে তথ্যের জন্য নিম্নলিখিত সহায়তা কেন্দ্র নিবন্ধগুলি দেখুন:

• ট্যাক্স এবং শিপিং
• অ্যাকাউন্ট-স্তরের শিপিং সেটিংস কনফিগার করুন

মনে রাখবেন যে tax অ্যাট্রিবিউট, এবং সেইজন্য অ্যাকাউন্টট্যাক্স পরিষেবার ব্যবহার, শুধুমাত্র মার্কিন টার্গেট করা পণ্যগুলির জন্য প্রযোজ্য।

অ্যাকাউন্টট্যাক্স এবং শিপিংসেটিং সামগ্রী 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 পদ্ধতি ব্যবহার করুন৷

জটিল উদাহরণ

নিউ ইয়র্কের আশেপাশের রাজ্যগুলিতে একটি বিনামূল্যে-শিপিং প্রচার তৈরি করতে (শিপিং চার্জ না করে), বাকি মার্কিন যুক্তরাষ্ট্রের জন্য ইউপিএস ব্যবহার করুন এবং মার্কিন যুক্তরাষ্ট্রের প্রতিটি রাজ্যের জন্য আলাদা ট্যাক্স প্রয়োগ করতে, অ্যাকাউন্টট্যাক্স এবং শিপিংসেটিং পরিষেবাগুলিতে অনুরোধগুলি ব্যবহার করুন নিম্নরূপ বিষয়বস্তু API-এর। প্রথমে শিপিং সেটিংস কনফিগার করুন:

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

দ্রষ্টব্য: ক্যারিয়ার রেট শুধুমাত্র US, DE, এবং AU তে উপলব্ধ। অবস্থান গোষ্ঠীগুলি বর্তমানে US এবং AU তে সমর্থিত।

জটিল শিপিং নিয়ম: দ্বি-মাত্রিক টেবিল এবং সাবটেবল

মার্কিন যুক্তরাষ্ট্রে $7, NYC-তে 10 পাউন্ডের বেশি ওজনের অর্ডারের জন্য $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টি অনন্য শিপিং হার পর্যন্ত পার্থক্য করতে পারেন৷

দ্রষ্টব্য: আপনার যদি একাধিক পরিষেবা থাকে, তাহলে সম্ভাব্য শিপিং হার গণনা করার জন্য একটি প্রদত্ত দেশের প্রতিটি পণ্য সেই দেশের জন্য সমস্ত শিপিং পরিষেবার সাথে পরীক্ষা করা হয়। যদি একাধিক পরিষেবা একই পণ্যের জন্য ভিন্ন হার ফেরত দেয়, তাহলে সর্বনিম্ন হার ব্যবহার করা হবে।

নীচের উদাহরণটি দুটি ভিন্ন পরিষেবা জুড়ে অনন্য হার ব্যবহার করে 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 একটি একক দেশের জন্য 12000টি শিপিং লেবেল পরিচালনা করতে পারে: প্রতি রেট গ্রুপে 30টি শিপিং লেবেল, 20টি শিপিং পরিষেবা প্রতি 20টি রেট গ্রুপ এবং প্রতি দেশে 20টি শিপিং পরিষেবা৷

আরও তথ্যের জন্য অ্যাকাউন্টট্যাক্স এবং শিপিং সেটিংসের জন্য রেফারেন্স ডকুমেন্টেশন দেখুন।