taxjar 接口文檔和其他需要注意地方

1险绘、接口地址:

https://api.taxjar.com/v2/taxes

  protected function callTaxJarApi($endpoint, $payload)
  {
    $client = new Client();
    $apiUrl = "https://api.taxjar.com/v2/{$endpoint}";
    $apiToken = '3aa5470f168e14914e260b1d425b6c68'; // 確認(rèn)你的 API Token 是否有效
   }

2坛善、請(qǐng)求入?yún)?/h3>
{
  "from_country": "US", // 發(fā)貨國(guó)家
  "from_zip": "90210", //發(fā)貨郵政編碼
  "from_state": "CA", //發(fā)貨州
  "from_city": "Beverly Hills",
  "from_street": "123 Main St",
  "to_country": "US", // 收貨國(guó)家
  "to_zip": "10001", // 收貨郵政編碼
  "to_state": "NY", // 收貨州
  "to_city": "New York",
  "to_street": "456 Park Ave",
  "amount": 100, // 訂單總金額趾痘。
  "shipping": 10, // 運(yùn)費(fèi)
  "nexus_addresses": [
    {
      "country": "US",
      "zip": "90210",
      "state": "CA",
      "city": "Beverly Hills",
      "street": "123 Main St"
    }
  ], // 哪些州有納稅義務(wù)
  "line_items": [
    {
      "id": "1",
      "quantity": 1,
      "product_tax_code": "20010",
      "unit_price": 100,
      "discount": 0
    }
  ] // 產(chǎn)品sku溃槐、數(shù)量羞反、產(chǎn)品稅碼吗蚌、單價(jià)腿倚、折扣
}

其中必傳的參數(shù)有:

     'amount' => $amount, // 必傳
      'shipping' => $shippingValue ?? 0, // 必傳
      'to_country' => 'US', // 必傳
      'to_zip' => $zip, // 必傳
      'to_state' => $stateValue ?? 'CA', // 必傳
       'line_items' => [] //必傳,這個(gè)參數(shù)不傳拿不到明細(xì)的

3蚯妇、響應(yīng)示例:

{
  "tax": {
    "order_total_amount": 110,
    "shipping": 10,
    "taxable_amount": 100,
    "amount_to_collect": 8.88,
    "rate": 0.0888,
    "has_nexus": true,
    "freight_taxable": false,
    "jurisdictions": {
      "country": "US",
      "state": "NY",
      "county": "NEW YORK",
      "city": "NEW YORK"
    },
    "breakdown": {
      "taxable_amount": 100,
      "tax_collectable": 8.88,
      "combined_tax_rate": 0.0888,
      "state_taxable_amount": 100,
      "state_tax_rate": 0.04,
      "state_tax_collectable": 4,
      "county_taxable_amount": 100,
      "county_tax_rate": 0.045,
      "county_tax_collectable": 4.5,
      "city_taxable_amount": 100,
      "city_tax_rate": 0.0038,
      "city_tax_collectable": 0.38,
      "special_district_taxable_amount": 100,
      "special_tax_rate": 0.001,
      "special_district_tax_collectable": 0.1,
      "line_items": [
        {
          "id": "1",
          "taxable_amount": 100,
          "tax_collectable": 8.88,
          "combined_tax_rate": 0.0888,
          "state_taxable_amount": 100,
          "state_sales_tax_rate": 0.04,
          "state_amount": 4,
          "county_taxable_amount": 100,
          "county_tax_rate": 0.045,
          "county_amount": 4.5,
          "city_taxable_amount": 100,
          "city_tax_rate": 0.0038,
          "city_amount": 0.38,
          "special_district_taxable_amount": 100,
          "special_tax_rate": 0.001,
          "special_district_amount": 0.1
        }
      ]
    }
  }
}

示例說(shuō)明
tax: 響應(yīng)的根對(duì)象敷燎,包含訂單的稅費(fèi)相關(guān)信息。

order_total_amount: 訂單總金額箩言,包括稅費(fèi)和運(yùn)費(fèi)在內(nèi)的所有費(fèi)用硬贯。示例中為 $110。
shipping: 運(yùn)費(fèi)金額陨收。示例中為 $10饭豹。
taxable_amount: 應(yīng)稅金額,示例中為 $100务漩,指除去非應(yīng)稅項(xiàng)的訂單金額拄衰。
amount_to_collect: 最終應(yīng)收的稅費(fèi)總額,示例中為 $8.88菲饼。
rate: 訂單的綜合稅率肾砂,示例中為 0.0888。
has_nexus: 指示賣(mài)家在收件地是否有納稅義務(wù)宏悦,true 表示有镐确。
freight_taxable: 運(yùn)費(fèi)是否應(yīng)稅,示例中為 false饼煞。
jurisdictions: 表示稅務(wù)歸屬信息源葫,包括:

