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';

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 × см³):

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

calcDutyEur(age, priceEur, volumeCc)

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

Возвращает: пошлину в EUR.

// 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

calcUtil(face, engineType, volumeCc, age)

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

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

Ставки утилизационного сбора (физические лица, BYN)

Ставки утилизационного сбора (юридические лица, BYN)

// Физлицо, авто до 3 лет
calcUtil('individual', 'fuel', 2000, 'under3'); // → 624.92

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

// Юрлицо, электромобиль до 3 лет
calcUtil('legal', 'electric', 0, 'under3'); // → 1229.28

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

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