OCR

Recupera o status de um documento

Disponível somente em ambiente de produção.

Este endpoint permite consultar o status de processamento de um documento enviado via /v1/ocr/upload para o fluxo de OCR (Reconhecimento Óptico de Caracteres).

Os possíveis valores do campo status_code são:

  • processing: o documento está em processamento.
  • success: o documento foi processado com sucesso.
  • error: ocorreu uma falha durante o processamento.

Quando status_code for error, o campo error_code poderá indicar o tipo de erro ocorrido. Atualmente, os valores possíveis são:

  • DOCUMENT_RESTRICTED: município bloqueado para processamento via OCR. Para mais informações, entre em contato com o time de atendimento.
  • DOCUMENT_NOT_ENABLED: documento não habilitado para sua conta. Verifique a habilitação junto ao time de atendimento.
  • INVALID_FILE: arquivo inválido. Certifique-se de que é um PDF válido e que não excede o limite de 10 páginas permitidas.
  • INVALID_NFSE: documento não reconhecido como uma NFS-e válida. O documento enviado atende aos critérios de processamento, mas não foi identificado como uma NFS-e válida.
  • MANUAL_REVIEW_REQUIRED: documento em análise manual. Aguarde o processamento por nossa equipe de operações.
  • UNAUTHENTICATED_NFSE: nfse não autenticada na prefeitura. Não foi possível confirmar a validade do documento. Tente validá-lo diretamente na prefeitura ou entre em contato com o time de atendimento.
  • INTERNAL_ERROR: erro genérico interno. Recomendamos tentar novamente ou entrar em contato com o time de atendimento.

Novos códigos poderão ser adicionados futuramente para representar erros mais específicos.

Para documentos do tipo NFS-e, a resposta de sucesso também incluí os campos adicionais document_id e role, que indicam, respectivamente, o identificador interno do documento e o papel do cliente (emitente ou destinatário). Com base no valor de role, é possível utilizar os endpoints /v1/nfse/received ou /v1/nfse/emitted para obter o XML ABRASF.

get/v1/ocr/status

Request

  • Base URL: https://api.arquivei.com.br
  • URL: https://api.arquivei.com.br/v1/ocr/status
  • Auth: none declared. Required headers: X-API-ID, X-API-KEY, X-Use-ApiGateway

Query parameters

message_idstring

Message ID é um identificador para o upload. Ele é retornado pela API de Upload.

Headers

X-API-IDstring required

API ID usado para autenticação.

X-API-KEYstring required

API KEY usado para autenticação.

X-Use-ApiGatewaystring required

Este header indica que a request será roteada pelo API Gateway da Qive e o valor deve ser passado como always.

Response

Requisição bem sucedida.

Example response

{
  "data": {
    "document_type": "\"NFSE\""
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.