Í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:
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
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 😊