ตลาดบริการ / นำเข้าเอกสารการพัฒนา API การคำนวณการทดลองภาษีนำเข้า

API การคำนวณการทดลองภาษีนำเข้าของไต้หวัน · v1

นำเข้าเอกสารการพัฒนา API การคำนวณการทดลองภาษีนำเข้า

ขึ้นอยู่กับผลิตภัณฑ์ (รหัสภาษี CCC หรือเพียงการจัดหมวดหมู่ AI อัตโนมัติของคำอธิบายผลิตภัณฑ์) + จำนวนสกุลเงินต่างประเทศ คำนวณภาษีนำเข้าของไต้หวันทันที: ภาษี (รวม ECFA / ภาษีคงที่) ภาษีธุรกิจ ค่าธรรมเนียมส่งเสริมการขาย ภาษีสินค้า ภาษียาสูบและเครื่องดื่มแอลกอฮอล์ และกำหนดจำนวนเล็กน้อยของ NT$2,000 ปลอดภาษีโดยอัตโนมัติ ออกแบบมาเป็นพิเศษสำหรับเชื่อมต่อกับแพลตฟอร์มอีคอมเมิร์ซข้ามพรมแดน เช่น 0337.tw

5 ภาษีและค่าธรรมเนียมที่สำคัญ

ภาษี + ภาษีธุรกิจ + ค่าธรรมเนียมส่งเสริมการขาย + ภาษีสินค้า + ภาษียาสูบและเครื่องดื่มแอลกอฮอล์

NT$2,000

การกำหนดการยกเว้นภาษีจำนวนเล็กน้อยโดยอัตโนมัติ

กฎภาษีเอไอ

จำแนกคำอธิบายผลิตภัณฑ์ CCC โดยอัตโนมัติ

อัตราแลกเปลี่ยนต่อสิบวัน

การแปลงอัตราแลกเปลี่ยนประกาศศุลกากรอย่างเป็นทางการ

1 ภาพรวม

ให้แพลตฟอร์มของคุณแสดงโดยตรงว่า "จะต้องเสียภาษีเท่าใดเมื่อนำเข้าผลิตภัณฑ์นี้ไปยังไต้หวัน" ที่แผนกต้อนรับ

สิ่งที่สามารถทำได้

การคำนวณภาษี - นำเข้าสินค้า (รหัสภาษี CCC หรือคำอธิบายผลิตภัณฑ์) + จำนวนสกุลเงินต่างประเทศ คืนรายละเอียดภาษีให้ครบถ้วน (ภาษี/ภาษีธุรกิจ/ค่าธรรมเนียมส่งเสริมการขาย/ภาษีสินค้า/ภาษียาสูบและเครื่องดื่มแอลกอฮอล์) และต้นทุนรวมในการดำเนินการรวมภาษีแล้ว
ตรวจสอบอัตราภาษี — ตรวจสอบอัตราภาษีและธงภาษีสินค้าตามหมายเลขภาษี CCC
อัตราภาษีอัตโนมัติ — เมื่อไม่มี CCC จะให้เฉพาะ product_description และระบบใช้โมเดล AI ของกรมศุลกากรเพื่อแนะนำภาษีและคำนวณภาษีโดยอัตโนมัติ

สกุลเงินภาษี: ดอลลาร์ไต้หวันใหม่ (TWD) จำนวนสินค้าที่คุณนำเข้าเป็นสกุลเงินต่างประเทศ (เช่น CNY) จะถูกคำนวณโดยระบบหลังจากแปลงเป็นดอลลาร์ไต้หวันใหม่ตามอัตราแลกเปลี่ยนประกาศศุลกากรอย่างเป็นทางการสิบวัน จำนวนภาษีทั้งหมดจะเป็นดอลลาร์ไต้หวันใหม่

ความสัมพันธ์ระหว่าง และ API การขนส่งสินค้า : shipping_fee ในการตอบสนองการคำนวณการทดลองภาษีคือค่าขนส่งอ้างอิง HowBridge NT$ (สำหรับการประมาณต้นทุนการดำเนินการ) สำหรับค่าธรรมเนียมการเรียกเก็บเงินตามจริงที่เรียกเก็บจาก 0337.tw โปรดใช้ ค่าขนส่ง API (sea express, RMB) ภาษีของ API นี้ไม่รวมค่าขนส่ง (ฐานภาษี = สินค้าโภคภัณฑ์ FOB พื้นฐานที่สะดวก การสำแดงศุลกากรอย่างเป็นทางการจะต้องได้รับการอนุมัติจากศุลกากรของ CIF)

