CustomsCalc

Библиотека для расчёта стоимости растаможки автомобилей в Беларуси по ставкам ЕАЭС. Не знает ничего о DOM и не имеет зависимостей — подходит для любого окружения.

Установка

npm install customs-calculator

TypeScript / ESM:

import { calculate, calcDutyEur, calcUtil, Age, PersonType, EngineType, Currency } from 'customs-calculator';

CommonJS:

const { calculate, Age, EngineType } = require('customs-calculator');

Быстрый старт

Три шага: задайте курсы валют, опишите расходы, вызовите calculate().

import { calculate, Age, PersonType, EngineType, Currency } from 'customs-calculator';

// 1. Курсы BYN (например, от НБРБ)
const rates = { usd: 2.82, eur: 3.3 };

// 2. Фиксированные расходы — любой набор в любой валюте
const fixedCosts = [
  { id: 'delivery',   amount: 1400, currency: 'EUR' },
  { id: 'warehouse',  amount: 200,  currency: 'BYN' },
  { id: 'epts',       amount: 70,   currency: 'BYN' },
];

// 3. Расчёт
const result = calculate({
  age:        'under3',   // возраст авто
  price:      15000,      // стоимость
  currency:   'EUR',      // валюта цены
  engineType: 'fuel',     // тип двигателя
  volume:     2000,       // объём, см³
  face:       'individual', // физ. лицо
  discount:   false,      // льгота 50%
  fixedCosts,
  rates,
});

console.log(result.totalEur); // итого в EUR

TypeScript с Enums

import { calculate, Age, PersonType, EngineType, Currency } from 'customs-calculator';

// те же rates и fixedCosts...
const result = calculate({
  age:        Age.Under3,
  price:      15000,
  currency:   Currency.EUR,
  engineType: EngineType.Fuel,
  volume:     2000,
  face:       PersonType.Individual,
  discount:   false,
  fixedCosts,
  rates,
});

С комиссией банковского перевода

const result = calculate({
  // ...остальные параметры...
  commission: 1.5,  // +1.5% к цене авто в totalEur
  fixedCosts,
  rates,
});

Прямой вызов низкоуровневых функций

import { calcDutyEur, calcUtil } from 'customs-calculator';

// Только пошлина, без остального
const duty = calcDutyEur('under3', 15000, 2000);

// Только утилизационный сбор
const util = calcUtil('individual', 'fuel', 2000, 'under3');

Типы данных

Enums

Строковые значения совместимы с обычным JS — можно передавать литералы 'under3' вместо Age.Under3.

import { Age, PersonType, EngineType, Currency } from 'customs-calculator';

Типы двигателя

Шесть значений EngineType и то, как каждое считается:

Строка «с электродвигателями» перечня ставок утильсбора распространяется только на ТС «с электродвигателями, за исключением транспортных средств, оснащённых различными типами гибридных силовых установок». Поэтому все гибриды, включая EREV, платят утильсбор по строке «с объёмом двигателя» — от объёма ДВС, и для них обязательно задавать volume. Разбор строк перечня — в разделе ставки утилизационного сбора.

Льгота 50% по Указу №140 — только для физлиц. При face: 'legal' параметр discount игнорируется, а не уменьшает пошлину.

Ставки утильсбора соответствуют категориям M1 и M1G и действуют с 29.04.2026 — дата доступна как UTIL_RATES_EFFECTIVE_FROM, ссылка на источник как UTIL_RATES_SOURCE. Категории M2/M3 и N1—N3 не реализованы.

FixedCostItem

Описывает один фиксированный расход. Передаётся в массиве fixedCosts.

{ id: 'delivery', amount: 1400, currency: 'EUR' }
{ id: 'warehouse', amount: 200,  currency: 'BYN' }

Rates

Курсы валют — рублей (BYN) за единицу. Получаются, например, из API НБРБ.

{ usd: 2.82, eur: 3.3 }

CalcResult

Объект, который возвращает calculate(). Все суммы — числа с плавающей точкой; округляйте по необходимости.

API Reference

calculate(params)

Основная функция. Принимает все параметры сделки, возвращает полный расчёт.

Параметры

