مالیات و حمل و نقل در سطح حساب

Content API شما را قادر می سازد تا مالیات و هزینه حمل و نقل را مشخص کنید که برای همه محصولات در یک حساب از طریق تنظیمات حمل و نقل و خدمات مالیات حساب اعمال می شود. اگر می‌خواهید دقیق‌تر باشید، می‌توانید مالیات و حمل و نقل را در سطح مورد از طریق خدمات محصولات مشخص کنید.

برای اطلاعات در مورد خط‌مشی‌های Google و طیف کامل گزینه‌ها برای تعیین مالیات و حمل‌ونقل، به مقالات مرکز راهنمایی زیر مراجعه کنید:

• مالیات و حمل و نقل
• تنظیمات حمل و نقل در سطح حساب را پیکربندی کنید

توجه داشته باشید که ویژگی tax و در نتیجه استفاده از خدمات حساب مالیاتی، فقط برای محصولاتی که ایالات متحده را هدف قرار می‌دهند قابل اعمال است.

خدمات 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 به شرح زیر است. ابتدا تنظیمات حمل و نقل را پیکربندی کنید:

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

توجه: نرخ های شرکت مخابراتی فقط در ایالات متحده، DE، و AU در دسترس است. گروه های مکان در حال حاضر در ایالات متحده و AU پشتیبانی می شوند.

قوانین پیچیده حمل و نقل: جداول دو بعدی و جدول های فرعی

برای تعریف تبلیغات حمل و نقل 7 دلاری در ایالات متحده، 3 یا 5 دلاری برای سفارشات با وزن بیش از 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": [ ... ]
}

این تقسیم برچسب‌های حمل‌ونقل در گروه‌های نرخ نیز ممکن است مورد نیاز باشد، حتی اگر برچسب‌های حمل‌ونقل نرخ حمل یکسانی داشته باشند، زیرا هر گروه نرخ فقط می‌تواند 30 برچسب حمل‌ونقل در قسمت applicableShippingLabels داشته باشد. بنابراین به عنوان یک مثال افراطی، اگر همه برچسب‌های حمل‌ونقل ساختار نرخ یکسانی داشته باشند، shippingsettings می‌تواند تا 12000 برچسب حمل‌ونقل را برای یک کشور انجام دهد: 30 برچسب حمل‌ونقل در هر گروه نرخ، 20 گروه نرخ در هر سرویس حمل و نقل و 20 خدمات حمل و نقل در هر کشور.

برای اطلاعات بیشتر به اسناد مرجع برای مالیات حساب و تنظیمات حمل و نقل مراجعه کنید.