TKS-API: Калькулятор Таможенных Платежей для Автомобилей
TKS-API — Python-библиотека для расчёта таможенных пошлин при импорте автомобилей в Россию. Она предоставляет точные данные о налогах, акцизах, утилизационных сборах и других обязательных платежах, автоматически применяя методы ETC (Единая ставка) и CTP (Совокупный таможенный платёж).
Эта библиотека — идеальное решение для физических и юридических лиц, которые хотят сэкономить время и избежать ошибок при таможенном расчёте. С её помощью вы можете узнать полную стоимость растаможки вашего автомобиля всего за несколько шагов.
Возможности TKS-API
- Автоматический расчёт пошлин и сборов: Метод выбирается на основе параметров автомобиля.
- Гибкость конфигурации: Легко адаптируется к изменениям тарифов.
- Поддержка всех типов автомобилей: Легковые, грузовые, гибридные и электромобили.
- Актуальные курсы валют: Интеграция с currency-converter-free для конвертации стоимости авто.
- Простая интеграция: Подходит для малого бизнеса, таможенных брокеров и крупных импортеров.
Установка
Чтобы установить библиотеку, выполните:
pip install tks-api-official
Как пользоваться
Пример расчёта таможенных пошлин
from tks_api_official.calc import CustomsCalculator
# Инициализация калькулятора с конфигурацией
calculator = CustomsCalculator("config.yaml")
# Установка параметров автомобиля
calculator.set_vehicle_details(
age="5-7", # Возраст автомобиля: "new", "1-3", "3-5", "5-7", "over_7"
engine_capacity=2000, # Объём двигателя в см³
engine_type="gasoline", # Тип двигателя: "gasoline", "diesel", "electric", "hybrid"
power=150, # Мощность двигателя в л.с.
price=100000, # Стоимость автомобиля
owner_type="individual", # Тип импортёра: "individual" или "company"
currency="USD" # Валюта стоимости автомобиля
)
# Расчёт платежей по ETC
etc_results = calculator.calculate_etc()
calculator.print_table("ETC")
# Расчёт платежей по CTP
ctp_results = calculator.calculate_ctp()
calculator.print_table("CTP")
Параметры класса CustomsCalculator
Метод set_vehicle_details
-
age(str)
Возможные значения:"new": Новый автомобиль."1-3": Возраст от 1 до 3 лет."3-5": Возраст от 3 до 5 лет."5-7": Возраст от 5 до 7 лет."over_7": Старше 7 лет.
-
engine_capacity(int)
Объём двигателя в кубических сантиметрах (см³). -
engine_type(str)
Возможные значения:"gasoline": Бензиновый двигатель."diesel": Дизельный двигатель."electric": Электромобиль."hybrid": Гибридный двигатель.
-
power(int)
Мощность двигателя в лошадиных силах (л.с.). -
price(float)
Стоимость автомобиля. -
owner_type(str)
Возможные значения:"individual": Физическое лицо."company": Юридическое лицо.
-
currency(str)
Код валюты стоимости автомобиля, например:"USD": Доллары США."EUR": Евро."KRW": Южнокорейская вона."RUB": Российский рубль.
Параметры конфигурации (config.yaml)
Пример конфигурации
tariffs:
base_clearance_fee: 3100 # Таможенная пошлина за оформление (руб.)
base_util_fee: 20000 # Утилизационный сбор (руб.)
etc_util_coeff_base: 1.5 # Коэффициент утилизационного сбора для ETC
ctp_util_coeff_base: 1.2 # Коэффициент утилизационного сбора для CTP
excise_rates:
gasoline: 58 # Акциз для бензиновых двигателей (руб./л.с.)
diesel: 58 # Акциз для дизельных двигателей (руб./л.с.)
electric: 0 # Для электромобилей акциз отсутствует
hybrid: 58 # Акциз для гибридных двигателей (руб./л.с.)
recycling_factors:
default:
gasoline: 1.0
diesel: 1.1
electric: 0.3
hybrid: 0.9
adjustments:
"5-7":
gasoline: 0.26
diesel: 0.26
electric: 0.26
hybrid: 0.26
age_groups:
overrides:
"5-7":
gasoline:
rate_per_cc: 4.8 # Ставка (евро/см³)
min_duty: 0 # Минимальная ставка
diesel:
rate_per_cc: 5.0
min_duty: 0
electric:
rate_per_cc: 0
min_duty: 1000
hybrid:
rate_per_cc: 2.0
min_duty: 2500
Основные параметры конфигурации
base_clearance_fee: Таможенная пошлина за оформление.base_util_fee: Утилизационный сбор.etc_util_coeff_base: Коэффициент для расчёта утилизационного сбора по ETC.ctp_util_coeff_base: Коэффициент для расчёта утилизационного сбора по CTP.excise_rates: Ставки акциза для различных типов двигателей.recycling_factors: Коэффициенты утилизационного сбора.age_groups: Индивидуальные тарифы для автомобилей разных возрастов.
Тестирование библиотеки
Для запуска тестов:
pytest tests
Лицензия
Проект распространяется под лицензией MIT.
Подробнее см. файл LICENSE.
Контакты
Разработка: Unrealos.com
Обратная связь: m@unrealos.com
Metadata
Release files for tks-api-official 1.0.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| tks_api_official-1.0.3.tar.gz | 11.0 kB | Without provenance | Details for tks_api_official-1.0.3.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| tks_api_official-1.0.3-py3-none-any.whl | Python 3 | none | any | Details for tks_api_official-1.0.3-py3-none-any.whl |
Total release size: 20.2 kB
Release files / tks_api_official-1.0.3.tar.gz
| Download URL | tks_api_official-1.0.3.tar.gz |
|---|---|
| Size | 11.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2cf0a9c6ab2c29b98b2c5765ad467fb48ffb1156332235b1228a71e24128b0aa
|
|
BLAKE2b-256 checksum How to use checksums |
61b5d61492d4a63381a6476a2e4edfcaf15df4bb1598496f0adbf94dbbda4f58
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.0.1 CPython/3.12.7
|
Release files / tks_api_official-1.0.3-py3-none-any.whl
| Download URL | tks_api_official-1.0.3-py3-none-any.whl |
|---|---|
| Size | 9.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
9da041ab2c57938a028dded38179ddae59a21b1f5151748682251febb8e64aa5
|
|
BLAKE2b-256 checksum How to use checksums |
a4dcbb7f565a0879d13fb0a3d2982d4862207fa237be907f4facd0fcca9f4e9e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.0.1 CPython/3.12.7
|
Security for tks-api-official 1.0.3
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.