pasar jasa / Dokumentasi pengembangan API penghitungan uji coba pajak impor

API penghitungan uji coba pajak impor Taiwan · v1

Dokumentasi pengembangan API penghitungan uji coba pajak impor

Berdasarkan produk (kode pajak CCC, atau hanya klasifikasi AI otomatis dari deskripsi produk) + jumlah mata uang asing, langsung menghitung pajak impor Taiwan: tarif (termasuk ECFA / pajak tetap), pajak bisnis, biaya promosi, pajak barang, pajak tembakau dan alkohol, dan secara otomatis menentukan jumlah kecil bebas pajak NT$2.000. Dirancang khusus untuk docking dengan platform e-commerce lintas batas seperti 0337.tw.

5 pajak dan biaya utama

Tarif + pajak bisnis + biaya promosi + pajak barang + pajak tembakau dan alkohol

NT$2,000

Penentuan otomatis pembebasan pajak dalam jumlah kecil

Aturan pajak AI

Secara otomatis mengklasifikasikan deskripsi produk CCC

Nilai tukar per sepuluh hari

Konversi nilai tukar deklarasi bea cukai resmi

1 Ringkasan

Biarkan platform Anda langsung menampilkan "Berapa pajak yang harus dibayar saat mengimpor produk ini ke Taiwan?" di meja depan.

apa yang bisa dilakukan

Perhitungan pajak - Membawa barang (kode pajak CCC atau deskripsi produk) + jumlah mata uang asing, mengembalikan rincian pajak lengkap (tarif/pajak usaha/biaya promosi/pajak barang/pajak tembakau dan alkohol) dan total biaya pelaksanaan termasuk pajak.
Periksa tarif pajak — Periksa tarif tarif dan tanda pajak barang sesuai dengan nomor tarif CCC.
Tarif otomatis — Jika tidak ada CCC, hanya product_description yang diberikan, dan sistem menggunakan model AI dari Administrasi Bea Cukai untuk secara otomatis merekomendasikan tarif dan menghitung pajak.

Mata uang pajak: Dolar Taiwan Baru (TWD). Jumlah barang yang Anda bawa dalam mata uang asing (seperti CNY) akan dihitung oleh sistem setelah dikonversi ke Dolar Taiwan Baru berdasarkan nilai tukar resmi deklarasi bea cukai sepuluh hari. Jumlah pajaknya akan seluruhnya dalam Dolar Taiwan Baru.

Hubungan antara dan API pengangkutan :. biaya_pengiriman dalam respons penghitungan uji coba pajak adalah pengiriman referensi HowBridge NT$ (untuk estimasi biaya implementasi). Untuk biaya pengambilan sebenarnya yang dipungut dari 0337.tw, silakan gunakan API pengiriman (sea express, RMB). Pajak API ini tidak termasuk ongkos angkut (basis pajak = komoditas FOB, dasar yang nyaman; pemberitahuan pabean formal harus tunduk pada persetujuan pabean CIF).

2 Sertifikasi dan informasi dasar

Semua permintaan memerlukan Kunci API (kunci yang sama dengan biaya pengiriman/status pengiriman sudah cukup, dan izin tax:read diperlukan).

Base URL

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

Header otentikasi (pilih salah satu)

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

Silakan hubungi dari sisi server dan jangan memaparkan kunci ke ujung depan. Batas laju dalam satuan utama, dan header respons X-RateLimit-Remaining melaporkan sisa kuota, dan HTTP 429 dikembalikan ketika batas terlampaui.

3 Titik Akhir: Perhitungan Uji Coba Pajak

GETPOST /api/v1/tax/estimate

Disarankan untuk menggunakan POST + JSON.

Parameter permintaan

parameter	Jenis	Diperlukan	menjelaskan
`currency_code`	string(3)	Diperlukan	Jenis mata uang asing, seperti `CNY`.
`price_foreign`	number	Diperlukan	Jumlah barang dagangan dalam mata uang asing.
`product_description`	string	Opsional*	Deskripsi produk. Ketika `hs_code` tidak diberikan, AI digunakan untuk secara otomatis mendorong aturan perpajakan.
`hs_code`	string	Opsional*	Kode Tarif CCC (8–11 digit).
`quantity`	int	Opsional	Kuantitas, default 1.
`weight_kg` / `dimensions`	number / [3]	Opsional	Berat / Panjang, Lebar dan Tinggi (lihat perkiraan pengiriman).
`over_exempt_limit`	bool	Opsional	Enam pembebasan pajak selama setengah tahun telah habis → wajib pajak.
`volume_liters` / `alcohol_degree` / `tobacco_sticks`	number/int	Opsional	Digunakan untuk perhitungan pajak tetap alkohol/rokok.

* hs_code dan product_description Pilih setidaknya 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":"Atasan wanita berbahan katun","currency_code":"CNY","price_foreign":300,"quantity":1}'

