Í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
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. ACESSO: Cobrança → Código de Acesso → Gerar. Atenção: este menu é apresentado exclusivamente para os beneficiários que possuem a modalidade API(Cobrança Online) habilitada no convênio)
Gere então a senha de acesso e armazene ele para configuração no Next.
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 - senha da API gerada 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 😊