Dienstleistungsmarkt / API-Entwicklungsdokumentation zur Importsteuer-Testberechnung

Testberechnungs-API für Einfuhrsteuern in Taiwan · v1

API-Entwicklungsdokumentation zur Importsteuer-Testberechnung

Basierend auf dem Produkt (CCC-Steuercode oder einfach nur automatische AI-Klassifizierung der Produktbeschreibung) + Fremdwährungsbetrag berechnen Sie sofort die taiwanesischen Einfuhrsteuern: Zoll (einschließlich ECFA / feste Steuer), Gewerbesteuer, Werbegebühr, Warensteuer, Tabak- und Alkoholsteuer, und ermitteln Sie automatisch den kleinen steuerfreien Betrag von NT$2.000. Speziell für das Andocken an grenzüberschreitende E-Commerce-Plattformen wie 0337.tw konzipiert.

5 wichtige Steuern und Gebühren

Tarif + Gewerbesteuer + Werbegebühr + Warensteuer + Tabak- und Alkoholsteuer

NT$2,000

Automatische Ermittlung der Steuerbefreiung für Kleinbeträge

KI-Steuerregeln

Produktbeschreibungen automatisch CCC klassifizieren

Wechselkurs pro zehn Tage

Umrechnung des Wechselkurses der offiziellen Zollanmeldung

1 Überblick

Lassen Sie auf Ihrer Plattform direkt anzeigen: „Wie viel Steuer wird bei der Einfuhr dieses Produkts nach Taiwan gezahlt?“ an der Rezeption.

was kann getan werden

Steuerberechnung - Bringen Sie die Waren ein (CCC-Steuercode oder Produktbeschreibung) + Fremdwährungsbetrag, geben Sie die vollständigen Steuerdetails (Tarif/Gewerbesteuer/Werbegebühr/Warensteuer/Tabak- und Alkoholsteuer) und die Gesamtkosten der Umsetzung einschließlich Steuern zurück.
Überprüfen Sie den Steuersatz. – Überprüfen Sie den Zollsatz und das Warensteuerkennzeichen entsprechend der CCC-Tarifnummer.
automatischer Tarif – Wenn kein CCC vorhanden ist, wird nur product_description angegeben, und das System verwendet das KI-Modell der Zollverwaltung, um den Tarif automatisch zu empfehlen und die Steuer zu berechnen.

Steuerwährung: Neuer Taiwan-Dollar (TWD). Die Menge der Waren, die Sie in einer Fremdwährung (z. B. CNY) einführen, wird vom System nach der Umrechnung in neue Taiwan-Dollar auf der Grundlage des offiziellen Wechselkurses für die Zollanmeldung für zehn Tage berechnet. Der Steuerbetrag wird vollständig in neuen Taiwan-Dollar angegeben.

Die Beziehung zwischen und der Fracht-API :. Die Versandgebühr in der Steuerversuchsberechnungsantwort ist die HowBridge NT$-Referenzfracht (zur Schätzung der Implementierungskosten). Für die tatsächliche Abholgebühr, die bei 0337.tw eingezogen wird, verwenden Sie bitte die Fracht-API (Seeexpress, RMB). Die Steuer dieser API beinhaltet keine Fracht (Steuerbasis = Ware FOB, praktische Basis; die formelle Zollanmeldung unterliegt der Zollgenehmigung von CIF).

2 Zertifizierung und grundlegende Informationen

Für alle Anfragen ist ein API-Schlüssel erforderlich (derselbe Schlüssel wie die Versandgebühr/der Versandstatus ist ausreichend, und die Berechtigung tax:read ist erforderlich).

Base URL

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

Authentifizierungsheader (wählen Sie einen aus)

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

Rufen Sie bitte von der Serverseite auf und geben Sie den Schlüssel nicht dem Frontend preis. Das Ratenlimit wird in Schlüsseleinheiten angegeben und der Antwortheader X-RateLimit-Remaining meldet das verbleibende Kontingent. Wenn das Limit überschritten wird, wird HTTP 429 zurückgegeben.

3 Endpunkt: Steuerversuchsberechnung

GETPOST /api/v1/tax/estimate

Es wird empfohlen, POST + JSON zu verwenden.

Parameter anfordern

Parameter	Typ	Erforderlich	veranschaulichen
`currency_code`	string(3)	Erforderlich	Fremdwährungstyp, z. B. `CNY`.
`price_foreign`	number	Erforderlich	Warenmenge in Fremdwährung.
`product_description`	string	Optional*	Produktbeschreibung. Wenn `hs_code` nicht angegeben ist, wird KI verwendet, um die Steuerregeln automatisch voranzutreiben.
`hs_code`	string	Optional*	CCC-Tarifcode (8–11 Ziffern).
`quantity`	int	Optional	Menge, Standard 1.
`weight_kg` / `dimensions`	number / [3]	Optional	Gewicht/Länge, Breite und Höhe (siehe Frachtkostenvoranschlag).
`over_exempt_limit`	bool	Optional	Die sechs Steuerbefreiungen für ein halbes Jahr sind ausgeschöpft → Zwangsbesteuerung.
`volume_liters` / `alcohol_degree` / `tobacco_sticks`	number/int	Optional	Wird zur Berechnung der Alkohol-/Zigaretten-Pauschalsteuer verwendet.

* hs_code und product_description Wählen Sie mindestens ein .

