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

StatusBedeutungWas tun
receivedGespeichert, noch nicht gelesen.Warten.
readingWird gelesen.Warten.
readGelesen. documents listet, was sie enthält.Ihre Belege lesen.
not_readGespeichert, aber nicht gelesen.reason ansehen.
failedOcost konnte sie nicht lesen.reason ansehen.
needs_companyGelesen, 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

GrundBeiBedeutung
limitnot_readDie Belege des Monats sind aufgebraucht. Ocost liest die Datei am renews_on von selbst.
model_offnot_readFür dieses Unternehmen werden PDFs und Bilder nicht gelesen. E-Rechnungen werden weiter gelesen. Sobald sie gelesen werden, schicken Sie dieselben Bytes erneut.
nothing_foundnot_readDie Datei enthält keinen Beleg.
too_largenot_readZu viele Seiten oder ein zu großes Bild.
damagedfailedKeine Datei, die Ocost öffnen kann.
unavailablefailedEinen Tag lang antwortete kein Lesedienst. Schicken Sie dieselben Bytes erneut, um es nochmals zu versuchen.
failedfailedDas 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.
otherbeideEin 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:

GrundErneut gelesen
unavailableJedes Mal, wenn Sie sie schicken.
failedJedes Mal, wenn Sie sie schicken, ab einer Minute nach dem Fehlschlag. Eine Datei, die das Modell abgelehnt hat, einmal.
model_offSobald 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, 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