Reprocessando Extrações com Falha
Alguns documentos falham — um escaneamento borrado demais, um fornecedor que ainda não existia, uma instabilidade transitória do serviço. As falhas chegam à visualização Erros da Caixa de entrada de OCR com o motivo registrado, e a ação Reprocessar dá a cada documento uma segunda chance depois que você corrige a causa. Nada se perde; nada precisa ser reenviado por e-mail.
Acesso necessário. Reprocessar itens de OCR requer o conjunto de permissões Accounts Payable v2 (analistas e gerentes de contas a pagar) ou Accounting Admin v2 (administradores de sistema). Os conjuntos Accounting Controller v2, Accounts Receivable v2 e Read Only v2 permitem visualizar os itens, mas não agir sobre eles.
Triagem por mensagem de erro
| A mensagem diz… | Significa… | Corrija e depois reprocesse |
|---|---|---|
| "…não parece ser uma fatura." | A IA está protegendo você de um extrato, um panfleto, um contrato | Se realmente não for uma conta, marque como Rejeitado. Se for (layout incomum), reprocesse — ou crie a fatura manualmente com o arquivo anexado |
| "O serviço de IA está temporariamente com limite de taxa atingido / sobrecarregado…" | Pressão transitória no serviço | Basta reprocessar em alguns minutos — não há nada errado do seu lado |
| "O limite mensal de processamento de documentos com IA foi atingido." | O medidor de documentos da organização foi esgotado | Novo mês ou um plano maior; a fila espera |
| "A chave de API de IA não está configurada…" | Licença não ativada (ou expirada) | Console de Administração → Assinatura → ativar; consulte seu administrador |
| Uma falha de análise/extração | O documento venceu o leitor (escaneamento rotacionado, imagem de uma imagem) | Consiga uma cópia mais limpa se possível; caso contrário, lançamento manual com o arquivo anexado |
Referência completa de mensagens
A tabela acima é a visão de triagem; esta é o catálogo completo, palavra por palavra, como as mensagens aparecem no registro (ou, no caso das respostas de entrada, na caixa de e-mail do remetente). Marcadores como {0} são preenchidos com o detalhe específico no momento da falha:
| A mensagem | O que significa / o que fazer |
|---|---|
| "O serviço de IA está temporariamente com limite de taxa atingido. Tente novamente em alguns instantes." | Muita coisa de uma vez — normalmente uma sequência de documentos. Nada a corrigir; reprocesse após uma breve espera. |
| "O serviço de IA está temporariamente sobrecarregado. Tente novamente em breve." | O próprio serviço está ocupado. Mesmo remédio: aguarde um pouco, reprocesse. |
| "O serviço de IA retornou uma resposta vazia. Tente novamente." | Uma resposta em branco pontual. Reprocesse; escale para o suporte apenas se se repetir no mesmo documento. |
| "O serviço de IA retornou um erro (HTTP {0}): {1}" | Um erro inesperado do serviço — os marcadores trazem o código e o detalhe. Reprocesse uma vez; se persistir, compartilhe a mensagem exata com seu administrador. |
| "Falha ao analisar a resposta de extração da IA: {0}" | A resposta da IA não pôde ser interpretada — geralmente um documento que venceu o leitor (escaneamento rotacionado, foto de uma foto). Reprocesse; se se repetir, consiga uma cópia mais limpa. |
| "O documento enviado não parece ser uma fatura. Envie um documento de fatura válido." | A verificação de primeira passagem que protege você de extratos, panfletos e contratos. Se realmente não for uma conta, marque o registro como Rejeitado. |
| "O arquivo enviado não foi encontrado. Tente enviar novamente." | O arquivo do documento não está no registro — normalmente um envio interrompido. Envie o arquivo novamente no formulário de Nova Fatura de Compra. |
| "Registro da Caixa de entrada de OCR não encontrado." | O registro foi excluído enquanto alguém estava agindo sobre ele. Atualize a página; se o documento ainda importar, reenvie-o. |
| "O limite mensal de processamento de documentos com IA foi atingido. Entre em contato com seu administrador." | O medidor de documentos de toda a organização para o mês está esgotado. Novo mês ou um plano maior; a fila espera. |
| "A chave de API de IA não está configurada. Ative sua licença da REDA Financials AI." | A licença não está ativa (ou expirou). Seu administrador a ativa na guia Assinatura do Console de Administração; depois disso, você reprocessa. |
| "Nenhum anexo em PDF foi encontrado no e-mail. Apenas arquivos PDF são processados para extração de faturas." | Devolvida ao remetente por e-mail — o canal de e-mail aceita apenas PDFs. Peça ao fornecedor para reenviar em PDF, ou envie o arquivo você mesmo no formulário de Nova Fatura de Compra (que também aceita JPG e PNG). |
| "Ocorreu um erro ao processar os anexos do seu e-mail: {0}" | A cópia da falha recebida pelo remetente. Um registro com status Erro ainda assim foi criado com o mesmo motivo registrado — encontre-o na visualização Erros e trabalhe a partir dali. |
| "Tipo de arquivo não suportado. Envie um arquivo PDF, JPG, JPEG ou PNG." | O envio manual aceita apenas esses quatro formatos. Converta ou reexporte o documento e envie novamente. |
Por que os erros nunca tentam novamente sozinhos
O loop de processamento automático — o card "Processamento de Documentos OCR" na guia Operações do Console de Administração, que roda a cada 15 minutos — só pega registros com status Pendente e Extraindo. Um registro marcado como Erro fica deliberadamente fora do alcance dele: tentar novamente um documento cujo fornecedor não existe falharia da mesma forma a cada 15 minutos, para sempre. Os erros esperam por uma pessoa, e Reprocessar é como a pessoa responde.
Esse design também protege a fila: quando um documento falha, apenas aquele registro é marcado como Erro (com o motivo em seu campo Mensagem de Erro) e o loop continua com o próximo documento. Um único escaneamento ilegível nunca trava as cinquenta boas contas atrás dele. Seu administrador também consegue acompanhar os danos à distância — o card de Operações mostra contadores de Fila de Documentos para Pendente, Extraindo e Erros, de modo que um aumento na contagem de Erros fica visível sem abrir a guia Caixa de entrada de OCR.
Executando um reprocessamento
Corrija a causa primeiro
O clássico: o fornecedor não existia → crie a conta do fornecedor. Entidade incompatível → verifique se a conta foi endereçada a uma entidade que você configurou. Erros transitórios não precisam de nenhuma correção.
Clique em Reprocessar no registro
A extração é reiniciada e executa novamente as duas fases sobre o documento armazenado ("Reprocessando documento..."), depois abre o formulário de fatura pré-preenchido exatamente como um novo Criar Fatura. Reprocessar também é a atitude certa em extrações bem-sucedidas mas erradas — depois que você corrige os dados mestres que a confundiram.
Higiene da fila
- Visualização Erros todos os dias — a maioria dos itens são reprocessamentos de um clique; o restante são pendências de dados mestres que melhoram todas as extrações futuras.
- Fique atento a padrões — o mesmo fornecedor falhando repetidamente significa que o layout da fatura dele precisa de uma análise (ou de um registro de orientação de território, via seu administrador), em vez de reprocessamentos por documento.
- Reprocessar não consome nenhum crédito de documento novo para o mês medido ao executar novamente um documento armazenado — a leitura já foi contabilizada no momento da entrada.
Uma varredura de sexta-feira na visualização Erros da Meridian
A entidade do Reino Unido da Meridian Properties Group zera sua visualização REDA: Erros toda sexta-feira. O lote desta semana mostra como as correções podem ser diferentes para uma fila com a mesma aparência:
| Registro | A Mensagem de Erro diz | O que realmente aconteceu | A correção |
|---|---|---|---|
| OCR #00000198 | "O serviço de IA está temporariamente com limite de taxa atingido. Tente novamente em alguns instantes." | Um fornecedor de manutenção predial enviou doze faturas por e-mail em uma única sequência na terça-feira; duas atingiram o limite | Nenhuma correção necessária — Reprocesse cada uma; ambas extraem corretamente na nova tentativa |
| OCR #00000201 | "Falha ao analisar a resposta de extração da IA: …" | Um recibo fotografado de lado, de um prestador pontual | Peça ao prestador um PDF adequado; reprocesse quando não for possível obtê-lo e faça o lançamento manual se a nova tentativa também falhar |
| OCR #00000203 | "O documento enviado não parece ser uma fatura. Envie um documento de fatura válido." | O resumo de um contrato de locação de um locatário encaminhado por engano ao endereço de entrada | Nada a reprocessar — marque como Rejeitado, informe a quem encaminhou para onde os documentos de locação devem realmente ir |
| OCR #00000205 | "A chave de API de IA não está configurada. Ative sua licença da REDA Financials AI." | A licença havia expirado durante a noite antes que a chave de renovação fosse aplicada | O administrador ativa a nova chave na guia Assinatura do Console de Administração; depois, reprocesse |
Tempo total: cerca de dez minutos — e observe que apenas um dos quatro casos (o recibo de lado) foi um problema com o documento. A visualização Erros é, na maior parte das vezes, uma lista de novas tentativas, ocasionalmente uma lista de pendências, e apenas raramente uma lista de más notícias.
Erros comuns a evitar
| Erro | Por que prejudica | Faça isto em vez disso |
|---|---|---|
| Reprocessar instantaneamente sem ler a Mensagem de Erro | Falhas de dados mestres (fornecedor ausente, entidade incompatível) falham da mesma forma na nova tentativa — você só perde tempo | Leia a mensagem primeiro; erros transitórios de serviço são os únicos que não precisam de correção |
| Reenviar o documento por e-mail em vez de reprocessar | Cada entrada por e-mail cria um novo registro e conta um novo documento contra a cota mensal — reprocessar o registro existente não custa nada a mais | Reprocesse — o arquivo já está armazenado no registro |
| Excluir registros de Erro para "limpar" a visualização | Você perde a mensagem de erro, o documento e a prova do que chegou — e a contagem de uso do mês deixa de bater com os registros que a explicam | Marque becos sem saída como Rejeitado; eles não custam nada para manter |
| Esperar o loop tentar novamente os erros | Isso nunca vai acontecer — o loop só processa registros Pendente e Extraindo | A visualização Erros é território humano; faça a varredura em uma programação regular |
| Reprocessar para "corrigir" uma fatura que já existe | Bloqueado por design: "Não é possível reprocessar — uma Fatura de compra já foi criada a partir deste registro." | Edite o rascunho da Fatura de compra diretamente — é um rascunho comum |
O que vem a seguir
- Caixa de entrada de OCR e fila de documentos — a base da visualização Erros.
- Criando uma Fatura a partir do OCR — para onde vai um reprocessamento bem-sucedido.
- Programador de operações — o loop que processa a fila.
Perguntas frequentes
Ele substitui o resultado de extração do registro pela nova leitura — o documento e o histórico de entrada permanecem. Como ainda não existe fatura (a trava garante isso), nada em seus livros contábeis é afetado.
Reprocessar é por registro (abre o formulário de revisão), então uma sequência de instabilidades do serviço é resolvida abrindo cada item na visualização Erros. Evite reencaminhar os mesmos e-mails como atalho: cada PDF recebido cria um novo registro de entrada e conta contra o medidor mensal de documentos — reprocessar o registro existente não conta.
Assim que uma Fatura de compra é criada a partir do registro: "Não é possível reprocessar — uma Fatura de compra já foi criada a partir deste registro." A partir desse momento, a fatura é a fonte da verdade — corrija-a diretamente em vez de reler o documento por trás dela.
O medidor conta documentos no momento em que entram na fila — cada registro de entrada incrementa o uso do mês uma única vez. O reprocessamento relê um documento que já foi contado, em seu registro existente.
Os dois funcionam. Criar Fatura permite escolher o fornecedor manualmente no formulário agora mesmo; Reprocessar executa a extração completa novamente para que a correspondência do fornecedor (e o histórico de contabilização desse fornecedor) seja aplicada automaticamente. Se você espera receber mais contas desse fornecedor, reprocesse uma vez — isso inicia corretamente o loop de aprendizado.
Isso foi útil?