सेवा बाज़ार / आयात कर परीक्षण गणना एपीआई विकास दस्तावेज़

ताइवान आयात कर परीक्षण गणना एपीआई · v1

आयात कर परीक्षण गणना एपीआई विकास दस्तावेज़

उत्पाद (CCC कर कोड, या उत्पाद विवरण का सिर्फ स्वचालित AI वर्गीकरण) + विदेशी मुद्रा राशि के आधार पर, तुरंत ताइवान आयात करों की गणना करें: टैरिफ (ECFA / निश्चित कर सहित), व्यापार कर, प्रचार शुल्क, माल कर, तंबाकू और शराब कर, और स्वचालित रूप से NT$2,000 कर-मुक्त की छोटी राशि निर्धारित करें। विशेष रूप से 0337.tw जैसे सीमा पार ई-कॉमर्स प्लेटफॉर्म के साथ डॉकिंग के लिए डिज़ाइन किया गया है।

5 प्रमुख कर और शुल्क

टैरिफ + व्यापार कर + प्रचार शुल्क + माल कर + तंबाकू और शराब कर

NT$2,000

छोटी राशि पर कर छूट का स्वत: निर्धारण

एआई कर नियम

उत्पाद विवरण सीसीसी को स्वचालित रूप से वर्गीकृत करें

विनिमय दर प्रति दस दिन

आधिकारिक सीमा शुल्क घोषणा विनिमय दर रूपांतरण

1 सिंहावलोकन

अपने प्लेटफ़ॉर्म को सीधे प्रदर्शित करने दें "ताइवान में इस उत्पाद को आयात करने पर कितना कर चुकाना होगा?" सामने की मेज पर.

क्या किया जा सकता है

कर गणना - माल (CCC कर कोड या उत्पाद विवरण) + विदेशी मुद्रा राशि लाएं, संपूर्ण कर विवरण (टैरिफ/व्यापार कर/पदोन्नति शुल्क/माल कर/तंबाकू और शराब कर) और कर सहित कार्यान्वयन की कुल लागत लौटाएं।
कर दर की जाँच करें - सीसीसी टैरिफ संख्या के अनुसार टैरिफ दर और माल कर ध्वज की जाँच करें।
स्वचालित टैरिफ - जब कोई CCC नहीं होता है, तो केवल product_description दिया जाता है, और सिस्टम स्वचालित रूप से टैरिफ की सिफारिश करने और कर की गणना करने के लिए सीमा शुल्क प्रशासन के AI मॉडल का उपयोग करता है।

Tax मुद्रा: न्यू ताइवान डॉलर (TWD)। आपके द्वारा विदेशी मुद्रा (जैसे CNY) में लाए गए सामान की मात्रा की गणना सिस्टम द्वारा आधिकारिक दस-दिवसीय सीमा शुल्क घोषणा विनिमय दर के आधार पर नए ताइवान डॉलर में परिवर्तित करने के बाद की जाएगी। कर की सारी राशि न्यू ताइवान डॉलर में होगी।

और माल ढुलाई एपीआई : के बीच संबंध। कर परीक्षण गणना प्रतिक्रिया में शिपिंग_फी HowBridge NT$ संदर्भ भाड़ा (कार्यान्वयन लागत अनुमान के लिए) है। 0337.tw से एकत्रित वास्तविक संग्रहण शुल्क के लिए, कृपया माल ढुलाई API (समुद्री एक्सप्रेस, RMB) का उपयोग करें। इस एपीआई के कर में माल ढुलाई शामिल नहीं है (कर आधार = वस्तु FOB, सुविधाजनक आधार; औपचारिक सीमा शुल्क घोषणा CIF के सीमा शुल्क अनुमोदन के अधीन होगी)।

2 प्रमाणीकरण और बुनियादी जानकारी

सभी अनुरोधों के लिए एक एपीआई कुंजी की आवश्यकता होती है (शिपिंग शुल्क/शिपमेंट स्थिति के लिए वही कुंजी पर्याप्त है, और 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	वैकल्पिक*	सीसीसी टैरिफ कोड (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 कम से कम एक चुनें।

उदाहरण का अनुरोध करें (पोस्ट 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}

सीसीसी टैरिफ संख्या (शुद्ध संख्या) के अनुसार टैरिफ दर और माल कर ध्वज की जांच करें।

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`	कर आधार (एनटीडी) = आइटम FOB × मात्रा (शिपिंग शुल्क को छोड़कर)।
`tax_breakdown.is_tax_exempt`	क्या यह छोटी राशि की कर छूट (कर आधार ≤ NT$2,000 और गैर-तंबाकू और मादक पेय) से मुक्त है।
`tax_breakdown.duty`	टैरिफ (एनटीडी)।
`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	नहीं/अमान्य एपीआई कुंजी।
403	insufficient_scope	कुंजी सक्रिय नहीं है `tax:read`।
422	मुद्रा_कोड/मूल्य_विदेशी मौजूद नहीं है	आवश्यक पैरामीटर अनुपलब्ध हैं या गलत प्रारूप में हैं।
422	कर कमी नियम	hs_code नहीं दिया गया है और product_description को वर्गीकृत नहीं किया जा सकता है।
422	इस मुद्रा के लिए कोई विनिमय दर नहीं है	करेंसी_कोड ने अभी तक विनिमय दर प्रदान नहीं की है, कृपया ग्राहक सेवा से संपर्क करें।
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 (स्थिर).

इतिहास बदलें: 2026-06-01 — आयात कर परीक्षण गणना एपीआई v1 ऑनलाइन है।

शिपिंग एपीआई उपलब्धता एपीआई एपीआई कुंजी के लिए आवेदन करें