Ir para o conteúdo principal

Boleto Híbrido - Pix Shipay

Disponibilizado no Ema ERP a emissão de Boleto Híbrido, combinando o Código de Barras e QR Code, permitindo o pagamento tanto em bancos e caixas eletrônicos quanto via Pix.

A configuração do boleto híbrido é de responsabilidade técnica da Ema Software, não do cliente.

 
Configuração Shipay

A emissão de boleto híbrido é feita em parceria com a Shipay, então a configuração deve ser realizada conforme a documentação Integração Pix - Shipay, disponibilizada aqui! 

 
Requisitos
  • É necessário habilitar a licença de uso do produto PIX Shipay;
  • A emissão de boleto híbrido é feita em parceria com a Shipay, então a configuração deve ser realizada conforme a documentação Integração Pix - Shipay, disponibilizada aqui!
  • O cadastro no painel Shipay deverá estar pronto, contendo todas as informações necessárias do cliente, assim como as credenciais de bancos e carteiras digitais que serão utilizadas. Este serviço é de responsabilidade da Ema Software, através do técnico responsável pelo painel Shipay, que deverá incluir o cadastro com as informações passadas pelo cliente.
Configurando o ERP

A configuração no ERP é relativamente simples, para isso precisamos ir em: Configuração > Matriz/filial > botão direito na filial que será configurada > Outros parâmetros > Navegar até a aba Pix/Shipay.

image-1669226593408.png

É ali que será configurado a API e as chaves para a integração:
⦁ URL API
⦁ Para homologação: https://api-staging.shipay.com.br/
⦁ Para produção: https://api.shipay.com.br/ * ajustar para orientar em não deixar configurado dentro da ema.
⦁ Access Key : No painel inicial do loja do cliente fica disponível a chave
⦁ Homologação: -z_rA4W9q1vSZrmePAxyrw
⦁ Secret Key: Fica disponível logo abaixo da access key
⦁ Homologação: 3ty93zQ2AcxAfxWOUzIN6SId7YpPfI1qpXMriBU4dSlNWYAIQMpkwhCHTdhBmbuXaRxP2xV0Ib4BpvjEIeJr_g
⦁ Cliente id: disponibilizado no painel de lojas do cliente no menu caixas.
⦁ Homologação: 3iphdywdxeHcYYMvKpgJH2jhJbVq80F2mbQq2621QXUGEboj4FrPxWM4RK49GQmfTZoCCtgnplCCs2ZI0HYON67jXfUV4BLqC269k7Mzg5Dwmr4S7tzH1HTxN1ZvW_Xh50VAzNuY_tu15lzCl_NxJXQGWksJ-FpT8InRCWyJE2E
Para produção, irá variar de cliente para cliente as chaves de acesso.
OBS.: Caso o cliente não possua a licença, o ERP não permitirá que a configuração seja concluída, apresentando uma mensagem na tela.

Configurar Conta Financeira
Em Finanças > Contas Financeiras, realizaremos o vínculo da conta que será movimentada no ERP, juntamente com a conta configurada no parceiro Shipay. 

Além de configurar a aba Filiais, é necessário preencher por completo a aba Boleto e CNAB, onde foram adicionadas as colunas Boleto híbrido e Boleto híbrido - Pix".
 
Habilite o checkbox Boleto híbrido e na coluna Boleto híbrido - Pix insira o código Shipay, conforme documentado aqui:
image-1733513075017.png

 

Após realizadas as devidas configurações, recomenda-se realizar uma cobrança de teste, realizando o pagamento de um título qualquer usando um método do "Tipo = Pix", garantindo que a integração com a Shipay está correta.

 
Configurando o Espelho do Boleto

Após validar a integração e cobrança com a Shipay, o espelho do boleto deve ser personalizado com o QR Code.

Na operação de pagamento > Contas a Receber > Selecione um título em aberto que permita gerar boleto > Ações > Imprimir > Gerar boletos [CTRL + B]:

image-1733747409134.png

Na operação, selecione a Conta Financeira configurada para a geração do Boleto Híbrido:

image-1733747515992.png

Na aba Relatório, selecione a opção "Personalizar":

image-1733747628413.png

Na estrutura de dados "DBPipe", será possível selecionar o campo "shipayqrcode" para personalizar o espelho do Boleto:

image-1733748101911.png

 

Com o Boleto Híbrido personalizado, teremos esse resultado:

image-1733748266498.png

 

Agendador

Para que as baixas dos pagamentos dos boletos sejam processadas, foi criado o novo Agendador "Verifica baixa de boleto híbrido - Shipay", que pode ser configurado com a periodicidade desejada. Em Configuração > Cadastros > Agendador:

image-1733748508131.png

Título Vencido

Ao tentar gerar um boleto para um título vencido, será exibida a mensagem:

image-1733748926951.png

Bastará realizar a operação na consulta de título > Ações > Prorrogar vencimento [CTRL + P]:

image-1733749027472.png

Após prorrogar o vencimento, será possível gerar o Boleto Híbrido!