marché des services / Documentation de développement de l'API de calcul d'essai de taxe à l'importation

API de calcul d'essai de taxe à l'importation de Taiwan · v1

Documentation de développement de l'API de calcul d'essai de taxe à l'importation

En fonction du produit (code fiscal CCC, ou simplement classification automatique par IA de la description du produit) + montant en devise étrangère, calculez instantanément les taxes d'importation de Taiwan : tarif (y compris ECFA / taxe fixe), taxe professionnelle, frais de promotion, taxe sur les produits, taxe sur le tabac et l'alcool, et déterminez automatiquement le petit montant de NT$2 000 en franchise d'impôt. Spécialement conçu pour l'amarrage avec des plateformes de commerce électronique transfrontalières telles que 0337.tw.

5 taxes et frais majeurs

Tarif + taxe professionnelle + frais de promotion + taxe sur les produits + taxe sur le tabac et l'alcool

NT$2,000

Détermination automatique de l'exonération fiscale d'un petit montant

Règles fiscales de l'IA

Classer automatiquement les descriptions de produits CCC

Taux de change par décade

Conversion du taux de change de la déclaration en douane officielle

1 Aperçu

Laissez votre plateforme afficher directement « Quel montant de taxe sera payé lors de l'importation de ce produit à Taiwan ? » à la réception.

que peut-on faire

