Ant Social Security Guangzhou Calculator

Problem It Solves

When estimating payroll in Guangzhou, a single social security base still leads to several moving parts: pension, medical including maternity, unemployment, work injury, and housing fund contributions must be split into employer and employee amounts, while each item has its own contribution band and default ratio. This skill turns that check into one calculation.

How It Works

The skill centers on scripts/calc_gz_social_security.py:
- Required base: social security contribution base, for example 10000
- Optional housing fund ratio: defaults to 8%, range 5%-12%
- Optional work injury ratio: defaults to 0.4%, range 0.2%-1.4%
It applies the built-in 2025-2026 Guangzhou rates, separates employer and employee payments, prints a terminal summary, emits JSON between ---JSON_START--- markers, and saves a detail image to /tmp/gz_social_security_{base}.png. If the input base falls below or exceeds an item’s allowed range, the script clamps it for that item and marks the adjustment.

Boundaries And Caveats

• The built-in rates cover the 2025-2026 period for Guangzhou and may need updates when policy changes
• Work injury defaults to the second industry tier at 0.4%; actual industry tiers can differ
• Housing fund defaults to 8%, within an employer-defined range
• Final amounts remain subject to verification by the local social security bureau and housing fund center
• Image generation depends on Pillow, which may be installed on first run