Archivos rechazados

Un rechazo es un problema del archivo en sí — no de la extracción — e Invofox te dice qué archivo ha fallado y por qué.

Un archivo se rechaza cuando Invofox no puede leerlo: un PDF protegido con contraseña, un archivo corrupto o un formato no soportado dentro de un ZIP (p. ej. un .pptx o un .exe). El archivo no produce ningún documento; en su lugar se dispara un webhook file.rejected con el motivo en su campo error. (Una subida directa de un tipo no soportado se rechaza de entrada con un 400, antes de crear nada.)

Escucha file.rejected para capturar estos casos en tu pipeline. Tu clientData se incluye, así que puedes correlacionar el rechazo con tus propios registros.

Códigos de error

Cuando un File alcanza el estado rejected, su campo error contiene uno de los siguientes códigos:

El campo error te dice qué ha pasado. Dos casos comunes:

1
{
2
  "type": "file.rejected",
3
  "id": "6a34b45c8947a908cf3c0640",
4
  "timestamp": "2026-06-19T03:15:41.826Z",
5
  "data": {
6
    "id": "6a34b45c8947a908cf3c0640",
7
    "importId": "6a34b45c8947a908cf3c063d",
8
    "status": "rejected",
9
    "filename": "invoice.pdf",
10
    "error": "ERR_PASSWORD_PROTECTED",   // ← el PDF está bloqueado con contraseña
11
    "clientData": { "internalId": "inv-1234" }
12
  }
13
}

1
{
2
  "type": "file.rejected",
3
  "id": "6a3521072f63bbec693e72df",
4
  "timestamp": "2026-06-19T10:59:19.241Z",
5
  "data": {
6
    "id": "6a3521072f63bbec693e72df",
7
    "importId": "6a3521061a05f30cb212cb78",
8
    "status": "rejected",
9
    "filename": "notes.pptx",
10
    "error": "ERR_UNSUPPORTED_UNCOMPRESSED_FILE_FORMAT",   // ← un .pptx extraído del ZIP no es un tipo soportado
11
    "clientData": { "internalId": "inv-1234" }
12
  }
13
}