...

...

Visão geral

O MK erp possui integração com a API do Pix Sicredi, o que viabiliza a realização de pagamentos (QRcode e pix copia e cola) pelo SAC WEB e app do SAC Plus+. Nesta modalidade os valores Pix pagos pelos clientes são depositados diretamente na conta corrente do provedor.

Com esta integração será possível: 

• Disponibilizar QRcode para pagamentos dos clientes
• Disponibilizar a linha do QRcode para pagamentos dos clientes (na modalidade/opção de pagamento PIX COPIA E COLA)
• Receber pagamentos dos clientes automaticamente
• Acompanhar as transações (geração do QRCode, pagamentos efetivados e rejeitados)

Pré Requisitos

• Sistema na versão 109.5254 - MK4 (veja informações sobre a migração em nosso canal no YouTube)
• Profile V2 homologada do Sicredi
• Acesso ao sistema e SAC web em https (recomendado)
• Processo de onboarding e geração dos certificados com a equipe de integrações do Sicredi

Configurações de adesão

O primeiro passo é iniciar a jornada de adesão junto com o a equipe do Sicredi. Entre em contato com a cooperativa (o gerente da sua conta pode lhe encaminhar para o setor responsável) e solicite a adesão com a integração API a integração API Pix. O gerente vai direcionar para a equipe de onboarding Pix.

Informações sobre o mk erp que serão solicitadas pelo Sicredi (em destaque as respostas que devem ser enviadas):

...

Execute no terminal:

Será solicitada uma senha para gerar o arquivo de chaves, informe a senha que desejar e após confirme a senha. Dica: anote/decore ele pois será utilizada novamente.

...

Execute no terminal:

Informe a senha gerada nos passos anteriores:

...

E após execute:

Pronto! O certificado foi gerado, ele fica salvo dentro da pasta OpenSSL-1.1.1h_win32

...

• mkSicrediCSR.csr - este certificado deve ser enviado para o Sicredi, por upload no internet banking, conforme o manual da cartilha de integração;
• mkSicrediFinal.key - guarde este certificado para fazer upload na profile do Sicredi no mk erp.

Próximos passos

Após o upload no internet banking eles vão analisar o certificado .CSR enviado e então disponibilizar o certificado .CER assinado que de fato será usado na integração com o mk erp. O SLA para disponibilização do certificado é de 3 dias úteis. É necessário aguardar este envio para seguir com a configuração da profile no sistema. Siga as etapas 1,2 e 4 do manual do Sicredi para fazer o upload, obter o certificado .CER e as credenciais. A ETAPA 1 descreve como deve ser feito o upload do mkSicrediCSR.csr:

...

A ETAPA 2 descreve o processo de análise/assinatura do Sicredi, o arquivo .CER será disponibilizado em alguns dias (o SLA do Sicredi é de 3 dias útei para análise deste certificado):

A equipe de desenvolvimento do mk erp já fez testes de pagamento com o Sicredi durante a criação da integração, por isso o sistema é considerado como já homologado. Assim basta solicitar para a agência as chaves de produção para inserir na profile. A ETAPA 4 informa os passos finais e direciona para a seleção do certificado já aprovado para gerar as credenciais do ambiente de produção.

Image Removed

Configuração da profile de pagamento

ACESSO: Configurações → Menu Financeiro → Submenu Profile de Pagamento → Boleto MK Ver. 2 - Edição, localize a profile do Sicredi e então vai estar disponível a área PIX para inserir a configuração:

Image Removed

Preencha os seguintes campos:

• Chave PIX: chave Pix da conta Sicoob (gerada pelo Sicoob e enviada para o cooperado por e-mail, pode ser o CNPJ, um e-mail, telefone, chave aleatória... verifique com o seu gerente)
• Credenciais: seleção da credencial utilizada na conta/profile de pagamento. Clique em Cadastrar credenciais PIX para inserir os dados de produção;
• Status: selecione a opção:
  
  • Produção
• Hab. testes:
  • Sim: pode utilizar esta opção para realizar um teste de pagamento, dessa forma a geração do QRcode vai ser permitida somente para um cadastro selecionado como Cliente Homologação;
  • Não: liberado para todos os clientes;
