# Stări și motive
> Stările unui fișier și motivele pentru care nu a fost citit, și ce faceți în fiecare caz.
>
> Înainte: [Trimiteți și citiți un fișier](https://ocost.io/docs/ro/files.md)

Fiecare fișier are un `status` care spune cât de departe a ajuns Ocost cu el. Un fișier care nu a fost citit are și un `reason`. Ramificați după amândouă.

## Stări

| Stare | Semnificație | Ce faceți |
| --- | --- | --- |
| `received` | Stocat, încă necitit. | Așteptați. |
| `reading` | În curs de citire. | Așteptați. |
| `read` | Citit. `documents` listează ce conține. | Citiți-i documentele. |
| `not_read` | Stocat, dar necitit. | Verificați `reason`. |
| `failed` | Ocost nu l-a putut citi. | Verificați `reason`. |
| `needs_company` | Citit, dar nu se știe cărei societăți din grup îi aparține. `candidates` le listează. | `PATCH` cu `business_id`, sau așteptați. Vedeți [Grupuri de firme](https://ocost.io/docs/ro/groups.md). |

> [!NOTE]
> Cât timp niciun serviciu de citire nu răspunde, un fișier rămâne `reading`. Ocost încearcă din nou timp de cel mult o zi.

## Așteptarea societății

Un fișier trimis cu cheia unui grup așteaptă ca `needs_company` când documentul lui numește mai multe societăți ale grupului sau alta doar după nume. Fiecare dintre `candidates` spune `why`: un identificator tipărit pe document, `name` sau `home`.

În Ocost, proprietarul sau contabilul răspunde în Azi › Alocă sau în Fișiere › Încă nealocate. Ocost propune primul candidat, cu excepția cazului în care este `home`. Fișierul se mută apoi în acea societate și este citit acolo. Un fișier trimis prin e-mail la adresa proprie a grupului așteaptă în căsuța grupului până când societatea lui este clară. Nicio cheie nu ajunge la acea căsuță. [Grupuri de firme](https://ocost.io/docs/ro/groups.md#atribuiti-un-fisier-care-asteapta) arată același răspuns cu `PATCH`.

## Motive

| Motiv | Cu | Semnificație |
| --- | --- | --- |
| `limit` | `not_read` | Documentele lunii s-au epuizat. Ocost citește fișierul singur la `renews_on`. |
| `model_off` | `not_read` | Această firmă nu are activată citirea PDF-urilor și a imaginilor. Facturile electronice se citesc în continuare. După ce o are, trimiteți aceiași octeți din nou. |
| `nothing_found` | `not_read` | Fișierul nu conține niciun document. |
| `too_large` | `not_read` | Prea multe pagini sau o imagine prea mare. |
| `damaged` | `failed` | Nu este un fișier pe care Ocost îl poate deschide. |
| `unavailable` | `failed` | Niciun serviciu de citire nu a răspuns timp de o zi. Trimiteți aceiași octeți din nou ca să reîncercați. |
| `failed` | `failed` | Citirea a eșuat sau a fost refuzată. Ocost reîncearcă o citire eșuată după 10 și după 60 de minute. Trimiteți aceiași octeți din nou ca să reîncercați mai devreme. |
| `other` | oricare | Un motiv pe care această versiune a API-ului nu îl numește încă. |

## Retrimiterea

Aceiași octeți trimiși din nou returnează același fișier, cu același `id`. Ocost îl numără o singură dată. Din trei motive îl citește din nou din octeții pe care îi păstrează, iar fișierul trece în `reading`:

| Motiv | Citit din nou |
| --- | --- |
| `unavailable` | De fiecare dată când îl trimiteți. |
| `failed` | De fiecare dată când îl trimiteți, de la un minut după eșec. Un fișier refuzat de model este citit din nou o singură dată. |
| `model_off` | După ce firma are un model de citire. |

Pentru orice alt motiv, retrimiterea nu schimbă nimic. Nu ștergeți un fișier ca să-l trimiteți din nou: un fișier nou se numără din nou. Un fișier citit își păstrează citirea când cititorul Ocost se îmbunătățește. Doar „Citește din nou” din Fișiere îl citește din nou.

## Un exemplu

Un fișier trimis după ce s-au epuizat documentele lunii:

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

Ocost îl citește la 1 decembrie, sau mai devreme dacă planul crește. Continuați să interogați sau [rămâneți sincronizat](https://ocost.io/docs/ro/sync.md), iar fișierul apare ca `read`.

## Fișiere lungi

Ocost citește doar primele pagini ale unui PDF lung. `pages` numără paginile fișierului, iar `pages_read` spune câte au fost citite. `pages_read` este `null` când Ocost le-a citit pe toate.

## Vezi și

- [Trimiteți și citiți un fișier](https://ocost.io/docs/ro/files.md): Trimiteți un fișier, retrimiteți-l în siguranță, așteptați până este citit, citiți-i documentele, obțineți originalul, ștergeți-l.
- [Limite și erori](https://ocost.io/docs/ro/limits.md): Documentele lunare ale planului, limitele de rată, dimensiunile, erorile RFC 9457, reîncercările și unde sunt păstrate datele.
- [Grupuri de firme](https://ocost.io/docs/ro/groups.md): Grupuri de firme: la ce societăți ajunge o cheie, antetul Ocost-Business, redirecționarea după identificatorii documentului, needs_company și fișierele din grup.
