Como configurar o Leitor de notas fiscais

Conferir fotos de cupons uma a uma consome tempo antes mesmo de avaliar um pedido de resgate. Em uma campanha promocional, a equipe precisa localizar a loja, os produtos, a data e o valor da compra, além de perceber quando um trecho da imagem não permite uma leitura segura.

Ao terminar a leitura, você saberá configurar o Leitor de notas fiscais para organizar essas informações no card, registrar o que precisa de conferência e preparar a solicitação para a próxima análise, com critérios claros para a participação humana.

📖 O que você vai entender aqui:

Conheça o agente e o resultado esperado

O agente lê documentos e extrai itens, valores, impostos e dados do comprador para estruturar a solicitação. Essa organização apoia um processo com 80% menos tempo de análise e capacidade de processar três vezes mais solicitações, liberando a equipe para conferir exceções e decidir sobre os resgates.

Pense em uma pessoa que envia a foto de uma compra para participar de uma promoção. O leitor organiza os dados visíveis e sinaliza uma data fora da vigência ou um valor que difere do cadastro. A análise de risco e a decisão de aprovar ou recusar seguem os critérios e responsáveis do processo.

O cruzamento com informações internas exige que essas informações estejam acessíveis ao agente, em uma fonte autorizada ou por uma integração configurada. Defina primeiro qual comparação é necessária. Uma leitura da imagem, por si só, não comprova a autenticidade fiscal nem confirma uma consulta a outro sistema.

Prepare o processo para utilizar o agente

Defina onde o comprovante será recebido e em que momento estará pronto para leitura. Para começar, trabalhe com um comprovante por solicitação e mantenha juntos o arquivo enviado e os dados declarados pelo participante. Isso facilita comparar a extração com a imagem original.

Planeje os destinos dos resultados. Se precisar adaptar o pipe, use, por exemplo, um campo de anexo para o comprovante, data para a emissão, moeda para o total e texto para os identificadores fiscais. Preserve zeros iniciais em CPF, CNPJ e números de documento. Esses são exemplos de configuração, que devem corresponder aos campos reais do seu processo.

Reserve espaço para os itens, as pendências e a situação da leitura. Distinga o dado declarado pelo participante do dado extraído do documento, para que uma divergência continue visível. Defina quem confere cada pendência e quem pode liberar a solicitação.

Separe o regulamento vigente da campanha, com datas de participação, produtos elegíveis e orientações sobre comprovantes. Use somente as informações necessárias à conferência e revise o acesso aos anexos, aos cards e às fontes consultadas.

Para praticar a construção de agentes e a escrita de instruções, consulte a Certificação de Especialista em Inteligência Artificial do Pipefy, na Academy.

Configure e personalize o agente

Escolha como começar

No pipe, abra Agentes de IA. Para criar, use Novo Agente de IA. Se partir de uma opção disponível em Templates, confira seu objetivo e as ações antes de personalizar. Se o processo já tiver um leitor, abra sua edição e revise a configuração existente. Os três caminhos devem chegar ao mesmo escopo de leitura e encaminhamento.

Defina o papel em Geral

Use um nome que a equipe reconheça e descreva a função: extrair dados de comprovantes de campanhas, organizar o resultado e indicar pendências para revisão. Deixe explícito que a liberação do resgate pertence à etapa responsável pela decisão.

Prepare o Conhecimento

Adicione o regulamento da campanha como referência. Quando a conferência depender de um cadastro de produtos ou de informações internas, conecte somente o pipe ou database pertinente e explique o que consultar. Confirme que a campanha e as referências utilizadas são as vigentes.

O regulamento orienta a análise; o comprovante de cada participante é a entrada daquela solicitação. Nas instruções, referencie o campo de anexo do card para que o agente leia o documento certo.

Organize os Comportamentos

Escolha um gatilho que ocorra depois do recebimento do comprovante, como a entrada na fase destinada à leitura. Evite iniciar a conferência antes de o arquivo estar disponível. Se houver reenvio, defina como a equipe iniciará uma nova leitura e identificará o resultado mais recente.

Use / ou + no editor para inserir os campos e as ações reais. Mapeie a extração para os destinos correspondentes e mantenha separadas a situação da leitura e a decisão do resgate. Se usar movimentação de card, condicione o avanço à completude exigida pelo processo.

