Methodology

Last updated: July 2026

1. Purpose of This Document

This page is the primary technical reference for how AKCalc calculators are researched, implemented, tested, and maintained. It is the document that the About page and Editorial Policy refer to when they describe our process. If you want to understand the specific steps behind any result produced by an AKCalc calculator, this is where that explanation lives.

The methodology described here applies to every calculator on the site. Individual calculator pages add the specific source documents, authority names, and last-verified dates that apply to that particular tool.

2. The Five-Step Research Protocol

Every calculator is built through the same five steps, in the same order, without exception. The steps cannot be resequenced or skipped. A calculator that cannot complete all five steps is not published.

Step 1 — Authority Identification

Before any source document is opened, we identify the regulatory authority legally responsible for the rule being calculated. This is not the same as finding a website that explains the rule — it is identifying the government body that created, administers, and publishes the rule.

For each jurisdiction, this authority is:

• United States (federal): Internal Revenue Service (IRS) for income tax and payroll; Department of Labor for wage and hour rules
• United States (state): The relevant state tax authority (e.g., California Franchise Tax Board, New York State Department of Taxation and Finance, Texas Comptroller of Public Accounts)
• Germany: Bundesministerium der Finanzen (BMF) for income tax and withholding; Deutsche Rentenversicherung and GKV-Spitzenverband for social insurance contributions
• Romania: Agenția Națională de Administrare Fiscală (ANAF) and the Romanian Parliament (via the Codul Fiscal)
• Poland: Ministerstwo Finansów and Zakład Ubezpieczeń Społecznych (ZUS)
• Gulf states: The Ministry of Human Resources (or equivalent) of each country, which administers the Labour Law containing the gratuity calculation rules
• All other countries: The equivalent national tax administration, ministry of finance, or relevant legislative body is identified before any source is opened

Identifying the authority is Step 1 because every subsequent step depends on it. If the authority cannot be identified with certainty, the calculator is not built.

Step 2 — Primary Source Location

Once the authority is identified, we locate the specific document that contains the applicable formula, rate schedule, or entitlement rule. This document must be published directly by the authority identified in Step 1. Acceptable primary sources include:

• Official IRS publications (e.g., Publication 15-T, Publication 519, Publication 54)
• Official state tax authority withholding instructions and rate schedules
• Official BMF publications, including the Programmablaufplan (PAP) for Lohnsteuer
• The Romanian Codul Fiscal as published in the Monitorul Oficial
• ZUS official rate tables and the Polish Personal Income Tax Act (Ustawa PIT)
• The specific Labour Law articles of each Gulf state governing end-of-service gratuity
• Official legislative texts, ministerial decrees, and gazette publications from the authority for any other jurisdiction

The following do not qualify as primary sources for implementing a formula:

• Third-party financial websites, even well-known ones
• Accounting firm or law firm summary articles
• News articles reporting on tax changes
• Other calculator tools or payslip examples from non-official sources
• AI-generated content or AI summaries of tax rules

These non-primary sources may help identify which document to look for, but the formula is always taken from the official original. The specific document, its publication date, and the relevant section or table reference are recorded before any code is written.

Step 3 — Formula Implementation

The calculation logic is implemented directly from the primary source document identified in Step 2. This means translating the official formula, rate table, bracket structure, or entitlement schedule into working calculator logic — not interpreting or adapting it based on other sources.

During implementation:

• Rate brackets, thresholds, and contribution ceilings are entered from the official table, not from memory or a secondary source
• The order of operations specified in the official formula is preserved exactly
• Where the official source provides multiple calculation methods (e.g., annualised vs. period-based withholding), the method is documented and the calculator's approach is stated on the page
• Edge cases identified in the official source (e.g., special rates for specific income types, modified rules for part-year periods) are implemented if they fall within the calculator's stated scope, or explicitly excluded with a note in the scope statement

Step 4 — Output Testing and Validation

This is the step that separates a correctly implemented calculator from one that is merely plausible. Before any calculator is published, its output is verified against at least one independent reference scenario. The reference scenario must produce a known, verifiable result. Acceptable reference scenarios include:

• Official worked examples: Many government publications (IRS Publication 15, BMF withholding tables, ANAF guidance documents) include specific numeric examples. The calculator is run against these inputs and the output is compared to the official result.
• Official withholding worksheets: Government-published worksheets that show the calculation step by step. The calculator's intermediate outputs are checked against each step, not just the final number.
• Publicly verified payslip cases: For some calculators (particularly gross-to-net salary calculators), real payslip breakdowns shared publicly in finance forums or verified by user reports provide a reference. These are used only when an official example is not available, and the source of the payslip case is documented.

If the calculator output does not match the reference scenario, it is not published. The discrepancy is diagnosed, the formula implementation is reviewed against the primary source, and the error is corrected. This cycle repeats until the output matches the official reference. There is no exception to this rule.

Where the official source does not provide a numeric example and no publicly verified reference is available, the calculator is either (a) not published, or (b) published with a clear scope statement noting that external validation against an official example was not possible, and why.

Step 5 — Source Citation and Last-Verified Dating