Calcul de la taxe - Apportez la marchandise (code fiscal CCC ou description du produit) + montant en devise étrangère, renvoyez les détails complets de la taxe (tarif/taxe professionnelle/frais de promotion/taxe sur les marchandises/taxe sur le tabac et l'alcool) et le coût total de mise en œuvre, taxe comprise.
Vérifiez le taux de taxe — Vérifiez le taux de droit et l'indicateur de taxe sur les produits en fonction du numéro de tarif CCC.
tarif automatique — Lorsqu'il n'y a pas de CCC, seul product_description est donné et le système utilise le modèle IA de l'administration des douanes pour recommander automatiquement le tarif et calculer la taxe.

Devise fiscale : nouveau dollar de Taiwan (TWD). Le montant des marchandises que vous apportez en devises étrangères (telles que le CNY) sera calculé par le système après l'avoir converti en nouveaux dollars taïwanais sur la base du taux de change officiel de la déclaration en douane sur dix jours. Le montant de la taxe sera entièrement en nouveaux dollars taïwanais.

La relation entre et l'API de fret :. Le shipping_fee dans la réponse de calcul de l'essai fiscal est le fret de référence HowBridge NT$ (pour l'estimation des coûts de mise en œuvre). Pour les frais de collecte réels collectés auprès de 0337.tw, veuillez utiliser le fret API (sea express, RMB). La taxe de cette API n'inclut pas le fret (base fiscale = marchandise FOB, base pratique ; la déclaration en douane formelle sera soumise à l'approbation douanière de CIF).

2 Certification et informations de base

Toutes les demandes nécessitent une clé API (la même clé que les frais d'expédition/le statut de l'expédition est suffisante et l'autorisation tax:read est requise).

Base URL

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

En-tête d'authentification (choisissez-en un)

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

Veuillez appeler du côté du serveur et n'exposez pas la clé au frontal. La limite de débit est en unités clés et l'en-tête de réponse X-RateLimit-Remaining signale le quota restant, et HTTP 429 est renvoyé lorsque la limite est dépassée.

3 Point final : calcul de l'essai fiscal

GETPOST /api/v1/tax/estimate

Il est recommandé d'utiliser POST + JSON.

Paramètres de la demande

paramètre	Taper	Requis	illustrer
`currency_code`	string(3)	Requis	Type de devise étrangère, tel que `CNY`.
`price_foreign`	number	Requis	Montant de la marchandise en devise étrangère.
`product_description`	string	Facultatif*	Description du produit. Lorsque `hs_code` n'est pas indiqué, l'IA est utilisée pour appliquer automatiquement les règles fiscales.
`hs_code`	string	Facultatif*	Code tarifaire CCC (8 à 11 chiffres).
`quantity`	int	Facultatif	Quantité, par défaut 1.
`weight_kg` / `dimensions`	number / [3]	Facultatif	Poids/Longueur, Largeur et Hauteur (se référer au devis de transport).
`over_exempt_limit`	bool	Facultatif	Les six exonérations fiscales pour six mois sont épuisées → fiscalité obligatoire.
`volume_liters` / `alcohol_degree` / `tobacco_sticks`	number/int	Facultatif	Utilisé pour le calcul de la taxe fixe sur l'alcool/les cigarettes.

* hs_code et product_description Choisissez au moins un .

Exemple de requête (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":"Hauts femme en coton","currency_code":"CNY","price_foreign":300,"quantity":1}'

Réponses 200 (extrait)

{
  "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,            // Assiette fiscale ≤ NT$2 000 → exonération fiscale d'un petit montant
      "duty": 0, "promo_fee": 0, "vat": 0, "total_tax": 0,
      "if_over_limit": {           // Si l'exonération fiscale est épuisée 6 fois par semestre, le montant dû
        "duty": 145.28, "vat": 76.44, "total_tax": 221.72
      }
    },
    "antidumping": [],
    "total_landed_cost": 1453.6,
    "disclaimer": "..."
  }
}

4 Point final : vérifier le taux de taxe

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

Vérifiez le taux de droit et le drapeau de taxe sur les produits en fonction du numéro de tarif CCC (chiffres purs).

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": "T-shirts, maillots de corps en coton…",
    "source": "tariffs_db"
  }
}

5 Description du champ de réponse (data)

champ	illustrer
`exchange.rate_to_twd`	Le taux de change quotidien de la déclaration en douane utilisé (Devise étrangère → Nouveau dollar de Taiwan).
`exchange.price_twd`	Le montant du produit est converti en nouveaux dollars de Taiwan.
`tariff_info.duty_rate`	Taux de droit appliqué (%) ; ECFA deuxième colonne, le cas échéant.
`tax_base`	Base fiscale (NTD) = article FOB × quantité (hors frais de port).
`tax_breakdown.is_tax_exempt`	Est-il exonéré d'une exonération fiscale de faible montant (assiette fiscale ≤ NT$2 000 et boissons non-tabac et alcoolisées).
`tax_breakdown.duty`	Tarif (NTD).
`tax_breakdown.promo_fee`	Frais de service commercial promotionnel (0,04 %, sans frais si inférieur à NT$100).
`tax_breakdown.commodity_tax`	Taxe d'accise (électroménager, etc. ; généralement 0 pour le prêt-à-porter).
`tax_breakdown.alcohol_tax`	Taxe sur le tabac et l'alcool (montant forfaitaire).
`tax_breakdown.vat`	Taxe de vente 5%.
`tax_breakdown.total_tax`	Taxe totale à payer (NTD).
`tax_breakdown.if_over_limit`	En cas d'exonération fiscale, l'impôt estimé à payer si l'exonération fiscale est utilisée 6 fois par semestre.
`antidumping`	Rappel de taxe antidumping/équilibré (selon le pays d'origine, seul le rappel n'est pas intégré au total).
`total_landed_cost`	Coût total d'atterrissage TTC (assiette fiscale + fret de référence + taxe).

6 formule fiscale

assiette fiscale = marchandise FOB (devise étrangère × taux de change) × quantité
exonération fiscale d'un petit montant = assiette fiscale ≤ NT$2 000 et non tabac et alcool → taxe 0 (6 fois en six mois)
Tarif = base d'imposition × taux de droit (ou taxe fixe, selon le montant le plus élevé)
Frais de promotion = base fiscale × 0,04% (sans frais si le montant n'atteint pas NT$100)
Taxe sur les produits = (Base fiscale + Tarif) × Taux de taxe sur les produits (éléments applicables)
Taxe professionnelle = (assiette fiscale + tarif + taxe sur les produits + taxe sur l'alcool et le tabac) × 5%
Taxe à payer = Droits de douane + Frais de promotion + Taxe sur les produits + Taxe sur le tabac et l'alcool + Taxe professionnelle

Base juridique : loi tarifaire, loi sur la taxe sur les entreprises à valeur ajoutée et sans valeur ajoutée, loi sur le commerce (promotion des frais de services commerciaux), réglementation sur la taxe sur les produits, loi sur la taxe sur le tabac et l'alcool. Le montant réel de la taxe est soumis à l'approbation des douanes.

7 code d'erreur

HTTP	`erreur` / situation	illustrer
401	missing_api_key / invalid_api_key	Clé API non valide/invalide.
403	insufficient_scope	La clé n'est pas activée `tax:read`.
422	Code_monnaie/prix_étranger manquant	Les paramètres requis sont manquants ou dans un format incorrect.
422	règles relatives aux déficits fiscaux	hs_code non fourni et product_description ne peut pas être classé.
422	Il n'y a pas de taux de change pour cette devise	Le code_monnaie n'a pas encore fourni de taux de change, veuillez contacter le service client.
429	rate_limit_exceeded	Limite par minute dépassée.

8 Exemple de programme

$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' => 'Hauts femme en coton',
        'currency_code' => 'CNY',
        'price_foreign' => 300,
    ],
]);
$tax = json_decode($res->getBody(), true)['data']['tax_breakdown'];
echo 'Taxes à payer 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: 'Hauts femme en coton', 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":"Hauts femme en coton","currency_code":"CNY","price_foreign":300}'

9 Support et versions

assistance technique : howyunqisoftware@gmail.com

Version API : v1 (stable).

Historique des modifications : 01/06/2026 — L'API v1 de calcul d'essai de taxe à l'importation est en ligne.

API d'expédition API de disponibilité Demander une clé API