StubLedger

StubLedger - Automatic tax calculations for the USA and Canada. Generate a beautiful PDF with your logo. No subscriptions, $15 per document.

https://stubledger.com

CRM-система

Проект: StubLedger — движок для расчета зарплаты и налогов с поддержкой юрисдикций США и Канады

StubLedger - это сервис, который позволяет работникам, бухгалтерам, руководителям и фрилансерам быстро формировать точные платежные ведомости (paystubs) с автоматическим расчетом всех налогов.

Пользователь вводит информацию о доходе, месте работы, заполняет данные W‑4 (форма 2020+), указывает количество иждивенцев, дополнительный доход, вычеты, дату найма, тип оплаты (почасовая или оклад), ставку, периодичность выплат и дополнительные заработки. Затем выбирает один из готовых шаблонов paystub, оплачивает через PayPal и получает документ для скачивания в личном кабинете. В кабинете также можно сохранять постоянные данные о рабочих местах и сотрудниках (если пользователь — работодатель).

Проблема

Расчет заработной платы и налогов в США и Канаде - одна из самых сложных областей финансового софта. Федеральные, штатные (провинциальные) и местные налоги имеют разные правила, пороги и ставки, которые ежегодно меняются. Кроме того, на итоговую сумму удержаний влияют индивидуальные параметры: выбор формы W‑4, наличие нескольких мест работы, дополнительные доходы, вычеты и льготы. Непрофессионалу разобраться во всех этих нюансах практически невозможно, а ошибки в расчетах могут привести к штрафам или проблемам с налоговыми органами.

Наше решение: глубокое исследование налоговых систем и архитектура данных чтобы обеспечить юридическую точность расчетов, команда провела систематический анализ налогового законодательства:

США: изучены федеральные налоги (IRS), налоги всех 50 штатов и округа Колумбия, включая штаты без подоходного налога, с плоской шкалой и прогрессивной ставкой, а также местные налоги (например, NYC, Yonkers).
Канада: исследованы федеральные налоги и налоги всех провинций/территорий, а также особенности отчислений CPP (Канадский пенсионный план), EI (страхование занятости) и квебекские QPP/QPIP.

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

Категория	Что входит
Федеральные налоги (США)	Налоговые скобки (Federal Tax Brackets), параметры федерального налога (Federal Tax Parameters), стандартные вычеты
FICA / Social Security & Medicare	Лимиты базы для Social Security, пороги для дополнительного налога Medicare (Additional Medicare Thresholds), справочные ставки Medicare (Medicare Reference)
Штатные налоги (State Taxes)	Прогрессивные и плоские ставки по штатам (State Income Taxes), специальные правила взаимности (reciprocity)
Канадские налоги	Федеральные и провинциальные скобки, ставки CPP/EI, отдельные таблицы для Квебека
Параметры пользователя	W‑4 (2020+): количество иждивенцев (Dependent Total), другой доход (Other Income Amount), сумма вычетов (Deduction Amount), дата найма (для пропорционального расчета), тип и частота выплат

Финансовые расчеты

На основе этих данных мы реализовали сложный конвейер вычислений:

Нормализация дохода - приведение почасовых, дневных и других выплат к годовому эквиваленту с учетом даты найма.
Послойное применение налогов - сначала федеральные, затем штатные/провинциальные, затем местные.
Учет W‑4 (2020+) - расчет удержаний по новой методике IRS, учитывающей наличие нескольких мест работы, кредиты на иждивенцев и дополнительные вычеты.
Валидация - сравнение результатов с официальными примерами IRS и налоговых департаментов штатов

Результаты

Точность: система корректно обрабатывает все 50 штатов США + DC и 13 провинций/территорий Канады, поддерживая как годовой, так и попериодный метод удержания налогов.
Масштабируемость: изменения в налоговом законодательстве вносятся через админ‑панель без перевыпуска кода, что позволяет оперативно реагировать на новые законы.
Удобство: пользователи без бухгалтерского опыта могут за пару минут получить документ, который можно использовать для подтверждения дохода, проверки расчетов работодателя или ведения отчетности.
Бизнес‑ценность: сервис востребован фрилансерами, малым бизнесом и частными лицами, которые хотят быть уверены в правильности налоговых удержаний.