Stări și motive

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

StareSemnificațieCe faceți
receivedStocat, încă necitit.Așteptați.
readingÎn curs de citire.Așteptați.
readCitit. documents listează ce conține.Citiți-i documentele.
not_readStocat, dar necitit.Verificați reason.
failedOcost nu l-a putut citi.Verificați reason.
needs_companyCitit, 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.

Notă

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 arată același răspuns cu PATCH.

Motive

MotivCuSemnificație
limitnot_readDocumentele lunii s-au epuizat. Ocost citește fișierul singur la renews_on.
model_offnot_readAceastă 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_foundnot_readFișierul nu conține niciun document.
too_largenot_readPrea multe pagini sau o imagine prea mare.
damagedfailedNu este un fișier pe care Ocost îl poate deschide.
unavailablefailedNiciun serviciu de citire nu a răspuns timp de o zi. Trimiteți aceiași octeți din nou ca să reîncercați.
failedfailedCitirea 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.
otheroricareUn 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:

MotivCitit din nou
unavailableDe fiecare dată când îl trimiteți.
failedDe 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_offDupă 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, 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