# Status und Gründe
> Die Status einer Datei und die Gründe, aus denen sie nicht gelesen wurde, und was jeweils zu tun ist.
>
> Vorher: [Eine Datei schicken und lesen](https://ocost.io/docs/de/files.md)

Jede Datei hat einen `status`, der sagt, wie weit Ocost mit ihr ist. Eine nicht gelesene Datei hat außerdem einen `reason`. Verzweigen Sie nach beiden.

## Status

| Status | Bedeutung | Was tun |
| --- | --- | --- |
| `received` | Gespeichert, noch nicht gelesen. | Warten. |
| `reading` | Wird gelesen. | Warten. |
| `read` | Gelesen. `documents` listet, was sie enthält. | Ihre Belege lesen. |
| `not_read` | Gespeichert, aber nicht gelesen. | `reason` ansehen. |
| `failed` | Ocost konnte sie nicht lesen. | `reason` ansehen. |
| `needs_company` | Gelesen, aber offen, zu welcher Gesellschaft der Gruppe sie gehört. `candidates` nennt sie. | Mit `business_id` per `PATCH` zuordnen oder warten. Siehe [Unternehmensgruppen](https://ocost.io/docs/de/groups.md). |

> [!NOTE]
> Solange kein Lesedienst antwortet, bleibt eine Datei bei `reading`. Ocost versucht es bis zu einen Tag lang erneut.

## Warten auf die Gesellschaft

Eine Datei vom Schlüssel einer Gruppe wartet als `needs_company`, wenn ihr Beleg mehrere Gesellschaften der Gruppe nennt oder eine andere nur mit Namen. Jeder ihrer `candidates` sagt `why`: eine Kennung auf dem Beleg, `name` oder `home`.

In Ocost antworten der Inhaber oder die Buchhaltung unter Heute › Zuordnen oder in Dateien › Noch nicht zugeordnet. Ocost schlägt den ersten Kandidaten vor, außer er ist `home`. Die Datei zieht dann in diese Gesellschaft um und wird dort gelesen. Eine Datei an die eigene Adresse der Gruppe wartet im Eingang der Gruppe, bis ihre Gesellschaft klar ist. Diesen Eingang erreicht kein Schlüssel. [Unternehmensgruppen](https://ocost.io/docs/de/groups.md#eine-wartende-datei-zuordnen) zeigt dieselbe Antwort per `PATCH`.

## Gründe

| Grund | Bei | Bedeutung |
| --- | --- | --- |
| `limit` | `not_read` | Die Belege des Monats sind aufgebraucht. Ocost liest die Datei am `renews_on` von selbst. |
| `model_off` | `not_read` | Für dieses Unternehmen werden PDFs und Bilder nicht gelesen. E-Rechnungen werden weiter gelesen. Sobald sie gelesen werden, schicken Sie dieselben Bytes erneut. |
| `nothing_found` | `not_read` | Die Datei enthält keinen Beleg. |
| `too_large` | `not_read` | Zu viele Seiten oder ein zu großes Bild. |
| `damaged` | `failed` | Keine Datei, die Ocost öffnen kann. |
| `unavailable` | `failed` | Einen Tag lang antwortete kein Lesedienst. Schicken Sie dieselben Bytes erneut, um es nochmals zu versuchen. |
| `failed` | `failed` | Das Lesen schlug fehl oder wurde abgelehnt. Ein fehlgeschlagenes Lesen versucht Ocost 10 und 60 Minuten später erneut. Schicken Sie dieselben Bytes erneut, um es früher zu versuchen. |
| `other` | beide | Ein Grund, den diese Version der API noch nicht benennt. |

## Erneut schicken

Dieselben Bytes erneut ergeben dieselbe Datei, mit derselben `id`. Ocost zählt sie einmal. Bei drei Gründen liest Ocost die Datei aus den gespeicherten Bytes erneut, und sie wird `reading`:

| Grund | Erneut gelesen |
| --- | --- |
| `unavailable` | Jedes Mal, wenn Sie sie schicken. |
| `failed` | Jedes Mal, wenn Sie sie schicken, ab einer Minute nach dem Fehlschlag. Eine Datei, die das Modell abgelehnt hat, einmal. |
| `model_off` | Sobald das Unternehmen ein Lesemodell hat. |

Bei jedem anderen Grund ändert erneutes Schicken nichts. Löschen Sie eine Datei nicht, um sie erneut zu schicken: Eine neue Datei wird erneut gezählt. Eine gelesene Datei behält ihr Ergebnis, wenn Ocosts Leser besser wird. Nur „Erneut lesen“ in Dateien liest sie neu.

## Ein Beispiel

Eine Datei, geschickt, nachdem die Belege des Monats aufgebraucht waren:

```json
{
  "id": "01a1b08c-6e3a-7562-8f4a-7924722667b1",
  "name": "invoice.pdf",
  "status": "not_read",
  "reason": "limit",
  "renews_on": "2026-12-01",
  "documents": []
}
```

Ocost liest sie am 1. Dezember, oder früher, sobald der Tarif wächst. Fragen Sie weiter ab oder [bleiben Sie synchron](https://ocost.io/docs/de/sync.md), dann taucht sie als `read` auf.

## Lange Dateien

Ocost liest nur die ersten Seiten eines langen PDFs. `pages` zählt die Seiten der Datei, und `pages_read` sagt, wie viele gelesen wurden. `pages_read` ist `null`, wenn Ocost alle gelesen hat.

## Siehe auch

- [Eine Datei schicken und lesen](https://ocost.io/docs/de/files.md): Eine Datei schicken, sicher erneut schicken, warten, bis sie gelesen ist, ihre Belege lesen, das Original holen, sie löschen.
- [Grenzen und Fehler](https://ocost.io/docs/de/limits.md): Die Belege des Tarifs im Monat, Ratenlimits, Größen, Fehler nach RFC 9457, Wiederholen und wo die Daten liegen.
- [Unternehmensgruppen](https://ocost.io/docs/de/groups.md): Unternehmensgruppen: welche Gesellschaften ein Schlüssel erreicht, der Header Ocost-Business, das Umleiten nach den Kennungen des Belegs, needs_company und Dateien in der Gruppe.
