> For the complete documentation index, see [llms.txt](https://docs.solutioo.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.solutioo.de/datanorm-item-import/betrieb-und-fehlerbehebung/logging.md).

# Logging

## Die Ebenen der Protokollierung

Die App protokolliert auf drei Ebenen. Arbeiten Sie sich bei einer Störung von oben nach unten durch.

<table><thead><tr><th width="100">Ebene</th><th width="240">Ort</th><th>Antwortet auf die Frage</th></tr></thead><tbody><tr><td>1</td><td>Importsitzung</td><td>Ist der Import als Ganzes durchgelaufen?</td></tr><tr><td>2</td><td>Staging-Datensatz</td><td>Welcher einzelne Datensatz hat ein Problem, und warum?</td></tr><tr><td>3</td><td>Ergebnismeldungen der Aktionen</td><td>Was hat das Schreiben von Preisen oder Stücklisten bewirkt?</td></tr></tbody></table>

## Ebene 1: Die Importsitzung

Jede Importsitzung hält den Verlauf eines Imports fest.

<table><thead><tr><th width="290">Feld</th><th>Aussage</th></tr></thead><tbody><tr><td><strong>Status</strong></td><td>Ausstehend, In Verarbeitung, Abgeschlossen, Abgeschlossen mit Fehlern, Fehler, Abgebrochen.</td></tr><tr><td><strong>Dateiname</strong></td><td>Welche Datei verarbeitet wurde.</td></tr><tr><td><strong>DATANORM-Version</strong></td><td>Die aus dem Vorlaufsatz erkannte Version.</td></tr><tr><td><strong>Kreditorennr.</strong></td><td>Der zugeordnete Kreditor.</td></tr><tr><td><strong>Verarbeitete Datensätze</strong></td><td>Anzahl gelesener Datensätze.</td></tr><tr><td><strong>Fehlerhafte Datensätze</strong></td><td>Anzahl Zeilen, die nicht gelesen werden konnten.</td></tr><tr><td><strong>Startzeit</strong>, <strong>Endzeit</strong></td><td>Laufzeit des Imports.</td></tr><tr><td><strong>Fehlermeldung</strong></td><td>Ursache, falls die Sitzung abgebrochen wurde.</td></tr></tbody></table>

{% hint style="info" %}
**Abgeschlossen mit Fehlern** bedeutet, dass die Datei verarbeitet wurde, einzelne Zeilen aber nicht gelesen werden konnten. Der Import ist damit nicht wertlos – prüfen Sie im Staging, was fehlt.
{% endhint %}

## Ebene 2: Der Staging-Datensatz

Jeder Datensatz trägt seinen eigenen Status und seine eigene Meldung.

<table><thead><tr><th width="290">Feld</th><th>Aussage</th></tr></thead><tbody><tr><td><strong>Verarbeitungsstatus</strong></td><td>Wo der Datensatz im Ablauf steht.</td></tr><tr><td><strong>Duplikat</strong>, <strong>Duplikatgrund</strong></td><td>Ob und weshalb ein Treffer erkannt wurde.</td></tr><tr><td><strong>Zugeordnete Artikelnr.</strong></td><td>Der vorhandene Artikel, auf den der Treffer verweist.</td></tr><tr><td><strong>Fehlermeldung</strong></td><td>Warum die Synchronisierung fehlgeschlagen ist.</td></tr><tr><td><strong>Zusammengeführte Quellsätze</strong></td><td>Aus wie vielen Dateizeilen der Datensatz entstanden ist.</td></tr></tbody></table>

Filtern Sie im Staging auf **Verarbeitungsstatus = Fehler**, um alle Problemfälle einer Sitzung auf einmal zu sehen.

## Ebene 3: Ergebnismeldungen

Die Aktionen an der Importsitzung melden nach dem Lauf, was sie bewirkt haben.

<table><thead><tr><th width="290">Aktion</th><th>Meldung enthält</th></tr></thead><tbody><tr><td><strong>Einkaufspreisliste schreiben</strong></td><td>Anzahl Einkaufszeilen, Verkaufszeilen, Staffelpreiszeilen und übersprungener Artikel.</td></tr><tr><td><strong>Stücklisten aufbauen</strong></td><td>Anzahl aufgebauter Sets, erzeugter Komponenten, übersprungener Sets und Fehler.</td></tr><tr><td><strong>Kreditor zuordnen</strong></td><td>Anzahl angepasster Staging-Datensätze.</td></tr></tbody></table>

{% hint style="info" %}
Notieren Sie diese Zahlen bei einer Abnahme. Sie sind der schnellste Nachweis, dass ein Import vollständig durchgelaufen ist.
{% endhint %}

## Archivierte Dateien

Ist **Importierte Dateien archivieren** aktiv, bewahrt die App den ursprünglichen Dateiinhalt an der Importsitzung auf. Damit lässt sich später nachvollziehen, was der Lieferant tatsächlich geliefert hat – unabhängig davon, ob die Datei beim Lieferanten noch verfügbar ist.

{% hint style="warning" %}
Lassen Sie die Archivierung aktiv. Sie ist bei einer Klärung mit dem Lieferanten oft der entscheidende Beleg. Sehr große Kataloge belegen entsprechend Speicherplatz – löschen Sie alte Sitzungen bei Bedarf gezielt.
{% endhint %}

## SFTP-Protokollierung

Die SFTP-Einrichtung führt zwei Felder für die Diagnose:

<table><thead><tr><th width="290">Feld</th><th>Aussage</th></tr></thead><tbody><tr><td><strong>Letzte Abfrage</strong></td><td>Wann der Eingangsordner zuletzt geprüft wurde. Ein alter Zeitstempel deutet auf eine nicht laufende Jobwarteschlange.</td></tr><tr><td><strong>Status der letzten Abfrage</strong></td><td>Ergebnis oder Fehlermeldung des letzten Abrufs.</td></tr></tbody></table>

Zusätzlich zeigt **DATANORM SFTP-Dateien**, was im Eingangsordner liegt.

## Vorgehen bei einer Störung

{% stepper %}
{% step %}

#### Sitzung ansehen

Status und Fehlermeldung der Importsitzung lesen. Steht dort ein Abbruchgrund, ist die Ursache meist die Datei selbst.
{% endstep %}

{% step %}

#### Staging filtern

Auf Status **Fehler** filtern und die Fehlermeldungen lesen. Wiederholt sich dieselbe Meldung, liegt es an der Einrichtung, nicht an den Daten.
{% endstep %}

{% step %}

#### Ursache beheben

Fehlende Einheitenzuordnung, Buchungsgruppe oder Nummernserie ergänzen, siehe [Typische Fehlerquellen](/datanorm-item-import/betrieb-und-fehlerbehebung/typische-fehlerquellen.md).
{% endstep %}

{% step %}

#### Erneut synchronisieren

Nur die betroffenen Datensätze erneut synchronisieren. Ein Neuimport der Datei ist fast nie nötig.
{% endstep %}
{% endstepper %}

## Für eine Supportanfrage

Halten Sie diese Angaben bereit:

* Nummer und Status der Importsitzung
* Dateiname und erkannte DATANORM-Version
* Wortlaut der Fehlermeldung
* Anzahl verarbeiteter und fehlerhafter Datensätze
* die betroffene DATANORM-Datei, sofern Sie sie weitergeben dürfen

Kontakte unter [Supportkontakte](/datanorm-item-import/betrieb-und-fehlerbehebung/supportkontakte.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.solutioo.de/datanorm-item-import/betrieb-und-fehlerbehebung/logging.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.