pasaran perkhidmatan / Dokumen pembangunan API pengiraan percubaan cukai import

API pengiraan percubaan cukai import Taiwan · v1

Dokumen pembangunan API pengiraan percubaan cukai import

Berdasarkan produk (kod cukai CCC, atau hanya klasifikasi AI automatik bagi perihalan produk) + jumlah mata wang asing, kira cukai import Taiwan dengan serta-merta: tarif (termasuk ECFA / cukai tetap), cukai perniagaan, yuran promosi, cukai barang, cukai tembakau dan alkohol, dan secara automatik menentukan jumlah kecil NT$2,000 tanpa cukai. Direka khas untuk dok dengan platform e-dagang rentas sempadan seperti 0337.tw.

5 cukai dan yuran utama

Tarif + cukai perniagaan + yuran promosi + cukai barang + cukai tembakau dan alkohol

NT$2,000

Penentuan automatik pengecualian cukai jumlah kecil

Peraturan cukai AI

Klasifikasikan penerangan produk CCC secara automatik

Kadar pertukaran setiap sepuluh hari

Penukaran kadar pertukaran pengisytiharan kastam rasmi

1 Gambaran keseluruhan

Biarkan platform anda memaparkan terus "Berapa cukai yang akan dibayar apabila mengimport produk ini ke Taiwan?" di meja depan.

apa yang boleh dilakukan

Pengiraan cukai - Bawa masuk barang (kod cukai CCC atau perihalan produk) + jumlah mata wang asing, kembalikan butiran cukai yang lengkap (tarif/cukai perniagaan/yuran promosi/cukai barang/tembakau dan cukai alkohol) dan jumlah kos pelaksanaan termasuk cukai.
Semak kadar cukai — Semak kadar tarif dan bendera cukai barang mengikut nombor tarif CCC.
tarif automatik — Apabila tiada CCC, hanya product_description diberikan, dan sistem menggunakan model AI Pentadbiran Kastam untuk mengesyorkan tarif secara automatik dan mengira cukai.

Mata wang cukai: Dolar Taiwan Baru (TWD). Jumlah barang yang anda bawa masuk dalam mata wang asing (seperti CNY) akan dikira oleh sistem selepas menukarnya kepada Dolar Taiwan Baru berdasarkan kadar pertukaran pengisytiharan kastam rasmi sepuluh hari. Amaun cukai semuanya dalam Dolar Taiwan Baharu.

Hubungan antara dan API pengangkutan :. shipping_fee dalam respons pengiraan percubaan cukai ialah fret rujukan HowBridge NT$ (untuk anggaran kos pelaksanaan). Untuk bayaran kutipan sebenar yang dikutip daripada 0337.tw, sila gunakan fret API (ekspres laut, RMB). Cukai API ini tidak termasuk pengangkutan (asas cukai = komoditi FOB, asas mudah; pengisytiharan kastam rasmi hendaklah tertakluk kepada kelulusan kastam CIF).

2 Pensijilan dan maklumat asas

Semua permintaan memerlukan Kunci API (kunci yang sama dengan yuran penghantaran/status penghantaran adalah mencukupi dan kebenaran tax:read diperlukan).

Base URL

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

Pengepala pengesahan (pilih satu)

Authorization: Bearer lk_live_xxxxxxxxxxxxxxxxxxxxxxxx
// atau
X-API-Key: lk_live_xxxxxxxxxxxxxxxxxxxxxxxx

Sila hubungi dari bahagian pelayan dan jangan dedahkan kunci ke bahagian hadapan. Had kadar adalah dalam unit utama dan pengepala respons X-RateLimit-Remaining melaporkan baki kuota dan HTTP 429 dikembalikan apabila had tersebut melebihi.

3 Titik Akhir: Pengiraan Percubaan Cukai

GETPOST /api/v1/tax/estimate

Adalah disyorkan untuk menggunakan POST + JSON.

Permintaan parameter

parameter	taip	Diperlukan	menggambarkan
`currency_code`	string(3)	Diperlukan	Jenis mata wang asing, seperti `CNY`.
`price_foreign`	number	Diperlukan	Jumlah barangan dalam mata wang asing.
`product_description`	string	Pilihan*	Penerangan produk. Apabila `hs_code` tidak diberikan, AI digunakan untuk menolak peraturan cukai secara automatik.
`hs_code`	string	Pilihan*	Kod Tarif CCC (8–11 digit).
`quantity`	int	Pilihan	Kuantiti, lalai 1.
`weight_kg` / `dimensions`	number / [3]	Pilihan	Berat / Panjang, Lebar dan Tinggi (rujuk anggaran pengangkutan).
`over_exempt_limit`	bool	Pilihan	Enam pengecualian cukai selama setengah tahun telah habis → cukai wajib.
`volume_liters` / `alcohol_degree` / `tobacco_sticks`	number/int	Pilihan	Digunakan untuk pengiraan cukai tetap alkohol/rokok.

* hs_code dan product_description Pilih sekurang-kurangnya satu .

