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

Ativação da API de Cobrança 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:

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 -  token de acesso gerado no portal de desenvolvimento
• Scopes - informe cobranca

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.

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.