SOAP Webservices – Schnittstellendokumentation

Einführung

Überblick

Die levatis-Plattform bietet eine umfassende SOAP-Webservice-Schnittstelle für die Integration mit Drittsystemen. Diese Services ermöglichen den bidirektionalen Datenaustausch zwischen Levatis und Ihrer Unternehmensanwendung – sei es ein ERP-System, eine Lohnverrechnungssoftware oder eine individuelle Branchenlösung.

Aktuell tauschen wir mit mehr als 10 Fremdsystemen erfolgreich Daten aus.

Technische Basis

Eigenschaft	Wert

Eigenschaft	Wert
Protokoll	SOAP 1.1 / 1.2
Authentifizierung	Session-basiert
Datenformat	XML (WSDL-definiert)
Session-Scope	`soapsession`

Verfügbare Services

Service	Zweck	WSDL-Endpunkt

Service	Zweck	WSDL-Endpunkt
LevatisBasicWS	Stammdaten (Kunden, Mitarbeiter, Projekte, Aufgaben)	`/services/LevatisBasicWS?wsdl`
WageHandlingWS	Lohnbuchungen und Lohnarten	`/services/WageHandlingWS?wsdl`
DocumentWS	Dokumentenverwaltung	`/services/DocumentWS?wsdl`
DocumentUploadWS	Dokument-Upload (MTOM)	`/services/DocumentUploadWS?wsdl`
TimeTrackingWS	Mobile Zeiterfassung	`/services/TimeTrackingWS?wsdl`
StockItemHandlingWS	Materialwirtschaft	`/services/StockItemHandlingWS?wsdl`
WatchDogWS	Health-Check / Monitoring	`/services/WatchDogWS?wsdl`

Integrations-Testumgebung

Für die Schnittstellenentwicklung steht Ihnen unser Partner-Integrations-System zur Verfügung. Dort finden Sie (fast) jederzeit einen Spiegel der Produktionsumgebung, auf dem Sie:

Die Schnittstelle entwickeln können
Tests mit Echtdaten durchführen können
Anpassungen vornehmen können

Ressource	URL

Ressource	URL
Web-Oberfläche	`https://dev.levatis.at/levatis4_integration/`
LevatisBasicWS	`https://dev.levatis.at/rep_integration/services/LevatisBasicWS?wsdl`
WageHandlingWS	`https://dev.levatis.at/rep_integration/services/WageHandlingWS?wsdl`
DocumentUploadWS	`https://dev.levatis.at/rep_integration/services/DocumentUploadWS?wsdl`

Authentifizierung

Alle Services (außer WatchDogWS) erfordern eine Authentifizierung. Der Ablauf ist wie folgt:

1. doClearTextLogin()  → Authentifizierung mit Credentials
2. [Business-Methoden aufrufen]
3. Session bleibt für weitere Aufrufe gültig

Methoden:

Methode	Beschreibung

Methode	Beschreibung
`doClearTextLogin(username, password, company)`	Login mit Klartext-Passwort
`isValidSession(sessionId)`	Prüft, ob eine Session noch gültig ist

Beispiel-Implementierungen

Wir bieten fertige Integrationsbeispiele für folgende Programmiersprachen:

Java – Native JAX-WS Integration
C# – .NET WCF Client

Diese Beispiele können auf Anfrage bereitgestellt werden.

Support & Onboarding

Bei Fragen wenden Sie sich bitte an: support@levatis.com

Tipp: Gerne bieten wir eine Teams-Sitzung an, um die Technik vorab durchzugehen – dann geht's schneller!

Eine ausführliche Anleitung zur Levatis-Anwendung finden Sie hinter den grünen Hilfe-Links direkt in der Anwendung.

LevatisBasicWS

Übersicht

Der LevatisBasicWS ist der zentrale Service für den Stammdatenaustausch. Er ermöglicht die vollständige Verwaltung aller Kernentitäten: Kunden, Mitarbeiter, Projekte, Aufgaben und Zeitbuchungen.

WSDL: /services/LevatisBasicWS?wsdl

Entitäten und Operationen

Kunden (Customer)

Methode	Parameter	Rückgabe	Beschreibung

Methode	Parameter	Rückgabe	Beschreibung
`createCustomer`	`CustomerBDTO`	`int`	Neuen Kunden anlegen
`createCustomer2`	`CustomerBDTO2`	`int`	Neuen Kunden anlegen (erweitert)
`getCustomer`	`publicId`, `levatisId`	`CustomerBDTO`	Kunden abrufen
`getCustomer2`	`publicId`, `levatisId`	`CustomerBDTO2`	Kunden abrufen (erweitert)
`updateCustomer`	`CustomerBDTO`	`int`	Kunden aktualisieren
`updateCustomer2`	`CustomerBDTO2`	`int`	Kunden aktualisieren (erweitert)
`deleteCustomer`	`publicId`, `levatisId`	`boolean`	Kunden löschen

Mitarbeiter (Worker)

Methode	Parameter	Rückgabe	Beschreibung

