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à)腿倚、折扣
}
{
"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)免稅立莉。