Módulo Financeiro v1.2.3 — OCR de comprovantes com importação em 1 clique

Chegou a versão 1.2.3 com um salto importante no fluxo de lançamento de despesas: OCR automático de cupons de posto de gasolina e comprovantes de cartão, revisão rápida e salvamento direto nas Despesas do Perfex.

🆕 Novidades

  • OCR integrado: lê imagens de comprovantes e extrai automaticamente:

    • Tipo do documento (cartão/posto)

    • Data e hora

    • Valor total (centavos)

    • Modalidade (Débito/Crédito)

    • Combustível, litros, preço/litro (quando for cupom de posto)

    • CNPJ, NSU e código de autorização (quando disponível)

  • Modal de revisão: após o upload, você confere e ajusta os campos antes de salvar.

  • Sugestão automática de Categoria e Modo de Pagamento com base no texto do comprovante.

  • Anexo automático: a imagem enviada é movida para uploads/expenses/{ID}/ e vinculada à despesa criada.

  • Campos personalizados dinâmicos: mapeamento automático de Status, Tipo de Despesa e ID da Transação (quando existirem).

  • API OCR dedicada: processamento fora do servidor do cliente — ideal para ambientes sem SSH/Composer.

  • Validação de licença embutida: o OCR só processa chamadas autorizadas (token + domínio + produto).

⚙️ Melhorias

  • Payload de salvamento mais seguro: normalização de valores (centavos → decimal), datas e referência (usa NSU quando informado).

  • JS simplificado: menos requisições, código mais legível e fácil de manter.

  • Compatibilidade com open_basedir: autodetecção dos binários e fallback limpo.

🐞 Correções

  • Tratamento correto dos custom fields (custom_fields[expenses][ID]) evitando warnings em handle_custom_fields_post.

  • Evita redirecionamentos indesejados no save; a resposta permanece 100% JSON.

🚀 Como usar (resumo)

  1. Em Despesas → Importar, envie a imagem do comprovante (PNG/JPG).

  2. Revise os dados no modal (edite se necessário).

  3. Clique em Salvar. A despesa é criada no Perfex com o anexo já vinculado.

✅ Requisitos

  • Perfex CRM atualizado.

  • Servidor OCR (nosso) já configurado com o que há de melhor no mercado para OCR

  • Chave de licença ativa (validação automática por token + domínio + produto).

📌 Observações

  • Nesta versão o OCR processa imagens. Suporte a PDF entra nas próximas releases.

  • A detecção de categoria e pagamento é sugestão — sempre revisável no modal.

  • Resultados de OCR variam com a qualidade da foto (dica: boa luz e foco = melhor extração).

📦 Atualização

  • Faça o upload do pacote v1.2.3 no Perfex.

  • Configure as opções do módulo (produto, domínio e token).

  • Pronto: a integração com o OCR já estará ativa.

Se quiser, compartilhe seu feedback ou exemplos reais — isso nos ajuda a refinar os parsers e ampliar os tipos de comprovantes suportados. 💬

— Equipe Diletec

Você achou esse artigo útil?