Import der Service-Buchungen

import { Tabs, TabItem } from ‘@astrojs/starlight/components’;

Interface Client

• api: service_booking
• variant: standard

Dieser Import dient der Erfassung von erbrachten Leistungen (Service-Buchungen), die sowohl in die Produktivitätsdaten als auch (optional) in die Arbeitszeiten der Mitarbeiter einfließen.

Daten für den Service-Booking-Import

Feld	Datentyp	Nicht NULL	Bemerkung
service_external_id	VARCHAR(32)	✓	Externe ID der Buchung (eindeutiger Schlüssel)
ord_external_id	VARCHAR(32)	✓	Externe ID des Auftrags
order_number	VARCHAR(24)		Auftragsnummer
structure	VARCHAR(10)		Struktur
coco_external_id	VARCHAR(8)		Externe ID des Company Codes Entlastungskostenstelle des Users
act_external_id	VARCHAR(32)	✓	Externe ID der Leistungsart
usr_external_id	VARCHAR(32)	✓	Externe ID des Benutzers
discharge_cc_external_id	VARCHAR(12)	✓	Entlastungs-Kostenstelle
service_date	DATE	✓	Datum der Leistung
service_start	INTEGER		Startzeit (in Minuten seit Mitternacht)
service_end	INTEGER		Endzeit (in Minuten seit Mitternacht)
service_minutes	INTEGER	✓	Dauer der Leistung in Minuten
service_description	VARCHAR(255)		Beschreibung
service_comment	VARCHAR(1000)		Kommentar

Ablauf im Überblick

1. Auftrags-Check: Wenn ein Auftrag (ord_external_id) im System noch nicht existiert, wird er automatisch angelegt (Standardmässig gesperrt, um keine manuelle Auswahl zu erlauben).
2. Leistungsarten-Check: Fehlende Leistungsarten-Zuordnungen zur Entlastungs-Kostenstelle werden automatisch im Hintergrund ergänzt.
3. Produktivität: Für jeden Datensatz wird ein Eintrag in der Tabelle t_productivity erzeugt. Existiert die service_external_id bereits, wird der Datensatz übersprungen (Deduplikation).
4. Arbeitszeit (Optional): Abhängig von den Benutzereinstellungen (uss_service_booking_import_worktimes) können aus den Service-Buchungen automatisch auch Arbeitszeit-Einträge (t_worktime) generiert werden.

Technische Hinweise

• Deduplikation: Das Feld service_external_id ist der Primärschlüssel für die Erkennung bereits importierter Buchungen.
• Arbeitszeit-Integration: Damit Arbeitszeiten generiert werden, müssen service_start und service_end geliefert werden. Zudem darf der Zeitraum für den Benutzer noch nicht final abgegeben/genehmigt sein.
• Stornierungen: Service-Buchungen mit negativen Minuten (service_minutes < 0) werden nur in die Produktivität übernommen, nicht aber in die Arbeitszeit.