What It Does

When a non-citizen employee ceases employment in Singapore, the employer must seek tax clearance on Form IR21 — at least one month before cessation — and withhold monies due until clearance is granted. This module builds the IR21 form data inside Odoo: it validates the employee's FIN against the official ICA weighted-checksum algorithm, captures the employee particulars, the employment record and the income for the cessation year and the preceding year (salary, bonus, director's fee, allowances, gratuity, compensation for loss of office, gains from share options and more), computes the amount to withhold, and exports a structured IR21 XML document and CSV income register for lodgement through the employer's own IRAS myTax Portal access.

Key Features

• FIN / NRIC validation against the official ICA weighted-checksum algorithm (S / T / F / G / M series), catching bad foreign identifiers before filing.
• Form IR21 record covering Section A (employee particulars), Section B (employment dates and reason for cessation), Section C (income for the cessation year and the preceding year) and Section D (monies withheld).
• One-month notice check that flags filings whose cessation date is too close to lodge in time, with a daily reminder.
• Withholding defaulted to the monies due to the leaver, per the section 68 withholding rule.
• XML & CSV export of the IR21 data for upload through the employer's own IRAS access (BYOK — no credentials stored).
• Prepare wizard that spins up a filing for a departing foreigner and seeds the standard income components.
• Pure-Python form engine, fully unit tested.

Built for Singapore

The IRAS myTax Portal URL and the statutory notice period are editable company settings. Tax clearance is submitted under the employer's own IRAS credentials — this app stores no keys and performs no network calls. Confirm the current IR21 requirements against official IRAS guidance before lodging live clearances.