Pré Requisitos

• ERP atualizado na versão MK4;

• Sistema atualizado na release 64.2 ou superior;

• Credenciais disponibilizadas após cadastro no Portal Developers do Bradesco.

• Contato com o time de negócios

 

Documentação para uso do PORTAL DEVELOPERS:

Conta

É possível ativar a API para VAN bancária em uma conta (profile) que já é utilizada no ERP. Neste cenário a profile atual deve ser desativada para que após seja configurada a nova profile com a entidade da VAN bancária.

Ativação da API de Boleto Simples + API Pix Bradesco

 

O banco Bradesco não possui um Portal Developers para geração de chaves pelo próprio cliente/provedor. Dessa forma, a solicitação deve ser feita pelo cliente/provedor diretamente ao seu gerente de cash do banco Bradesco e o banco será o responsável por lhe fornecer os dados necessários para preenchimento da integração do MK Next com o Bradesco. É de suma importância que se atente a necessidade da geração, pelo Bradesco, de credenciais para API Boleto Simples e API PIX, pois a API de Boleto Hibrido do banco não apresenta um comportamento esperado como as demais VANS que já estão implementadas no MK Next. 

A necessidade de geração de dados para essas duas APIs citadas acima é de que a API de Boleto Simples não é capaz de gerar qrcode ou PIX copia e cola para a cobrança, sendo assim uma API complementará o serviço da outra e provedor precisará utilizar a integração de VAN com os dados da API de Boleto Simples e a integração de PIX Avulso Next com os dados da API PIX do Bradesco e posteriormente vincular uma a outra.

Vale ressaltar também que API Boleto Simples não possuem webhook, ou seja, as liquidações só funcionam mediante disparo de rotinas internas do MK Next para consulta dos boletos na API do banco Bradesco.

Ativação da conta no ERP

ACESSO: Configurações → Profiles de pagamento → Boleto MK Ver 2.

Em DADOS BÁSICOS DA PROFILE preencha os seguintes campos:

• Nome da profile - identificação da sua profile no ERP

• Entidade - MK Next Bradesco

• Multa - % de multa mensal

• Juros - % de juro diário

• Status Profile - Em homologação

• Instruções - instruções de pagamento que vão constar no layout do boleto (gerado em PDF)

• Modelo padrão de impressão - selecione um dos modelos padrões (ou entre em contato com o time de operações caso deseje personalizar o layout):

  • Impressão 3 x folha - layout em que, caso selecionados múltiplas faturas para impressão, terão a geração de 3 boletos por folha com o QRcode e linha de pagamento via PIX

  • Impressão 2 x folha - layout em que, caso selecionados múltiplas faturas para impressão, terão a geração de 2 boletos por folha com o QRcode e linha de pagamento via PIX

  • Impressão 1 x folha - layout que terá a geração de 1 boleto por folha com o QRcode e linha de pagamento via PIX

• Modelo para impressão via SAC - modelo de impressão que será utilizado no SAC (web e app) caso deseje que seja diferente do que é gerado via sistema

Acesse a aba DADOS DO BENEFICIÁRIO e preencha as informações com os dados do CNPJ beneficiário da conta:

Ativação da conta Next

Cadastro da matriz

Para o cadastro utilize os dados da matriz do seu provedor. Se tiver multiempresas, ou contas com CNPJs diferentes cadastre como novas integrações, dessa forma todas vão ficar vinculadas ao CNPJ da matriz.

Acesso: criação de conta Next

Siga os passos até a etapa de confirmação para criar a sua conta e obter o acesso. Se tiver qualquer dúvida neste processo entre em contato com o nosso time de suporte ao Next.

E então insira os dados para a integração no menu Configurações → Integrações:

• Template de integração -  selecione Bradesco

• Nome da integração - descrição identificativa

• clientId - clientId informado pelo Bradesco

• clientSecret - clientSecret informado pelo Bradesco

• senha do certificado- senha do PFX atribuído a integração

• certificado .pfx - certificado utilizado para geração das credenciais da API

• Id da carteira -  numero da carteira da conta do cliente/provedor

• Número da agência - numero da agência do provedor + digito 0 a esquerda

• Número da conta: número da conta bancária do provedor + digito 00 a esquerda

• Número do CNPJ da conta Bradesco - Número do CNPJ da conta vinculada ao APP no Portal Developers.

• Integração PIX Avulso - Para VAN Bradesco é imprescindível ter uma integração pix vinculada pois a API utilizada não dispõe de criação de PIX. Você pode vincular um pix avulso Bradesco ou de qualquer banco que desejar.

No menu Minha empresa → Integrações copie e cole os dados que foram gerados automaticamente para a sua empresa, eles serão utilizados no seu ERP.

Ativação da conta no ERP

ACESSO: Configurações → Profiles de pagamento → Boleto MK Ver.2. Localize a sua profile MK Next Bradesco e acesse a aba MK NEXT → Cadastrar credenciais MK Next

• client_id - copie do seu MK Next;

• client_secret - copie do seu MK Next;

• integration_id - solicite ao time de suporte do Next;

Grave o registro e utilize a ferramenta Testar comunicação:

Será realizado um teste de comunicação entre o ERP e o Next.

Informe no ticket de ativação da sua conta e então o nosso time de onboarding do Next vai mudar o status da profile no ERP para produção. Pronto! Você já pode utilizar as ferramentas da integração pela VAN bancária e também todos os recursos do seu MK Next 😊

Registro de faturas

Acesso: Financeiro → Remessas

O registro dos boletos é realizado através da API da van bancária. Por isso no ERP basta criar um filtro de arquivo de remessa para a profile e ao concluir o registro será enviado automaticamente para o Bradesco:

• Tipo da remessa - Normal (todos registros);

• Tipo de profile - Boleto;

• Profile - localize a sua profile MK Next;

• Tipo de período -

  • Data de vencimento - para registrar faturas que tem vencimento dentro de um período;

  • Data de lançamento - para registrar faturas que foram criadas dentro de um período;

• Data inicial - início do período;

• Data final - final do período;

• TAG - para personalizar o filtro de acordo com TAGs utilizadas nos cadastros dos clientes