Anforderungsbeispiel (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":"Damenoberteile aus Baumwolle","currency_code":"CNY","price_foreign":300,"quantity":1}'

Antworten 200 (Auszug)

{
  "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,            // Steuerbemessungsgrundlage ≤ NT$2.000 → Steuerbefreiung für kleine Beträge
      "duty": 0, "promo_fee": 0, "vat": 0, "total_tax": 0,
      "if_over_limit": {           // Bei 6-maliger Ausschöpfung des Steuerfreibetrages in einem halben Jahr beträgt der zu zahlende Betrag
        "duty": 145.28, "vat": 76.44, "total_tax": 221.72
      }
    },
    "antidumping": [],
    "total_landed_cost": 1453.6,
    "disclaimer": "..."
  }
}

4 Endpunkt: Steuersatz prüfen

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

Überprüfen Sie den Zollsatz und die Warensteuerkennzeichnung anhand der CCC-Tarifnummer (reine Zahlen).

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": "Baumwoll-T-Shirts, Unterhemden…",
    "source": "tariffs_db"
  }
}

5 Beschreibung des Antwortfelds (data)

Feld	veranschaulichen
`exchange.rate_to_twd`	Der täglich verwendete Wechselkurs für die Zollanmeldung (Fremdwährung → Neuer Taiwan-Dollar).
`exchange.price_twd`	Der Produktbetrag wird in neue Taiwan-Dollar umgerechnet.
`tariff_info.duty_rate`	Angewendeter Zollsatz (%); ECFA zweite Spalte, falls zutreffend.
`tax_base`	Steuerbasis (NTD) = Artikel FOB × Menge (ohne Versandkosten).
`tax_breakdown.is_tax_exempt`	Ist es von der Steuerbefreiung für kleine Mengen befreit (Steuerbemessungsgrundlage ≤ NT$2.000 und nicht tabakhaltige und alkoholische Getränke)?
`tax_breakdown.duty`	Tarif (NTD).
`tax_breakdown.promo_fee`	Werbedienstleistungsgebühr (0,04 %, keine Gebühr, wenn weniger als NT$100).
`tax_breakdown.commodity_tax`	Verbrauchsteuer (Haushaltsgeräte usw.; im Allgemeinen 0 für Konfektionskleidung).
`tax_breakdown.alcohol_tax`	Tabak- und Alkoholsteuer (Festbetrag).
`tax_breakdown.vat`	Umsatzsteuer 5 %.
`tax_breakdown.total_tax`	Gesamtsteuerschuld (NTD).
`tax_breakdown.if_over_limit`	Im Falle einer Steuerbefreiung die voraussichtlich zu zahlende Steuer, wenn die Steuerbefreiung in einem halben Jahr sechsmal in Anspruch genommen wird.
`antidumping`	Antidumping-/Ausgleichssteuer-Mahnung (je nach Herkunftsland geht nur die Mahnung nicht in die Gesamtsumme ein).
`total_landed_cost`	Gesamtlandekosten inklusive Steuern (Steuerbasis + Referenzfracht + Steuern).

6 Steuerformel

Steuerbasis = Ware FOB (Fremdwährung × Wechselkurs) × Menge
Steuerbefreiung für kleine Beträge = Steuerbemessungsgrundlage ≤ NT$2.000 und nicht Tabak und Alkohol → Steuer 0 (6-mal in einem halben Jahr)
Tarif = Steuerbasis × Tarifsatz (oder feste Steuer, je nachdem, welcher Wert höher ist)
Werbegebühr = Steuerbasis × 0,04 % (keine Gebühr, wenn der Betrag NT$100 nicht erreicht)
Warensteuer = (Steuerbasis + Tarif) × Warensteuersatz (anwendbare Artikel)
Gewerbesteuer = (Steuerbasis + Zoll + Warensteuer + Alkohol- und Tabaksteuer) × 5%
Zu zahlende Steuer = Zollgebühr + Werbegebühr + Warensteuer + Tabak- und Alkoholsteuer + Gewerbesteuer

Rechtsgrundlagen: Tarifrecht, Umsatzsteuerrecht und Umsatzsteuerrecht, Gewerberecht (Förderung von Gewerbegebühren), Warensteuerordnung, Tabak- und Alkoholsteuerrecht. Der tatsächliche Steuerbetrag unterliegt der Genehmigung durch den Zoll.

7 Fehlercode

HTTP	`error` / Situation	veranschaulichen
401	missing_api_key / invalid_api_key	Kein/ungültiger API-Schlüssel.
403	insufficient_scope	Der Schlüssel ist nicht aktiviert `tax:read`.
422	Fehlender Währungscode/Preis_ausländischer Betrag	Die erforderlichen Parameter fehlen oder haben das falsche Format.
422	Steuerdefizitregeln	hs_code nicht angegeben und Produktbeschreibung kann nicht klassifiziert werden.
422	Für diese Währung gibt es keinen Wechselkurs	Für den Währungscode wurde noch kein Wechselkurs angegeben. Bitte wenden Sie sich an den Kundendienst.
429	rate_limit_exceeded	Das Minutenlimit wurde überschritten.

8 Programmbeispiel

$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' => 'Damenoberteile aus Baumwolle',
        'currency_code' => 'CNY',
        'price_foreign' => 300,
    ],
]);
$tax = json_decode($res->getBody(), true)['data']['tax_breakdown'];
echo 'Zu zahlende Steuern 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: 'Damenoberteile aus Baumwolle', 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":"Damenoberteile aus Baumwolle","currency_code":"CNY","price_foreign":300}'

9 Support und Versionen

technische Unterstützung: howyunqisoftware@gmail.com

API-Version: v1 (stabil).

Änderungshistorie: 01.06.2026 – Die Einfuhrsteuer-Testberechnungs-API v1 ist online.

Versand-API Verfügbarkeits-API Beantragen Sie einen API-Schlüssel