2 การรับรองและข้อมูลพื้นฐาน

คำขอทั้งหมดต้องใช้คีย์ API (คีย์เดียวกันกับค่าธรรมเนียมการจัดส่ง/สถานะการจัดส่งก็เพียงพอแล้ว และต้องได้รับอนุญาตจาก tax:read)

Base URL

https://0523.tw/api/v1/tax

ส่วนหัวการตรวจสอบสิทธิ์ (เลือกอย่างใดอย่างหนึ่ง)

Authorization: Bearer lk_live_xxxxxxxxxxxxxxxxxxxxxxxx
// หรือ
X-API-Key: lk_live_xxxxxxxxxxxxxxxxxxxxxxxx

กรุณาโทรจากฝั่งเซิร์ฟเวอร์และอย่าให้คีย์ถูกเปิดเผยที่ส่วนหน้า ขีดจำกัดอัตราอยู่ในหน่วยคีย์ และส่วนหัวการตอบสนอง X-RateLimit-Remaining รายงานโควต้าที่เหลือ และ HTTP 429 จะถูกส่งคืนเมื่อเกินขีดจำกัด

3 จุดสิ้นสุด: การคำนวณทดลองภาษี

GETPOST /api/v1/tax/estimate

ขอแนะนำให้ใช้ POST + JSON

ขอพารามิเตอร์

พารามิเตอร์	พิมพ์	ที่จำเป็น	แสดงให้เห็น
`currency_code`	string(3)	ที่จำเป็น	ประเภทสกุลเงินต่างประเทศ เช่น `CNY`
`price_foreign`	number	ที่จำเป็น	จำนวนสินค้าที่เป็นสกุลเงินต่างประเทศ
`product_description`	string	ไม่จำเป็น*	รายละเอียดสินค้า. เมื่อไม่ได้ให้ `hs_code` ระบบจะใช้ AI เพื่อผลักดันกฎภาษีโดยอัตโนมัติ
`hs_code`	string	ไม่จำเป็น*	รหัสภาษี CCC (8–11 หลัก)
`quantity`	int	ไม่จำเป็น	ปริมาณ ค่าเริ่มต้น 1
`weight_kg` / `dimensions`	number / [3]	ไม่จำเป็น	น้ำหนัก / ความยาว ความกว้าง และความสูง (อ้างอิงตามค่าขนส่งโดยประมาณ)
`over_exempt_limit`	bool	ไม่จำเป็น	ได้รับการยกเว้นภาษีหกรายการเป็นเวลาครึ่งปีหมดแล้ว → การเก็บภาษีภาคบังคับ
`volume_liters` / `alcohol_degree` / `tobacco_sticks`	number/int	ไม่จำเป็น	ใช้สำหรับคำนวณภาษีคงที่เครื่องดื่มแอลกอฮอล์/บุหรี่

* hs_code และ product_description เลือก อย่างน้อยหนึ่งรายการ

ตัวอย่างคำขอ (POST JSON)

curl -X POST https://0523.tw/api/v1/tax/estimate \
  -H "Authorization: Bearer lk_live_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"product_description":"เสื้อผ้าฝ้ายผู้หญิง","currency_code":"CNY","price_foreign":300,"quantity":1}'

คำตอบ 200 (ข้อความที่ตัดตอนมา)

{
  "success": true,
  "data": {
    "input": { "hs_code": "61061000", "currency_code": "CNY", "price_foreign": 300 },
    "exchange": { "rate_to_twd": 4.612, "price_twd": 1383.6 },
    "tariff_info": { "duty_rate": 10.5, "duty_rate_text": "10.5%", "ecfa_applied": false },
    "tax_base": 1383.6,
    "tax_breakdown": {
      "is_tax_exempt": true,            // ฐานภาษี ≤ NT$2,000 → ได้รับการยกเว้นภาษีจำนวนเล็กน้อย
      "duty": 0, "promo_fee": 0, "vat": 0, "total_tax": 0,
      "if_over_limit": {           // หากการยกเว้นภาษีหมด 6 ครั้งในครึ่งปีจำนวนเงินที่ต้องชำระ
        "duty": 145.28, "vat": 76.44, "total_tax": 221.72
      }
    },
    "antidumping": [],
    "total_landed_cost": 1453.6,
    "disclaimer": "..."
  }
}

