The Eye

Como otimizar a contagem de páginas processadas e evitar duplicatas no DigitAI

Administradoruser

Saiba como o DigitAI calcula o consumo de páginas processadas para faturamento, como funciona o mecanismo de detecção de arquivos duplicados e quais práticas adotar para auditar e otimizar seu consumo mensal.

Passo a passo

  1. 1

    Como o DigitAI calcula as páginas processadas?

    No DigitAI existem dois conceitos essenciais sobre a extensão dos arquivos: 1. **Páginas totais (`total_pages` / `pages_number`):** Quantidade física total de páginas do arquivo original (ex.: um PDF de 3 páginas). 2. **Páginas processadas (`processed_pages`):** Quantidade de páginas faturáveis computadas pelo sistema. #### Critério de cálculo e faturamento: - Quando o motor de extração processa uma página via Inteligência Artificial, atribui internamente o status `ai_extracted: true`. - O campo `processed_pages` considera apenas as páginas com `ai_extracted` confirmado. - Caso nenhuma página receba essa marcação ou o extrator esteja desativado, o sistema adota como contingência (fallback) o número total de páginas físicas (`pages_number`). #### Documentos multipáginas com cópias idênticas (Original, Duplicata, Triplicata): - **Sem deduplicação interna de páginas:** Se um arquivo possui 3 páginas e a conta não tem deduplicação configurada, as 3 páginas serão processadas e faturadas. - **Com deduplicação interna de páginas:** O extrator identifica páginas idênticas subsequentes, processa apenas a primera via IA e desconsidera as cópias (`ai_extracted: false`), computando apenas 1 página processada.

  2. 2

    Detecção automática de documentos duplicados (`check_duplicated`)

    O DigitAI conta com mecanismo preventivo para evitar reprocessamentos desnecessários: - **Configuração padrão:** A detecção automática vem desativada por padrão. Se o mesmo arquivo for enviado duas vezes, será processado e faturado em ambas as ocasiões. - **Ativação:** O recurso (`check_duplicated: true`) é configurado por cliente. A ativação pode ser solicitada junto à equipe de suporte. - **Como funciona:** Quando habilitado, o sistema calcula o checksum SHA-256 do arquivo. Se identificar que o mesmo binário já foi carregado na organização: 1. Define o ciclo de vida como `DUPLICATED` (`extractor = 'duplicated'`). 2. Vincula o arquivo ao documento original existente e copia suas etiquetas (tags). 3. Não executa novamente os modelos de extração de IA. 4. **Não adiciona páginas ao consumo mensal.**

  3. 3

    O que ocorre com documentos excluídos?

    - Excluir um documento na plataforma **não estorna nem reduz** as páginas já computadas. - Uma vez processado pela IA, o consumo de páginas fica registrado permanentemente no acumulado do período de faturamento.

  4. 4

    Monitoramento, auditoria e boas práticas operacionais

    #### Configuração de colunas para auditoria: Tanto administradores quanto usuários podem personalizar a visualização de documentos: 1. Acesse a área de **Documentos**. 2. Clique no seletor de colunas da tabela. 3. Ative as colunas: - **Páginas totais** - **Páginas processadas** - **Ciclo de vida (Lifecycle):** Para identificar facilmente documentos `DUPLICATED` ou com divergências. #### Relatório de Métricas de Uso: Administradores podem auditar o consumo na seção de **Métricas / Relatórios de Uso** para monitorar a evolução das páginas processadas no período. #### Recomendações para otimizar o consumo: - Utilize os filtros de busca antes de subir novos lotes de documentos para checar se o arquivo já consta na base. - Solicite a configuração de deduplicação interna de páginas caso receba notas fiscais/faturas com múltiplas vias idênticas. - Solicite a habilitação do `check_duplicated` se receber documentos por canais variados (e-mail, upload manual ou API).

[@portabletext/react] Unknown block type "helpCallout", specify a component for it in the `components.types` prop
[@portabletext/react] Unknown block type "helpCallout", specify a component for it in the `components.types` prop
[@portabletext/react] Unknown block type "helpCallout", specify a component for it in the `components.types` prop
Este artigo foi útil?

Última atualização: 13/11/2026

Ainda tem dúvidas?

Falar com o suporte