HaloPSA

Liest abrechenbare Zeiteinträge aus HaloPSA und macht daraus Leistungsnachweise je Kunde, Agent und Verrechnungsart. Dienstleistungen sind ein gesondertes Rechnungsdokument: Sie erscheinen nie auf der weclapp-Lizenzrechnung des Rechnungslaufs, sondern wandern einzeln in den weclapp-Buchungsbericht. In der App ist HaloPSA deshalb ein eigener Menüpunkt direkt über weclapp — keine Integration wie die Lizenz-Portale.

Zugangsdaten (Zahnrad)

HaloPSA-API-Zugang (URL der Instanz, Client-ID/Secret der API-Anwendung mit Leserechten auf Tickets/Zeiten/Kunden/Agents).

Metriken

• Eine Metrik je HaloPSA-Abrechnungsartikel, Wert = Stunden des Kunden im Zeitraum.
• Agent-Namen werden über die Agent-Liste aufgelöst, Zeiten ohne Zeitzonen-Angabe als lokale Gerätezeit interpretiert.
• Die Stunden bleiben als Snapshot-Daten in Dashboard, Trends und Export sichtbar (Leistungsnachweis) — fakturiert wird darüber nichts.

Ansicht

Drei Tabs:

1. Zeiteinträge (live) — die einzelnen Einträge zur Kontrolle und zum Buchen in den Buchungsbericht.
2. Monatssummen — aggregiert je Kunde und Verrechnungsart; der letzte Snapshot eines Monats trägt die Monatssumme als Leistungsnachweis.
3. Artikel-Zuordnung — welcher weclapp-Artikel je Verrechnungsart beim Buchen in den Buchungsbericht verwendet wird (siehe unten).

Einzelne Einträge lassen sich von den abrechenbaren Stunden ausschließen (z. B. Kulanz) — Ausschlüsse sind kuratiert und überleben jeden Snapshot.

Einzelzeiten in den weclapp-Buchungsbericht

Einzelne Zeiteinträge werden in den weclapp-Buchungsbericht gebucht — für die Nachvollziehbarkeit, welcher Agent welche Tätigkeit gemacht hat, und als Grundlage des gesonderten Dienstleistungs-Rechnungsdokuments in weclapp. Je Buchung entsteht in weclapp ein Task (Kunde aus der Kunden-Zuordnung, Artikel aus der Artikel-Zuordnung dieser Ansicht, Bearbeiter über die E-Mail des HaloPSA-Agents) plus ein Zeiteintrag mit Dauer, Abrechenbar-Kennzeichen und der Beschreibung „TicketID: … [Ersteller: …] - Notiz".

• Nur manuell: pro Zeile über das weclapp-Symbol oder gesammelt über Checkboxen + „Ausgewählte zu weclapp buchen" (mit Bestätigungsdialog). Nichts bucht automatisch.
• Idempotent: Gebuchte Einträge tragen einen grünen „gebucht"-Chip und sind gegen Doppelbuchung gesperrt; bei Teilfehlern wird die halbe Buchung automatisch aufgeräumt.
• Zurücknehmen: Der Lösch-Button an gebuchten Einträgen entfernt Zeiteintrag + Task in weclapp — der Eintrag ist danach wieder buchbar.
• Konventionen: E-Mail-Aktionen erscheinen als „E-mail Korrespondenz", „Quick Time"-Sammeltickets als „Client Support Office Hours"; der Ticket-Ersteller kommt aus dem HaloPSA-Custom-Field „Ticket Ersteller" (das Sammelkonto „General User" wird weggelassen).
• Voraussetzungen: Der Kunde ist einem weclapp-Kunden zugeordnet, die Verrechnungsart einem weclapp-Artikel (Tab „Artikel-Zuordnung"), und die Agent-E-Mail existiert als weclapp-Benutzer — fehlt etwas, wird der Eintrag mit verständlicher Meldung übersprungen.

Artikel-Zuordnung

Im Tab Artikel-Zuordnung wird je Verrechnungsart der weclapp-Artikel hinterlegt, mit dem Einzelzeiten in den Buchungsbericht gebucht werden. Die Liste zeigt alle bekannten Verrechnungsarten (aus den Snapshots) plus bereits zugeordnete Produkte. Diese Zuordnung wohnte früher in der weclapp-Artikel-Zuordnung — bestehende Zuordnungen wurden automatisch übernommen. Im weclapp-Produktkatalog und in den Kunden-Positionen tauchen HaloPSA-Zeiten seit der Trennung nicht mehr auf.

Besonderheiten

• Client-IDs sind stabil → automatische Umbenennungs-Erkennung.
• Die weclapp-Lizenzrechnung enthält keine HaloPSA-Positionen mehr — Dienstleistungen laufen ausschließlich über den Buchungsbericht als eigenes Rechnungsdokument.