4 จุดสิ้นสุด: ตรวจสอบอัตราภาษี

GET /api/v1/tax/rate/{hsCode}

ตรวจสอบอัตราภาษีและธงภาษีสินค้าตามหมายเลขภาษี CCC (ตัวเลขล้วนๆ)

curl https://0523.tw/api/v1/tax/rate/6109100000 \
  -H "Authorization: Bearer lk_live_xxxxxxxxxxxxxxxxxxxxxxxx"

{
  "success": true,
  "data": {
    "hs_code": "6109100000",
    "duty_rate": 10.5,
    "duty_rate_text": "10.5%",
    "is_commodity_tax": false,
    "name_zh": "เสื้อยืดผ้าฝ้าย เสื้อชั้นใน…",
    "source": "tariffs_db"
  }
}

5 คำอธิบายฟิลด์การตอบกลับ (data)

สนาม	แสดงให้เห็น
`exchange.rate_to_twd`	อัตราแลกเปลี่ยนตามใบศุลกากรรายวันที่ใช้ (สกุลเงินต่างประเทศ → ดอลลาร์ไต้หวันใหม่)
`exchange.price_twd`	จำนวนผลิตภัณฑ์จะถูกแปลงเป็นดอลลาร์ไต้หวันใหม่
`tariff_info.duty_rate`	อัตราภาษีที่ใช้ (%); ECFA คอลัมน์ที่สอง หากมี
`tax_base`	ฐานภาษี (NTD) = สินค้า FOB × จำนวน (ไม่รวมค่าจัดส่ง)
`tax_breakdown.is_tax_exempt`	ได้รับการยกเว้นภาษีจำนวนเล็กน้อยหรือไม่ (ฐานภาษี ≤ NT$2,000 และเครื่องดื่มที่ไม่สูบบุหรี่และเครื่องดื่มแอลกอฮอล์)
`tax_breakdown.duty`	อัตราภาษี (NTD)
`tax_breakdown.promo_fee`	ค่าธรรมเนียมบริการส่งเสริมการขายการค้า (0.04% ไม่คิดค่าบริการหากน้อยกว่า NT$100)
`tax_breakdown.commodity_tax`	ภาษีสรรพสามิต (เครื่องใช้ไฟฟ้าภายในบ้าน ฯลฯ โดยทั่วไปจะเป็น 0 สำหรับเสื้อผ้าสำเร็จรูป)
`tax_breakdown.alcohol_tax`	ภาษียาสูบและเครื่องดื่มแอลกอฮอล์ (จำนวนคงที่)
`tax_breakdown.vat`	ภาษีการขาย 5%
`tax_breakdown.total_tax`	ยอดรวมภาษีที่ต้องชำระ (NTD)
`tax_breakdown.if_over_limit`	ในกรณีได้รับการยกเว้นภาษี ภาษีโดยประมาณที่ต้องชำระหากใช้การยกเว้นภาษีถึง 6 ครั้งในครึ่งปี
`antidumping`	การเตือนการทุ่มตลาด/การปรับสมดุลภาษี (ขึ้นอยู่กับประเทศต้นทาง เฉพาะการแจ้งเตือนเท่านั้นที่ไม่รวมอยู่ในยอดรวม)
`total_landed_cost`	ค่าลงจอดทั้งหมดรวมภาษี (ฐานภาษี + ค่าขนส่งอ้างอิง + ภาษี)

6 สูตรภาษี

