...

Pré Requisitos

• ERP atualizado na versão MK4;
• sistema atualizado na versão release 64.2 ou superior;
• contratação do produto Cobrança do Sicredi com modalidade API (Cobrança Online) e boleto híbrido;
• criação do "APP para Produção" no portal do Sicredi (entre em contato com a sua agência para auxílio neste processo)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:

Image Added

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

Image Added

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)

Image Added

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

Image Added

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.

Image Added

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:

Image Added

Ativação da conta no ERP

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

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

Image RemovedImage Added

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

Image Removed

Grave o registro e Image Added

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 time de operações da MK via ticket e solicite a ativação da sua conta. (vai ser criado um canal exclusivo pra esses tickets? acho importante já orientar o cliente o máximo possível) 

Neste ticket devem ser passadas as seguintes informações (geradas pelo portal do Sicredi, se tiver dúvidas solicite auxílio do gerente de conta):

• Nome da integração
• Posto
• Cooperativa
• Password
• xApiKey
• Código do beneficiário

A equipe então vai ativar o seu acesso ao Next e mudar o status da profile no ERP para produção 😊nosso time de suporte ao Next.

Image Added

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

Image Added

• 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.

Image Added

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

• Image Addedclient_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:

Image Added

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:

• Image AddedTipo 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

Image AddedApó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.