REST Resource: accounts.accounttax

משאב: AccountTax

הגדרות המס של חשבון מוכר. בכל השיטות נדרש תפקיד אדמין.

ייצוג JSON 
{
  "name": string,
  "account": string,
  "taxRules": [
    {
      object (TaxRule)
    }
  ]
}
שדות
name

string

מזהה. השם של הגדרת המס. פורמט: "{accountTax.name=accounts/{account}}"
account

string (int64 format)

פלט בלבד. מספר החשבון שאליו שייכות הגדרות המס של החשבון.
taxRules[]

object (TaxRule)

כללי מס. "מגדירים את כללי המס בכל אזור. לא יוצג מס אם לא הוגדר באזור כלל".

TaxRule

סוג ההמרה הראשי

אחוז מיקרו : 100% = 1 000 000 ו-1% = 10 000 לא יכול להיות שלילי.

מידע על זיקה לצורכי מס ופרמטרים קשורים שרלוונטיים להזמנות שנמסרו לאזור שמכוסה על ידי אדמין מס אחד. מכשיר Nexus נוצר כשמוכר מבצע עסקים באזור שמנוהל על ידי מנהל המס (אפשר להגדיר זיקה לצורכי מס רק למדינות בארה"ב). אם למוכר יש זיקה במדינה בארה"ב, המוכר צריך לשלם מס לכל רשויות המס שקשורות ליעד המשלוח. המזהה הבא : 8

ייצוג JSON 
{
  "regionCode": string,
  "shippingTaxed": boolean,
  "effectiveTimePeriod": {
    object (Interval)
  },

  // Union field location can be only one of the following:
  "locationId": string,
  "postCodeRange": {
    object (TaxPostalCodeRange)
  }
  // End of list of possible types for union field location.

  // Union field rate_calculation can be only one of the following:
  "useGoogleRate": boolean,
  "selfSpecifiedRateMicros": string
  // End of list of possible types for union field rate_calculation.
}
שדות
regionCode

string

קוד האזור שבו הכלל הזה חל
shippingTaxed

boolean

אם המדיניות מוגדרת, המערכת תגבה מס על המשלוח (בשיעור זהה לתעריף של המוצר) כשמסירים מוצרים לאזור של האדמין. אפשר להגדיר את הערך רק במדינות בארה"ב ללא קטגוריה.
effectiveTimePeriod

object (Interval)

חובה. התקופה שבה הכלל ייכנס לתוקף. אם משך הזמן לא רשום ב-Effective_time, אז הוא פתוח עם סיום בעתיד. ההתחלה של התקופה הזו כוללת, והיא לא כוללת את הסיום.
שדה איחוד location. יש לתאר את המיקום באמצעות טווח מיקוד או מזהה קריטריון. location יכול להיות רק אחת מהאפשרויות הבאות:
locationId

string (int64 format)

הערך admin_id או criteria_id של האזור שבו הכלל הזה חל.
postCodeRange

object (TaxPostalCodeRange)

טווח מספרי המיקוד שבהם הכלל הזה חל.
שדה איחוד rate_calculation. מהי הדרך שבה מחשבים את שיעור המס על משלוחים לאזור של האדמין הזה. אפשר להגדיר זאת רק במדינות בארה"ב. rate_calculation יכול להיות רק אחת מהאפשרויות הבאות:
useGoogleRate

boolean

תעריף שתלוי במיקום המשלוח: אם למוכר יש זיקה לצורכי מס במדינה תואמת בארה"ב, יתווספו תעריפים מרשויות שיש להן סמכות שיפוט מעל האזור למשלוחים.
selfSpecifiedRateMicros

string (int64 format)

תעריף קבוע שמצוין במיליוניות השנייה, כאשר 100% = 1_000_000. מתאים למדינות לפי המוצא.

TaxPostalCodeRange

טווח של מספרי מיקוד שמגדיר את האזור.

ייצוג JSON 
{
  "start": string,
  "end": string
}
שדות
start

string

חובה. תחילת טווח המיקוד, שהוא גם הקטן ביותר בטווח.
end

string

סוף טווח המיקודים. אם לא תציינו ערך, תהיה אותה ערך כמו 'התחלה'.

שיטות

get

 פונקציה זו מחזירה את כללי המס שתואמים לתנאים של GetAccountTaxRequest

list

 מפרט את הגדרות המס של חשבונות המשנה רק בחשבון Merchant Center שלך.

patch

 מעדכנים את הגדרות המס של החשבון.