Idexa — Novos status de processamento
Entenda os status 4 (INVALID_FILE_TYPE) e 5 (DOCUMENT_TYPE_MISMATCH) no retorno dos documentos processados pelo Idexa.
Objetivo
Este guia complementa a documentação da API com dois novos status de processamento, adicionados recentemente e ainda não descritos na documentação oficial. Use-o para interpretar corretamente o campo status no retorno dos documentos.
Referência rápida
| status | statusDesc | Significado |
|---|---|---|
| 0 | RECEIVED | Recebido, aguardando processamento. |
| 3 | IN PROGRESS | Sendo processado. |
| 1 | FINISHED | Processamento concluído com sucesso (campo data preenchido). |
| 2 | ERROR | Erro interno ao tentar ler o documento. |
| 4 | INVALID_FILE_TYPE | Novo — extensão de arquivo não suportada. |
| 5 | DOCUMENT_TYPE_MISMATCH | Novo — documento não corresponde ao modelo esperado. |
Status 4 — INVALID_FILE_TYPE
Retornado quando o arquivo enviado está em uma extensão não suportada (por exemplo .html, .md, entre outras). Nesse caso, o documento não segue para processamento.
Exemplo de retorno:
{
"id": "a6cb7d44-dbe0-4b90-be6d-ff805c",
"externalId": null,
"status": 4,
"analyzedPages": 1,
"createdAt": "2026-07-14T16:54:10.392234-03:00",
"updatedAt": "2026-07-14T16:54:10.392234-03:00",
"modelName": null,
"type": null,
"data": null,
"finishedAt": null,
"processTime": null,
"statusDesc": "INVALID_FILE_TYPE"
}Status 5 — DOCUMENT_TYPE_MISMATCH
Antes de o documento passar por todo o fluxo, é feita uma pré-análise para verificar se ele corresponde ao modelo esperado. Quando não corresponde, o documento recebe este status. Isso evita erros como enviar uma procuração usando o modelo de nota fiscal.
Disponibilidade: este status não existe em todos os modelos — ele é criado conforme a demanda. Fale com o suporte para confirmar se já está disponível no modelo que você usa.
Exemplo de retorno:
{
"id": "a6cb7d44-dbe0-4b90-be6d-ff805c",
"externalId": null,
"status": 5,
"analyzedPages": 1,
"createdAt": "2026-07-14T16:54:10.392234-03:00",
"updatedAt": "2026-07-14T16:54:10.392234-03:00",
"modelName": null,
"type": null,
"data": null,
"finishedAt": null,
"processTime": null,
"statusDesc": "DOCUMENT_TYPE_MISMATCH"
}Documentação técnica
Consulte a referência completa da API em documentation.idexa.pixforce.ai.
Luis Souza
Luis Souza é Product Owner na Pix Force. É responsável por fazer do Idexa a principal ferramenta de automação inteligente de documentos, eliminando tarefas manuais e repetitivas para que as empresas processem mais, com menos esforço e mais precisão.
Quer ver isso aplicado na sua operação?
A Pix Force usa visão computacional nas câmeras que a sua operação já tem para identificar riscos em tempo real. Fale com um especialista e receba uma demonstração aplicada ao seu cenário.
Este material foi útil?
Sua avaliação ajuda a melhorar o conteúdo da central.