Desktop APIs Payroll

Payroll

3.1.0
API-Reference API-Documentation

Changelog

Changelog

Summary

Version 3.1.0

Version 3.0.0

Version 2.0.3

Version 2.0.2


 

Known Issues

  • Currently, there are no known issues.


 

Version 3.1.0

Summary

Breaking Changes

ResourceDescription
--

Added Features

ResourceDescription
--

Fixes

ResourceDescription
GenerellHinzufügen englischer Übersetzungen für Response-Beschreibung       

Content-Header in GET Endpunkten - Entfernen des nicht verwendeten Attributs "multipart/mixed" Ausnahme: Endpunkt GET /clients       

Entfernen des fehlerhaft angegeben Response-Bodys "Message-container" für Responses mit Statuscode 204 no content
Fehler-ResponsesProcess-message - Entfernen der nicht verwendeten Properties "help_link", "internal_information" und "reason"       

Message-container - Entfernen des nicht verwendeten Properties "error_uri"
DatentypenUmstellung von Datentypen:       
"number(int16)" auf "integer"        
"integer(int16)" auf "integer"        
Entfernung des Formats "int32"
Stapelerfassung PUT (Bewegungsdaten, Mitarbeiterstammdaten und Mitarbeiterstammdaten-Batch)Eine erfolgreiche Verarbeitung liefert Statuscode 200 anstatt 204        

Eine erfolgreiche Verarbeitung gibt im Response Body die Ressource "Batch-Response zurück       

Nicht benötigte Statuscodes (300, 404, 409, 412) wurden entfernt
Stapelerfassung POST (Bewegungsdaten)Hinzufügen des Endpunkts POST /clients/{client-id}/calendar-records/batch        
Hinzufügen des Endpunkts POST /clients/{client-id}/month-records/batch
ClientFeld "Id" liefert wieder Mandanten-GUID        
Client-List-Item entfernt, da identisch zu Client. Rückgabe des Client-Objekts bei GET /clients Request
DisabilityDatumspattern für "valid_from" und "valid_to" hinzugefügt       

Behebung des Rechtschreibfehlers in "disability_group": von "schwerbinderter_2_anrechnungen" auf "schwerbehinderter_2_anrechnungen"
EmployeePOST: Entfernung des Schemas "employee-without-id" und Verwendung des Schemas "employee"
Employment_periodsEntfernen von GET /clients/{client-id}/employment-periods/{employment-period-id}
Gross_paymentsEntfernen von GET /clients/{client-id}/gross-payments/{gross-payment-id}       

Behebung des Rechtschreibfehlers in "payment_interval" von "annualy" auf "annually"
Gross-payment-without-idHinzufügen des Properties "personnel_number" (Konsistenz zu anderen Ressourcen hergestellt)       

Für POST fehlendes Feld "payment_interval" hinzugefügt
Hourly_wagesEntfernen von GET /clients/{client-id}/hourly-wages/{hourly-wage-id}        
Entfernen von PUT /clients/{client-id}/hourly-wages/{hourly-wage-id}
Private_insuranceFeld "monthly_contribution_to_basic_health_insurance" mit aufgenommen
Salary_typeÄnderung des Datentyps für "id" von "string" auf "integer"


 

Version 3.0.0

Summary

Breaking Changes

ResourceDescription
Personal-dataRechtschreibfehler in Feld marital_status behoben (zuvor: martial_status)
Accountable-employeeFeld personnel_number wurde entfernt, da das Feld Id dieser schon entspricht
Calendar-records-batch, Month-records-batchRessourcen sind weggefallen, da nun eine Stapelerfassung für calendar-record und month-record möglich ist (siehe Added Features Stapelerfassung PUT)
Gross-paymentFeld payment_interval ist nun vom Datentyp enum mit den möglichen Werten: „monthly, semiannually, quarterly, annualy“
New-employeeRessource ist weggefallen, da nun ein POST auf employee möglich ist.
Individual-data

Ist nicht mehr Subressource von personal-data sondern employee, um die URI zu verkürzen.       
Beispiel:

datev/api/hr/v3/clients/1234567-12345/employees/100/individual-data?reference-date=2022-01-01

GenerellDELETE nicht länger unterstützt
 Monatshistorische Werte müssen mit dem Monatsletzten angefragt werden. (z.B.: reference-date=2022-01-31)

Added Features

ResourceDescription
Query-Parameter: ExpandHinzufügen des Query-Parameter „expand“ welcher es ermöglicht, weitere Ressourcen in einer Abfrage zu verknüpfen. Als Parameter können einzelne Ressourcen getrennt durch Komma angegeben werden oder „expand=all“ um alle verfügbaren Ressourcen zu verknüpfen.       

Beispiel:       
datev/api/hr/v3/clients/1234567-12345/employees/100?reference-date=2022-01-01&expand=address, personal-data       
ODER       
datev/api/hr/v3/clients/1234567-12345?reference-date=2022-01-01&expand=all
ClientKombination aus „BeraterNr-MandantenNr“ lässt sich zusätzlich als Uri-Identifier verwenden.       

Beispiel:       
datev/api/hr/v3/clients/1234567-12345?reference-date=2022-01-01        
ODER       
datev/api/hr/v3/clients/990b2s7b-c3a0-4c91-a256-43b0fba6b967?reference-date=2022-01-01
Stapelerfassung PUTAlle Ressourcen können zur Stapelerfassung genutzt werden. (Ausnahmen: cost-center, cost-unit, vocational-training, employment-period)
EmployeePOST hinzugefügt       
Zusätzliche Felder: date_of_commencement_of_employment (Eintrittsdatum) und first_accounting_month (Erster Abrechnungsmonat)
Employee-groupNeue Ressource Mitarbeitergruppe hinzugefügt
DisabilityNeue Ressource Schwerbehinderung hinzugefügt
Hourly-wageZusätzliches Feld: personnel_number (Personalnummer)
SalaryNeue Ressource Abrechnungsdaten hinzugefügt
Voluntary-insuranceZusätzliche Felder:       
premium_for_voluntary_nursing_insurance_is_paid_by_employee (Arbeitgeberzuschuss aus Entgelt für freiwillige Pflegeversicherung) (nur lesend)
Employment-periodDrittes Geschlecht kann gelesen und gesetzt werden.
Employment-periodZusätzliche Felder: date_of_death (Datum des Todes), personnel_numner (Personalnummer)
Vocational-trainingZusätzliches Feld: personnel_number (Personalnummer)
Gross-paymentZusätzliches Feld: personnel_number (Personalnummer)

Fixes

ResourceDescription
--

 

Version 2.0.3

Summary

Breaking Changes

ResourceDescription
--

Added Features

ResourceDescription
Gross-paymentReference_date zu Properties zugefügt.
Personal-dataDrittes Geschlecht kann gelesen und gesetzt werden.

Fixes

ResourceDescription
Calendar-Record (PUT, POST)Baulohnarten (z.B. 8000) konnten in 'salary_type_id' nicht gesetzt werden.

 

Version 2.0.2

Summary

Breaking Changes

ResourceDescription
--

Added Features

ResourceDescription
Gross-paymentErgänzung der Abfrage der Bezüge um das Abrechnungsintervall.
Working-hours, Individual-data, Financial-accountingErweiterung der Schnittstelle um Arbeitszeiten, individuelle Personaldaten und Abweichende Berater- und Mandantennummer für die Finanzbuchführung.

Fixes

ResourceDescription
--

- -