====== Schnittstelle 2012 – Normal-Warengruppen importieren ======

Die Schnittstelle **2012** pflegt ''KRWarenGruppenNormal'' aus einer Datei. Vorhandene IDs erhalten eine neue ''Bezeichnung''; fehlende IDs werden angelegt. ''KRWarenGruppen'' und ''Umsätze'' werden nicht unmittelbar geändert.

===== Eingabedatei =====

''PFAD'' muss eine vorhandene Datei bezeichnen. Der Parser liest UTF-8, Semikolon, gekürzten Rand-Leerraum und eingeschlossene Anführungszeichen. Es gibt keinen ausdrücklichen Header-Skip; eine nichtnumerische erste Spalte wird still übersprungen. Mindestens zwei Felder sind nötig, weitere ab Position 3 werden ignoriert. Die Datei bleibt am Ursprungsort.

^ Position ^ Zielfeld ^ Verarbeitung ^
| 1 | ''KRWarenGruppenNormal.ID'' | Numerische Vorprüfung und ''CLng''; Match und INSERT. |
| 2 | ''KRWarenGruppenNormal.Bezeichnung'' | Maximal 50 Zeichen; leer bleibt Leerstring. |

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

Ein parametriertes ''IF EXISTS/UPDATE/INSERT'' vergleicht ''ID''. Bei Treffer wird nur ''Bezeichnung'' aktualisiert, sonst werden ''ID'' und ''Bezeichnung'' eingefügt. Es gibt keine fachliche Stored Procedure, keinen DELETE und keinen automatischen Bezug auf ''KRWarenGruppen.KRWarenGruppenNormal''. Die Datenbank-Fremdschlüsselbeziehung löst hier keine Kaskade aus, weil weder Schlüssel geändert noch Zeilen gelöscht werden.

Jede Zeile wird einzeln verarbeitet; ohne Gesamttransaktion bleiben frühere Änderungen nach einem späteren Fehler bestehen. Eine erneute Zeile derselben ID kann die Bezeichnung erneut überschreiben. Parserfehler können den Rest stoppen; Konvertierungs- oder SQL-Fehler einer Zeile können protokolliert und mit der nächsten Zeile fortgesetzt werden.

===== 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 | ''2012'' / ''ImpKRWarenGruppeNormal'' |
| Einstieg | ''cSchnittKRWarenGruppenNormal.Import'' |
| Fachlicher Ausgang | ''KRWarenGruppenNormal.ID'', ''Bezeichnung''; UPDATE oder INSERT |
| Fachliches SQL | Parametriertes Inline-SQL; keine fachliche SP |

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

  * [[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.