Configuração PlugBoleto - GerencieAqui

• API Sicredi
• API Itaú

API Sicredi

Como configurar a API da Sicredi no Gerencie Aqui ?

 

Primeiramente vá em Cadastros > Contas Financeiras.

 

 

Clique em Nova Conta.

 

 

Agora, coloque um nome para a conta financeira e selecione a opção Tipo Conta Financeira > Sicredi - API.

 

 

Selecione a opção Produção e em seguida, preencha os campos obrigatórios com os dados da sua empresa sendo eles:

• Nome do Cedente

• CNPJ/CPF Cedente

• Telefone

• Email

 

 

Agora, preencha o Endereço completo do cedente.

 

 

Preencha os campos da seguinte forma:

• Número da Agência
  

• Dígito da Agência (Se tiver)

• Tipo de conta - Corrente

• Número da Conta

• Dígito da Conta

 

 

Em seguida, preencha os seguintes campos:

• Código Beneficiário é o número da conta

• Código Banco Correspondente deve informar 748

• Código Empresa no Banco deve informar 0 ou deixar em branco

 

 

Agora, preencha estes campos: 

• Carteira deve ser informado 001

• Código Carteira deve selecionar Cobrança Simples

• CNAB 240

 

 

Informe o Convênio (preencha com o número da conta) e o Nome do Convênio.

 

 

Preencha os campos abaixo da seguinte maneira:

• Número atual da remessa com 1

• Densidade da Remessa em branco

• Quem numera? Cliente

• Último Nosso Número com 1

 

 

Informe, com base em sua conta, os dados referentes à cobrança da multa.

• Dispensar - Não haverá cobrança de multa.

• Valor Fixo - Informe um valor de multa a ser cobrado e após qual dia a partir da data do vencimento.

• Percentual - Informe um percentual de multa a ser cobrado e após qual dia a partir da data do vencimento.

 

 

Informe também, com base em sua conta, os dados referente ao desconto.

 

• Sem desconto - Não haverá desconto no pagamento.

• Valor fixo até a data informada - Informe o valor do desconto que será aplicado e a quantidade de dias antes do vencimento em que ele será válido.

• Percentual até a data informada - Informe o percentual do desconto que será aplicado e a quantidade de dias antes do vencimento em que ele será válido.

 

 

Agora, informe com base em sua conta, os dados referentes à cobrança de juros.

 

• Dispensar - Não haverá cobrança de juros após o vencimento.

• Valor fixo por dias de atraso - Cobra um valor fixo para cada dia que o pagamento estiver atrasado.

• Taxa mensal - Aplica uma porcentagem de juros ao mês sobre o valor devido, proporcional aos dias de atraso.

• Isento - Indica que a cobrança será livre de juros, mesmo que possa haver informação de cobrança.

 

Preencha também os campos de Instrução do boleto de cobrança nas linhas 1, 2 e 3, para que a orientação seja exibida no boleto.

 

 

Se o boleto tiver protesto, preencha o campo Dias Protesto, informando o período após o vencimento.

 

 

Se houver negativação por não pagamento, preencha no campo Dias Negativação, caso não haja, deixe o campo em branco.

 

 

Se o seu banco tiver a opção de recebimento do boleto por PIX, habilite o campo Incluir QR Code Pag. Pix.

 

 

Preencha o campo Tipo do WS,  e para o Sicredi deve ser informado v3.

 

 

O campo ID da API é um código composto, seguido pelo Número da Conta + Número da Agência.

 

 

 

API Itaú

Criando as requisições para a API:

OBS: Antes de iniciar os procedimentos abaixo, é necessário ter o OpsenSsl instalado e configurado na sua máquina. Caso não tenha, baixe o instalador no Windows e execute o seguinte comando no CMD:

setx OPENSSL_CONF "C:\Program Files\OpenSSL-Win64\bin\openssl.cfg" /M
setx PATH "%PATH%;C:\Program Files\OpenSSL-Win64\bin" /M

Crie uma pasta em sua área de trabalho e nomeie com a razão social da empresa que está configurando:

Após isso, abra a pasta e clique com o botão direito. Selecione a opção "Abrir no terminal". 

Caso não exiba essa opção, clique no endereço da pasta e digite "CMD".