O comportamento do agente reúne a leitura, as instruções e suas ações. Uma automação do pipe para mover ou notificar precisa de configuração própria. Confira os dois mecanismos para evitar encaminhamentos repetidos.

Personalize as instruções

Adapte o exemplo abaixo. Substitua os termos entre colchetes e selecione as referências reais no editor, inclusive os campos de destino. Defina o formato de saída e os critérios para considerar a leitura completa antes de salvar.

A pendência precisa orientar uma ação. Prefira “Data de emissão anterior ao início da campanha, conferir regulamento e documento” a uma indicação genérica de erro. Caso o CPF não apareça no cupom, registre a ausência conforme o critério da campanha, sem completar o dado com o cadastro do participante.

Melhore as instruções e escolha os recursos

Após personalizar, use Melhorar instruções e revise se a sugestão preserva as fontes, os destinos e os limites de decisão. Quando disponíveis, use Testar sugestão e Tentar novamente para refinar, Descartar para manter o texto anterior e Substituir apenas quando a proposta atender ao processo. Veja como funciona o recurso Melhorar instruções na Community.

Como ponto de partida, avalie Pipefy AI Standard para leitura e preenchimento de vários campos. Compare com Pro se houver documentos variados ou informações conflitantes. Escolha por comportamento e pelos resultados dos testes.

Habilite Análise de documentos para a leitura. Acrescente Cálculos e análises somente se houver uma conferência numérica definida, como comparar a soma dos itens com o total. Para este escopo, mantenha Pesquisa na Web desativada. Use Esforço proporcional à tarefa; reserve o máximo para análises que precisem de raciocínio mais extenso. O Esforço máximo utiliza Pro e deve entrar na avaliação de consumo.

Teste o agente na prática

Use Testar comportamento antes de colocar o agente em operação. Compare o resultado com uma conferência humana de cada documento. O artigo sobre testes de comportamentos explica a simulação antes da publicação.

• Comprovante legível: confira loja, data, itens e total. O resultado deve corresponder ao documento, mantendo como ausente o que não estiver impresso.
• Dados divergentes: use um comprovante cujo total ou data difira do declarado. A diferença deve aparecer na pendência, preservando as duas informações para conferência.
• Data fora da campanha: use uma compra anterior à vigência. O leitor deve registrar o motivo da revisão e manter a decisão do resgate com o responsável.
• Documento ausente ou ilegível: teste um card sem arquivo e uma imagem cortada. A leitura deve indicar o que falta, sem inventar valores ou considerar o caso completo.
• Correção e nova leitura: substitua um documento de teste por uma versão legível e repita a execução pelo caminho definido. Confira se o resultado mais recente está identificável e se a pendência resolvida foi tratada corretamente.
• Revisão humana: percorra o encaminhamento da pendência até a conferência pelo responsável. Confirme que uma extração completa não libera o resgate por conta própria.

Revise e coloque em operação

Nos Logs, abra os detalhes e o Rastreamento para investigar a execução e as fontes utilizadas. Confira também os dados gravados no card. Um status de sucesso precisa ser acompanhado da conferência do conteúdo extraído.

Antes de liberar o uso, revise o gatilho, os acessos, os destinos e qualquer automação posterior. Faça um teste completo em ambiente controlado, incluindo a chegada à análise seguinte e o caminho das exceções. Retire os documentos de teste da rotina operacional.

Comece com um conjunto acompanhado pela equipe. Observe o tempo de conferência, os dados corrigidos manualmente e as pendências mais frequentes. Ajuste as instruções quando um mesmo tipo de cupom exigir correções recorrentes e repita os testes após mudanças no regulamento ou na configuração.

Antes de avançar, confirme que você entende

☐ O leitor organiza os dados do comprovante para a análise seguinte.

☐ O regulamento, os campos de destino e as fontes internas correspondem à campanha.

☐ Dados ilegíveis permanecem identificados como pendências.

☐ O agente registra divergências sem concluir fraude ou liberar resgates.

☐ Os cenários de teste e o encaminhamento para revisão humana foram conferidos.

☐ A equipe sabe acompanhar as execuções e revisar os resultados.