country: 國(guó)家。
state: 州砖瞧。
county: 縣息堂。
city: 城市。
breakdown: 各部分的稅費(fèi)詳細(xì)分解。

taxable_amount: 應(yīng)稅金額荣堰。
tax_collectable: 可收集的總稅額床未。
combined_tax_rate: 綜合稅率。
state_taxable_amount, state_tax_rate, state_tax_collectable: 州稅的應(yīng)稅金額振坚、稅率和應(yīng)收金額薇搁。
county_taxable_amount, county_tax_rate, county_tax_collectable: 郡縣稅的詳細(xì)信息。
city_taxable_amount, city_tax_rate, city_tax_collectable: 市稅的詳細(xì)信息渡八。
special_district_taxable_amount, special_tax_rate, special_district_tax_collectable: 特殊稅區(qū)(如交通或教育區(qū))稅費(fèi)詳細(xì)信息啃洋。
line_items: 每件商品的稅費(fèi)詳細(xì)信息,結(jié)構(gòu)與 breakdown 類(lèi)似屎鳍,包含各級(jí)稅費(fèi)的分解宏娄。

使用此響應(yīng)信息的關(guān)鍵點(diǎn)
amount_to_collect 是商家需要收取的稅費(fèi),最終會(huì)在支付或開(kāi)票時(shí)使用逮壁。
breakdown 提供了更細(xì)化的稅務(wù)數(shù)據(jù)孵坚,幫助商家了解不同稅級(jí)的來(lái)源和金額,適合用于會(huì)計(jì)和財(cái)務(wù)分析貌踏。
line_items 可以用于查看和核算單件商品的稅收情況十饥,有助于商品分類(lèi)和報(bào)告。

1. 各州的免稅額

不同的最低免稅額:一些州對(duì)銷(xiāo)售稅的征收設(shè)有起征點(diǎn)祖乳,即只有超過(guò)一定金額的銷(xiāo)售才會(huì)征收稅逗堵。例如,一些州可能對(duì)低于一定金額的服裝免稅眷昆,而超過(guò)該金額的服裝則會(huì)征收稅蜒秤。
免稅商品:一些州對(duì)特定類(lèi)型的商品免稅,如食品亚斋、藥品或兒童用品作媚。對(duì)于服裝,一些州設(shè)定了免稅金額上限帅刊,只有在該上限以下的服裝才免稅纸泡。
例外情況:某些州如德克薩斯州或紐約州對(duì)服裝和鞋類(lèi)的銷(xiāo)售實(shí)施特定的免稅額。例如赖瞒,紐約州對(duì)每件價(jià)格低于 $110 的服裝和鞋類(lèi)免征州銷(xiāo)售稅女揭,但各地方政府可能征收額外稅費(fèi)。

2. 消費(fèi)稅征收注意事項(xiàng)

州稅和地方稅:除了州銷(xiāo)售稅外栏饮,各地方政府(如城市吧兔、縣等)也可以征收額外的地方銷(xiāo)售稅。因此袍嬉,在一些地區(qū)境蔼,消費(fèi)者支付的綜合稅率會(huì)比州稅率高灶平。
特定時(shí)間的免稅期:有些州在特定時(shí)間(如返校季)會(huì)提供免稅期,期間內(nèi)購(gòu)買(mǎi)特定商品免征銷(xiāo)售稅箍土。

3. 奢侈品的界定

奢侈品的標(biāo)準(zhǔn):不同州對(duì)“奢侈品”的定義不完全相同逢享,但通常指高價(jià)的、非必需的商品涮帘,如名牌包拼苍、設(shè)計(jì)師時(shí)裝、珠寶和豪華手表调缨。
價(jià)格分級(jí):一些州設(shè)置了特定價(jià)格門(mén)檻,超過(guò)此門(mén)檻的商品被視為奢侈品吆你。例如弦叶,某些州可能對(duì)價(jià)格超過(guò)一定金額(如 $1,000)的商品收取更高的稅率。

4. 特別關(guān)注的州

