====== Schnittstelle 1059 – Anteile für Kostenstellenobjekte importieren ======

Die Schnittstelle **1059** fügt neue Anteile in ''KRKostenstellenObjekteAnteil'' ein. Ein vorhandener Anteil wird nicht aktualisiert. Es gibt keine direkte Änderung von ''Umsätze''.

===== Eingabedatei =====

''PFAD'' muss auf eine vorhandene Datei zeigen. Der Parser liest UTF-8, Semikolon, Rand-Leerraumkürzung und eingeschlossene Anführungszeichen. Eine Kopfzeile wird nicht ausdrücklich übersprungen. Mindestens **vier** Felder sind fachlich nötig; die äußere Prüfung verlangt fälschlich nur zwei. Weitere Felder werden ignoriert; kein Archiv.

^ Position ^ Zielfeld ^ Verarbeitung ^
| 1 | ''KRKostenKonto'' | Konto-ID; numerische Vorprüfung nur hier. |
| 2 | ''KRDatenquelle'' | Datenquellen-ID. |
| 3 | ''KRKostenstellenObjekt'' | Objekt-ID. |
| 4 | ''Anteil'' | Wert unverändert, ohne Prozentumrechnung oder Summenprüfung. |

Die Routine bindet alle Werte als SQL-''Float''; die Schlüssel sind im Schema ''bigint''. Fehlende Felder erhalten keinen automatischen Default. Der Datenbank-Default 0 für ''Anteil'' hilft nicht, weil der Parameter explizit gebunden wird.

===== Datenfluss und Ergebnis =====

''IF NOT EXISTS'' prüft Konto, Datenquelle und Kostenstellenobjekt. Fehlt die Kombination, schreibt ein INSERT diese drei Schlüssel und ''Anteil''. Es gibt keinen UPDATE, DELETE oder fachlichen SP-Aufruf. Konto/Datenquelle und Kostenstellenobjekt werden im untersuchten Schema über Fremdschlüssel geprüft. Die Datei bleibt unverändert.

Wiederholung ändert vorhandene Anteile nicht. Ein doppelter Schlüssel in der Datei führt höchstens beim ersten erfolgreichen Satz zur Anlage. Ohne Gesamttransaktion können frühere Inserts nach einem späteren Fehler bestehen bleiben; die getrennte Existenzprüfung schützt nicht vor parallelen Einfügungen.

===== Einstellungen =====

Keine direkte fachliche ZW-Einstellung; ''SQL_TIMEOUT'' wird nicht ausdrücklich gesetzt. Die gemeinsame Basis verwendet bedingt ''GLOBAL_LOGLEVEL'', ''GLOBAL_LOGLEVELEVLOG'', ''MAIL_SCHNITTSTELLEONSUCCESS'', ''MAIL_SCHNITTSTELLEONERROR'', ''SCHNITT_MELDUNG_SchnittstelleOnSuccess'', ''SCHNITT_MELDUNG_SchnittstelleOnError'' und beim Versand ''MAIL_SCHNITTSTELLETO'', ''MAIL_SMTP_SERVER'', ''MAIL_USER'', ''MAIL_PASS'', ''MAIL_USEDEFAULTCREDENTIALS'', ''MAIL_SSL'', ''MAIL_TESTADRESSE'', ''MAIL_FROM'' und ''MAIL_FROM_NAME''. ''MANUELL'', ''SILENT'' und ''MAILTO'' sind Laufparameter.

===== Technische Referenz =====

^ Merkmal ^ Wert ^
| Programmkennung | ''1059'' / ''ImpKRAnteilKostenstellenObjekte'' |
| Einstieg | ''cSchnittKRAnteil.Import_AnteilKostenstellenObjekte'' |
| Fachlicher Ausgang | ''KRKostenstellenObjekteAnteil''; nur INSERT neuer Kombinationen |
| Fachliches SQL | Direkte Existenzprüfung und INSERT; keine fachliche SP |

===== Siehe auch =====

  * [[schnittstellen:1058|Kostenkonten-Anteile (1058)]]
  * [[schnittstellen:schnittstellen|Übersicht der dokumentierten Schnittstellen]]

===== Prüfstand =====

Am 25.09.2026 aus der statischen Analyse des Quellcommits ''f1d82a003b62f2658f06eaa943dc685ab219bdf3'' übernommen. Analyse vom 18.09.2026; kein Importlauf oder produktiver Schemaabgleich bestätigt.