MK NextVAN Sicredi

Índice

Pré Requisitos

  • ERP atualizado na versão MK4;
  • sistema atualizado na release 64.2 ou superior;
  • cadastro no portal de desenvolvedores do Sicredi e ativação das APIs COBRANÇA BOLETO 1.0.0 e API AUTH - OPENAPI - PARCEIROS 1.0.0;
  • contato com o time de negócios

Solicite um contato do time de negócios para que todas as vantagens do MK Next seja apresentadas e então você pode escolher a opção mais adequada 😊

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 cobrança do Sicredi

O tutorial abaixo é uma sugestão para ativar as APIs. Em caso de dúvida entre em contato com o seu gerente de conta, ou atendimento do Sicredi

Solicitando as credenciais

Faça o cadastro no portal de desenvolvedores do Sicredi e então acesse a opção Criar nova app:

Selecione as APIs e clique em registrar COBRANÇA BOLETO 1.0.0 e API AUTH - OPENAPI - PARCEIROS 1.0.0:

Após criar a APP de Produção, você deve, ainda no portal do desenvolvedor abrir um chamado para solicitar o token de acesso.

Selecione a opção “Solicitar Access Token”, e preencha o campo Client ID ou Nome da APP com os dados da APP de produção. O time de tecnologia do Sicredi vai analisar a solicitação e gerar o Access token. Quando for disponibilizado copie a informação para utiliza-la no ERP e MK Next.

  • Clique em Ver Detalhes e copia o  access-token (que será utilizado no campo xApiKey no MK Next Pay)

  • Copie a informação em Cliente ID / Client Secret da área Minhas Apps e então cole no campo ClientID da aplicação para abrir o chamado. Preencha os demais campos conforme imagem abaixo de exemplo:


Após a abertura do chamado você vai receber o retorno do Sicredi informando que as credenciais para utilizar a API de cobrança estão disponíveis. Este processo pode levar alguns dias, é necessário aguardar o SLA do banco.

Gerando a senha no internet banking

Acesse o Internet Banking, pela conta vinculada ao seu convênio de cobrança para gerar a senha de acesso. Seguem instruções conforme o manual do Sicredi:


Para ativação do Webhook é necessário que os dados cadastrais no portal do Sicredi estejam atualizados. Verifique com seu gerente de conta!

Ativação da conta no ERP

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

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

  • Nome da profile - identificação da sua profile no ERP
  • Entidade - MK Next Sicredi
  • 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 Sicredi
  • Nome da integração - descrição identificativa
  • Posto - posto da conta corrente utilizada na van bancária
  • Cooperativa - código da cooperativa da conta bancária
  • Password - senha gerada pelo internet banking
  • xApiKey -  token de acesso gerado no portal de desenvolvimento
  • Scopes - informe cobrancas

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 Sicredi 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 Sicredi:

  • 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

Confirme e então o sistema vai exibir todas as faturas que se encaixam no filtro selecionado. Para efetivar o registro basta confirmar e então o ERP já vai enviar instantaneamente o registro para o banco.

Verificar o registro das faturas

Acesso: Financeiro → Leitura de retorno

Após a geração do arquivo de remessa um novo registro vai ser exibido automaticamente no menu Leitura de retorno com o operador Webhook que indica que foi uma informação gerada automaticamente gerada pelo sistema.

Clique 2x para visualizar as faturas registradas ou rejeições.

Caso uma fatura seja rejeitada verifique os detalhes do motivo da rejeição, faça os ajustes necessários no sistema e após crie um novo filtro de remessa para enviar o registro novamente.

Rotinas de pagamento

Acesso: Financeiro → Leitura de retorno

Os pagamentos também são processados automaticamente assim que a API do banco disponibiliza-los. Cada lote de pagamento vai ficar visível no Leitura de retorno com o operador Webhook que indica que foi uma informação gerada automaticamente gerada pelo sistema.

A API processa os pagamentos a cada 24h, independente do meio de pagamento escolhido pelo cliente: tanto o pagamento pelo boleto (linha digitável), quanto PIX (QRcode), serão processados em rotina diárias (em 24h).
Pix Avulsos tem validade de 90 dias após vencidos!