Statusy i powody

Każdy plik ma status, który mówi, jak daleko Ocost z nim doszedł. Plik, którego nie odczytano, ma też reason. Rozgałęziaj logikę według obu.

Statusy

StatusZnaczenieCo zrobić
receivedZapisany, jeszcze nieodczytany.Poczekaj.
readingW trakcie odczytu.Poczekaj.
readOdczytany. documents wymienia, co zawiera.Odczytaj jego dokumenty.
not_readZapisany, ale nieodczytany.Sprawdź reason.
failedOcost nie mógł go odczytać.Sprawdź reason.
needs_companyOdczytany, ale nie wiadomo, do której spółki grupy należy. candidates je wymienia.PATCH z business_id albo czekaj. Zobacz Grupy spółek.

Uwaga

Dopóki żadna usługa odczytu nie odpowiada, plik pozostaje w reading. Ocost próbuje ponownie przez maksymalnie dobę.

Oczekiwanie na spółkę

Plik wysłany kluczem grupy czeka jako needs_company, gdy jego dokument wskazuje kilka spółek grupy albo inną spółkę tylko z nazwy. Każdy z jego candidates podaje why: identyfikator wydrukowany na dokumencie, name lub home.

W Ocost odpowiada właściciel lub księgowy w Dziś › Przypisz albo w Pliki › Jeszcze nieprzypisane. Ocost proponuje pierwszego kandydata, chyba że jest nim home. Plik przenosi się wtedy do tej spółki i tam jest odczytywany. Plik wysłany pocztą na własny adres grupy czeka w skrzynce grupy, aż jego spółka będzie jasna. Żaden klucz nie sięga tej skrzynki. Grupy spółek pokazuje tę samą odpowiedź przez PATCH.

Powody

PowódPrzyZnaczenie
limitnot_readDokumenty na ten miesiąc się wyczerpały. Ocost sam odczyta plik w dniu renews_on.
model_offnot_readTa firma nie ma włączonego odczytu plików PDF i obrazów. E-faktury są nadal odczytywane. Gdy odczyt zostanie włączony, wyślij te same bajty ponownie.
nothing_foundnot_readPlik nie zawiera żadnego dokumentu.
too_largenot_readZa dużo stron albo za duży obraz.
damagedfailedTo nie jest plik, który Ocost potrafi otworzyć.
unavailablefailedŻadna usługa odczytu nie odpowiedziała przez dobę. Wyślij te same bajty ponownie, aby spróbować jeszcze raz.
failedfailedOdczyt się nie powiódł lub został odrzucony. Ocost ponawia nieudany odczyt po 10 i po 60 minutach. Wyślij te same bajty ponownie, aby spróbować wcześniej.
otherobaPowód, którego ta wersja API jeszcze nie nazywa.

Ponowne wysłanie

Ponowne wysłanie tych samych bajtów zwraca ten sam plik, z tym samym id. Ocost liczy go raz. Z trzech powodów odczytuje plik ponownie z przechowywanych bajtów, a plik przechodzi w reading:

PowódPonowny odczyt
unavailablePrzy każdym wysłaniu.
failedPrzy każdym wysłaniu, od minuty po niepowodzeniu. Plik odrzucony przez model jest odczytywany ponownie raz.
model_offGdy firma ma model do odczytu.

Przy każdym innym powodzie ponowne wysłanie niczego nie zmienia. Nie usuwaj pliku, aby wysłać go ponownie: nowy plik zostanie policzony jeszcze raz. Odczytany plik zachowuje swój odczyt, gdy czytnik Ocost się poprawia. Tylko „Odczytaj ponownie” w Plikach czyta go od nowa.

Przykład

Plik wysłany po wyczerpaniu dokumentów na ten miesiąc:

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

Ocost odczyta go 1 grudnia albo wcześniej, gdy plan się powiększy. Odpytuj dalej albo synchronizuj się, a plik pojawi się jako read.

Długie pliki

Z długiego pliku PDF Ocost odczytuje tylko pierwsze strony. pages liczy strony pliku, a pages_read mówi, ile z nich odczytano. pages_read ma wartość null, gdy Ocost odczytał wszystkie.

Zobacz też