Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- finance:bill-items [2025/12/01 15:50] – agoldman
+++ finance:bill-items [2026/05/07 09:26] (aktuell) – nullrich
@@ Zeile 1: / Zeile 1: @@
-===== Vorpositionen =====
+====== 📦 Vorpositionen ======
-Vorpositionen sind einzelne, verrechenbare und konkret erfasste Leistungs- oder Serviceeinheiten, wie zB Betreuungsleistungen oder Fahrtkosten.
+> **Zielgruppe:** Verrechnung, Verwaltung, Backoffice
+> **Modul:** ADM Cockpit – Abrechnung
-Vorpositionen entstehen
+<WRAP lo>
-  * **automatisiert** aus der Auswertung der Geschäftsfälle und Einsätze durch ein **Vorpositions-Generatorskript**, wenn ein solches als Erweiterung vorhanden ist. In diesem Fall löst jede Änderung an einem Geschäftsfall oder Einsatz unmittelbar einen Abgleich mit der Vorpositionsliste aus. Dabei werden Vorpositionen, die noch nicht auf Belegen stehen, neu berechnet, während solche, die schon auf Belegen stehen, mit passenden Gutschrifts- oder Ergänzungsbuchungen realisiert werden, die dann auf dem jeweils nächsten Beleg berücksichtigt werden.
+**Schlagworte:** vorpositionen, leistungen, abrechnung, verrechnung, einsätze, geschäftsfall, beleg, splitting, caats
-  * **automatisiert** durch die Auswertung der Geschäftsfälle und Einsätze in Rahmen eines **Abrechnungslaufs** auf Basis automatisierter Verrechnungsmodelle
+</WRAP>
-  * aus **manuell erstellten Positionen** mit Hilfe des Leistungskatalogs, wenn Belege manuell ausgestellt werden
-  * **manuell durch direktes //Anlegen// von Vorpositionen** über den Menüpunkt rechts oben neben Ihrem Benutzernamen
-Grundsätzlich werden Leistungen, die manuell in die Vorpositionsliste eingebucht werden, automatisch den über Kreditor und Debitor sich ergebenden Belegarten zugeschlagen und auf dem jeweils nächsten Beleg der entsprechenden Belegart bzw. einem Beleg mit passendem Abrechnungszeitraum anteilig oder vollständig zugerechnet.
+===== 🧭 Überblick =====
-CAATS kann auch ohne Vorpositions-Generatorskript betrieben werden, dies hat aber zwei Nachteile:
+**Vorpositionen** sind einzelne, **verrechenbare Leistungs- oder Serviceeinheiten**,
-  - die Konten sind nicht sofort aktuell, sondern immer erst nach einem Abrechnungslauf und
+z. B.:
-  - die Abrechnungsläufe dauern wesentlich länger, da alle Vorpositionen, die auf Basis von automatisierten Verrechnungsmodellen zu erstellen sind, in dem Fall erst dann angelegt werden, wenn die Belege angefordert werden.
-Wenn in der Abrechnungs-Engine zeitliches Splitting konfiguriert ist (Beispiel: Einsatz über die Monatsgrenze, aber monatliche Abrechnung), so erfolgt dieses Splitting bereits auf der Vorpositionsebene, ist also am Konto
+  * Betreuungsleistungen
-ersichtlich. Der gesamte Leistungszeitraum steht dabei im Text, während das Von- bzw. BisDatum der abrechnungsfertigen Vorposition die Abgrenzung einhält.
+  * Fahrtkosten
+  * Zusatzleistungen
+Sie bilden die **direkte Grundlage für alle Belege** im System.
+<WRAP info>
+Vorpositionen entstehen **vor der eigentlichen Belegerstellung**
+und werden später zu Rechnungen zusammengeführt.
+</WRAP>
+----
+===== ⚙️ Entstehung von Vorpositionen =====
+Vorpositionen können auf vier Arten entstehen:
+^ Art ^ Beschreibung ^
+| **Automatisch (Generator)** | laufende Berechnung durch Vorpositions-Generatorskript |
+| **Automatisch (Abrechnungslauf)** | Erstellung im Rahmen eines Abrechnungslaufs |
+| **Manuell (Leistungskatalog)** | beim manuellen Erstellen von Belegen |
+| **Manuell (Direkt)** | über **„Anlegen“** im Vorpositionsbereich |
+----
+===== 🔄 Automatische Verarbeitung =====
+Wenn ein **Vorpositions-Generatorskript** aktiv ist:
+  * jede Änderung an:
+    - Geschäftsfall
+    - Einsatz
+  → löst **sofort eine Neuberechnung** aus
+**Verhalten:**
+| Status | Verarbeitung |
+|--------|-------------|
+| Vorposition **noch nicht verrechnet** | wird neu berechnet |
+| Vorposition **bereits auf Beleg** | wird über **Gutschrift oder Ergänzung** korrigiert |
+<WRAP tip>
+💡 Änderungen wirken sich automatisch auf zukünftige Belege aus.
+</WRAP>
+----
+===== 🧾 Verhalten bei manuellen Vorpositionen =====
+Manuell erfasste Leistungen:
+  * werden automatisch einer **Belegart** zugeordnet
+  * basieren auf:
+    - Kreditor (Leistungserbringer)
+    - Debitor (Rechnungsempfänger)
+  * werden beim nächsten passenden Beleg:
+    - vollständig oder
+    - anteilig berücksichtigt
+----
+===== ⚠️ Betrieb ohne Vorpositions-Generator =====
+CAATS kann auch **ohne Generatorskript** betrieben werden.
+Dies hat jedoch zwei Nachteile:
+  * ❌ Konten sind **nicht aktuell in Echtzeit**
+  * ❌ Vorpositionen entstehen erst beim **Abrechnungslauf**
+<WRAP important>
+Das führt zu:
+  * längeren Abrechnungsläufen
+  * verzögerter Transparenz im Konto
+</WRAP>
+----
+===== 📅 Zeitliche Abgrenzung (Splitting) =====
+Wenn eine **zeitliche Abrechnungstrennung** konfiguriert ist
+(z. B. monatliche Abrechnung bei durchgehenden Einsätzen):
+→ erfolgt das **Splitting bereits auf Vorpositionsebene**
+**Beispiel:**
+  * Einsatz: 20.01. – 10.02.
+  * Abrechnung: monatlich
+→ Vorpositionen:
+  * 20.01. – 31.01.
+  * 01.02. – 10.02.
+<WRAP info>
+Der **Gesamtzeitraum bleibt im Beschreibungstext sichtbar**,
+während die Vorposition selbst korrekt abgegrenzt wird.
+</WRAP>
+----
+<WRAP center round box 75%>
+**❓ Was passiert, wenn …? (Vorpositionen)**
+^ Situation ^ Ursache ^ Maßnahme ^
+| ❌ Keine Vorpositionen | kein Einsatz / Geschäftsfall | Daten prüfen |
+| ⚠️ Vorposition falsch | Leistung falsch definiert | Leistungskatalog prüfen |
+| 🔄 Vorposition ändert sich | Einsatz geändert | erwartetes Verhalten |
+| 🧾 Betrag passt nicht | Splitting aktiv | Zeitraum prüfen |
+| ⏳ Abrechnung dauert lange | kein Generator aktiv | Systemkonfiguration prüfen |
+| 📊 Konto unvollständig | Vorpositionen fehlen | Abrechnungslauf durchführen |
+</WRAP>
+----
+===== 📘 Zusammenfassung =====
+Vorpositionen sind das zentrale Bindeglied zwischen:
+  * **Einsatzplanung**
+  * **Geschäftsfällen**
+  * **Leistungen**
+  * **Abrechnung**
+Sie ermöglichen:
+  * automatisierte Verrechnung
+  * transparente Leistungszuordnung
+  * flexible Anpassung bei Änderungen
+<WRAP important>
+⚠️ Fehler in Einsätzen oder Leistungen wirken sich direkt auf Vorpositionen
+und damit auf die Abrechnung aus.
+</WRAP>