Início rápido

O PDF Mail Engine é uma ferramenta local e segura para gerar e enviar PDFs em massa por e-mail. Este guia vai levar você da instalação ao envio da sua primeira fatura em poucos minutos.

Passo 1: Instalação

A forma mais segura de instalar o aplicativo é pela Microsoft Store.

1. Clique no botão acima.
2. Clique em Obter (ou Instalar).
3. Após a instalação, clique em Abrir.

Passo 2: Criando seu primeiro perfil

Ao iniciar o aplicativo pela primeira vez, a tela inicial exibe duas opções:

• Create New Profile — Comece do zero com seus próprios dados.
• Try Demo Data — Explore o aplicativo com dados de exemplo pré-carregados (recomendado para novos usuários, veja abaixo).

Clique em Create New Profile, insira um nome descritivo como Faturas Mensais e clique em Create. Você será direcionado para a tela de configurações do Perfil.

Configurar e-mail (SMTP)

Na tela de configurações do perfil, encontre a seção SMTP & Email Configuration e configure o servidor de e-mail para envio. Você precisará dos dados de conexão do seu provedor:

• Host: O endereço do servidor (ex.: smtp.example.com)
• Port: Geralmente 587 (TLS) ou 465 (SSL)
• Username: Seu ID de login (geralmente seu endereço de e-mail, mas consulte o provedor)
• Password: Sua senha de login
• SSL/TLS: Habilite se exigido pelo provedor (geralmente sim)

Passo 3: Criando um modelo

Agora, vamos criar o layout do seu PDF. Você usará nosso Template Designer visual.

1. Baixar dados de exemplo

Primeiro, baixe esta lista de faturas de exemplo para usar no design: 📥 sample_invoices.csv

2. Abrir o Designer

Na tela de configurações do perfil, clique no botão Template Designer (localizado no canto inferior direito).

3. Inicializar o modelo

Antes de começar a projetar, uma tela de configuração será exibida para definir a estrutura dos dados:

1. Load Data: Clique em Load Transaction Data e selecione o arquivo sample_invoices.csv que você acabou de baixar.
2. Group Key: Selecione uma coluna que identifique um documento único (ex.: id).
3. Email Address: Selecione a coluna que contém os endereços de e-mail (ex.: email).
4. PDF Filename: Defina como os arquivos devem ser nomeados. Você pode usar variáveis como {{ id }}_{{ name }}.pdf.
5. Clique em Finish.

4. Criar o layout

Agora você está no canvas visual do designer.

1. Adicionar texto: Arraste um elemento Text para o canvas.
2. Mapear variável: Na área de conteúdo do texto, digite: Olá, {{ name }}.
   • Você verá a atualização em tempo real usando seus dados de exemplo.
3. Salvar: Clique em Save e nomeie como invoice_template.yaml.

Passo 4: Gerar e enviar

Agora que seu perfil está pronto (e-mail configurado, modelo selecionado), vamos executar o processo.

1. Importar dados

Navegue até Data Import na barra lateral e selecione o mesmo sample_invoices.csv. (No cenário real, aqui você selecionaria seus dados mensais).

2. Gerar PDFs

Navegue até PDF Generation na barra lateral e clique em Run Process. O motor processará cada linha do CSV, substituindo {{ name }} pelos nomes reais (ex.: "Alice", "Bob"), e criará os PDFs na pasta de saída.

3. Enviar e-mails

Navegue até Email Sending na barra lateral. Revise a fila e clique em Run Process para enviar os PDFs gerados como anexos de e-mail.

Testar dados de demonstração

Se você deseja explorar o aplicativo antes de configurar seus próprios dados, escolha Try Demo Data na tela inicial:

1. Clique em Setup Demo.
2. Opcionalmente, insira os dados do seu servidor SMTP (você pode pular essa etapa e configurar depois).
3. Um perfil de demonstração com modelo e dados de exemplo será criado automaticamente.

É uma ótima forma de ver como o fluxo de trabalho funciona de ponta a ponta antes de criar seu próprio perfil.

Resumo

Você concluiu com sucesso:

1. A configuração de um perfil.
2. A inicialização e o design de um modelo dinâmico.
3. A geração e o envio de PDFs personalizados.

Próximos passos:

• Recursos avançados de modelo: Tabelas, imagens e códigos de barras.
• Cálculos: Impostos, totais e lógica condicional.