Contoh permintaan (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":"Baju atasan wanita kapas","currency_code":"CNY","price_foreign":300,"quantity":1}'

Respons 200 (petikan)

{
  "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,            // Asas cukai ≤ NT$2,000 → pengecualian cukai amaun kecil
      "duty": 0, "promo_fee": 0, "vat": 0, "total_tax": 0,
      "if_over_limit": {           // Jika pengecualian cukai habis 6 kali dalam setengah tahun, jumlah yang perlu dibayar
        "duty": 145.28, "vat": 76.44, "total_tax": 221.72
      }
    },
    "antidumping": [],
    "total_landed_cost": 1453.6,
    "disclaimer": "..."
  }
}

4 Titik akhir: semak kadar cukai

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

Semak kadar tarif dan bendera cukai barang mengikut nombor tarif CCC (nombor tulen).

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": "Baju-T kapas, seluar dalam…",
    "source": "tariffs_db"
  }
}

5 Penerangan medan respons (data)

padang	menggambarkan
`exchange.rate_to_twd`	Kadar pertukaran pengisytiharan kastam harian yang digunakan (Mata Wang Asing → Dolar Taiwan Baru).
`exchange.price_twd`	Jumlah produk ditukar kepada Dolar Taiwan Baru.
`tariff_info.duty_rate`	Kadar tarif dikenakan (%); ECFA lajur kedua apabila berkenaan.
`tax_base`	Asas cukai (NTD) = item FOB × kuantiti (tidak termasuk caj penghantaran).
`tax_breakdown.is_tax_exempt`	Adakah ia dikecualikan daripada pengecualian cukai jumlah kecil (asas cukai ≤ NT$2,000 dan minuman bukan tembakau dan beralkohol).
`tax_breakdown.duty`	Tarif (NTD).
`tax_breakdown.promo_fee`	Yuran perkhidmatan perdagangan promosi (0.04%, tiada caj jika kurang daripada NT$100).
`tax_breakdown.commodity_tax`	Cukai eksais (peralatan rumah, dsb.; umumnya 0 untuk pakaian siap).
`tax_breakdown.alcohol_tax`	Cukai tembakau dan alkohol (jumlah tetap).
`tax_breakdown.vat`	Cukai jualan 5%.
`tax_breakdown.total_tax`	Jumlah cukai yang perlu dibayar (NTD).
`tax_breakdown.if_over_limit`	Dalam kes pengecualian cukai, anggaran cukai yang perlu dibayar jika pengecualian cukai digunakan sebanyak 6 kali dalam setengah tahun.
`antidumping`	Peringatan anti-lambakan/cukai seimbang (bergantung kepada negara asal, hanya peringatan itu tidak dimasukkan ke dalam jumlah keseluruhan).
`total_landed_cost`	Jumlah kos pendaratan termasuk cukai (asas cukai + pengangkutan rujukan + cukai).

6 formula cukai

asas cukai = komoditi FOB (mata wang asing × kadar pertukaran) × kuantiti
pengecualian cukai jumlah kecil = asas cukai ≤ NT$2,000 dan bukan tembakau dan alkohol → cukai 0 (6 kali dalam setengah tahun)
tarif = asas cukai × kadar tarif (atau cukai tetap, yang mana lebih tinggi)
Yuran promosi = asas cukai × 0.04% (tiada caj jika jumlah tidak mencapai NT$100)
Cukai barang = (Asas cukai + Tarif) × Kadar cukai barang (item berkenaan)
Cukai perniagaan = (asas cukai + tarif + cukai barang + cukai alkohol dan tembakau) × 5%
Cukai kena bayar = Duti kastam + Yuran promosi + Cukai barang + Cukai tembakau dan alkohol + Cukai perniagaan

Asas undang-undang: Undang-undang Tarif, Undang-undang Cukai Perniagaan Nilai Tambah dan Bukan Nilai Ditambah, Undang-undang Perdagangan (Yuran Perkhidmatan Perdagangan), Peraturan Cukai Barang, Undang-undang Cukai Tembakau dan Alkohol. Amaun cukai sebenar tertakluk kepada kelulusan kastam.

7 kod ralat

HTTP	`error` / situasi	menggambarkan
401	missing_api_key / invalid_api_key	Tiada/Kunci API tidak sah.
403	insufficient_scope	Kunci tidak diaktifkan `tax:read`.
422	Tiada currency_code / price_foreign	Parameter yang diperlukan tiada atau dalam format yang salah.
422	peraturan kekurangan cukai	hs_code tidak diberikan dan product_description tidak boleh diklasifikasikan.
422	Tiada kadar pertukaran untuk mata wang ini	currency_code belum lagi memberikan kadar pertukaran, sila hubungi perkhidmatan pelanggan.
429	rate_limit_exceeded	Had seminit melebihi.

8 Contoh program

$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' => 'Baju atasan wanita kapas',
        'currency_code' => 'CNY',
        'price_foreign' => 300,
    ],
]);
$tax = json_decode($res->getBody(), true)['data']['tax_breakdown'];
echo 'Cukai kena bayar 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: 'Baju atasan wanita kapas', 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":"Baju atasan wanita kapas","currency_code":"CNY","price_foreign":300}'

9 Sokongan dan versi

sokongan teknikal: howyunqisoftware@gmail.com

Versi API: v1 (stabil).

Sejarah perubahan: 2026-06-01 — Pengiraan percubaan cukai import API v1 dalam talian.

API Penghantaran API Ketersediaan Mohon kunci API