SocialSecurityTax

Social security and payroll tax configuration. Defines employer and employee contribution rates, wage bases, and caps.

6 properties

Schema

Properties

Property	Type	Mode	Description	Required
tax	Tax	stored	Reference to the base Tax entity	Required
socialSecurityType	string	enum	Type of social security contribution Values: `old_age_pension, disability_insurance, health_insurance, unemployment_insurance, workers_compensation, family_benefits, training_contribution, general` Example: `"old_age_pension"`	Required
employerRate	number	stored	Employer contribution rate as percentage Example: `6.2`	Required
employeeRate	number	stored	Employee contribution rate as percentage Example: `6.2`	Required
annualWageBase	MonetaryAmount	stored	Maximum annual wages subject to this tax (cap)	Optional
taxCapPerEmployee	MonetaryAmount	computed	Maximum tax amount per employee (computed from annualWageBase * rate)	Optional

Examples

Example 1

{
  "@type": "SocialSecurityTax",
  "tax": {
    "@type": "Tax",
    "code": "US-SOCIAL-SECURITY"
  },
  "socialSecurityType": "old_age_pension",
  "employerRate": 6.2,
  "employeeRate": 6.2,
  "annualWageBase": {
    "value": 160200,
    "currency": "USD"
  }
}

Example 2

{
  "@type": "SocialSecurityTax",
  "tax": {
    "@type": "Tax",
    "code": "FR-URSSAF-HEALTH"
  },
  "socialSecurityType": "health_insurance",
  "employerRate": 13,
  "employeeRate": 0,
  "annualWageBase": {
    "value": 999999,
    "currency": "EUR"
  }
}

Example 3

{
  "@type": "SocialSecurityTax",
  "tax": {
    "@type": "Tax",
    "code": "DZ-CNAS"
  },
  "socialSecurityType": "general",
  "employerRate": 26,
  "employeeRate": 9
}