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
| Status | Znaczenie | Co zrobić |
|---|---|---|
received | Zapisany, jeszcze nieodczytany. | Poczekaj. |
reading | W trakcie odczytu. | Poczekaj. |
read | Odczytany. documents wymienia, co zawiera. | Odczytaj jego dokumenty. |
not_read | Zapisany, ale nieodczytany. | Sprawdź reason. |
failed | Ocost nie mógł go odczytać. | Sprawdź reason. |
needs_company | Odczytany, 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ód | Przy | Znaczenie |
|---|---|---|
limit | not_read | Dokumenty na ten miesiąc się wyczerpały. Ocost sam odczyta plik w dniu renews_on. |
model_off | not_read | Ta 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_found | not_read | Plik nie zawiera żadnego dokumentu. |
too_large | not_read | Za dużo stron albo za duży obraz. |
damaged | failed | To nie jest plik, który Ocost potrafi otworzyć. |
unavailable | failed | Żadna usługa odczytu nie odpowiedziała przez dobę. Wyślij te same bajty ponownie, aby spróbować jeszcze raz. |
failed | failed | Odczyt 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. |
other | oba | Powó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ód | Ponowny odczyt |
|---|---|
unavailable | Przy każdym wysłaniu. |
failed | Przy każdym wysłaniu, od minuty po niepowodzeniu. Plik odrzucony przez model jest odczytywany ponownie raz. |
model_off | Gdy 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:
{
"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.