VenDoc Schnittstelle

Um die Kommunikation zwischen VenDoc und ALEX robust abzuhandeln, werden klare organisatorische Abläufe und funktionelle Zuständigkeiten festgelegt. Darauf aufbauend ist die technische Umsetzung beschrieben.

Übersicht

Organisationskonzept

Stammdatenverwaltung

Personaldatenpflege

Die systemübergreifende Identifikation der Personalstammdaten erfolgt über eine von ALEX vergebene eindeutige Nummer. Das Personal wird in ALEX angelegt.

VenDoc holt sich die verwendbaren Eigenschaften (Vor- Zuname, Geb. Datum, Ein/Austritt...) von ALEX.

Es wird immer der gesamte Personalstamm zurück gegeben.

Kunden, Aufträge, Tätigkeiten, Material

Diese Daten werden an ALEX übergeben, und hier nur lesend verwendet.

Die Übergabe der Daten erfolgt vollständig: Alle Sätze, die für ALEX markiert sind, werden in der Schnittstelle übergeben.

In ALEX werden keine Daten gelöscht, sondern nur auf 'Abgelaufen' gesetzt.

Verrechnung der erfassten Zeiten

In ALEX gibt es verschiedene Möglichkeiten, Arbeitszeiten eines Mitarbeiters auf Aufträge und Tätigkeiten zuzuordnen:

• An/Abmeldung über Stempeluhr
• Buchung über App
• Manuelle Erfassung/Nachbearbeitung durch
  • Selbstbedienung
  • Verantwortlichen

Manuelle Änderungen der Intervalle werden nur in ALEX durchgeführt.

Diese Daten sind in ALEX vom Verantwortlichen zu überprüfen.

Dabei helfen ihm Werkzeuge wie Standeskontrolle und Besetzungs-Report.

Ist die Datenlage geprüft und für richtig befunden, ist der Tag für die Zeiterfassung in ALEX abzuschließen (siehe Supervisorenschulung_WEB).

Damit VenDoc die Intervalle leicht weiter verarbeiten kann, werden die Intervalle gruppiert nach Personal, aufsteigend sortiert nach "Von" Zeitpunkt übergeben. Zusätzliche Garantie: Pro Personal und Zeitpunkt gibt es nur EIN Intervall.

Materialbuchungen

Die Materialbuchungen werden in ALEX nur erfasst und nicht geändert. Korrekturen sind als Minus in einer neuen Buchungen mit neuem Zeitstempel zu erfassen. Materialbuchungen können jederzeit von VenDoc für einen beliebigen Zeitraum abgefragt werden.

Infobuchungen

Die Infobuchungen werden in ALEX nur erfasst und nicht geändert. Sie können jederzeit von VenDoc für einen beliebigen Zeitraum abgefragt werden.

Technische Beschreibung

Allgemeines

Je ALEX Installation steht ein Webservice zur Verfügung.

Der Port des Webservice ist via - https://k5.alexweb.io/CustomerPort ersichtlich.

Kommunikation erfolgt über HTTP Protokoll. An ALEX via "POST", von ALEX via "GET".

Die Daten selbst werden in JSON dargestellt.

Allgemeine Stammdaten von VenDoc an ALEX

• Auftrag (in ALEX -> 'Kundenplan')
  • VenDoc Primärschlüssel
  • Kunde * VenDoc Primärschlüssel
  • Betreff
  • Status (0 = Offen, 2 = Erledigt)
  • Belegnummer
  • Mitarbeiter Zuordnung (ALEX Primärschlüssel)

• Tätigkeiten (in ALEX -> Farbmarkierung)
  • VenDoc Primärschlüssel
  • Code
  • Name

• Material (in ALEX 'Material')
  • VenDoc Primärschlüssel
  • Artikelnummer
  • Bezeichnung
  • Einheit
  • EAN Nummer
  • Warengruppe (VenDoc Primärschlüssel)

• Lager (in ALEX 'Lager')
  • VenDoc Primärschlüssel
  • Code
  • Name

• Warengruppe (in ALEX 'Warengruppe')
  • VenDoc Primärschlüssel
  • Code
  • Name

• Kunde (in ALEX 'Kundenstamm')
  • VenDoc Primärschlüssel
  • Firmenname
  • Inaktiv

Ergebnisse von ALEX an VenDoc

Angestoßen von VenDoc durch Angabe von "Alle" oder "Personal", von/bis, optional nur geprüfte.

• Zeitbuchungen
  • Personal (ALEX Primärschlüssel)
  • Beginn
  • Ende
  • Auftrag (VenDoc Primärschlüssel)
  • Tätigkeit (VenDoc Primärschlüssel)
  • Lohnart (VenDoc Primärschlüssel)
  • Text

• Material/Gerätebuchungen
  • ALEX Primärschlüssel der Buchung
  • Personal (VenDoc Primärschlüssel)
  • Zeitpunkt
  • Auftrag (VenDoc Primärschlüssel)
  • Menge
  • Artikel (VenDoc Primärschlüssel)
  • Lager (VenDoc Primärschlüssel)
  • Text

• Infobuchungen
  • ALEX Primärschlüssel der Buchung
  • Personal (VenDoc Primärschlüssel)
  • Datum
  • Auftrag (VenDoc Primärschlüssel)
  • Titel
  • Text
  • Bild

Personalstammdaten von ALEX an VenDoc

• Personal
  • Personalnummer
  • Vorname / Nachname
  • Geburtstag
  • Eintritt / Austritt
  • Anschrift
  • Alex Primärschlüssel

In ALEX an VenDoc schicken Ja/Nein einstellen lassen

Konfiguration (*.bfx_CONFIG)

, "modelPlugins" :
{	
....
,"n" : "Bfx.Alex.Logistics.Interface.Model.dll"
....
}