新澤西州:服裝通常免征銷(xiāo)售稅妇多,但奢侈品除外伤哺。
加利福尼亞州:對(duì)所有服裝征收銷(xiāo)售稅,無(wú)具體的免稅政策者祖。
佛羅里達(dá)州:提供免稅期并規(guī)定服裝和鞋類(lèi)在一定價(jià)格范圍內(nèi)免稅立莉。

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個(gè)濱河市七问,隨后出現(xiàn)的幾起案子蜓耻,更是在濱河造成了極大的恐慌,老刑警劉巖械巡,帶你破解...
    沈念sama閱讀 206,013評(píng)論 6 481
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件刹淌,死亡現(xiàn)場(chǎng)離奇詭異,居然都是意外死亡讥耗,警方通過(guò)查閱死者的電腦和手機(jī)有勾,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 88,205評(píng)論 2 382
  • 文/潘曉璐 我一進(jìn)店門(mén),熙熙樓的掌柜王于貴愁眉苦臉地迎上來(lái)古程,“玉大人蔼卡,你說(shuō)我怎么就攤上這事≌跄ィ” “怎么了雇逞?”我有些...
    開(kāi)封第一講書(shū)人閱讀 152,370評(píng)論 0 342
  • 文/不壞的土叔 我叫張陵,是天一觀的道長(zhǎng)趋急。 經(jīng)常有香客問(wèn)我喝峦,道長(zhǎng),這世上最難降的妖魔是什么呜达? 我笑而不...
    開(kāi)封第一講書(shū)人閱讀 55,168評(píng)論 1 278
  • 正文 為了忘掉前任谣蠢,我火速辦了婚禮,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘眉踱。我一直安慰自己挤忙,他們只是感情好,可當(dāng)我...
    茶點(diǎn)故事閱讀 64,153評(píng)論 5 371
  • 文/花漫 我一把揭開(kāi)白布谈喳。 她就那樣靜靜地躺著册烈,像睡著了一般。 火紅的嫁衣襯著肌膚如雪婿禽。 梳的紋絲不亂的頭發(fā)上赏僧,一...
    開(kāi)封第一講書(shū)人閱讀 48,954評(píng)論 1 283
  • 那天,我揣著相機(jī)與錄音扭倾,去河邊找鬼淀零。 笑死,一個(gè)胖子當(dāng)著我的面吹牛膛壹,可吹牛的內(nèi)容都是我干的驾中。 我是一名探鬼主播,決...
    沈念sama閱讀 38,271評(píng)論 3 399
  • 文/蒼蘭香墨 我猛地睜開(kāi)眼模聋,長(zhǎng)吁一口氣:“原來(lái)是場(chǎng)噩夢(mèng)啊……” “哼肩民!你這毒婦竟也來(lái)了?” 一聲冷哼從身側(cè)響起链方,我...
    開(kāi)封第一講書(shū)人閱讀 36,916評(píng)論 0 259
  • 序言:老撾萬(wàn)榮一對(duì)情侶失蹤持痰,失蹤者是張志新(化名)和其女友劉穎,沒(méi)想到半個(gè)月后侄柔,有當(dāng)?shù)厝嗽跇?shù)林里發(fā)現(xiàn)了一具尸體共啃,經(jīng)...
    沈念sama閱讀 43,382評(píng)論 1 300
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 35,877評(píng)論 2 323
  • 正文 我和宋清朗相戀三年暂题,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了移剪。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 37,989評(píng)論 1 333
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡薪者,死狀恐怖纵苛,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情言津,我是刑警寧澤攻人,帶...
    沈念sama閱讀 33,624評(píng)論 4 322
  • 正文 年R本政府宣布,位于F島的核電站悬槽,受9級(jí)特大地震影響怀吻,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜初婆,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 39,209評(píng)論 3 307
  • 文/蒙蒙 一蓬坡、第九天 我趴在偏房一處隱蔽的房頂上張望猿棉。 院中可真熱鬧,春花似錦屑咳、人聲如沸萨赁。這莊子的主人今日做“春日...
    開(kāi)封第一講書(shū)人閱讀 30,199評(píng)論 0 19
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)杖爽。三九已至,卻和暖如春紫皇,著一層夾襖步出監(jiān)牢的瞬間慰安,已是汗流浹背。 一陣腳步聲響...
    開(kāi)封第一講書(shū)人閱讀 31,418評(píng)論 1 260
  • 我被黑心中介騙來(lái)泰國(guó)打工坝橡, 沒(méi)想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留泻帮,地道東北人。 一個(gè)月前我還...
    沈念sama閱讀 45,401評(píng)論 2 352
  • 正文 我出身青樓计寇,卻偏偏與公主長(zhǎng)得像,于是被迫代替她去往敵國(guó)和親脂倦。 傳聞我的和親對(duì)象是個(gè)殘疾皇子番宁,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 42,700評(píng)論 2 345

推薦閱讀更多精彩內(nèi)容