# Envio de Pix por E-mail

## Introdução
A funcionalidade de **Enviar Pix por E-mail** foi desenvolvida para simplificar o compartilhamento de dados de cobranças via **Pix** diretamente pelo correio eletrônico. Essa solução otimiza a comunicação ao possibilitar o envio de extratos para contatos cadastrados no sistema, promovendo maior transparência no relacionamento com os clientes. Além disso, elimina a necessidade de procedimentos manuais, assegurando que as informações sejam transmitidas com precisão e segurança.

> [!NOTA] **Acesso à Configuração:**  
> **Caminho:** Configurações > Parâmetros > Parâmetros financeiro > Servidor de e-mail Pix

Com essa funcionalidade, é possível notificar os clientes de forma eficiente sobre pagamentos via Pix. Este documento apresenta o passo a passo para configurar e utilizar essa ferramenta no sistema.

### Requisitos de Uso
Para utilizar a funcionalidade de envio de cobranças Pix, é necessário atender às seguintes condições:
- Possuir uma integração de [[e-mail smtp|E-mail SMTP]] ativa e funcional no sistema;
- Utilizar integrações bancárias que efetuem a geração do código pix; 

>[!EXAMPLE] Carteiras de cobrança compatíveis para o envio de pix:
>**Carteiras de pix instantâneo:**
>- Efí Bank;
>- modobank; 
>
>**Carteiras de boleto híbrido (boleto com QRCode Pix):**
>- API Banco do Brasil;
>- API Santander;
>- API Sicoob;
>- API Sicredi;
>- Wide Pay;
>- Iugu;
>- Efí Bank (Gerencianet);
>- Cel_cash (Galaxpay).
>  
>**Carteiras de cobrança com configuração alternativa de pagamento com:**
>- Efí Bank (não gera QR Code no boleto);
>- modobank; 
  
## Entrega de Valor
Esta funcionalidade oferece valor em diversas áreas:
- Possibilita a personalização e envio de cobranças alinhadas às necessidades específicas de cada cliente, promovendo um atendimento mais próximo e individualizado;
- Otimiza o tempo para envio dos dados de cobrança, agilizando o processo de compartilhamento das informações;
- Simplifica o pagamento ao fornecer opções práticas, como Pix Copia e Cola ou QR Code, tornando o processo mais acessível;
- Oferece maior transparência ao disponibilizar aos clientes um acesso fácil e direto às informações de suas cobranças;
- Garante a confiabilidade das informações enviadas, baseando-se em filtros configurados no sistema.

## Estrutura da Funcionalidade
A funcionalidade **'Enviar Pix por E-mail'** está integrada ao processo de geração de boletos do tipo Pix, permitindo o envio eficiente de cobranças diretamente por e-mail. Com essa ferramenta, é possível compartilhar um resumo detalhado dos dados de cobrança com o cliente, incluindo opções práticas de pagamento, como Pix Copia e Cola e QR Code. Essa solução agiliza a comunicação, melhora a experiência do cliente e facilita o recebimento dos pagamentos de forma simples e segura.

Esta funcionalidade é acessada por meio do envio de boletos:
- [[envio de boletos por e-mail pelo financeiro do cliente|Envio de Boletos por E-mail pelo Financeiro do Cliente]]
- [[envio de boletos por e-mail pelo relatorio de emissao de boletos|Envio de Boletos por E-mail pelo Relatório de Emissão de Boletos]]

Ao utilizá-la, o usuário aplica filtros personalizados no sistema, determinando os dados específicos a serem incluídos no envio. O sistema compila as informações e as encaminha automaticamente ao e-mail do destinatário.

O envio de e-mail inclui informações detalhadas sobre a cobrança conforme a configuração das variáveis no SMTP, tais como:
- Pix copia e cola;
- QR Code;
- Valor a ser pago;
- Documento;
- Data de vencimento;
- Boleto anexo (disponível apenas para a modobank).

Essa ferramenta é especialmente útil para empresas que desejam enviar dados financeiros de boletos gerados para seus clientes, garantindo uma comunicação eficiente e transparente sobre os custos e o uso do serviço.

## Configuração e Envio do E-mail para Cobranças Pix
### Passo 1: Servidor de E-mail Pix
Nesta etapa, será definida uma conta de e-mail previamente integrada no sistema como padrão para o envio das mensagens relacionadas à cobranças pix. Para realizar este procedimento, siga os passos a seguir:

