# Manual-Import und Delta-Stand

Stand: 2026-05-21

Diese Datei beschreibt, wie manuelle Excel-/CSV-Importe aktuell behandelt werden und wie neue Eintraege bzw. Delta-Dateien verarbeitet werden.

## Uebersicht

| Land / Standort | Quelle aktuell | Dateityp | Neue Eintraege / Deltas | Wie die App auswaehlt | Was beim Standortexport passiert | Finance-Wert |
| --- | --- | --- | --- | --- | --- | --- |
| UK / England `TRUK` | SharePoint-Ordner `Import/Finance/UK_B1` | Sage Excel `.xlsx` | Delta-faehig | Bei Jahreslauf: Jahresdatei fuer `TRUK` plus spaetere datierte Dateien `ddMMyy_TRUK.xlsx` oder `.csv` | Alle gefundenen Dateien werden gelesen und zusammen in `CentralSalesRecords` fuer `TRUK` ersetzt | `Sales Price/Value * Quantity`, Credit Notes negativ, GBP |
| Spanien `TRSE` / `TRES` | SharePoint-Datei oder Ordner / Sage CSV | `.csv` | Vollfile erforderlich, keine Deltas | Wenn Ordner: neueste passende Vollfile-Datei nach TSC/Datum | Datei wird gelesen, Standortdaten werden ersetzt | Sage `ImporteNeto`, REC/Abono/Credit negativ, EUR |
| Deutschland `TRDE` | Alphaplan Excel | `.xlsx` | Vollfile/Jahresfile erforderlich, keine Deltas | Pfad/Datei am Standort hinterlegt | Datei wird gelesen, DE-Zeilen ersetzen bisherigen DE-Stand | `NettoPreisGesamtX`, Finance-Regeln: Ausschluesse, GS negativ, 2025-Zwang |
| CH/AT `ZSCHWEIZ` | SAP OData | OData | Kein manueller Delta-Excel-Prozess | App liest SAP-Service | ZSCHWEIZ-Zeilen ersetzen bisherigen Stand | `NetwrHc`, CHF/EUR nach Land |
| FR / IT / US | HANA / SAP B1 | direkte DB | Kein manueller Delta-Excel-Prozess | App liest HANA nach Datum/Schema | Standortdaten werden neu aus HANA aufgebaut | B1 Positions-Netto, Credit Notes negativ |
| IN | HANA / Sage | direkte DB | Kein manueller Delta-Excel-Prozess | App liest HANA/Sage | Standortdaten werden neu aus Quelle aufgebaut | Hauswaehrung INR |

## UK / England Delta-Mechanik

UK ist aktuell am besten fuer laufende Delta-Lieferungen vorbereitet.

| Punkt | Aktuelle Logik |
| --- | --- |
| Standort | `England`, `TSC = TRUK`, `SourceSystem = MANUAL_EXCEL` |
| SharePoint-Ordner | `Import/Finance/UK_B1` |
| Basisdatei | Jahresdatei im SharePoint-Ordner, z. B. mit Jahr `2025` im Namen |
| Delta-Dateien | Datierte Dateien wie `010526_TRUK.xlsx` oder `010526_TRUK.csv` |
| Auswahl | Jahresdatei zuerst, danach alle spaeteren Delta-Dateien im gleichen Jahr |
| Import | App liest alle ausgewaehlten Dateien in einem Lauf zusammen |
| Persistenz | `CentralSalesRecords` fuer `TRUK` werden ersetzt, nicht blind additiv angehaengt |
| Nach Delta-Lieferung | Delta-Datei in den Ordner legen, `TRUK` exportieren, danach zentrale Excel neu erzeugen |

Wichtig:

- Der Ordnername `UK_B1` ist nur technisch/historisch. Fachlich ist UK Sage, nicht SAP B1.
- UK nutzt grafisches Manual-Excel-Mapping.
- Der Finance-Wert wird aus `Sales Price/Value * Quantity` gebildet.
- Credit Notes werden anhand erkennbarer Sage-Typen negativ gesetzt.

