Skip to main content
POST
Create Wage Type

Authorizations

Authorization
string
header
required

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

Body

application/json

Request schema for creating a German wage type

wage_type_number
integer
required

The business key of the wage type

Example:

1000

name
string
required

The name of the wage type

Required string length: 1 - 255
Example:

"Basic Salary"

is_total_gross_component
boolean
default:true

Component of the total gross (Gesamtbrutto)

component_type
enum<string>
default:gross_earning

The component type of the wage, defining its place in the calculation flow

Available options:
gross_earning,
gross_deduction,
net_earning,
net_deduction
tax_treatment
enum<string>
default:recurring_wage

The tax treatment for this wage type

Available options:
recurring_wage,
one_time_payment,
flat_rate_tax,
tax_free
tax_certificate_line_item
string | null

Points to a line item in the annual tax certificate (Lohnsteuerbescheinigung)

Maximum string length: 100
social_security_treatment
enum<string>
default:recurring_wage

The social security treatment for this wage type

Available options:
recurring_wage,
one_time_payment,
social_security_free
is_sv_relevant_component
boolean
default:true

Component of Arbeitsentgelt according to §14 SGB IV

is_reimbursable_aag
boolean
default:false

Reimbursable under the Aufwendungsausgleichsgesetz (U1 / U2 coverage)

is_accident_insurance_relevant
boolean
default:true

Relevant for accident insurance (Unfallversicherung)

is_gl_component
boolean
default:false

Component of the base wage (Grundlohn) used for calculating surcharges

is_average_earnings_component
boolean
default:true

Component of the average earnings used for continued remuneration

garnishment_treatment
enum<string>
default:full

The garnishment treatment (Pfändbarkeit)

Available options:
full,
non_garnishable,
partial
is_minimum_wage_component
boolean
default:true

Component of the statutory minimum wage (Mindestlohn)

Response

Successful Response

Response schema for German wage type

id
integer
required

Database ID

wage_type_number
integer
required

The business key of the wage type

name
string
required

The name of the wage type

is_total_gross_component
boolean
required

Component of the total gross (Gesamtbrutto)

component_type
enum<string>
required

The component type

Available options:
gross_earning,
gross_deduction,
net_earning,
net_deduction
tax_treatment
enum<string>
required

The tax treatment

Available options:
recurring_wage,
one_time_payment,
flat_rate_tax,
tax_free
tax_certificate_line_item
string | null
required

Tax certificate line item

social_security_treatment
enum<string>
required

The social security treatment

Available options:
recurring_wage,
one_time_payment,
social_security_free
is_sv_relevant_component
boolean
required

Component of Arbeitsentgelt

is_reimbursable_aag
boolean
required

Reimbursable under AAG

is_accident_insurance_relevant
boolean
required

Relevant for accident insurance

is_gl_component
boolean
required

Component of base wage

is_average_earnings_component
boolean
required

Component of average earnings

garnishment_treatment
enum<string>
required

Garnishment treatment

Available options:
full,
non_garnishable,
partial
is_minimum_wage_component
boolean
required

Component of minimum wage

valid_from
string<date> | null
valid_to
string<date> | null