1. Acesse o formulário de [[parametros financeiro|Parâmetros Financeiro]] através do caminho: Configurações > Parâmetros > Parâmetros financeiro;
2. Na aba **Geral**, no campo **Servidor de e-mail pix**, clique na lupa e selecione uma conta de [[e-mail smtp|E-mail SMTP]] previamente configurada com sua respectiva mensagem;
3. Clique em **Salvar** para validar a alteração.

>[!INFO] E-mail SMTP:
>Para acessar o material de configuração de uma conta de e-mail SMTP, acesse: [[e-mail smtp|E-mail SMTP]];

>[!TIP] Modelos padrão:
>Para configurar um servidor de e-mail, é possível definir um e-mail específico utilizando modelos padrão previamente configurados. Esses modelos otimizam a construção da mensagem de e-mail, incluindo variáveis Pix, como o código 'copia e cola', QR Code e linha digitável, para boletos gerados nas carteiras [[modobank - pix avulso|modobank - Pix Avulso]], [[efi - pix avulso|Efí - Pix Avulso]] e boletos híbridos. Confira
>- [[modelos padrao e-mail smtp|Modelos Padrão E-mail SMTP]] 
>- [[configuracao modelos padrao de envio de cobrancas pix|Configuração Modelos Padrão de Envio de Cobranças Pix]]


### Passo 2: Envio do Pix por E-mail
Com o servidor de [[e-mail smtp|E-mail SMTP]] padrão previamente configurado para o envio das mensagens, o envio dos dados da cobrança pix é viabilizado, podendo ser efetuado tanto pelo cadastro do [[formulario cliente|Formulário Cliente]] como pelo Relatório de [[emissao de boletos|Emissão de Boletos]]. A configuração prévia do servidor permite que o sistema envie estes dados sem a necessidade de realizar ajustes manuais a cada envio, proporcionando um processo contínuo e eficiente, portanto, para realizar o envio, siga os passos a seguir:

>[!TIP] Importante:
>Certifique-se de que o boleto emitido possui o código pix gerado para recebimento.

#### Envio através do cadastro do cliente
1. Acesse o [[formulario cliente|Formulário Cliente]] através do caminho: Sistema > Cadastros > Clientes;
2. Acesse a aba **Financeiro**;	
3. Selecione um dos boletos gerados e clique em **Imprimir boleto**;
4. Clique em **Enviar por e-mail** para efetuar o disparo da mensagem de e-mail com os dados da cobrança. O sistema processará a solicitação e exibirá um relatório confirmando o status do envio. Caso o envio seja bem-sucedido, a seguinte mensagem será exibida: _"E-mail enviado com sucesso para (e-mail do destinatário)!"_
	O destinatário receberá a mensagem em sua caixa de entrada, que incluirá os seguintes dados configurados no **E-mail SMTP**:
	- **Assunto**;
	- **Responsável pelo envio**;
	- **Conteúdo da mensagem**.

#### Envio através do relatório de [[emissao de boletos|Emissão de Boletos]]
1. Acesse o formulário de [[emissao de boletos|Emissão de Boletos]] através do caminho: Relatórios > Relatórios financeiros > Relatórios de Saída > Emissão de boletos;
2. Filtre por **Carteira de cobrança**, **Data de vencimento inicial e final** e **Status dos títulos (abertos)**. Após aplicar os filtros, clique em **Enviar por e-mail** para efetuar o disparo da mensagem de e-mail com os dados da cobrança. O sistema processará a solicitação e exibirá um relatório confirmando o status do envio. Caso o envio seja bem-sucedido, um relatório será impresso na tela do sistema, contendo uma listagem com os clientes dos quais foram identificados nos filtros: _"E-mail adicionado na fila com sucesso! Destinatário: (e-mail do destinatário)!"_
	O destinatário receberá a mensagem em sua caixa de entrada, que incluirá os seguintes dados configurados no **E-mail SMTP**:
	- **Assunto**;
	- **Responsável pelo envio**;
	- **Conteúdo da mensagem**.

>[!DANGER] Atenção:
>Ao utilizar a carteira de cobrança [[efi - pix avulso|Efí - Pix Avulso]], o envio de faturas pelo relatório de emissão de boletos **não** é permitido, portanto, utilize o envio através do financeiro do cliente.

