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
| Estado | Significado | Qué hacer |
|---|---|---|
received | Guardado, aún sin leer. | Espera. |
reading | Se está leyendo. | Espera. |
read | Leído. documents lista lo que contiene. | Lee sus documentos. |
not_read | Guardado, pero no leído. | Mira reason. |
failed | Ocost no pudo leerlo. | Mira reason. |
needs_company | Leí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
| Motivo | Con | Significado |
|---|---|---|
limit | not_read | Los documentos del mes se han agotado. Ocost lee el archivo por sí solo en renews_on. |
model_off | not_read | Esta 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_found | not_read | El archivo no contiene ningún documento. |
too_large | not_read | Demasiadas páginas, o una imagen demasiado grande. |
damaged | failed | No es un archivo que Ocost pueda abrir. |
unavailable | failed | Ningún servicio de lectura respondió durante un día. Envía los mismos bytes otra vez para reintentar. |
failed | failed | La 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. |
other | cualquiera | Un 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:
| Motivo | Se vuelve a leer |
|---|---|
unavailable | Cada vez que lo envías. |
failed | Cada 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_off | Cuando 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:
{
"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.