Status und Gründe
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. |
Hinweis
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 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:
{
"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, 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.