Skip to main content
PUT
/
organizations
/
{organization_id}
/
employees
/
{employee_id}
/
tax-details
Update Employee Tax Details
curl --request PUT \
  --url https://dev.intermezzo.ai/organizations/{organization_id}/employees/{employee_id}/tax-details \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "taxId": "<string>",
  "taxClass": "1"
}
'
{
  "employeeId": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "id": "<string>",
  "taxId": "<string>",
  "taxClass": "1",
  "employmentCountry": "DE",
  "childAllowances": "0.0",
  "churchConfession": "AK",
  "churchConfessionPartner": "AK",
  "factorProcedure": false,
  "factor": 123,
  "taxAllowanceAmount": "0.00",
  "additionalTaxableAmount": "0.00",
  "validFrom": "2023-12-25",
  "validTo": "2023-12-25",
  "churchMember": false,
  "churchTaxState": "Baden-Württemberg"
}

Authorizations

​
Authorization
string
header
required

Get token from Auth0 and paste it here

Path Parameters

​
organization_id
required
​
employee_id
required

Body

application/json

German-specific tax data with comprehensive validation aligned with ELSTAM API

​
taxId
string
required

Steuerliche Identifikationsnummer (11 digits) - ELSTAM: steuerid

Required string length: 11
​
taxClass
enum<string>
required

Steuerklasse (1-6) - ELSTAM: steuerklasse

Available options:
1,
2,
3,
4,
5,
6
​
employmentCountry
string
default:DE
Allowed value: "DE"
​
childAllowances
default:0.0

Kinderfreibeträge - ELSTAM: kinderfreibetrag

Required range: 0 <= x <= 9Must be a multiple of 0.5
​
churchConfession
enum<string> | null

Konfession für Kirchensteuer - ELSTAM: kirchensteuer

Available options:
AK,
EV,
FA,
FB,
FG,
FM,
FR,
FS,
IB,
IH,
IL,
IS,
IW,
JD,
JH,
LT,
RF,
RK,
NA,
KEINE
​
churchConfessionPartner
enum<string> | null

Konfession des Partners - ELSTAM: kirchensteuer_partner

Available options:
AK,
EV,
FA,
FB,
FG,
FM,
FR,
FS,
IB,
IH,
IL,
IS,
IW,
JD,
JH,
LT,
RF,
RK,
NA,
KEINE
​
factorProcedure
boolean
default:false

Faktorverfahren

​
factor
integer | null

Factor Percent as Integer (0-999)

Required range: 0 <= x <= 999
​
taxAllowanceAmount

Steuerfreibetrag - ELSTAM: freibetrag monat

Required range: x >= 0
​
additionalTaxableAmount

Hinzurechnungsbetrag - ELSTAM: hinzurechnungsbetrag monat

Required range: x >= 0
​
validFrom
string<date> | null

Gültig ab Datum - ELSTAM: gueltig_ab

​
validTo
string<date> | null

EN: Valid to date | DE: Gültig bis Datum

​
churchMember
boolean
default:false

Kirchensteuerpflichtig

​
churchTaxState
enum<string> | null

Bundesland for church tax

Available options:
Baden-Württemberg,
Bayern,
Berlin,
Brandenburg,
Bremen,
Hamburg,
Hessen,
Mecklenburg-Vorpommern,
Niedersachsen,
Nordrhein-Westfalen,
Rheinland-Pfalz,
Saarland,
Sachsen,
Sachsen-Anhalt,
Schleswig-Holstein,
Thüringen

Response

Successful Response

Response model for tax details with metadata fields.

​
employeeId
string
required
​
createdAt
string<date-time>
required
​
updatedAt
string<date-time>
required
​
id
required
​
taxId
string
required
Required string length: 11
​
taxClass
enum<string>
required

Steuerklasse (STKL)

Available options:
1,
2,
3,
4,
5,
6
​
employmentCountry
string
default:DE
Allowed value: "DE"
​
childAllowances
string
default:0.0
Pattern: ^(?!^[-+.]*$)[+-]?0*(?:\d{0,1}|(?=[\d.]{1,3}0*$)\d{0,1}\.\d{0,1}0*$)
​
churchConfession
enum<string> | null

German church tax confessions as defined in ELSTAM API

Available options:
AK,
EV,
FA,
FB,
FG,
FM,
FR,
FS,
IB,
IH,
IL,
IS,
IW,
JD,
JH,
LT,
RF,
RK,
NA,
KEINE
​
churchConfessionPartner
enum<string> | null

Konfession des Partners - ELSTAM: kirchensteuer_partner

Available options:
AK,
EV,
FA,
FB,
FG,
FM,
FR,
FS,
IB,
IH,
IL,
IS,
IW,
JD,
JH,
LT,
RF,
RK,
NA,
KEINE
​
factorProcedure
boolean
default:false
​
factor
integer | null
​
taxAllowanceAmount
string | null
default:0.00
Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
​
additionalTaxableAmount
string | null
default:0.00
Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
​
validFrom
string<date> | null

Gültig ab Datum - ELSTAM: gueltig_ab

​
validTo
string<date> | null

EN: Valid to date | DE: Gültig bis Datum

​
churchMember
boolean
default:false
​
churchTaxState
enum<string> | null

German states (Bundesländer) with their official names

Available options:
Baden-Württemberg,
Bayern,
Berlin,
Brandenburg,
Bremen,
Hamburg,
Hessen,
Mecklenburg-Vorpommern,
Niedersachsen,
Nordrhein-Westfalen,
Rheinland-Pfalz,
Saarland,
Sachsen,
Sachsen-Anhalt,
Schleswig-Holstein,
Thüringen