Calcus API (1.0)

Download OpenAPI specification:Download

Растаможка автомобилей

Authorizations:
(clientkey)
Request Body schema: application/json
required
owner
integer
Enum: 1 2 3

Лицо, которое ввозит автомобиль:
1 - Физическое лицо (для личного использования)
2 - Юридическое лицо
3 - Физическое лицо (для перепродажи)

age
string
Enum: "0-3" "3-5" "5-7" "7-0"

Возраст автомобиля

engine
integer
Enum: 1 2 3 4

Тип двигателя:
1 - Бензиновый
2 - Дизельный
3 - Гибридный
4 - Электрический

power
number

Мощность двигателя
Обязательно для юридических лиц и для ТС с электрическими двигателями. В остальных случаях необязательно.

power_unit
integer
Default: 1
Enum: 1 2

Единицы измерения мощность двигателя:
1 - ЛС
2 - кВт

value
integer

Объем двигателя в кубических сантиметрах (1 литр = 1000 см.куб.). Обязательный параметр для двигателей внутреннего сгорания.

price
number

Стоимость автомобиля

curr
string
Default: "RUB"
Enum: "RUB" "USD" "EUR" "CNY" "JPY" "KRW"

Валюта стоимости автомобиля

Responses

Request samples

Content type
application/json
{
  • "owner": 1,
  • "age": "0-3",
  • "engine": 1,
  • "power": 150,
  • "power_unit": 1,
  • "value": 2000,
  • "price": 5000000,
  • "curr": "RUB"
}

Response samples

Content type
application/json
{
  • "sbor": 0,
  • "tax": 0,
  • "util": 0,
  • "nds": 0,
  • "excise": 0,
  • "total": 0,
  • "total2": 0
}

Калькулятор транспортного налога

Authorizations:
(clientkey)
Request Body schema: application/json
required
owner_type
integer
Default: 1
Enum: 1 2

1 - физическое лицо
2 - юридическое лицо

region
integer

Номер региона

ts_type
integer
  1. Автомобили легковые
  2. Мотоциклы и мотороллеры
  3. Автобусы
  4. Грузовые автомобили
  5. Снегоходы, мотосани
  6. Катера, моторные лодки и другие водные транспортные средства
  7. Яхты и другие парусно-моторные суда
  8. Гидроциклы
  9. Несамоходные (буксируемые) суда
  10. Самолеты, вертолеты и иные воздушные суда, имеющие двигатели
  11. Самолеты, имеющие реактивные двигатели
  12. Другие водные и воздушные транспортные средства, не имеющие двигателей
  13. Другие самоходные транспортные средства
power
number

Мощность ТС в лошадиных силах

period
integer
Default: 12

Количество месяцев владения в году

vehicle_year
integer

Год выпуска ТС (обязательно только для регионов, в которых налог зависит от года выпуска ТС)

pov_k
integer
Default: 1

Повышающий коэффициент для автомобилей. Принимает единственное значение 3 если стоимость автомобиля выше 10 млн. руб.

Responses

Request samples

Content type
application/json
{
  • "owner_type": 1,
  • "region": 66,
  • "ts_type": 1,
  • "power": 150,
  • "period": 12,
  • "vehicle_year": 2020,
  • "pov_k": 1
}

Response samples

Content type
application/json
{
  • "rate": 0,
  • "tax": 0
}

Калькулятор инфляции

Authorizations:
(clientkey)
Request Body schema: application/json
required
month1
integer

Начальный месяц (1 - январь ... 12 - декабрь)

year1
integer

Начальный год

month2
integer

Конечный месяц (1 - январь ... 12 - декабрь)

year2
integer

Конечный год

price
number

Цена в начале периода (если нужно расчитать изменение цены за период)

savings
number

Сумма сбережений в начале периода (если нужно расчитать обесценение сбережений)

Responses

Request samples

Content type
application/json
{
  • "month1": 0,
  • "year1": 0,
  • "month2": 0,
  • "year2": 0,
  • "price": 0,
  • "savings": 0
}

Response samples

Content type
application/json
{
  • "inflation": 0,
  • "new_price": 0,
  • "new_savings": 0
}

Калькулятор инвестиций

Authorizations:
(clientkey)
Request Body schema: application/json
required
type
integer
Default: 1
Enum: 1 2 3 4 5

Тип расчета:
1 - Рассчитать конечную сумму
2 - Рассчитать ставку (пока работает только без пополнений)
3 - Рассчитать стартовый капитал
4 - Рассчитать срок достижения цели
5 - Рассчитать размер пополнений.

sum
number

Начальный капитал. Обязательно для всех типов расчетов кроме 3.

period
integer

Срок инвестирования. Обязательно для всех типов расчетов кроме 4.