ฐานภาษี = สินค้าโภคภัณฑ์ FOB (สกุลเงินต่างประเทศ × อัตราแลกเปลี่ยน) × ปริมาณ
การยกเว้นภาษีจำนวนเล็กน้อย = ฐานภาษี ≤ NT$2,000 และไม่ใช่ยาสูบและเครื่องดื่มแอลกอฮอล์ → ภาษี 0 (6 ครั้งในครึ่งปี)
ภาษี = ฐานภาษี × อัตราภาษี (หรือภาษีคงที่ แล้วแต่จำนวนใดจะสูงกว่า)
ค่าธรรมเนียมโปรโมชั่น = ฐานภาษี × 0.04% (ไม่คิดค่าบริการหากยอดไม่ถึง NT$100)
ภาษีสินค้า = (ฐานภาษี + ภาษี) × อัตราภาษีสินค้า (สินค้าที่เกี่ยวข้อง)
ภาษีธุรกิจ = (ฐานภาษี + ภาษี + ภาษีสินค้า + ภาษีเครื่องดื่มแอลกอฮอล์และยาสูบ) × 5%
ภาษีที่ต้องชำระ = อากรศุลกากร + ค่าธรรมเนียมส่งเสริมการขาย + ภาษีสินค้า + ภาษียาสูบและเครื่องดื่มแอลกอฮอล์ + ภาษีธุรกิจ

พื้นฐานทางกฎหมาย: กฎหมายภาษี, กฎหมายภาษีธุรกิจมูลค่าเพิ่มและไม่มีมูลค่าเพิ่ม, กฎหมายการค้า (การส่งเสริมค่าธรรมเนียมบริการการค้า), กฎระเบียบภาษีสินค้า, กฎหมายภาษียาสูบและเครื่องดื่มแอลกอฮอล์ จำนวนภาษีที่แท้จริงขึ้นอยู่กับการอนุมัติของศุลกากร

7 รหัสข้อผิดพลาด

HTTP	`error` / สถานการณ์	แสดงให้เห็น
401	missing_api_key / invalid_api_key	ไม่มี/คีย์ API ไม่ถูกต้อง
403	insufficient_scope	กุญแจไม่ได้เปิดใช้งาน `tax:read`
422	ไม่มี currency_code / price_foreign	พารามิเตอร์ที่จำเป็นขาดหายไปหรืออยู่ในรูปแบบที่ไม่ถูกต้อง
422	กฎการขาดภาษี	ไม่ได้ระบุ hs_code และ product_description ไม่สามารถจัดประเภทได้
422	ไม่มีอัตราแลกเปลี่ยนสำหรับสกุลเงินนี้	currency_code ยังไม่ได้ระบุอัตราแลกเปลี่ยน โปรดติดต่อฝ่ายบริการลูกค้า
429	rate_limit_exceeded	เกินขีดจำกัดต่อนาที

8 ตัวอย่างโปรแกรม

$client = new GuzzleHttp\Client(['base_uri' => 'https://0523.tw']);
$res = $client->post('/api/v1/tax/estimate', [
    'headers' => ['Authorization' => 'Bearer ' . env('LUCKY_FREIGHT_KEY')],
    'json' => [
        'product_description' => 'เสื้อผ้าฝ้ายผู้หญิง',
        'currency_code' => 'CNY',
        'price_foreign' => 300,
    ],
]);
$tax = json_decode($res->getBody(), true)['data']['tax_breakdown'];
echo 'ภาษีที่ต้องชำระ NT$' . $tax['total_tax'];

const r = await fetch('https://0523.tw/api/v1/tax/estimate', {
  method: 'POST',
  headers: { 'Authorization': `Bearer ${process.env.LUCKY_FREIGHT_KEY}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({ product_description: 'เสื้อผ้าฝ้ายผู้หญิง', currency_code: 'CNY', price_foreign: 300 }),
});
const { data } = await r.json();
console.log(data.tax_breakdown.total_tax);

curl -X POST https://0523.tw/api/v1/tax/estimate \
  -H "Authorization: Bearer $LUCKY_FREIGHT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_description":"เสื้อผ้าฝ้ายผู้หญิง","currency_code":"CNY","price_foreign":300}'

9 การสนับสนุนและเวอร์ชัน

การสนับสนุนทางเทคนิค: howyunqisoftware@gmail.com

เวอร์ชันเอพีไอ: v1 (เสถียร)

ประวัติการเปลี่ยนแปลง: 01-06-2026 — API การคำนวณการทดลองภาษีนำเข้า v1 ออนไลน์อยู่

API การจัดส่ง API ความพร้อมใช้งาน สมัครคีย์ API