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.54 - 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 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):

• Possui provedor para integração: Sim

• Se sim, qual? MK Solutions (software house já homologada)

• Nome do responsável pela integração: (informe o nome do responsável no provedor que vai realizar o contato com o Sicredi)

• E-mail: (informe o e-mail em que deseja receber a cartilha de integração)

• Telefone comercial: (número comercial do provedor)

• Finalidade: Gerar Cobrança Imediata - Cob

A equipe de onboarding vai enviar por e-mail o passo a passo para geração do certificado.

Geração do certificado .CSR

O processo de uso da API Pix do Sicredi exige que o provedor utilize um certificado específico .CER para utilização no internet banking e mk erp. Este certificado é gerado pelo banco após o envio de um certificado .CSR que deve ser gerado pelo provedor. Nesta documentação vamos passar sugestões para que faça a geração dos arquivos necessários.

1. Acesse o disco local C em seu computador e crie uma pasta chamada OpenSSL

2. 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 na pasta criada:

Open

1. Crie uma nova pasta chamada SSL (o diretório deve ser exatamente C:\OpenSSL\SSL)

2. Volte na pasta onde a ferramenta foi extraída, copie o arquivo ‘openssl.cnf’ e cole na pasta SSL:

Open

Retorne para a pasta onde extraiu o programa e execute o terminal openssl como administrador:

Open

Gerando o arquivo de chave

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.

Open

Execute no terminal:

Gerando a requisição do certificado

Será solicitada a senha registrada anteriormente, basta digitar ela e então os comandos abaixo devem ser informados (são dados do Sicredi e do provedor, o que deve ser alterado está em destaque):

Open

• BR

• Rio Grande do Sul

• Porto Alegre

• Confederacao Interestadual das Cooperativas Ligadas ao Sicredi

• API PIX Sicredi

• api-pix-NOMEDOPROVEDOR

• EMAIL DO ASSOCIADO

• Enter (para pular esta etapa)

• Enter (para pular esta etapa)

Open

Retirando a senha do certificado

Execute no terminal:

Informe a senha gerada nos passos anteriores:

Open

E após execute:

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

Open

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

Open

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

Open

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.

Open

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:

Open

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;

Open

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

Open

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:

Open

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:

Open

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

🆕 Webhook Sicredi

A partir da release 81 foi implementado o recebimento de pagamentos Pix via rotina webhook, disponibilizado pela API PIX do Sicredi. Essa rotina notifica e atualiza o status das transações em tempo real, não sendo mais necessário aguardar a rotina agendada para baixa das faturas.

Ativação e consulta

ACESSO: Configurações>Financeiro>Profiles de pagamento, opção Boleto MK Ver. 2 - Edição

Open

Nessa tela foram inseridas as informações do Webhook, trazendo após a atualização a situação como INATIVO. Ao clicar na opção ATIVAR WEBHOOK, a rotina vai pegar a URL que o ERP está usando e cadastrar na api do banco, sinalizando que será essa URL que vai receber os Webhooks.

Open

Open

Ao utilizar a opção CONSULTAR WEBHOOK, será informada a chave pix, a data de criação, status e a URL do Webhook, sinalizando que está OK para utilização.

Open

Open

A ativação do Webhook só vai acontecer em ambientes com DNS, ambientes que operam por número de IP não conseguirão realizar a ativação com sucesso, obtendo mensagem de erro no processo.

Open

Em casos de troca de DNS, basta ativar novamente o Webhook dentro da profile, que a URL será atualizada no banco.

Após a ativação do Webhook, as liquidações serão processadas instantaneamente, marcando já a fatura como liquidada e lançando o histórico com o operador Webhook.

Open

Mesmo com essa opção ativa, as rotinas de liquidação do Pix avulso continuarão a executar normalmente para capturar qualquer liquidação que por algum motivo análogo não seja capturado pelo Webhook.