Este material tem o objetivo de auxiliar a obtenção das credenciais de acesso às APIs do Sicoob. Estes passos podem ser seguidos para gerar credenciais tanto para boleto quanto para PIX. Foi escrito com base na documentação oficial do Sicoob e no Open Banking Sicoob - Manual de obtenção de Credenciais (em anexo).

Como solicitar os dados necessários

Para começar a utilizar o registro instantâneo do Sicoob é necessário obter a credencial (client_id) associado a um certificado digital válido do tipo A1 (emitido pela ICP BRASIL). Abaixo estão listadas as etapas:

a) Faça login no Portal Developers (https://developers.sicoob.com.br).

b) É necessário cadastrar uma aplicação para a geração da credencial, para isso clique em “Nova Aplicação”.

c) Nesse momento o Portal irá validar seus dados a partir de uma autenticação, para isso efetue o login com suas credenciais do SicoobNet.

d) Em seguida clique em “Aprovar” para autorizar a validação dos seus dados.

e) Pronto, agora você pode seguir com o cadastro do seu aplicativo. Para isso informe: Nome, Descrição, Conta corrente, Nome do cooperado e clique em “Prosseguir”.

f) Nesse item "A integração será por uma empresa parceira?" você deve selecionar a opção "não". Na mesma página, selecione um certificado digital A1 válido que tenha sido emitido para o CNPJ do cedente, em seguida clique em “Prosseguir”. O certificado deve estar no formato .PEM para vincular o certificado à sua credencial.

Caso não saiba como exportar o .PEM verifique esta documentação: Certificado digital.

g) Selecione a API de Boleto (Cobrança Bancária) e clique em “Prosseguir”.

OBS: Na imagem está a de PIX, desconsiderar.

h) Agora confirme os dados informados e caso esteja tudo ok e clique em “Criar aplicativo”.

i) Pronto, a credencial foi gerada para você.

Observação: O Sicoob disponibilizou um vídeo tutorial reproduzindo esses passos, para visualizar clique aqui.

Como configurar as credenciais no PlugBoleto

Após obter os dados necessários, (client_id) e o certificado digital A1 vinculado à estas, tais dados deverão ser cadastrados no PlugBoleto.

1) Cadastrar credencias no convênio
Na página de convênios você irá encontrar o campo "Registro instantâneo", esse campo é onde você habilita o uso desse recurso no seu convênio.

Porém antes disso irá constar o campo "NumeroContrato" onde o mesmo deve ser preenchido com o "Numero do Cliente" (valor informado pelo próprio banco).

Quando o campo Registro instantâneo for ativado, deve aparecer logo abaixo 2 novos campos:

O  campo "Versão web service", que deve ser informado V2.2;

O campo "API - ID", onde deve ser informado o client_id informado pelo Sicoob.

Exemplo do cadastro das credenciais no portal do Plugboleto:

Você também pode realizar o cadastro das informações diretamente utilizando a rota da API via JSON, conforme detalhado na documentação a seguir:

https://atendimento.tecnospeed.com.br/hc/pt-br/articles/360006145374-Cadastrando-um-Conv%C3%AAnio 

Abaixo, também segue um JSON de exemplo para demonstrar este cadastro:

{ 
    "ConvenioNumero": "5033", 
    "ConvenioDescricao": "Convenio da tecnospeed", 
    "ConvenioCarteira": "17", 
    "ConvenioEspecie": "R$", 
    "ConvenioPadraoCNAB": "400", 
    "ConvenioApiId":"asbf-vfg5-vf5-cdg4", 
    "ConvenioRegistroInstantaneo": true, 
    "Conveniotipowebservice": "V2", 
    "ConvenioConsultaws": true, 
    "ConvenioReiniciarDiariamente": true, 
    "conta": 14404 
}

Lembrando que estas credenciais são apenas para demonstração, nenhuma delas é válida para uso em produção.

2) Fazer o upload do client certificate
O upload do certificado, com extensão .PFX,  pode ser realizado via API ou Portal. Para tal veja esses passos: Cadastrar certificado para Convênio via API ou Cadastrar certificado para Convênio via GUI WEB.

Uma observação é que após fazer o upload do certificado, o PlugBoleto irá realizar a sincronização deste e pode levar até 1h.

Para o Sicoob V2.2 o certificado precisa estar vinculado ao convênio conforme as instruções apresentadas acima, caso o arquivo esteja vinculado apenas ao cedente, ocorrerão erros de autenticação.

Após essas etapas serem seguidas corretamente o registro instantâneo para o Sicoob estará habilitado. Caso haja dúvidas no processo, fique a vontade para nos acionar via atendimento online!