Документация по разработке API пробного расчета налога на импорт

что можно сделать

• Расчет налога — внесите товары (налоговый код CCC или описание продукта) + сумму в иностранной валюте, верните полную информацию о налоге (тариф/налог на бизнес/плату за продвижение/налог на товары/налог на табак и алкоголь) и общую стоимость реализации, включая налоги.
• Проверьте ставку налога. — проверьте ставку тарифа и флаг налога на товары в соответствии с номером тарифа CCC.
• автоматический тариф — при отсутствии CCC задается только product_description, и система использует модель AI Таможенной администрации для автоматической рекомендации тарифа и расчета налога.

Base URL

Заголовок аутентификации (выберите один)

Authorization: Bearer lk_live_xxxxxxxxxxxxxxxxxxxxxxxx
// или
X-API-Key: lk_live_xxxxxxxxxxxxxxxxxxxxxxxx

Пожалуйста, позвоните со стороны сервера и не раскрывайте ключ перед интерфейсом. Ограничение скорости указывается в ключевых единицах, а заголовок ответа X-RateLimit-Remaining сообщает об оставшейся квоте, а HTTP 429 возвращается при превышении ограничения.

GETPOST /api/v1/tax/estimate

Рекомендуется использовать POST + JSON.

Параметры запроса

Пример запроса (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":"Хлопковые женские топы","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": "..."
  }
}

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

Проверьте тарифную ставку и флаг налога на товары в соответствии с номером тарифа CCC (чистые числа).

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"
  }
}

техническая поддержка: howyunqisoftware@gmail.com

Версия API: v1 (стабильная).

История изменений: 01.06.2026 — API пробного расчета налога на импорт доступен онлайн.