VenDoc Schnittstelle

ACHTUNG: nicht in Verwendung

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). Es können dabei natürlich auch mehrere Tage auf einmal abgeschlossen werden.

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 (= Unique Key).

Im Ergebnis der Abfrage finden sich alle korrekt verarbeiteten Intervalle.

Beispiel 1

Ergebnis zum Zeitpunkt 2010.12.20 00:00 für Abfragezeitraum 2019.12.18 00:00 - 2019.12.20 00:00

Personal ID	von	bis	Auftrag	Tätigkeit
10	2019.12.18 08:30	2019.12.18 12:00	111	1
10	2019.12.18 13:00	2019.12.18 17:00	444	2
11	2019.12.18 08:30	2019.12.18 12:00	111	1
11	2019.12.18 13:00	2019.12.18 17:00	444	2
10	2019.12.19 08:15	2019.12.19 12:30	999	3
10	2019.12.19 13:00	2019.12.19 17:00	999	1
10	2019.12.20 08:30	2019.12.20 12:00	111	1
10	2019.12.20 13:00	2019.12.20 17:00	444	2

Am 2019.12.20 werden diese Daten erfasst

Personal ID	von	bis	Auftrag	Tätigkeit
10	2019.12.20 08:30	2019.12.20 12:00	111	1
10	2019.12.20 13:00	2019.12.20 17:00	444	2

und die Zeile

Personal ID	von	bis	Auftrag	Tätigkeit
10	2019.12.18 13:00	2019.12.18 17:00	444	2

auf

Personal ID	von	bis	Auftrag	Tätigkeit
10	2019.12.18 13:00	2019.12.18 17:30	444	2

geändert.

Ergebnis zum Zeitpunkt 2010.12.21 00:00 für Abfragezeitraum 2019.12.18 00:00 - 2019.12.21 00:00

Personal ID	von	bis	Auftrag	Tätigkeit
10	2019.12.18 08:30	2019.12.18 12:00	111	1
10	2019.12.18 13:00	2019.12.18 17:30	444	2
11	2019.12.18 08:30	2019.12.18 12:00	111	1
11	2019.12.18 13:00	2019.12.18 17:00	444	2
10	2019.12.19 08:15	2019.12.19 12:30	999	3
10	2019.12.19 13:00	2019.12.19 17:00	999	1
10	2019.12.20 08:30	2019.12.20 12:00	111	1
10	2019.12.20 13:00	2019.12.20 17:00	444	2

Beispiel 2

Ergebnis zum Zeitpunkt 2010.12.20 00:00 für Abfragezeitraum 2019.12.01 00:00 - 2019.12.20 00:00

Personal ID	von	bis	Auftrag	Tätigkeit
10	2019.12.18 08:30	2019.12.18 12:00	321	1
10	2019.12.18 13:00	2019.12.18 17:00	321	2

Am 20.12.2020 09:00 wird dieses Interval

Personal ID	von	bis	Auftrag	Tätigkeit
10	2019.12.18 13:00	2019.12.18 17:00	321	1

durch diese ersetzt:

Personal ID	von	bis	Auftrag	Tätigkeit
10	2019.12.18 12:45	2019.12.18 14:30	587	2
10	2019.12.18 14:30	2019.12.18 18:15	321	2

Ergebnis zum Zeitpunkt 20.12.2020 09:01 für Abfragezeitraum 2019.12.01 00:00 - 2019.12.20 00:00

Personal ID	von	bis	Auftrag	Tätigkeit
10	2019.12.18 08:30	2019.12.18 12:00	321	1
10	2019.12.18 12:45	2019.12.18 14:30	587	2
10	2019.12.18 14:30	2019.12.18 18:15	321	2

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.

Beispiel 1

Ergebnis zum Zeitpunkt 2010.12.20 00:00 für Abfragezeitraum 2019.12.01 00:00 - 2019.12.20 00:00

RecordID	Personal ID	um	Auftrag	Menge	Artikel	Lager	Text
1	4711	2019.12.18 08:30	0815	100	1

Wird am 2010.12.20 08:30 erkannt, dass die 100 ein Erfassungsfehler sind, weil nur 10 Artikel '1' ausgehoben wurden und die Buchung korrigiert, so sieht das Abfrageergebnis um 2010.12.20 08:31 so aus:

RecordID	Personal ID	um	Auftrag	Menge	Artikel	Lager	Text
1	4711	2019.12.18 08:30	0815	100	1
2	4711	2010.12.20 08:30	0815	-90	1

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 HTTPS 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
  • Unique Key:
    • 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"
....
}