Download the PHP package daniel-jorg-schuppelius/datev-php-sdk without Composer
On this page you can find all versions of the php package daniel-jorg-schuppelius/datev-php-sdk. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download daniel-jorg-schuppelius/datev-php-sdk
More information about daniel-jorg-schuppelius/datev-php-sdk
Files in daniel-jorg-schuppelius/datev-php-sdk
Package datev-php-sdk
Short Description DATEV SDK for PHP
License MIT
Informations about the package datev-php-sdk
DATEV PHP SDK
Ein PHP SDK für die DATEV Desktop API (DATEVconnect) und die DATEV Online-APIs (Cloud-Datenservices), das programmatischen Zugriff auf die deutsche Buchhaltungs- und Lohnabrechnungssoftware ermöglicht.
🚀 Features
- Flexible Authentifizierung: Basic Auth, Bearer Token und OAuth2 über austauschbare Authentication-Klassen
- Domain-Driven Design: Strikte Trennung zwischen API-Clients, Endpoints, Entities und Contracts
- Über 120 Desktop-Endpoints für umfassende DATEVconnect-Integration:
- Buchhaltung (Accounting) - 34 Endpoints
- Mandantenstammdaten (Client Master Data) - 19 Endpoints
- Lohn & Gehalt (Payroll/HR) - 32 Endpoints
- Dokumentenmanagement (DMS) - 11 Endpoints
- Auftragsverwaltung (Order Management) - 21 Endpoints
- Rechtswesen (Law) - 15 Endpoints
- Öffentlicher Sektor (Public Sector) - 12 Endpoints
- Identity & Access Management (SCIM) - 5 Endpoints
- Diagnostics - 2 Endpoints
- 14 DATEV Online-Dienste (Cloud) mit 111 Operationen vollständig abgedeckt:
- accounting-clients, accounting:documents (Belegbilderservice), accounting:dxso-jobs, accounting:extf-files, Accounting Data Exchange (Buchungsdatenservice)
- hr:exchange, hr:exports, hr:files, hr:payrollreports, hr:eau, Datenservice Dokumente Personalwirtschaft
- cashregister:import (Kassenarchiv), Health-Endpunkte (master-data, my-tax)
- Async-Job-Unterstützung (202 + Location, State-Polling, mehrstufige Jobs) über einen konfigurierbaren
JobPoller
📋 Voraussetzungen
- PHP 8.2, 8.3 oder 8.4
- DATEV Software mit aktivierter Desktop API (läuft standardmäßig auf Port 58452)
- Composer
📦 Installation
⚙️ Konfiguration
Verbindung zur DATEV Desktop API
Die API läuft standardmäßig auf https://127.0.0.1:58452.
Authentifizierung
HTTP Basic Auth (empfohlen):
Bearer Token Auth:
📚 Verwendung
Beispiel: Mandanten abrufen (Accounting)
Beispiel: Mitarbeiter abrufen (Payroll)
Beispiel: Echo-Test (Verbindung prüfen)
🏗️ Projektstruktur
🔌 API-Endpunkte
Accounting (accounting/v1)
Buchungssätze, Kostenstellen, Konten, Kreditoren, Debitoren und mehr.
| Endpoint | Beschreibung |
|---|---|
ClientsEndpoint |
Mandantenverwaltung |
AccountingRecordsEndpoint |
Buchungssätze |
AccountingSequencesEndpoint |
Buchungsstapel |
GeneralLedgerAccountsEndpoint |
Sachkonten |
CreditorsEndpoint / DebitorsEndpoint |
Kreditoren & Debitoren |
CostCentersEndpoint |
Kostenstellen |
FiscalYearsEndpoint |
Wirtschaftsjahre |
TermsOfPaymentEndpoint |
Zahlungsbedingungen |
PostingProposal*Endpoint |
Buchungsvorschläge (Kasse, Ein-/Ausgangsrechnungen) |
| ... und 24 weitere |
Client Master Data (master-data/v1)
Mandantenstammdaten, Adressaten und Finanzämter.
| Endpoint | Beschreibung |
|---|---|
ClientsEndpoint |
Mandantenstammdaten |
AddresseesEndpoint |
Adressatenverwaltung |
TaxAuthoritiesEndpoint |
Finanzämter |
BanksEndpoint |
Bankverbindungen |
LegalFormsEndpoint |
Rechtsformen |
ClientCategoriesEndpoint |
Mandantenkategorien |
RelationshipsEndpoint |
Beziehungen |
| ... und 12 weitere |
Payroll / HR (hr/v3)
Lohn- und Gehaltsabrechnung. Hinweis: Alle HR-Endpoints erfordern ein reference-date.
| Endpoint | Beschreibung |
|---|---|
EmployeesEndpoint |
Mitarbeiterverwaltung |
SalariesEndpoint |
Gehälter |
SocialInsuranceEndpoint |
Sozialversicherung |
TaxationEndpoint |
Besteuerung |
WorkingHoursEndpoint |
Arbeitszeiten |
VacationEntitlementEndpoint |
Urlaubsansprüche |
GrossPaymentsEndpoint |
Bruttobezüge |
| ... und 25 weitere |
Document Management (dms/v2)
Dokumentenverwaltung und Archivierung.
| Endpoint | Beschreibung |
|---|---|
DocumentsEndpoint |
Dokumentverwaltung |
DocumentFilesEndpoint |
Dateien zu Dokumenten |
DocumentStatesEndpoint |
Dokumentstatus |
DomainsEndpoint |
Mandantenbereiche |
StructureItemsEndpoint |
Ordnerstrukturen |
SecureAreasEndpoint |
Sicherheitsbereiche |
| ... und 5 weitere |
Order Management
Auftragsverwaltung mit Gebührenplanung.
| Endpoint | Beschreibung |
|---|---|
OrdersEndpoint |
Aufträge |
InvoicesEndpoint |
Rechnungen |
FeePlansEndpoint |
Gebührenpläne |
ChargeRatesEndpoint |
Verrechnungssätze |
CostItemsEndpoint |
Kostenträger |
ExpensePostingsEndpoint |
Auslagenbuchungen |
| ... und 15 weitere |
Law (law/v1)
Aktenverwaltung für Rechtsanwälte und Notare.
| Endpoint | Beschreibung |
|---|---|
FilesEndpoint |
Akten |
ExpensesEndpoint |
Auslagen |
FeeVersionsEndpoint |
Gebührenversionen |
CausesEndpoint |
Fallursachen |
PartyRolesEndpoint |
Parteirollen |
SecurityZonesEndpoint |
Sicherheitszonen |
| ... und 9 weitere |
Public Sector (public-sector/v1)
Kommunalverwaltung und öffentlicher Sektor.
| Endpoint | Beschreibung |
|---|---|
CitizensEndpoint |
Bürgerverwaltung |
MetersEndpoint |
Zählerverwaltung |
MeterReadingsEndpoint |
Zählerablesungen |
NotificationsEndpoint |
Bescheide |
DuesEndpoint |
Gebühren |
ConsumptionsEndpoint |
Verbrauchsdaten |
| ... und 6 weitere |
Identity & Access Management (SCIM)
Benutzer- und Gruppenverwaltung nach SCIM-Standard.
| Endpoint | Beschreibung |
|---|---|
UsersEndpoint |
Benutzerverwaltung |
GroupsEndpoint |
Gruppenverwaltung |
SchemasEndpoint |
SCIM-Schemas |
ResourceTypesEndpoint |
Ressourcentypen |
ServiceProviderConfigEndpoint |
Provider-Konfiguration |
Diagnostics
Verbindungstests und Systemdiagnose.
| Endpoint | Beschreibung |
|---|---|
EchoEndpoint |
Verbindungstest |
DomainsEndpoint |
Verfügbare Domains |
☁️ DATEV Online-APIs (Cloud)
Neben der lokalen Desktop API deckt das SDK alle 14 DATEV-Online-Dienste vollständig ab (src/API/Online/). Jeder Dienst hat einen eigenen Host (https://<service>.api.datev.de/platform[-sandbox]/vN); die Dienstfakten (Host, Basispfad, Header-Schreibweise) kapselt das Enum Datev\API\Online\OnlineService.
Client und Authentifizierung
Die Authentifizierung erfolgt per OAuth2-Bearer-Token plus X-DATEV-Client-Id-Header. Die Token-Beschaffung (Authorization Code Flow über login.datev.de) ist Sache des Aufrufers — das php-api-toolkit liefert dafür OAuth2AuthorizationCodeGrant und OAuth2BearerAuthentication.
Beispiel: Mandanten und Belegtransfer
Beispiel: EXTF-Import mit Job-Polling
Online-Dienste im Überblick
Dienst (OnlineService::…) |
Endpoints | Besonderheiten |
|---|---|---|
AccountingClients |
Mandanten + Datenservices | OData top/skip/filter, Link/Total-Items-Paging |
AccountingDocuments |
Belegbilderservice | Multipart-Uploads, stapled Documents |
AccountingDxsoJobs |
DXSO-Datentransfer | create → addFile → finalize → Status/Protokoll |
AccountingExtfFiles |
EXTF-Import | octet-stream + Filename-Header, 202 + Location |
AccountingDataExchange |
Buchungsdatenservice | ndjson-Antworten, Header-Paging, Export-Jobs |
CashRegister |
Kassenarchiv | Tenant-Adressierung, ApiKey-only |
HrExchange |
Lohn-Datenaustausch | Alle Writes 202-async, Lese-Jobs, RestHooks |
HrExports |
Lohn-Auswertungsdaten | Zeitraumfilter, Arbeitnehmer-/Mandantenebene |
HrFiles |
Lohn-Importdateien | Multipart ≤3 MB, Job-Status |
HrPayrollReports |
Auswertungs-PDFs | PDF/ZIP-Download via Accept-Negotiation |
HrEau |
eAU-Anfragen | Verbundnummer + Personalnummer |
HrDocuments |
Personalakte-Dokumente | Duale Adressierung (GUID/Verbundnummer) |
MasterClientsHealth, MyTaxHealth |
Healthchecks | ApiKey-only |
Die Abdeckung lässt sich jederzeit prüfen: php tools/OpenApiCoverageAnalyzer.php --type=Online.
🧪 Tests
Test-Konfiguration
- Kopieren Sie
.samples/config.json.samplenachtests/.samples/config.json - Tragen Sie Ihre DATEV-Zugangsdaten ein:
Tests ausführen
Hinweis: Die Endpoint-Tests erfordern standardmäßig eine laufende DATEV-Installation und sind daher deaktiviert (
DATEV_SKIP_API_TESTS=1inphpunit.xml.dist). Im Mock-Modus werden die Antworten aus den OpenAPI-Spezifikationen indocs/OpenAPI/generiert.Online-Live-Tests: Mit
DATEV_ONLINE_LIVE=1und dem AbschnittDATEV-ONLINE-APIin.samples/config.json(Sandbox-Bearer-Token + DATEV-Client-Id) laufen die Online-Endpoint-Tests gegen die DATEV-Sandbox statt gegen Mocks.
📖 Abhängigkeiten
- php-api-toolkit (^2.0) - Basis-Klassen für Clients, Endpoints und Entities
- GuzzleHttp - HTTP Client
- PSR-3 Logger - Logging-Interface
🔧 Tools
Das SDK enthält ein OpenAPI Coverage Analyzer Tool zur Analyse der API-Abdeckung:
Dokumentation: docs/OpenApiCoverageAnalyzer.md
📄 Lizenz
Dieses Projekt ist unter der MIT-Lizenz lizenziert.
💖 Unterstützung
Wenn Ihnen dieses Projekt gefällt und es Ihnen bei Ihrer Arbeit hilft, würde ich mich sehr über eine Spende freuen!
👤 Autor
Daniel Jörg Schuppelius
- Website: schuppelius.org
- E-Mail: [email protected]
All versions of datev-php-sdk with dependencies
daniel-jorg-schuppelius/php-api-toolkit Version ^2.8
dschuppelius/php-common-toolkit Version ^1.20 || ^2.0