Калькулятор растаможки на сайте: как считать чужие деньги и не соврать

Калькулятор на сайте выглядит простой задачей ровно до того момента, когда начинаешь искать, откуда брать цифры. Дальше выясняется, что половина проекта — это не код, а вопрос «я вообще имею право показывать это число».

Что было до

Компания занимается доставкой грузов и подбором автомобилей из Китая и Японии. Направления разные по устройству: по Китаю это склады, осмотр до оплаты и выкуп, по Японии — аукционы, инвойс и бронь места на корабле.

Клиент почти всегда начинает с одного и того же: «а сколько по деньгам выйдет с растаможкой». Менеджер открывал таблицу и считал руками. На это уходило время, ответы у разных менеджеров расходились, а часть людей уходила, не дождавшись.

Задача звучала как «сделайте сайт», но настоящая задача была другая — снять с менеджера повторяющийся расчёт и дать человеку возможность получить порядок цифры самому, ночью, без переписки.

Что сделал

Одностраничный сайт: ни сборки, ни бэкенда, ни внешних CDN. Открывается как есть, правится в одном файле. Для сайта, который будет жить годами и обновляться нечасто, это надёжнее любого фреймворка — через два года не окажется, что проект не собирается из-за устаревших зависимостей.

Калькулятор считает пять составляющих платежа:

Плюс НДС и подстановка курса ЦБ, потому что цена приходит в валюте, а платить придётся в рублях.

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

Две ставки, которые я отказался угадывать

При сборке выяснилось, что две позиции в открытых источниках не раскрыты однозначно. Вариантов было три.

Поставить наиболее вероятное значение и промолчать. Самый распространённый путь, и самый плохой: клиент увидит уверенное число, заложит его в расчёт сделки и узнает правду на таможне.

Убрать эти позиции из калькулятора. Тогда итог занижается, а это ещё хуже: заниженная оценка выглядит привлекательной ровно до оплаты.

Показать значение и рядом сказать, что оно требует подтверждения. Выбрал это. В результате расчёта стоит предупреждение: такие-то позиции предварительные, точную цифру подтверждает брокер. В сопроводительном документе обе строки отмечены отдельно — чтобы тот, кто будет обновлять ставки, не принял их за проверенные.

Калькулятор от этого стал менее «продающим» и более полезным. Человек получает порядок величины и понимает, где граница точности, а компания не получает конфликт на этапе оплаты.

Почему расчёт покрыт тестами

Движок расчёта — чистые функции: на входе параметры, на выходе число. К ним написаны тесты, которых сейчас десять и все проходят. Проверяют они не «работает ли вообще», а границы, где обычно и ломается:

Границы диапазонов. Возраст «более трёх, но не более пяти лет» — включается ли ровно пять. Классическое место ошибки на единицу, которая меняет ставку в полтора раза.

Электромобиль. Для него часть ставок не применяется — расчёт помечается неполным, а не выдаёт ноль, будто платить нечего.

Переход между ступенями мощности. Там, где утилизационный сбор скачком меняется.

Тесты здесь нужны не ради галочки. Ставки будут обновлять раз в год люди, не писавшие этот код. Тесты — единственное, что не даст тихо сломать расчёт правкой одной цифры.

Что из этого стоит забрать себе

Калькулятор — это не виджет, а обязательство. Показав число, вы взяли на себя ответственность за него. Поэтому решать надо сначала вопрос источников, а уже потом вопрос вёрстки.

Данные отдельно от логики. Ставки, курсы, тарифы в одном файле, расчёт в другом. Обновление данных не должно требовать программиста, иначе через год калькулятор будет врать просто потому, что его некому обновить.

Неизвестное лучше назвать неизвестным. Пользователь прощает «здесь мы не уверены». Он не прощает уверенное число, которое не сошлось.

Похожий разбор про честность цифр в интерфейсе — в кейсе витрины авто из Китая.

Частые вопросы

Сколько стоит такой калькулятор на сайт?

Зависит не от количества полей, а от того, есть ли у вас готовая и проверенная база ставок. Если она есть — это несколько дней. Если её надо собирать из первоисточников и сверять — основная работа именно там.

Можно ли подтягивать ставки автоматически?

Курс валюты — да, он публикуется машиночитаемо. Таможенные ставки — нет: они живут в текстах нормативных актов, машиночитаемого канала под них нет, и их обновляют руками с проверкой.

Почему статика, а не CMS?

Потому что страниц одна, правок в год немного, а надёжность важнее удобства редактирования. Статику нельзя взломать через админку, она не требует обновлений безопасности и открывается быстро на плохой связи — а клиенты часто смотрят сайт с телефона в дороге.

Что делать, если ставки изменились?

Открыть файл со ставками, поправить число, прогнать тесты. Логику расчёта трогать не нужно — она от значений не зависит.

Кто отвечает, если расчёт разошёлся с реальностью?

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

Коротко о главном

Сайт с калькулятором снял с менеджера повторяющийся расчёт и дал клиенту возможность получить порядок цифры самому. Но ценность здесь не в форме на странице, а в том, что за каждым числом стоит источник, а за каждой неуверенностью — честная пометка.

Если вам нужен расчёт на сайте — цена, смета, платёж, доставка — начните не с вёрстки, а с вопроса: откуда возьмётся каждое число и кто будет его обновлять через год. Опишите задачу, и я посчитаю объём вместе с этой частью, а не вместо неё. Напишите в Telegram, MAX или VK.