> ## Documentation Index > Fetch the complete documentation index at: https://docs.stampfactory.eu/llms.txt > Use this file to discover all available pages before exploring further. # Lohndaten abrufen ## OpenAPI ````yaml GET /employees/{employee}/payroll openapi: 3.1.0 info: title: Stampfactory API version: 1.0.0 description: >- REST API für die Stampfactory Zeiterfassungs- und Personalverwaltungsplattform. ## Basis-URL Jeder Mandant hat eine eigene Subdomain: `https://{tenant}.stamp.eu/rest/…`. Custom Domains werden unterstützt; der Pfad-Präfix ist immer `/rest`. Authentifizierung über `POST /rest/login` (Bearer-Token, Laravel Sanctum). ## Datenformate (verbindlich, ADR 0005) | Typ | Format | Beispiel | |---|---|---| | Dauer (Anzeige) | String `HH:MM:SS.mmm`, Feldname ohne Suffix | `"08:00:00.000"` | | Dauer (Rohwert) | Integer Millisekunden, Feldname mit Suffix `_ms` | `28800000` | | Datum | ISO 8601 (`YYYY-MM-DD`) | `"2026-07-25"` | | Fachliche Zeitstempel (Stempelungen, Korrekturen) | ISO 8601 in Mandanten-Zeitzone | `"2026-07-25T08:00:00+02:00"` | | Technische Metadaten (`created_at`, `updated_at`) | ISO 8601 UTC | `"2026-07-25T06:00:00+00:00"` | | IDs | UUID bzw. TypeID-String | `"9d3f…"` | | Arbeitszeit-Flags | Integer-Bitmaske (`flags`), Bits siehe `WorkingTimeFlag` | `512` = Feiertag | | Monats-Perioden | `YYYY-MM` | `"2026-07"` | ## Responses Erfolgs-Responses liefern die fachliche Payload unter `data` (dokumentierte Ausnahmen: `POST /rest/terminal/{code}` und `/rest/mobile`). Listen sind, wo paginiert, im Laravel-Paginator-Format (`data` + `links` + `meta`). ## Fehlerformat Alle Fehler (4xx/5xx) folgen einem einheitlichen Envelope: ```json { "request_id": "…", "timestamp": "2026-07-25T06:00:00Z", "message": "Menschlich lesbare Meldung", "field_errors": { "feld": ["Meldung"] }, "errors": [{ "title": "…", "detail": "…", "type": "https://docs.stampfactory.eu/errors#…", "_meta": { } }] } ``` `field_errors` erscheint bei Validierungsfehlern (422). Endpoint-spezifische Zusatzdaten (z. B. `warnings`, `earliest`, `code`) stehen kanonisch in `errors[0]._meta`; Top-Level-Duplikate sind eine Übergangs-Kompatibilitätsschicht. Die `type`-URLs verlinken auf die Fehlerdokumentation. servers: - url: https://{tenant}.stamp.eu/rest description: Production variables: tenant: default: demo description: Subdomain des Mandanten security: - http: [] paths: /employees/{employee}/payroll: get: tags: - Sonstiges operationId: tenant.employees.payroll.show parameters: - name: employee in: path required: true description: The employee ID schema: type: string format: uuid responses: '200': description: '`EmployeePayrollDataResource`' content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/EmployeePayrollDataResource' required: - data '401': $ref: '#/components/responses/AuthenticationException' '404': $ref: '#/components/responses/ModelNotFoundException' components: schemas: EmployeePayrollDataResource: type: object properties: id: type: string employee_id: type: string birth_name: type: string description: Personal name_prefix: type: string name_suffix: type: string title: type: string street: type: string postal_code: type: string city: type: string birth_date: type: string birth_place: type: string nationality: type: string gender: type: string marital_status: type: string tax_id: type: string description: Tax tax_class: type: string tax_factor: type: - number - 'null' religion: type: string spouse_religion: type: string number_of_children: type: string child_tax_allowance: type: - number - 'null' pension_obligation: type: string insurance_type: type: string description: Health insurance health_insurance_name: type: string health_insurance_number: type: string health_insurance_company_number: type: string health_insurance_member_number: type: string pkv_provider: type: string pkv_monthly_premium: type: - number - 'null' pension_insurance_number: type: string description: Pension pension_fund: type: string pension_fund_member_number: type: string social_fund: type: string description: Social fund social_fund_employee_number: type: string outpatient_care: type: string description: Employment lbnr: type: string job_title: type: string profession: type: string education_level: type: string is_shareholder: type: string description: Special is_student: type: string multiple_employment: type: string disability_degree: type: string bank_account_holder: type: string description: Bank iban: type: string bic: type: string stammdaten_confirmed_at: type: string description: eAU Stammdaten-Bestätigung stammdaten_confirmed_by: type: string updated_at: type: string required: - id - employee_id - birth_name - name_prefix - name_suffix - title - street - postal_code - city - birth_date - birth_place - nationality - gender - marital_status - tax_id - tax_class - tax_factor - religion - spouse_religion - number_of_children - child_tax_allowance - pension_obligation - insurance_type - health_insurance_name - health_insurance_number - health_insurance_company_number - health_insurance_member_number - pkv_provider - pkv_monthly_premium - pension_insurance_number - pension_fund - pension_fund_member_number - social_fund - social_fund_employee_number - outpatient_care - lbnr - job_title - profession - education_level - is_shareholder - is_student - multiple_employment - disability_degree - bank_account_holder - iban - bic - stammdaten_confirmed_at - stammdaten_confirmed_by - updated_at title: EmployeePayrollDataResource responses: AuthenticationException: description: Unauthenticated content: application/json: schema: type: object properties: message: type: string description: Error overview. required: - message ModelNotFoundException: description: Not found content: application/json: schema: type: object properties: message: type: string description: Error overview. required: - message securitySchemes: http: type: http description: Bearer-Token, erhalten über den Login-Endpunkt (POST /rest/login). scheme: bearer ````