Manual de Instruções

1. O que este sistema faz?

O Exportador Web - Automação AR é uma ferramenta ETL (Extract, Transform, Load) desenvolvida para padronizar planilhas de faturamento/cobrança. Ele consolida relatórios diários (Daily Reports), trata inconsistências de dados e gera um arquivo final padronizado e pronto para importação no sistema de cobrança.

2. Passo a Passo de Uso

Passo 1: Preparar os arquivos

Você precisará de pelo menos um arquivo Excel (.xlsx ou .xls) contendo o relatório principal.

• AR Daily Report (Obrigatório): O seu relatório de base principal contendo os títulos.
• Complemento (Opcional): Uma segunda planilha contendo dados adicionais que precisam ser cruzados com a base.

Passo 2: Inserir no Sistema

• Na tela inicial, clique na primeira área tracejada ou arraste o seu arquivo "AR Daily Report" sobre ela. O quadro ficará verde indicando sucesso.
• Caso possua a planilha complementar, faça o mesmo processo no segundo quadro (opcional).

Passo 3: Processar

Clique no botão verde "GERAR EXPORTAÇÃO". O sistema mostrará uma animação de carregamento. Aguarde alguns segundos.

Passo 4: Download

Uma vez finalizado, o formulário será limpo automaticamente e o download do novo arquivo limpo começará sem precisar de nenhuma outra confirmação. O nome do arquivo gerado geralmente começará com exportado_...

3. Regras de Negócio e Transformações (Como funciona?)

Padronização de Cabeçalhos

O sistema "traduz" dezenas de nomes de colunas diferentes para um modelo de gabarito estrito. Por exemplo:

• due date, vencimento, data de vencimento -> se tornam datavencimento
• customer_code, code, cnpj -> se tornam cnpjdoinadimplente
• value, valor, open value -> se tornam valornominal

Identificação Inteligente de Título e Parcela

O robô busca o campo que representa a "Identidade do Título". Ele tem uma hierarquia de preferência: title > reference2 > invoice > nf.

Para evitar erros de parcelas embutidas com hífen no título (Exemplo: Título 123456-11), o sistema possui uma "Lógica Anti-Corte":

Cruzamento de Base Pelo Complento (Match)

Se você enviar o segundo arquivo "Complemento", o sistema criará uma "Chave Única Segura" para cada linha unindo o Número do Título com a Data de Vencimento. Ele só vai levar para a exportação as linhas do arquivo base que tiverem um casamento perfeito da mesma chave com o arquivo Complemento.

Limpeza Profunda do CNPJ

A automação remove magicamente todos os traços, pontos ou formatações contábeis quebradas (ex: .0 do excel) que vêm junto do CNPJ e preenche com "zeros à esquerda" automáticos para que todo código enviado saia perfeitamente com 14 dígitos numéricos absolutos.

Correção de Datas vazias e Moedas

Colunas de datas como a emissão e vencimento são reformatadas para o formato brasileiro DD/MM/YYYY e as cédulas ou numerações nulas são tratadas como erro e retornam o campo "vazio" propositalmente para não interromper a exportação.