## Spanien

Spanien nutzt technisch ebenfalls `MANUAL_EXCEL`, fachlich aber Sage CSV.

Aktueller Implementierungsstand:

- Datei/Ordner kann ueber SharePoint oder lokal hinterlegt werden.
- Bei SharePoint-Ordnern wird die neueste passende Datei nach TSC/Datum ausgewaehlt.
- Spanien muss immer den kompletten relevanten Datenstand liefern.
- Delta-Dateien sind fuer Spanien nicht vorgesehen.
- Praktisch gilt Spanien deshalb als Vollfile-Import.
- Beim Standortexport ersetzt die App den bisherigen Spanien-Stand in `CentralSalesRecords`.
- Wenn versehentlich nur eine Delta-Datei als neueste Datei im Ordner liegt oder direkt als Pfad hinterlegt wird, wuerde die App technisch nur dieses Delta lesen und damit den bisherigen Spanien-Stand ersetzen.
- Es gibt aktuell keine explizite Sperre, die eine Spanien-Delta-Datei erkennt und ablehnt.

Finance-Logik:

- `SalesPriceValue = ImporteNeto`
- `REC`, Abono bzw. Credit-Faelle werden negativ.
- Waehrung ist EUR.

## Deutschland

Deutschland nutzt Alphaplan Excel.

Aktueller Implementierungsstand:

- Standort `TRDE` ist als `MANUAL_EXCEL` vorbereitet.
- Quelle ist ein Jahres-/Vollfile, aktuell fuer 2025.
- Finance-Regeln erzwingen DE fachlich auf 2025.
- Deutschland muss immer den kompletten relevanten Datenstand liefern.
- Delta-Dateien sind fuer Deutschland nicht vorgesehen.
- Beim Standortexport ersetzt die App den bisherigen Deutschland-Stand in `CentralSalesRecords`.
- Wenn versehentlich nur eine Delta-Datei als Pfad hinterlegt wird, wuerde die App technisch nur dieses Delta lesen und damit den bisherigen Deutschland-Stand ersetzen.
- Es gibt aktuell keine explizite Sperre, die eine Deutschland-Delta-Datei erkennt und ablehnt.

Finance-Logik:

- `SalesPriceValue = NettoPreisGesamtX`
- Ausschluesse gemaess Finance-Regeln:
  - `CustomerName = Trafag AG`
  - `CustomerName contains Magnetic Sense`
  - `InvoiceNumber = GS2510095`
- `InvoiceNumber starts with GS` wird negativ gerechnet.

Offen:

- Finance/Munir muss bestaetigen, welche Kundenlaender und Filter fuer den offiziellen DE-Istwert gelten.

## Praktische Bedienreihenfolge

1. Neue Datei oder Delta-Datei im richtigen Ordner bereitstellen.
2. In `Manuelle Importe` Pfad pruefen bzw. Standort aktiv lassen.
3. Standortexport fuer das betroffene Land ausfuehren.
4. Danach `Zentrale Datei neu erzeugen` starten.
5. Im zentralen Excel `Finance Summary` und `Finance Details` pruefen.

## Merksatz

Manual-Importe ersetzen pro Standort den aktuellen Stand in `CentralSalesRecords`. Delta-Dateien muessen daher beim Import zusammen mit der passenden Basisdatei gelesen werden. Das ist aktuell nur fuer UK vorgesehen. Spanien und Deutschland muessen immer Vollfiles liefern.

Wichtig: Fuer Spanien und Deutschland ist das fachlich/prozessual so vorgesehen und durch den Ersetzungsmechanismus praktisch erforderlich. Eine technische Validierung, die Delta-Dateien fuer ES/DE aktiv blockiert, ist aktuell noch nicht eingebaut.