Ставки пошлины (встроенные таблицы)

Ставки соответствуют решению Совета ЕЭК для физических лиц.

До 3 лет — MAX(% от стоимости в EUR, EUR × см³):

По этим же таблицам считаются 'hybrid_mhev', 'hybrid_hev' и 'hybrid_phev': у них ДВС механически связан с колёсами, поэтому они попадают в 8703 40/50/60/70 — обычный легковой автомобиль товарной позиции 8703. Сами таблицы — единые ставки для товаров для личного пользования, Приложение 2 к Решению Совета ЕЭК от 20.12.2017 № 107.

От 3 до 5 лет и старше 5 лет — EUR × см³ (ставка по объёму):

Гибрид EREV ('hybrid_erev') — фиксированные ставки независимо от возраста и объёма:

Льгота 50% (Указ №140), если применима, уменьшает и пошлину, и НДС вдвое. Объём двигателя в расчёте пошлины EREV не участвует, но нужен для утильсбора.

calcDutyEur(age, priceEur, volumeCc, engineType?)

Низкоуровневая функция. Вычисляет только таможенную пошлину, в отрыве от остальных расходов. Четвёртый параметр необязателен, по умолчанию 'fuel'.

Возвращает: пошлину в EUR. Льгота 50% по Указу №140 здесь не применяется — её учитывает только calculate().

// BMW X5, 3.0 л, возраст 1 год, цена 50 000 EUR
calcDutyEur('under3', 50000, 3000);
// → MAX(50000 × 0.48, 3000 × 5.5) = MAX(24000, 16500) = 24000

// VW Golf, 1.6 л, возраст 4 года, цена 12 000 EUR
calcDutyEur('3to5', 12000, 1600);
// → 1600 × 2.5 = 4000

// PHEV 1.5 л, старше 5 лет — как обычный ДВС
calcDutyEur('over5', 20000, 1500, 'hybrid_phev'); // → 1500 × 3.2 = 4800

// EREV — 15% от стоимости, объём не участвует
calcDutyEur('over5', 20000, 1500, 'hybrid_erev'); // → 3000

// Электромобиль — пошлины нет
calcDutyEur('over5', 20000, 1500, 'electric'); // → 0

calcUtil(face, engineType, volumeCc, age)

Возвращает утилизационный сбор в BYN по Постановлению №195 (апрель 2026) для категорий M1 и M1G. Ставки для физических лиц зависят только от возраста; для юридических — от типа двигателя, объёма и возраста.

Возвращает: утилизационный сбор в BYN.

Ставки утилизационного сбора

Ставки берутся из перечня видов и категорий транспортных средств, являющихся объектами обложения утилизационным сбором, а также ставок утилизационного сбора. Легковые автомобили — это раздел 1 перечня: «транспортные средства категории M1, в том числе повышенной проходимости категории M1G». Внутри раздела ровно три строки, и выбор между ними определяет всю логику функции:

Оговорка в строке 1.1 и есть причина, по которой гибриды считаются по объёму: пункт прямо исключает ТС с гибридными силовыми установками любого типа, а строка 1.2 никаких оговорок о приводе не содержит. Отдельных строк для гибридов в перечне нет.

Строка 1.3 — физические лица, BYN

Строки 1.1 и 1.2 — юридические лица, BYN

// Физлицо — строка 1.3, тип и объём не влияют
calcUtil('individual', 'fuel', 2000, 'under3'); // → 624.92

// Юрлицо, топливо 1.6 л, старше 3 лет — строка 1.2
calcUtil('legal', 'fuel', 1600, 'over5'); // → 44374.56

// Юрлицо, электромобиль до 3 лет — строка 1.1, объём не важен
calcUtil('legal', 'electric', 0, 'under3'); // → 1229.28

// Юрлицо, любой гибрид 1.5 л до 3 лет — строка 1.2, по объёму ДВС
calcUtil('legal', 'hybrid_erev', 1500, 'under3'); // → 25226.22
calcUtil('legal', 'hybrid_phev', 1500, 'under3'); // → 25226.22

Интерактивное демо

Меняйте параметры — расчёт и фрагмент кода обновляются мгновенно.