period_unit
string
Default: "y"
Enum: "m" "y"

Единица срока

rate
number

Ставка. Обязательно для всех типов расчетов кроме 2.

reinvest
boolean
Default: false

Реинвестировать доход

reinvest_period
integer
Default: 1
Enum: 1 3 6 12

Периодичность реинвестирования:
1 - раз в месяц
3 - раз в квартал
6 - раз в полгода
12 - раз в год

add_period
integer
Default: 1
Enum: 1 3 6 12

Периодичность дополнительных вложений:
1 - раз в месяц
3 - раз в квартал
6 - раз в полгода
12 - раз в год

add_sum
number

Размер дополнительных вложений

Responses

Request samples

Content type
application/json
{
  • "type": 1,
  • "sum": 1000000,
  • "period": 10,
  • "period_unit": "y",
  • "rate": 5,
  • "reinvest": true,
  • "reinvest_period": 1,
  • "add_period": 1,
  • "add_sum": 0
}

Response samples

Content type
application/json
{
  • "total_contributions": 0,
  • "profit": 0,
  • "end_sum": 0,
  • "rate": 0,
  • "start_sum": 0,
  • "term": {
    },
  • "contributions": 0
}

Калькулятор вкладов

Authorizations:
(clientkey)
Request Body schema: application/json
required
sum
number

Сумма вклада

period
number

Срок размещения

period_type
string
Enum: "Y" "M" "D"

Единица периода

date_start
string

Начало срока (YYYY-MM-DD)

percent
number

Процентная ставка (годовых)

cap
integer
Default: 0
Enum: 0 1

Капитализация процентов

compound_frequency
string
Enum: "END" "1D" "1W" "1M" "3M" "6M" "1Y"

Периодичность капитализации. Используется при cap=1

payout_frequency
string
Enum: "1D" "1W" "1M" "3M" "6M" "1Y"

Периодичность выплат. Используется при cap=0

Array of objects

Пополнения вклада

Array of objects

Частиное снятие средств из вклада

Responses

Request samples

Content type
application/json
{
  • "sum": 1000000,
  • "period": 1,
  • "period_type": "M",
  • "date_start": "2024-01-01",
  • "percent": 5,
  • "cap": 1,
  • "compound_frequency": "END",
  • "payout_frequency": "1D",
  • "contributions": [
    ],
  • "withdrawals": [
    ]
}

Response samples

Content type
application/json
{
  • "profit": 0,
  • "total": 0,
  • "growth": 0,
  • "effective_rate": 0,
  • "tax": 0,
  • "clear_profit": 0,
  • "total_contributions": 0,
  • "total_withdrawals": 0,
  • "schedule": [
    ]
}

Кредитный калькулятор

Authorizations:
(clientkey)
Request Body schema: application/json
required
calc_type
number
Default: 1
Enum: 1 2 3

Тип расчета
1 - Расчет ежемесячного платежа
2 - Расчет срока кредита
3 - Расчет максимальной суммы кредита

credit_sum
number

Сумма кредита (кроме типа расчета для нахождения суммы кредита)

period
number

Срок кредита (кроме типа расчета для нахождения срока кредита)

period_type
string
Enum: "Y" "M"

Единица срока

percent
number

Процентная ставка (годовых)

monthly_payment
number

Ежемесячный платеж (кроме типа расчета для нахождения ежемесячного платежа)

payment_type
integer
Default: 1
Enum: 1 2

Тип ежемесячных платежей
1 - Аннуитетные
2 - Дифференцированные

Responses

Request samples

Content type
application/json
{
  • "calc_type": 1,
  • "credit_sum": 1000000,
  • "period": 3,
  • "period_type": "Y",
  • "percent": 5,
  • "monthly_payment": 30000,
  • "payment_type": 1
}

Response samples

Content type
application/json
{
  • "monthly_payment": 0,
  • "last_monthly_payment": 0,
  • "term": {
    },
  • "max_amount": 0,
  • "interest": 0,
  • "total_paid": 0,
  • "schedule": [
    ]
}

Калькулятор автокредита

Authorizations:
(clientkey)
Request Body schema: application/json
required
cost
number

Стоимость автомобиля

start_sum_type
integer
Enum: 1 2

Тип первоначального взноса
1 - в валюте
2 - в процентах от стоимости

start_sum
number

Размер первоначального взноса. Сумма или процент от стоимости в зависимости от start_sum_type

period
number

Срок кредита

period_type
string
Enum: "Y" "M"

Единица срока

percent
number

Процентная ставка (годовых)

payment_type
integer
Default: 1
Enum: 1 2

Тип ежемесячных платежей
1 - Аннуитетные
2 - Дифференцированные

Responses

Request samples

