====== Schnittstelle 1012 – Umsatzwerte ab einem Datum zurückstellen ======

Das Programm **1012** setzt fünf Werte in bereits vorhandenen ''Umsätze''-Zeilen auf 0: ''Ist'', ''IstNetto'', ''SollUmsatzBrutto'', ''SollUmsatzNetto'' und ''Kunden''. Es lädt keine neuen Daten aus Aprocon, obwohl der Enum-Name das nahelegen kann.

<WRAP center round important 100%>
Der Lauf hat keine obere Datums-, Gruppen-, Filial- oder Herkunftsgrenze. Ab dem gewählten Datum können alle vorhandenen Umsatzzeilen betroffen sein. Es gibt keine automatische Wiederherstellung der vorherigen Werte.
</WRAP>

===== Parameter und Ablauf =====

''DATUM'' ist die einschließlich geltende Untergrenze; in der Registrierung ist kein Standardwert vorgegeben. PEP4 wertet absolute deutsche Datumsangaben, Tagesversätze und Datumsmuster aus. Einige Quartalsmuster sind im untersuchten Code fehlerhaft; prüfe das tatsächlich aufgelöste Datum vor dem Start. Es gibt keine Eingangs- oder Ausgangsdatei.

Ein parametriertes SQL-''UPDATE'' setzt die fünf genannten Spalten auf 0. Es werden keine Zeilen eingefügt oder gelöscht und keine fachliche Stored Procedure aufgerufen. Bei Wiederholung bleiben die Werte 0; die Zahl geänderter Zeilen wird durch den Basisabschluss nicht belegt.

===== Einstellungen und Fixierung =====

^ Einstellung ^ Code-Default ^ Wirkung ^
| ''SCHNITT_KR_UmsatzFixedBeachten'' | ''True'' | Bei ''True'' werden nur Zeilen mit ''IstFixed=0'' geändert; NULL erfüllt die Bedingung nicht. Bei ''False'' können auch fixierte Zeilen zurückgesetzt werden. |
| ''GLOBAL_LOGLEVEL'', ''GLOBAL_LOGLEVELEVLOG'' | 50, 0 | Steuern Protokolle, nicht die fünf Umsatzwerte. |

Die gemeinsame ''cSchnitt_Basis'' kann abhängig von ''MANUELL'', ''SILENT'' und den Einstellungen ''MAIL_SCHNITTSTELLEONSUCCESS'', ''MAIL_SCHNITTSTELLEONERROR'', ''SCHNITT_MELDUNG_SchnittstelleOnSuccess'' und ''SCHNITT_MELDUNG_SchnittstelleOnError'' Mail-/API-Rückmeldungen auslösen. Empfänger und Versand hängen zusätzlich von ''MAIL_SCHNITTSTELLETO'', ''MAIL_SMTP_SERVER'', ''MAIL_USER'', ''MAIL_PASS'', ''MAIL_USEDEFAULTCREDENTIALS'', ''MAIL_SSL'', ''MAIL_TESTADRESSE'', ''MAIL_FROM'' und ''MAIL_FROM_NAME'' ab. Diese Einstellungen ändern keine fachlichen Umsatzwerte. ''SQL_TIMEOUT'' wird für diesen Fachbefehl nicht ausdrücklich gesetzt.

===== Ergebnis und Grenzen =====

Prüfe nach dem Lauf ''Umsätze.Datum'', ''IstFixed'' und die fünf Zielspalten. Der Filter endet nicht an einem bestimmten Tag. Ein ungültiges Datum kann bereits vor dem lokalen Fehler-Catch scheitern. Eine Erfolgsmeldung nennt nicht die Anzahl betroffener Zeilen.

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

^ Merkmal ^ Wert ^
| Programmkennung | ''1012'' / ''ImpUmsatzAproconRückstellungIstIstNettoSollKunden'' |
| Einstieg | ''cSchnittKRApc.RückstellungIstIstNettoSollKunden'' |
| Eingang | ''DATUM'' und vorhandene ''Umsätze''-Zeilen |
| Ausgang | UPDATE der fünf Zielspalten; kein INSERT/DELETE |
| Fachliches SQL | Parametriertes Inline-UPDATE; keine fachliche SP |

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

  * [[schnittstellen:1013|Nur Ist und IstNetto zurückstellen (1013)]]
  * [[schnittstellen:schnittstellen|Übersicht der dokumentierten Schnittstellen]]

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

Am 25.09.2026 aus der statischen Analyse des Quellcommits ''f1d82a003b62f2658f06eaa943dc685ab219bdf3'' übernommen. Die Analyse wurde am 18.09.2026 erstellt; kein Lauf oder produktiver Datenbankstand bestätigt.