Skip to main content
PUT
Update Employee Tax Details

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

organization_id
required
employee_id
required

Body

application/json

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

tax_id
string
required

Steuerliche Identifikationsnummer (11 digits) - ELSTAM: steuerid

Required string length: 11
tax_class
enum<string>
required

Steuerklasse (1-6) - ELSTAM: steuerklasse

Available options:
1,
2,
3,
4,
5,
6
employment_country
string
default:DE
Allowed value: "DE"
child_allowances
default:0.0

Kinderfreibeträge - ELSTAM: kinderfreibetrag

Required range: 0 <= x <= 9Must be a multiple of 0.5
church_confession
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
church_confession_partner
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
factor_procedure
boolean
default:false

Faktorverfahren

factor
integer | null

Factor Percent as Integer (0-999)

Required range: 0 <= x <= 999
tax_allowance_amount

Steuerfreibetrag - ELSTAM: freibetrag monat

Required range: x >= 0
additional_taxable_amount

Hinzurechnungsbetrag - ELSTAM: hinzurechnungsbetrag monat

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

Gültig ab Datum - ELSTAM: gueltig_ab

valid_to
string<date> | null

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

church_member
boolean
default:false

Kirchensteuerpflichtig

church_tax_state
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.

employee_id
string
required
created_at
string<date-time>
required
updated_at
string<date-time>
required
id
required
tax_id
string
required
Required string length: 11
tax_class
enum<string>
required

Steuerklasse (STKL)

Available options:
1,
2,
3,
4,
5,
6
employment_country
string
default:DE
Allowed value: "DE"
child_allowances
string
default:0.0
Pattern: ^(?!^[-+.]*$)[+-]?0*(?:\d{0,1}|(?=[\d.]{1,3}0*$)\d{0,1}\.\d{0,1}0*$)
church_confession
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
church_confession_partner
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
factor_procedure
boolean
default:false
factor
integer | null
tax_allowance_amount
string | null
default:0.00
Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
additional_taxable_amount
string | null
default:0.00
Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
valid_from
string<date> | null

Gültig ab Datum - ELSTAM: gueltig_ab

valid_to
string<date> | null

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

church_member
boolean
default:false
church_tax_state
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