====== Schnittstelle 1100: Zusatzleistung aus Aprocon ====== Diese technische Referenz beschreibt die Eingänge, Ausgänge und aktiven Codepfade von **Zusatzleistung aus Aprocon**. Sie ist keine Anleitung zur ungeprüften Ausführung. Stand: **02.10.2026**, Desktop-Commit ''f1d82a003b62f2658f06eaa943dc685ab219bdf3''. Statisch dokumentiert; Nutzerprüfung offen. Kein Import, Datenbank- oder HTTP-Test. Dokumentiert / statisch geprüft: **2026-10-02**. Statisch dokumentiert; Nutzerprüfung offen. Keine Schnittstelle ausgeführt. ===== Identität und Quellenstand ===== ''eProgramm.ImpZusatzleistungApc = 1100''. Aktive feste Registrierung → ''cSchnittZusatzleistungAprocon.Ausführen''; Projekteinschluss bestätigt (E,P,PRJ). Active=True, InAutomatik=True und ManuellerAufruf=True (Registrierung bzw. Klassendefault); NurAufServer=True. Keine Aussage über eingerichtete Automatik oder produktive Nutzung. ===== Zweck und Ablauf ===== Aprocon-Statistik über ODBC → Personenmapping → ''Zusatzleistung''. Keine Datei, keine SP. Nach Verbindungstest lädt der Import Personen.PersonID/KundenNummer mit KundenNummer>0, löscht Leistungen ab Datum und fügt passende Statistikzeilen ein. ===== Parameter und Eingangsvertrag ===== ^ Parameter ^ Dialog ^ Vorgabe ^ Tatsächliche Prüfung ^ | DATUM | Datum | keine | IsDate geprüft, lokale Variable Datum erhält den Wert **nicht** | SELECT filtert Datenquelle=2, UmsatzArtProdukt=1, UmsatzArtKunde=1 und Kunden aus dem Mapping. Datum>=lokales Datum. Doppelte Kundennummern: erste Person bleibt; leeres Mapping erzeugt SQL-IN(). Menge=GewichtSoll+MengeSoll; Preis=UmsatzSoll. Externe Typen/Einheiten sind Q13. ===== Schreibverhalten und Befunde ===== **1100-F01:** Datum bleibt DateTime.MinValue, auch für SqlDbType.DateTime (außerhalb SQL-datetime). Der Parameter steuert den Import deshalb nicht zuverlässig; Beziehungen sind versuchte, datumabhängige Wirkungen, kein Erfolg. Fehler können vor der Neubefüllung auftreten. Keine Transaktion/Archivierung. ODBC-Timeout0, SQL-Standard30s. LEGACY-Rückmeldung, kein BASE-Mail/API. U116: ID Identity, PersonID/Datum/Artikel/Menge/Preis NOT NULL. Test: Parameterübernahme, leeres/mehrdeutiges Mapping und Wiederholung isoliert prüfen. ===== Systemeinstellungen und gemeinsame Nebenwirkungen ===== Gemeinsames Profil: LEGACY (interne Referenz). ^ Beziehung ^ Schlüssel / Variable ^ Default ^ Einflussweg ^ Wirkung ^ Beleg ^ | 1100-S001 | ''SCHNITT_APC_DSN'' / ''SCHNITT_AproconDSN'' | leer | ODBC-Eingang | Verbindung zum externen Aprocon-DSN; kein DSN-Wert gespeichert | B,SET | Nur belegte Profilzuordnung; Fachdaten und Rückmeldung sind nicht atomar. Defaults sind keine Livewerte. ===== Feldbeziehungen ===== Unqualifizierte Fachobjekte in der Anmeldedatenbank; ''Import.dbo'' ausdrücklich Importdatenbank. Dateifelder stehen separat im Dateivertrag. ^ Beziehung ^ Tabelle.Feld ^ Operation ^ Datenfluss / Verwendung ^ Bedingung ^ Beleg ^ | 1100-D001 | ''Personen.PersonID'' | SELECT | KundenNummer>0; erste Person je Kunde | Aktiver Pfad; kein Laufzeitnachweis | B | | 1100-D002 | ''Personen.KundenNummer'' | SELECT | KundenNummer>0; erste Person je Kunde | Aktiver Pfad; kein Laufzeitnachweis | B | | 1100-D003 | ''Aprocon.Statistik.Datum'' | SELECT | Gefilterter ODBC-Eingang; Datumvariable nicht gesetzt | Aktiver Pfad; kein Laufzeitnachweis | B | | 1100-D004 | ''Aprocon.Statistik.ReferenzKunde'' | SELECT | Gefilterter ODBC-Eingang; Datumvariable nicht gesetzt | Aktiver Pfad; kein Laufzeitnachweis | B | | 1100-D005 | ''Aprocon.Statistik.ReferenzProdukt'' | SELECT | Gefilterter ODBC-Eingang; Datumvariable nicht gesetzt | Aktiver Pfad; kein Laufzeitnachweis | B | | 1100-D006 | ''Aprocon.Statistik.UmsatzSoll'' | SELECT | Gefilterter ODBC-Eingang; Datumvariable nicht gesetzt | Aktiver Pfad; kein Laufzeitnachweis | B | | 1100-D007 | ''Aprocon.Statistik.MengeSoll'' | SELECT | Gefilterter ODBC-Eingang; Datumvariable nicht gesetzt | Aktiver Pfad; kein Laufzeitnachweis | B | | 1100-D008 | ''Aprocon.Statistik.GewichtSoll'' | SELECT | Gefilterter ODBC-Eingang; Datumvariable nicht gesetzt | Aktiver Pfad; kein Laufzeitnachweis | B | | 1100-D009 | ''Aprocon.Statistik.Datenquelle'' | SELECT | Gefilterter ODBC-Eingang; Datumvariable nicht gesetzt | Aktiver Pfad; kein Laufzeitnachweis | B | | 1100-D010 | ''Aprocon.Statistik.UmsatzArtProdukt'' | SELECT | Gefilterter ODBC-Eingang; Datumvariable nicht gesetzt | Aktiver Pfad; kein Laufzeitnachweis | B | | 1100-D011 | ''Aprocon.Statistik.UmsatzArtKunde'' | SELECT | Gefilterter ODBC-Eingang; Datumvariable nicht gesetzt | Aktiver Pfad; kein Laufzeitnachweis | B | | 1100-D012 | ''Zusatzleistung.— Zeilen'' | DELETE | Datum>=lokales Datum | Versucht; MinValue-Befund | B | | 1100-D013 | ''Zusatzleistung.PersonID'' | INSERT | PersonID aus Mapping | Versucht nach DELETE; keine Transaktion | B | | 1100-D014 | ''Zusatzleistung.Datum'' | INSERT | Statistik.Datum | Versucht nach DELETE; keine Transaktion | B | | 1100-D015 | ''Zusatzleistung.Artikel'' | INSERT | ReferenzProdukt | Versucht nach DELETE; keine Transaktion | B | | 1100-D016 | ''Zusatzleistung.Menge'' | INSERT | GewichtSoll+MengeSoll | Versucht nach DELETE; keine Transaktion | B | | 1100-D017 | ''Zusatzleistung.Preis'' | INSERT | UmsatzSoll | Versucht nach DELETE; keine Transaktion | B | | 1100-D018 | ''Zusatzleistung.ID'' | IDENTITY | DB erzeugt ID | INSERT erreicht | U116 | ===== Teststatus und Pflege ===== Keine Laufzeit-/Live-Schema-/Lieferformat-Abnahme. Fachbefunde und Grenzen siehe oben und Fragen (interne Referenz); kundenspezifische Trigger/Constraints, DLLs und Jobs bleiben Q02. Nutzerprüfung offen. [[schnittstellen:schnittstellen|Schnittstellenübersicht]] ===== Gemeinsame Rückmeldung ===== Direkte Dialog-/Info-/Logpfade, kein cSchnitt_Basis-Mail/API/Outbox. GLOBAL_LOGLEVEL (Default50) und GLOBAL_LOGLEVELEVLOG (Default0, VB GLOBAL_LOGLEVELEVENTLOG) steuern Datei-/DB-/Eventlogging; Details der Fachfehler stehen oben. Keine Livewerte dokumentiert. ===== Quellen je Datei ===== Repository: seegerstefan/pep4desktop, master, obiger Commit. Je Datei ein Quellenlink; Kürzel in den Tabellen. Private Git-Quellen setzen Zugriffsrechte voraus. ^ Kürzel ^ Quelldatei am geprüften Commit ^ | E | [[https://github.com/seegerstefan/pep4desktop/blob/f1d82a003b62f2658f06eaa943dc685ab219bdf3/PEP4/ZW/Allgemein.vb|PEP4/ZW/Allgemein.vb]] | | P | [[https://github.com/seegerstefan/pep4desktop/blob/f1d82a003b62f2658f06eaa943dc685ab219bdf3/PEP4/cSchnittstellen/Programme/cProgramme.vb|PEP4/cSchnittstellen/Programme/cProgramme.vb]] | | PRJ | [[https://github.com/seegerstefan/pep4desktop/blob/f1d82a003b62f2658f06eaa943dc685ab219bdf3/PEP4/cSchnittstellen/cSchnittstellen.vbproj|PEP4/cSchnittstellen/cSchnittstellen.vbproj]] | | SET | [[https://github.com/seegerstefan/pep4desktop/blob/f1d82a003b62f2658f06eaa943dc685ab219bdf3/PEP4/ZW/Einstellungen/cEinstellungenZw.vb|PEP4/ZW/Einstellungen/cEinstellungenZw.vb]] | | B | [[https://github.com/seegerstefan/pep4desktop/blob/f1d82a003b62f2658f06eaa943dc685ab219bdf3/PEP4/cSchnittstellen/Programme/Schnittstellen/Aprocon/cSchnittZusatzleistungAprocon.vb|PEP4/cSchnittstellen/Programme/Schnittstellen/Aprocon/cSchnittZusatzleistungAprocon.vb]] | | U116 | [[https://github.com/seegerstefan/pep4desktop/blob/f1d82a003b62f2658f06eaa943dc685ab219bdf3/Sqlfiles/PEP4Update/update_0116.sql|Sqlfiles/PEP4Update/update_0116.sql]] | ===== Offene Abnahme ===== Externe Liefer-/API-Verträge und installierte Migrationen sind nicht bestätigt. Vor einem Test die beschriebenen Datenrisiken in einer isolierten Umgebung klären. Bei1214/1215 sind weitere Calc-/CalcPep-Feldwirkungen ausdrücklich noch nicht vollständig analysiert. [[schnittstellen:schnittstellen|Übersicht aller Schnittstellen]]