• Cliente Homologação: 
• Testar comunicação: teste de comunicação com o Sicoob para confirmar se a chave e credenciais estão corretas (clique para executar somente após inserir os dados conforme instruções abaixo);
• Cadastrar credenciais PIX: ao clicar neste botão será aberta nova janela onde deve ser inserida a configuração com as novas chaves de produção;

Image Removed

• client_id: credencial de produção enviada pelo Sicredi;
• client_secret: credencial de produção enviada pelo Sicredi;
• path_cert_host: certificado digital público do host da api Pix do Sicredi (pode fazer o download clicando aqui e após basta fazer o upload no sistema);
• path_cert_client: certificado .CER disponibilizado pelo Sicredi no internet banking;
• path_key_cliente: chave privada extraída do certificado digital (se foi seguido o passo a passo da documentação Pix Sicredi: gerando o certificado .CSR vai estar salvo no computador com o nome mkSicrediFinal.key).

 Testar comunicação

Para confirmar que as chaves de homologação estão corretas utilize a ferramenta Testar comunicação:

Image Removed

...

isso o sistema é considerado como já homologado. Assim basta solicitar para a agência as chaves de produção para inserir na profile. A ETAPA 4 informa os passos finais e direciona para a seleção do certificado já aprovado para gerar as credenciais do ambiente de produção.

Image Added

Configuração da profile de pagamento

ACESSO: Configurações → Menu Financeiro → Submenu Profile de Pagamento → Boleto MK Ver. 2 - Edição, localize a profile do Sicredi e então vai estar disponível a área PIX para inserir a configuração:

Image Added

Preencha os seguintes campos:

• Chave PIX: chave Pix da conta Sicredi (gerada pelo Sicredi e enviada para o cooperado por e-mail, pode ser o CNPJ, um e-mail, telefone, chave aleatória... verifique com o seu gerente)
• Credenciais: seleção da credencial utilizada na conta/profile de pagamento. Clique em Cadastrar credenciais PIX para inserir os dados de produção;
• Status: selecione a opção:
  
  • Produção
• Hab. testes:
  • Sim: pode utilizar esta opção para realizar um teste de pagamento, dessa forma a geração do QRcode vai ser permitida somente para um cadastro selecionado como Cliente Homologação;
  • Não: liberado para todos os clientes;
• Cliente Homologação: caso deseje efetuar testes de pagamento selecione o cliente que será utilizado (o QRcode só será gerado para ele);
• Testar comunicação: teste de comunicação com o Sicredi para confirmar se a chave e credenciais estão corretas (clique para executar somente após inserir os dados conforme instruções abaixo);
• Cadastrar credenciais PIX: ao clicar neste botão será aberta nova janela onde deve ser inserida a configuração com as novas chaves de produção;

Image Added

• client_id: credencial de produção enviada pelo Sicredi;
• client_secret: credencial de produção enviada pelo Sicredi;
• path_cert_host: certificado digital público do host da api Pix do Sicredi (pode fazer o download clicando aqui e após basta fazer o upload no sistema). ATENÇÃO: a partir da release nº 64 do ERP esta certificado não é mais necessário! Por isso o campo para upload não ficará visível.
• path_cert_client: certificado .CER disponibilizado pelo Sicredi no internet banking;
• path_key_cliente: chave privada extraída do certificado digital (se foi seguido o passo a passo da documentação vai estar salvo no computador com o nome mkSicrediFinal.key).

 Testar comunicação

Para confirmar que as chaves de homologação estão corretas utilize a ferramenta Testar comunicação:

Image Added

Este teste verifica se as chaves informadas na credencial estão certas e se os certificados tiveram o upload feito corretamente. Como os certificados são obrigatórios para geração do PIX Sicredi observe que se não for realizado o upload o retorno do teste não será OK:

Image Added

A API do Sicredi realiza as transações utilizando o certificado digital .CER que é gerado no internet banking. Este certificado é gerado com o padrão de 2 anos de validade. Na ferramenta Exibir dados do certificado é possível verificar o status:

Image Added

Pronto! A sua profile Sicredi está com o Pix ativo 😊