Methode	Parameter	Rückgabe	Beschreibung
`createWorker`	`WorkerBDTO`	`int`	Neuen Mitarbeiter anlegen
`createWorker3`	`WorkerBDTO3`	`int`	Neuen Mitarbeiter anlegen (V3)
`createWorkerExt`	`WorkerExtendedBDTO`	`int`	Neuen Mitarbeiter anlegen (erweitert)
`getWorker`	`publicId`, `levatisId`	`WorkerBDTO`	Mitarbeiter abrufen
`getWorkerExt`	`publicId`, `levatisId`	`WorkerExtendedBDTO`	Mitarbeiter abrufen (erweitert)
`updateWorker`	`WorkerBDTO`	`int`	Mitarbeiter aktualisieren
`updateWorkerExt`	`WorkerExtendedBDTO`	`int`	Mitarbeiter aktualisieren (erweitert)

Projekte (Project)

Methode	Parameter	Rückgabe	Beschreibung

Methode	Parameter	Rückgabe	Beschreibung
`createProject`	`ProjectBDTO`	`int`	Neues Projekt anlegen
`createProject3`	`ProjectBDTO3`	`int`	Neues Projekt anlegen (V3)
`createProjectExt`	`ProjectExtendedBDTO`	`int`	Neues Projekt anlegen (erweitert)
`getProject`	`publicId`, `levatisId`	`ProjectBDTO`	Projekt abrufen
`getProject3`	`publicId`, `levatisId`	`ProjectBDTO3`	Projekt abrufen (V3)
`getProjectExt`	`publicId`, `levatisId`	`ProjectExtendedBDTO`	Projekt abrufen (erweitert)
`updateProject`	`ProjectBDTO`	`int`	Projekt aktualisieren
`updateProject3`	`ProjectBDTO3`	`int`	Projekt aktualisieren (V3)
`updateProjectExt`	`ProjectExtendedBDTO`	`int`	Projekt aktualisieren (erweitert)
`deleteProject`	`publicId`, `levatisId`	`boolean`	Projekt löschen

Aufgaben (Task)

Methode	Parameter	Rückgabe	Beschreibung

Methode	Parameter	Rückgabe	Beschreibung
`createTask`	`TaskBDTO`	`int`	Neue Aufgabe anlegen
`getTask`	`publicId`, `levatisId`	`TaskBDTO`	Aufgabe abrufen
`updateTask`	`TaskBDTO`	`int`	Aufgabe aktualisieren
`deleteTask`	`publicId`, `levatisId`	`boolean`	Aufgabe löschen
`getTaskForProject`	`projectId`, `levatisId`	`TaskBDTOArray`	Alle Aufgaben eines Projekts
`getTasksByJobnumber`	`jobnumber`	`TaskBDTOArray`	Aufgaben nach Auftragsnummer

Zeitbuchungen (Taskentry)

Methode	Parameter	Rückgabe	Beschreibung

Methode	Parameter	Rückgabe	Beschreibung
`createTaskentry`	`TaskentryBDTO`	`int`	Neue Zeitbuchung anlegen
`getTaskentry`	`publicId`, `levatisId`	`TaskentryBDTO`	Zeitbuchung abrufen
`getTaskentryExt`	`publicId`, `levatisId`	`TaskentryExtBDTO`	Zeitbuchung abrufen (erweitert)
`updateTaskentry`	`TaskentryBDTO`	`int`	Zeitbuchung aktualisieren
`deleteTaskentry`	`publicId`, `levatisId`	`boolean`	Zeitbuchung löschen
`getTaskentryForWorker`	`workerId`, `levatisId`	`TaskentryBDTOArray`	Alle Zeitbuchungen eines Mitarbeiters

Such- und Sync-Funktionen

Methode	Parameter	Rückgabe	Beschreibung

Methode	Parameter	Rückgabe	Beschreibung
`searchChangedTasks`	`since`, `state`	`SearchResult`	Geänderte Aufgaben seit Zeitpunkt
`searchChangedItems`	`since`	`SearchResult`	Alle geänderten Entitäten seit Zeitpunkt
`searchChangedItemsFilter`	`since`, Filter...	`SearchResult`	Geänderte Entitäten mit Filteroptionen

Arbeitslast-Berechnung

Methode	Parameter	Rückgabe	Beschreibung

Methode	Parameter	Rückgabe	Beschreibung
`calculateTaskWorkload`	Task-Parameter	`BigDecimal`	Arbeitslast für eine Aufgabe berechnen
`calculateJobnumberWorkload`	Jobnumber-Parameter	`BigDecimal`	Arbeitslast für eine Auftragsnummer berechnen

Arbeitszeitmodell (WTM)

Methode	Parameter	Rückgabe	Beschreibung

Methode	Parameter	Rückgabe	Beschreibung
`getResourceWorkdayInfoJS`	`publicResourceId`, `from`, `to`, `sessionId`	`ResourceWorkdayInfoBDTOArray`	Arbeitszeit-Info pro Tag für eine Ressource

Liefert für jeden Tag im Zeitraum (max. 31 Tage) sowohl WTM-Sollwerte als auch Ist-Werte aus Buchungen:

Feld	Typ	Beschreibung

Feld	Typ	Beschreibung
`date`	`Calendar`