Content type
application/json
{
  • "cost": 3000000,
  • "start_sum_type": 1,
  • "start_sum": 3000000,
  • "period": 3,
  • "period_type": "Y",
  • "percent": 5,
  • "payment_type": 1
}

Response samples

Content type
application/json
{
  • "loan_amount": 0,
  • "monthly_payment": 0,
  • "interest": 0,
  • "total_paid": 0,
  • "schedule": [
    ]
}

Генератор промокодов

Authorizations:
(clientkey)
Request Body schema: application/json
required
type
integer
Default: 1
Enum: 1 2

1 - Указать длину
2 - Указать шаблон

length
integer

Длина промокода. Только для type=1.

prefix
string

Префикс (набор постоянных символов вначале промокода). Только для type=1.

pattern
string

Шаблон (Символы решетки (#) заменятся на случайные символы. Например: ####-####). Только для type=2.

use_digits
integer
Default: 1
Enum: 0 1

Использовать цифры

use_uppercase_letters
integer
Default: 1
Enum: 0 1

Использовать заглавные буквы

use_lowercase_letters
integer
Default: 0
Enum: 0 1

Использовать строчные буквы

exclude
integer
Default: 0
Enum: 0 1

Исключить похожие символы (0, O, I, l)

Responses

Request samples

Content type
application/json
{
  • "type": 1,
  • "length": 8,
  • "prefix": "",
  • "pattern": "",
  • "use_digits": 1,
  • "use_uppercase_letters": 1,
  • "use_lowercase_letters": 0,
  • "exclude": 0
}

Response samples

Content type
application/json
{
  • "code": "string"
}

Калькулятор дней отпуска

Authorizations:
(clientkey)
Request Body schema: application/json
required
start_date
string

Дата приёма на работу (гггг-мм-дд)

end_date
string

Расчетная дата (гггг-мм-дд)

Array of objects

Периоды, не включаемые в отпускной стаж

days
integer

Продолжительность ежегодного оплачиваемого отпуска

used_days
integer

Использованные дни отпуска за весь период работы

daily_salary
number

Средний дневной заработок (для расчета компенсации)

Responses

Request samples

Content type
application/json
{
  • "start_date": "string",
  • "end_date": "string",
  • "exclude_periods": [
    ],
  • "days": 0,
  • "used_days": 0,
  • "daily_salary": 0
}

Response samples

Content type
application/json
{
  • "work_period": {
    },
  • "work_period_text": "string",
  • "record": {
    },
  • "record_text": "string",
  • "total_vac_days": 0,
  • "vac_days": 0,
  • "compensation": 0
}

Калькулятор отпускных

Authorizations:
(clientkey)
Request Body schema: application/json
required
vac_start
string

Дата начала отпуска (гггг-мм-дд)

vac_end
string

Дата конца отпуска (гггг-мм-дд)

work_start
string

Начало расчетного периода (гггг-мм-дд)

work_end
string

Конец расчетного периода (гггг-мм-дд)

salary_type
integer
Enum: 1 2 3

Тип указания выплат
1 - Указать среднемесячную зарплату
2 - Указать за каждый месяц расчетного периода отдельно
3 - Указать сумму всех выплат за расчетный период

salary
number

Только для salary_type=1. Среднемесячная з/п за отчетный период.

s_n
number

Только для salary_type=2.
З/п за месяц n, где n - номер месяца в отчетном периоде.
Количество параметров = кол-ву месяцев в отчетном периоде, максимум 12. Например s_1, s_2, s_3...s_12

salary_total
number

Только для salary_type=3. Общая сумма выплат за расчетный период.

Array of objects

Исключаемые периоды в расчетном периоде: отпуска, больничные, командировки

Responses

Request samples

Content type
application/json
{
  • "vac_start": "2025-07-14",
  • "vac_end": "2025-07-21",
  • "work_start": "2024-07-01",
  • "work_end": "2025-06-30",
  • "salary_type": 1,
  • "salary": 0,
  • "s_n": 0,
  • "salary_total": 0,
  • "exclude_periods": [
    ]
}

Response samples

Content type
application/json
{
  • "worked_days": 0,
  • "avg_daily_income": 0,
  • "vac_pay": 0,
  • "detailed": [
    ]
}

Калькулятор стажа

Authorizations:
(clientkey)
Request Body schema: application/json
required
y
integer
Default: 0

Количество лет первоначального стажа

m
integer
Default: 0

Количество месяцев первоначального стажа

d
integer
Default: 0

Количество дней первоначального стажа

Array of objects

Периоды

Responses

Request samples

Content type
application/json
{
  • "y": 0,
  • "m": 0,
  • "d": 0,
  • "periods": [
    ]
}

Response samples

Content type
application/json
{
  • "record": {
    },
  • "periods": [
    ]
}