Pré Requisitos

• ERP atualizado na versão MK4;
• Sistema atualizado na release 64.6 ou superior;
• Solicitação para a cooperativa à qual está cadastrado para habilitação na Plataforma Cobrança Bancária 3.0; 
  - Para habilitar essa funcionalidade do boleto híbrido é necessário que o cooperado entre em contato com a cooperativa que ele está cadastrado e solicite a habilitação em seu cadastro, na Plataforma Cobrança Bancária 3.0, por meio do seguinte caminho: Sisbr 2.0 → Cobrança Bancária 3.0 (Direcionamento para o Sisbr 3.0) → Beneficiário → Cadastro. Para isso, será necessária e obrigatória a criação prévia de uma chave aleatória Pix para o usuário (cedente).
• Extração da chave pública .pem do certificado A1 para upload no portal do Sicoob;
• Contato com o time de negócios.

Ativação da API de cobrança do Sicoob

Primeiro entre em contato com o seu gerente de conta e siga as etapas de habilitação por beneficiário na Plataforma Cobrança Bancária 3.0. Esse primeiro contato com o gerente e agência é pré requisito para seguir com a integração!

Após, no portal de desenvolvimento do Sicoob deve ser solicitada a criação da aplicação para geração do boleto híbrido e API de cobrança. Faça login e acesse o menu Meus Aplicativos  → Nova Aplicação. Caso o seu cadastro esteja desatualizado há algum tempo, será exigida a atualização das informações de sua conta.

Selecione a aplicação Cobrança Bancária:

Após a criação da aplicação será enviado um código de verificação no seu APP Sicoob.

Prossiga com o cadastro no aplicativo seguindo os passos da tela de geração da aplicação que será apresentada. Após a geração, as aplicações de acesso e as URLs de produção estarão disponíveis no menu Meus Aplicativos no portal.

Extraindo a chave pública do certificado digital

Faça o download do OpenSSL clicando neste link, a versão é a 1.1 Portable. Extraia da pasta compactada e salve no seu computador no diretório de sua preferência. No exemplo abaixo foi salvo dentro da pasta Documentos: 

Na mesma pasta onde salvou o OpenSSL (a pasta vai ficar com o nome OpenSSL-1.1.1h_win32) coloque o seu certificado digital (caso o nome do certificado tenha espaçamentos na descrição é recomendado que renomeie ele e retire os espaços): 

Abra o terminal openssl como administrador: 

Execute no terminal: 

Onde:

• CertificadoDigital.pfx - substitua pelo nome e extensão do seu certificado digital
• ChavePublica.pem - substitua pelo nome que deseja utilizar para a chave pública

Após rodar o comando o terminal vai solicitar a senha do certificado:

Basta informar e então se estiver correta a chave publica vai ser criada dentro da mesma pasta OpenSSL-1.1.1h_win32.

Criação da conta no ERP

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

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

• Nome da profile - identificação da sua profile no ERP
• Entidade - MK Next Sicoob
• 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

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.

Acesso: Configurações  → Integrações  → Criar nova integração

• Template de integração - selecione a opção Banco Sicoob para que os campos abaixo sejam habilitados;

• Nome da integração - identificação da sua conta no Next;

• Número do contrato - informação obtida pelo portal do Sicoob;
• Modalidade - informação da conta corrente;
• Número da conta corrente - informação da conta corrente;
• clientId - informação obtida pelo portal do Sicoob;

• Scopes -  clique para visualizar e copie todo o conteúdo abaixo e cole na área (são 27 linhas no total):

   Clique para visualizar

  cobranca_boletos_consultar
  cobranca_boletos_incluir
  cobranca_boletos_pagador
  cobranca_boletos_segunda_via
  cobranca_boletos_descontos
  cobranca_boletos_abatimentos
  cobranca_boletos_valor_nominal
  cobranca_boletos_seu_numero
  cobranca_boletos_especie_documento
  cobranca_boletos_baixa
  cobranca_boletos_rateio_credito
  cobranca_pagadores
  cobranca_boletos_negativacoes_incluir
  cobranca_boletos_negativacoes_alterar
  cobranca_boletos_negativacoes_baixar
  cobranca_boletos_protestos_incluir
  cobranca_boletos_protestos_alterar
  cobranca_boletos_protestos_desistir
  cobranca_boletos_solicitacao_movimentacao_incluir
  cobranca_boletos_solicitacao_movimentacao_consultar
  cobranca_boletos_solicitacao_movimentacao_download
  cobranca_boletos_prorrogacoes_data_vencimento
  cobranca_boletos_prorrogacoes_data_limite_pagamento
  cobranca_boletos_encargos_multas
  cobranca_boletos_encargos_juros_mora
  cobranca_boletos_pix
  cobranca_boletos_faixa_nn_disponiveis
• Certificado - faça o upload do certificado .pfx do qual extraiu a chave pública utilizada no portal do Sicoob;
• Password - informe a senha do certificado digital;
• Distribuição Boleto - preencha cliente;
• Emissão Boleto - preencha cliente;

No menu Minha empresa → Integrações copie 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.