Idexa — Novos status de processamento

Entenda os status 4 (INVALID_FILE_TYPE) e 5 (DOCUMENT_TYPE_MISMATCH) no retorno dos documentos processados pelo Idexa.

Foto de Luis SouzaLuis SouzaProduct Owner, Pix Force
1 min de leitura 5 visualizaçõesAtualizado em 23/10/2026

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

statusstatusDescSignificado
0RECEIVEDRecebido, aguardando processamento.
3IN PROGRESSSendo processado.
1FINISHEDProcessamento concluído com sucesso (campo data preenchido).
2ERRORErro interno ao tentar ler o documento.
4INVALID_FILE_TYPENovo — extensão de arquivo não suportada.
5DOCUMENT_TYPE_MISMATCHNovo — 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.

idexastatusapi
Foto de Luis Souza

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.

0 acharam útil · 0 não acharam