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.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Informations about the package datev-php-sdk

DATEV PHP SDK

PHP Version Packagist

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

📋 Voraussetzungen

📦 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

  1. Kopieren Sie .samples/config.json.sample nach tests/.samples/config.json
  2. 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=1 in phpunit.xml.dist). Im Mock-Modus werden die Antworten aus den OpenAPI-Spezifikationen in docs/OpenAPI/ generiert.

Online-Live-Tests: Mit DATEV_ONLINE_LIVE=1 und dem Abschnitt DATEV-ONLINE-API in .samples/config.json (Sandbox-Bearer-Token + DATEV-Client-Id) laufen die Online-Endpoint-Tests gegen die DATEV-Sandbox statt gegen Mocks.

📖 Abhängigkeiten

🔧 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!

GitHub Sponsors PayPal

👤 Autor

Daniel Jörg Schuppelius


All versions of datev-php-sdk with dependencies

PHP Build Version
Package Version
Requires php Version >=8.2 <8.6
daniel-jorg-schuppelius/php-api-toolkit Version ^2.8
dschuppelius/php-common-toolkit Version ^1.20 || ^2.0
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package daniel-jorg-schuppelius/datev-php-sdk contains the following files

Loading the files please wait ...