Ant Hebei Social Insurance Calculator

What It Solves

Employer and employee social insurance estimates in Hebei often require manually splitting a monthly contribution base into insurance items, applying personal and employer rates, and handling base limits or industry-specific injury rates. This skill automates that repeated calculation: given a monthly social insurance base, it calculates pension, medical (including maternity), unemployment, and work-injury contributions for enterprise employees in Hebei under the July 2026 to June 2027 reference period, and renders a Chinese PNG infographic.

How It Works

The core entrypoint is scripts/generate.py, with --base as the required parameter in CNY per month. Optional flags include --injury-rate, --output, and --logo, used to adjust the employer work-injury rate, set the PNG path, and add a brand logo. The script clamps the base: values below 4,076 CNY/month are calculated as 4,076, values above 20,382 CNY/month are calculated as 20,382, and the image flags the adjustment. It then splits contributions into personal and employer parts: pension 8% / 16%, medical including maternity 2% / ~7.5%, unemployment 0.3% / 0.7%, and work injury 0% / 0.2%–1.9%, with the default employer work-injury rate set to 0.5%. The output includes a terminal summary and a PNG infographic with a base card, two-column line items, monthly total, and footer notes.

Boundaries

This is useful for payroll estimation, HR explainers, and quick social insurance cost comparisons, but it should not be treated as an official payment certificate or a substitute for local government systems. Medical and maternity rates can vary slightly across cities in Hebei, so the skill uses a province-wide midpoint; work-injury rates vary more widely by industry, so pass --injury-rate when the company rate is known. The runtime depends on matplotlib; if it is missing, the script reports an installation error.