# Statusy i powody
> Statusy pliku i powody, dla których nie został odczytany, oraz co zrobić w każdym przypadku.
>
> Najpierw: [Wysłać plik i go odczytać](https://ocost.io/docs/pl/files.md)

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](https://ocost.io/docs/pl/groups.md). |

> [!NOTE]
> 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](https://ocost.io/docs/pl/groups.md#przypisz-czekajacy-plik) 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:

```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ę](https://ocost.io/docs/pl/sync.md), 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ż

- [Wysłać plik i go odczytać](https://ocost.io/docs/pl/files.md): Wysłać plik, bezpiecznie wysłać go ponownie, poczekać, aż zostanie odczytany, odczytać jego dokumenty, pobrać oryginał, usunąć go.
- [Limity i błędy](https://ocost.io/docs/pl/limits.md): Dokumenty planu na miesiąc, limity wywołań, rozmiary, błędy RFC 9457, ponawianie i miejsce przechowywania danych.
- [Grupy spółek](https://ocost.io/docs/pl/groups.md): Grupy spółek: do których spółek sięga klucz, nagłówek Ocost-Business, przekierowanie po identyfikatorach dokumentu, needs_company i pliki w grupie.
