Emissão de Boleto Com PagHiper
v1.0.0
**Visão Geral** Pedidos cujo meio de pagamento é **Boleto Bancário** podem ter o boleto de cada parcela emitido via integração com o **PagHiper** (por trás, o redline chama o serviço `magneto-api`, que fala com a API do PagHiper). A emissão pode acontecer de duas formas: **manual**, pelo botão **Boleto** no lançamento, ou **automática**, disparada junto com o e-mail da nota fiscal — as duas usam exatamente a mesma integração e produzem o mesmo resultado (linha digitável, código de barras, PDF). ***Prints exemplificando os testes na sessão "Como testar"*** --- ## Pré-requisitos (configurar ANTES de emitir o boleto) > Obs: Em clientes migrados do Teorema Praxis que já usam a funcionalidade, já deve vir preenchido essas informações. | Onde configurar | O que configurar | | --- | --- | | Financeiro → Cadastro de Conta → seção Carteiras | Cadastrar uma carteira com Nome, API Key e Token do PagHiper | | Financeiro -> Cadastro de Meio de Pagamento (tipo Boleto Bancário) | Selecionar PagHiper no campo Integração emissão de boletos | | Lançamento financeiro do pedido | Método de pagamento = o de Boleto Bancário configurado acima, na Conta que tem a Carteira vinculada | Carteira: Método de pagamento:  > Precisa ser do tipo "Boleto" para conseguir inserir a integração  > Sem esses itens configurados, nenhuma das duas formas de emissão (manual ou automática) funciona. --- ## Emissão manual — botão "Boleto" no lançamento A qualquer momento, com ou sem nota fiscal emitida, é possível gerar ou consultar o boleto de uma parcela direto pelo lançamento financeiro. No momento da geração, o próprio PagHiper envia no email cadastrado no cliente, o boleto. **Passo a passo:** 1. Abra o lançamento do pedido (pela tela de Contas a Receber, ou pelo detalhe da parcela) 2. Na parcela desejada, clique no botão **Boleto** 3. Escolha a **Carteira** cadastrada e clique em **Emitir** 4. O painel mostra o número, a linha digitável, o código de barras, o status, e links para abrir o boleto/PDF 5. Use o botão **Consultar** para atualizar o status a qualquer momento (a consulta de status não é automática). Se a parcela já tiver um boleto emitido, o painel mostra direto o resultado — o botão **Emitir** não aparece mais, e clicar em Emitir de novo não gera um segundo boleto nem gasta uma nova cobrança na integração. ## Emissão automática — junto com o e-mail da nota fiscal Quando a nota fiscal do pedido é enviada por e-mail (automaticamente após a autorização, ou manualmente pela tela de detalhe — ver `manual_envio_email_nfe.md`), o sistema aproveita esse mesmo momento para gerar o boleto de cada parcela, sem nenhuma ação extra do operador: > Para isso, precisa estar habilitado na operação a geração de financeiro  - Para cada parcela do lançamento que ainda não tem boleto emitido, o sistema chama a integração e gera um boleto novo - Se a parcela já tiver um boleto emitido anteriormente (seja porque foi gerado manualmente antes, ou em um envio de e-mail anterior), o sistema **reaproveita** o que já existe — não gera de novo - O corpo do e-mail passa a listar o código de barras de cada parcela, e o PDF do boleto é anexado por link (mesmo padrão do DANFE) - Se a carteira não tiver API Key/Token preenchidos, ou o meio de pagamento não tiver a integração PagHiper habilitada, o e-mail é enviado normalmente (DANFE + XML) — só sem o boleto; não gera erro nem bloqueia o envio > **Atenção — ambiente de Homologação**: nesse caminho automático (via e-mail), o boleto **não é gerado** para notas emitidas em ambiente de Homologação, porque o envio de e-mail inteiro é bloqueado para homologação. A emissão **manual** pelo botão Boleto não tem essa restrição — funciona independente do ambiente da nota. --- ## Conteúdo do e-mail (quando há boleto) Além do conteúdo padrão descrito em `manual_envio_email_nfe.md` (DANFE + XML): | Elemento | Descrição | | --- | --- | | Anexo boleto (PDF) | Um por parcela, anexado por link | | Corpo (parcelas) | Lista o código de barras de cada parcela | --- ## Como testar > **Atenção**: o PagHiper não tem ambiente de sandbox — qualquer emissão é real e pode ser cobrada pelo provedor. Use uma credencial de teste da conta e valores baixos. **Testando a emissão manual (mais rápido, não depende de nota fiscal nem de e-mail):** 1. Configure a Carteira (Conta → Carteiras) com uma API Key/Token do PagHiper 2. Configure o Meio de Pagamento como Boleto Bancário, com PagHiper habilitado em "Integração emissão de boletos" 3. Crie um lançamento/pedido usando esse meio de pagamento 4. Abra a parcela, clique em **Boleto** → **Emitir** e confirme que aparece linha digitável, código de barras e PDF 5. Clique em **Consultar** e confirme que o status atualiza Cria um lançamento ou edita um já existente:     **Testando a emissão automática (via e-mail):** 1. Emita um pedido, preenchendo o lançamento financeiro e gerando uma NFe/Nfce 2. Verifique o e-mail recebido: deve conter o código de barras da(s) parcela(s) no corpo e o link do PDF do boleto 3. Volte no botão **Boleto** do lançamento e confirme que mostra o mesmo boleto (não foi gerado um segundo) *Tela que mostra ao finalizar uma nota cuja operação gere financeiro:*Nota finaliza normal e se tudo correr bem, boleto irá chegar no email cadastrado no cadastro do cliente e constar no financeiro: ## Informações do documento > Autor: Des.Raqueli > Setor: Desenvolvimento > Chamado: 0000563939