Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Painel
borderColorblack
borderWidth1
borderStylesolid

Índice

Í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;
  • contato com o time de negócios

...

Informações
titleConta

É 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

Informações

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:

Image RemovedImage Added

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

Image RemovedImage 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.

...

  • Clique em Ver Detalhes e copia o  access-token (que será utilizado no campo xApiKey no MK Next Pay)

Image RemovedImage 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 RemovedImage 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 RemovedImage Added



Dica

Para ativação do Webhook é necessário que os dados cadastrais no portal do Sicredi estejam atualizados. Verifique com seu gerente de conta!

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 RemovedImage Added

Ativação da conta Next

Informações
titleCadastro 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.

...

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.

Image RemovedImage Added

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

Image RemovedImage 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 cobrancascobranca

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 RemovedImage 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 Removed

  • 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 RemovedImage 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 Removed

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

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.

...

Informações

Caso uma fatura seja rejeitada verifique os detalhes do motivo da rejeição, faça os ajustes necessários no sistema e após crie um novo filtro de remessa para enviar o registro novamente.

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.

Informações

A API processa os pagamentos a cada 24h, independente do meio de pagamento escolhido pelo cliente: tanto o pagamento pelo boleto (linha digitável), quanto PIX (QRcode), serão processados em rotina diárias (em 24h)Boletos pagos via linha digitável ou código de barras até às 13:30, possuem compensação no turno seguinte. Nos casos de pagamentos por estes meios, após este horário, compensação se dá em D+1.

Pagamentos via PIX (QR CODE), terão compensação IMEDIATA após a liquidação realizada pelo cliente final.