Estados y motivos

Cada archivo tiene un status que dice hasta dónde ha llegado Ocost con él. Un archivo que no se leyó también tiene un reason. Decide según ambos.

Estados

EstadoSignificadoQué hacer
receivedGuardado, aún sin leer.Espera.
readingSe está leyendo.Espera.
readLeído. documents lista lo que contiene.Lee sus documentos.
not_readGuardado, pero no leído.Mira reason.
failedOcost no pudo leerlo.Mira reason.
needs_companyLeído, pero falta decir a qué sociedad del grupo pertenece. candidates las lista.Hacer PATCH con business_id, o esperar. Ver Grupos de empresas.

Nota

Mientras ningún servicio de lectura responde, un archivo sigue en reading. Ocost lo vuelve a intentar durante hasta un día.

Esperando a su sociedad

Un archivo enviado con la clave de un grupo espera como needs_company cuando su documento nombra varias sociedades del grupo, u otra solo por su nombre. Cada uno de sus candidates dice why: un identificador impreso en el documento, name o home.

En Ocost, el propietario o el contable responde en Hoy › Asignar, o en Archivos › Aún sin asignar. Ocost propone el primer candidato, salvo que sea home. El archivo pasa entonces a esa sociedad y se lee allí. Un archivo enviado a la dirección propia del grupo espera en la bandeja del grupo hasta que su sociedad esté clara. Ninguna clave llega a esa bandeja. Grupos de empresas muestra la misma respuesta con PATCH.

Motivos

MotivoConSignificado
limitnot_readLos documentos del mes se han agotado. Ocost lee el archivo por sí solo en renews_on.
model_offnot_readEsta empresa no hace leer los PDF ni las imágenes. Las facturas electrónicas se siguen leyendo. Cuando lo haga, envía los mismos bytes otra vez.
nothing_foundnot_readEl archivo no contiene ningún documento.
too_largenot_readDemasiadas páginas, o una imagen demasiado grande.
damagedfailedNo es un archivo que Ocost pueda abrir.
unavailablefailedNingún servicio de lectura respondió durante un día. Envía los mismos bytes otra vez para reintentar.
failedfailedLa lectura falló o fue rechazada. Ocost vuelve a intentar una lectura fallida 10 y 60 minutos después. Envía los mismos bytes otra vez para reintentar antes.
othercualquieraUn motivo que esta versión de la API aún no nombra.

Enviarlo otra vez

Enviar los mismos bytes otra vez responde el mismo archivo, con el mismo id. Ocost lo cuenta una vez. Por tres motivos vuelve a leer el archivo a partir de los bytes que guarda, y el archivo pasa a reading:

MotivoSe vuelve a leer
unavailableCada vez que lo envías.
failedCada vez que lo envías, a partir de un minuto después del fallo. Un archivo que el modelo rechazó se vuelve a leer una vez.
model_offCuando la empresa tiene un modelo de lectura.

Por cualquier otro motivo, enviarlo otra vez no cambia nada. No borres un archivo para enviarlo otra vez: un archivo nuevo se vuelve a contar. Un archivo ya leído conserva su lectura cuando mejora el lector de Ocost. Solo «Volver a leer» en Archivos lo lee de nuevo.

Un ejemplo

Un archivo enviado después de agotarse los documentos del mes:

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

Ocost lo lee el 1 de diciembre, o antes si el plan crece. Sigue consultando o mantente sincronizado, y aparece como read.

Archivos largos

Ocost lee solo las primeras páginas de un PDF largo. pages cuenta las páginas del archivo, y pages_read dice cuántas se leyeron. pages_read es null cuando Ocost las leyó todas.

Véase también