Before the calculator is published, the following information is added to the page:

• The full name of the primary source document
• The issuing authority (agency or legislative body)
• The publication date or tax year to which the document applies
• A last-verified date (explained in Section 4 below)
• A direct link to the official source document where publicly accessible

This information is displayed on the calculator page in a clearly labelled source block, not buried in a footer or hidden from the user.

3. The Scope Statement Standard

Every calculator page includes a scope statement — a clear description of what the calculator covers and what it explicitly does not cover. This is not a disclaimer; it is a precision statement.

The scope statement answers:

• Which income types, filing statuses, or employment scenarios are included in the calculation
• Which scenarios are excluded and why (e.g., self-employment income, non-resident rules, church tax, regional surcharges)
• Whether the calculator uses annualised or period-based calculation where both are possible
• Any simplifying assumptions that are baked into the formula

A user who reads the scope statement should be able to determine, without running the calculator, whether it applies to their specific situation. If it does not apply, they should understand why — not be left to discover a wrong result after the fact.

4. The Last-Verified Date System

Every calculator page displays a last-verified date. This date has a specific, defined meaning:

"The last-verified date is the date on which the calculator's source document was most recently checked by a human reviewer to confirm that the rates, thresholds, formulas, and entitlement rules implemented in the calculator match the currently effective official publication."

It is not the date the page was last edited, the date explanatory text was updated, or the date a minor cosmetic change was made. It reflects only confirmed checks against the official regulatory source.

The last-verified date is updated when:

• A scheduled annual review is completed and the rates are confirmed unchanged
• A regulatory change is detected, the calculator is updated to reflect the new rules, and the update is verified against the new official source
• A user-reported discrepancy is investigated, resolved, and the correction is confirmed against the official source

If you find a last-verified date that appears significantly outdated relative to a known regulatory change in a covered jurisdiction, please report it via the Contact page. We will verify and update the calculator or provide an explanation of its current status.

5. What Triggers an Update

A calculator is reviewed and potentially updated when any of the following occurs:

• Scheduled annual review. At the start of each tax year, calculators covering jurisdictions with annual rate changes (income tax brackets, social insurance ceilings, contribution rates) are checked against the newly published official tables. If rates have changed, the calculator is updated before the new tax year begins. If rates are unchanged, the last-verified date is updated to reflect the completed check.
• Mid-year regulatory change. Legislative amendments, emergency budget measures, ministerial decrees, or court-ordered changes that affect a covered calculation trigger an immediate review. The calculator is updated against the new official source as soon as the change is confirmed in a primary publication.
• User-reported discrepancy. When a user reports that a calculator result does not match their official payslip, tax authority notice, or employment contract, the report is reviewed within 48 hours. If the discrepancy is confirmed against the official source, the calculator is corrected and republished immediately.
• Internal audit. Periodic internal checks of published calculators against their source documents may identify errors or outdated rates. Any confirmed discrepancy triggers an immediate update.

What does not trigger an update: media reporting about a tax change, unofficial industry commentary, or user opinion unsupported by a primary source reference. Updates are made only on confirmed official publication.

6. How to Read a Calculator Page

Every calculator page is structured to make the methodology transparent at a glance. Here is what each element means:

• Scope statement (near the top of the page): tells you exactly what the calculator covers and what it excludes. Read this first before entering any inputs.
• The calculator itself: implements the official formula for the stated scope. The output is an estimate, not an official determination.
• How this calculator works (below the calculator): explains the formula logic in plain language, including any key assumptions or simplifications.
• Source block: shows the specific document used (name, issuing authority, publication date), the last-verified date, and a link to the official source where available. This is the evidence chain for the result.
• Disclaimer: states that the result is an informational estimate and is not a substitute for a determination by a licensed professional or official authority. This is required for every YMYL (financial) page and is always displayed.
• "Found an error?" link: provides a direct route to report a discrepancy. Every calculator page includes this.

7. Inherent Limitations of Calculator Results

Even a correctly implemented calculator will not produce the right result for every individual situation. This is not a flaw in the methodology — it is a consequence of how tax law works. Calculators model the general case; individual outcomes depend on specific facts. Common reasons a result may differ from your actual situation:

• Individual exemptions and deductions. Most payroll calculators model standard or no exemptions. If you claim specific deductions, allowances, or credits not reflected in the standard formula, your result will differ.
• Employer-specific elections. Some rules allow employers to choose from multiple withholding methods. The calculator implements one method, stated in the scope. Your employer may use another.
• Regional and municipal variation. In some jurisdictions (notably US state and local taxes, and some German Kirchensteuer calculations), sub-national variation exists that the general calculator does not model.
• Changed rates after the last-verified date. If regulations changed after the last-verified date shown on the page, results may reflect outdated rates. Check the last-verified date for each calculator and contact us if you believe it is outdated.
• Combined or unusual income situations. A calculator designed for a standard employment scenario will not produce an accurate result for someone with multiple employers, mid-year salary changes, equity compensation, or other non-standard inputs unless the scope statement explicitly includes them.

The scope statement on each calculator page identifies which of these limitations apply to that specific tool.