>[!INFO] modobank
>Além da mensagem de e-mail, o sistema anexa automaticamente o **PDF** contendo os dados detalhados do título, contendo o QRCode e demais informações da cobrança, enviando ao cliente de forma segura 

>[!SUCCESS] Finalização:
>Após o sistema exibir a mensagem de confirmação, o processo será concluído e o cliente receberá a mensagem com sucesso. A mensagem ficará registrada em [[log de e-mail|Log de E-mail]] (Configurações > Logs > Log de e-mail).

>[!CAUTION] Atenção:
>Caso, após solicitar o envio, a mensagem exibida seja diferente de _"Sucesso"_, verifique os dados da conta de **E-mail SMTP** integrada. Se necessário, redefina a senha da conta no provedor de e-mail e também no sistema **IXC** para restabelecer a comunicação entre as plataformas envolvidas. Certifique-se de que as credenciais estejam corretamente configuradas para garantir o envio bem-sucedido das mensagens.


## Fluxo de Trabalho

```mermaid
graph TD
  A[Início] --> B{Enviar e-mail através do cadastro do cliente?}
  B -->|Sim| C[Acesse o Formulário Cliente<br>Sistema > Cadastros > Clientes]
  C --> D[Acesse a aba Financeiro]
  D --> E[Selecione um boleto e clique em Imprimir boleto]
  E --> F[Clique em Enviar por e-mail]
  F --> G[O sistema processa a solicitação e exibe o status]
  G --> H{Envio bem-sucedido?}
  H -->|Sim| I[E-mail enviado com sucesso<br>Dados:<br>- Assunto<br>- Responsável<br>- Conteúdo]
  I --> J[Registrar no log de e-mail]
  H -->|Não| K[Erro no envio<br>Verificar configuração SMTP]

  B -->|Não| L{Enviar e-mail através do relatório de Emissão de Boletos?}
  L -->|Sim| M[Acesse Relatórios > Relatórios financeiros<br>Relatórios de Saída > Emissão de boletos]
  M --> N[Filtre por:<br>- Carteira de cobrança<br>- Data de vencimento<br>- Status dos títulos]
  N --> O[Clique em Enviar por e-mail]
  O --> P[O sistema processa a solicitação e exibe o status]
  P --> Q{Envio bem-sucedido?}
  Q -->|Sim| R[E-mail adicionado à fila<br>Dados:<br>- Assunto<br>- Responsável]
  R --> S[Registrar no log de e-mail]
  Q -->|Não| T[Erro no envio<br>Verificar configuração SMTP]

```

## Considerações Finais
A funcionalidade de envio de e-mails para cobrança de boletos oferece uma solução eficiente e automatizada para empresas, simplificando a comunicação com os clientes e garantindo o envio de informações precisas sobre os pagamentos. A integração com o log de e-mails proporciona maior controle e rastreabilidade das ações, permitindo que as equipes monitorem o sucesso ou falha de cada envio. Com a personalização dos dados, como o assunto, responsável e conteúdo da mensagem, a ferramenta assegura que o processo de cobrança seja transparente, ágil e alinhado às necessidades da empresa, resultando em um atendimento mais eficiente e em melhores práticas de gestão financeira.

## Etiquetas
#Integracoes #EmailSMTP #EmissaoDeBoletos #CadastroCliente 
## Leia Também
 - [[integracoes|Integrações]]
 - [[e-mail smtp|E-mail SMTP]]
 - [[modobank - pix avulso|modobank - Pix Avulso]]
 - [[efi - pix avulso|Efí - Pix Avulso]]
 - [[emissao de boletos|Emissão de Boletos]]
 - [[formulario cliente|Formulário Cliente]]
 - [[parametros financeiro|Parâmetros Financeiro]]
 - [[contas a receber|Contas a Receber]]
- [[emissao de boletos|Emissão de Boletos]]
- [[integracoes bancarias - carteira de cobranca|Integrações Bancárias - Carteira de Cobrança]]
- [[integracoes bancarias - gateway|Integrações Bancárias - Gateway]]
- [[integracoes bancarias - api|Integrações Bancárias - API]]
- [[integracoes bancarias - pix avulso|Integrações Bancárias - Pix Avulso]]