Execute os seguintes comandos:

openssl genpkey -out private.pem -algorithm RSA -pkeyopt rsa_keygen_bits:2048

openssl rsa -in private.pem -pubout -out public.pem

Será gerado um arquivo "private.pem" e "public.pem". Encaminhe esses arquivos ao cliente e solicite o TOKEN e o CLIENT SECRET da API de COBRANÇA. Ou então peça um e-mail de contato para falar diretamente com o GERENTE DE CONTAS e solicite você mesmo as informações.

Gerando os arquivos de montagem do certificado digital:

Após a abertura do chamado com o T.I do ITAÚ, será encaminhado um e-mail com as informações das credenciais. Assim como os dados da conta bancária (caso não seja encaminhado, formalize um novo e-mail solicitando os dados da conta). O TOKEN e o CLIENT SECRET estarão inseridos na planilha "Token e Credencial.xlsx"

Abra a planilha. Copie o Client ID e abra a pasta que você criou no inicio. Abra novamente o CMD e insira o Client ID no seguinte código:

openssl req -new -subj '/CN=(INSIRA O CLIENT ID AQUI)/OU=tecnospeed/L=(CIDADE)/ST=(UF)/C=BR' -out ARQUIVO_REQUEST_CERTIFICADO.csr -nodes -sha512 -newkey rsa:2048 -keyout ARQUIVO_CHAVE_PRIVADA.key

Exemplo:

openssl req -new -subj '/CN=92360a67-86b1-4dc0-95f7-2c2d35f142c1/OU=tecnospeed/L=JOSE BONIFACIO/ST=SP/C=BR' -out ARQUIVO_REQUEST_CERTIFICADO.csr -nodes -sha512 -newkey rsa:2048 -keyout ARQUIVO_CHAVE_PRIVADA.key

(Se preferir, copie e cole o código em um bloco de notas para editar o código antes de executar no CMD).

Após isso, será gerado os arquivos "ARQUIVO_REQUEST_CERTIFICADO.csr" e "ARQUIVO_CHAVE_PRIVADA.key".

Subindo os arquivos no POSTMAN:

Abra o POSTMAN e importe a collection para realizar a requisição do certificado digital.

Abra a pasta "Ativação Certificado Dinâmico" e clique em "3 - Envio de arquivo .csr". Abra a pasta com os arquivos e abra o arquivo "ARQUIVO_REQUEST_CERTIFICADO.csr" com o bloco de notas. Copie o conteúdo do arquivo (Ctrl + A) e cole na aba "Body".

Vá até a aba "Authorization" e altere o "Auth Type" para "Bearer Token". Após isso, abra a planilha "Token e Credencial" gerada no começo dos procedimentos e pegue o "Token" inserido na planilha. Copie o Token e cole no Postman. Após isso, clique em "Send".

Em "Response" será gerado um conteúdo de certificado ".crt" em formato de texto. Copie o conteúdo e cole em um bloco de notas. 

Salve esse bloco de notas com o nome que desejar, mas o arquivo deve ser salvo com a extensão ".crt" no final.

Após isso, abra o CMD na pasta com os arquivos gerados até aqui e execute o seguinte comando:

openssl pkcs12 -export -out certificado.pfx -inkey ARQUIVO_CHAVE_PRIVADA.key -in certificado.crt

(Obs: Altere a ultima parte do comando de acordo com o nome que foi utilizado para salvar o arquivo).

Ao executar o comando, o CMD irá gerar um arquivo ".pfx". Esse arquivo irá ser usado para importar na plataforma do PlugBoleto.

Configurando conta corrente no GerencieAqui:

Clique em CADASTROS > CONTAS FINANCEIRAS:

Clique em NOVA CONTA e preencha as informações a respeito da conta do cliente. Essas informações são repassadas pelo Banco junto com os dados no inicio dessa documentação. No caso de ausencia dessas informações, entre em contato com o gerente de contas ou com o TI do ITAÚ.

Se atentar aos seguintes campos:

ID da API - Copie e cole o ID da Planilha "Token e Credencial" repassada pelo banco.

Chave da API (API Key) - Copie e cole a KEY usada no POSTMAN.

Segredo da API (API secret) - Copie e cole o conteúdo do TOKEN da planilha "Token e Credencial"