Tanggapan 200 (kutipan)

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

4 Titik akhir: periksa tarif pajak

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

Periksa tarif tarif dan bendera pajak barang sesuai nomor tarif CCC (angka murni).

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": "Kaos katun, kaos dalam…",
    "source": "tariffs_db"
  }
}

5 Deskripsi bidang respons (data)

bidang	menjelaskan
`exchange.rate_to_twd`	Nilai tukar pemberitahuan pabean harian yang digunakan (Mata Uang Asing → Dolar Taiwan Baru).
`exchange.price_twd`	Jumlah produk dikonversi menjadi Dolar Taiwan Baru.
`tariff_info.duty_rate`	Tarif tarif yang diterapkan (%); ECFA kolom kedua bila berlaku.
`tax_base`	Basis pajak (NTD) = item FOB × jumlah (tidak termasuk biaya pengiriman).
`tax_breakdown.is_tax_exempt`	Apakah dibebaskan dari pembebasan pajak dalam jumlah kecil (basis pajak ≤ NT$2,000 dan minuman non-tembakau dan beralkohol).
`tax_breakdown.duty`	Tarif (NTD).
`tax_breakdown.promo_fee`	Biaya layanan perdagangan promosi (0,04%, tidak dikenakan biaya jika kurang dari NT$100).
`tax_breakdown.commodity_tax`	Pajak cukai (peralatan rumah tangga, dll; umumnya 0 untuk pakaian jadi).
`tax_breakdown.alcohol_tax`	Pajak tembakau dan alkohol (jumlah tetap).
`tax_breakdown.vat`	Pajak penjualan 5%.
`tax_breakdown.total_tax`	Jumlah pajak yang terutang (NTD).
`tax_breakdown.if_over_limit`	Dalam hal pembebasan pajak, taksiran pajak yang terutang jika pembebasan pajak tersebut digunakan sebanyak 6 kali dalam waktu setengah tahun.
`antidumping`	Pengingat pajak antidumping/berimbang (tergantung negara asal, hanya pengingat yang tidak dimasukkan ke dalam total).
`total_landed_cost`	Total biaya pendaratan termasuk pajak (basis pajak + biaya pengiriman referensi + pajak).

6 rumus pajak

dasar pengenaan pajak = komoditas FOB (mata uang asing × nilai tukar) × kuantitas
pembebasan pajak dalam jumlah kecil = basis pajak ≤ NT$2,000 dan bukan tembakau dan alkohol → pajak 0 (6 kali dalam setengah tahun)
Tarif = dasar pajak × tarif tarif (atau pajak tetap, mana yang lebih tinggi)
Biaya promosi = basis pajak × 0.04% (tidak dikenakan biaya jika jumlahnya tidak mencapai NT$100)
Pajak barang = (Dasar pajak + Tarif) × Tarif pajak barang (item yang berlaku)
Pajak bisnis = (dasar pajak + tarif + pajak barang + pajak alkohol dan tembakau) × 5%
Hutang pajak = Bea masuk + Biaya promosi + Pajak barang + Pajak tembakau dan alkohol + Pajak bisnis

Dasar Hukum: UU Tarif, UU Pajak Usaha Pertambahan Nilai dan Non Pertambahan Nilai, UU Perdagangan (Promosi Biaya Jasa Perdagangan), Peraturan Pajak Barang, UU Pajak Tembakau dan Alkohol. Jumlah pajak sebenarnya harus mendapat persetujuan bea cukai.

7 kode kesalahan

HTTP	`error` / situasi	menjelaskan
401	missing_api_key / invalid_api_key	Tidak ada/Kunci API tidak valid.
403	insufficient_scope	Kuncinya tidak diaktifkan `tax:read`.
422	Kode_mata uang/harga_asing tidak ada	Parameter yang diperlukan tidak ada atau formatnya salah.
422	aturan kekurangan pajak	hs_code tidak diberikan dan deskripsi_produk tidak dapat diklasifikasikan.
422	Tidak ada nilai tukar untuk mata uang ini	Kode_mata uang belum memberikan nilai tukar, silakan hubungi layanan pelanggan.
429	rate_limit_exceeded	Batas per menit terlampaui.

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' => 'Atasan wanita berbahan katun',
        'currency_code' => 'CNY',
        'price_foreign' => 300,
    ],
]);
$tax = json_decode($res->getBody(), true)['data']['tax_breakdown'];
echo 'Hutang pajak 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: 'Atasan wanita berbahan katun', 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":"Atasan wanita berbahan katun","currency_code":"CNY","price_foreign":300}'

9 Dukungan dan versi

dukungan teknis: howyunqisoftware@gmail.com

Versi API: v1 (stabil).

Ubah riwayat: 01-06-2026 — API penghitungan uji coba pajak impor v1 sudah online.

API Pengiriman API Ketersediaan Terapkan untuk kunci API