Manual de integração financeiro via API Sicoob

1 – O que é preciso para iniciar o processo de integração da API de cobrança Online.

• O titular da conta do condomínio precisará entrar em contato com o gerente e solicitar a contratação ou alteração do convênio de cobrança para API de Cobrança Online Sicoob.

• Solicitar também a habilitação do boleto híbrido.

• Ter o Certificado A1 com o mesmo CNPJ da conta, ou utilizar o certificado do sistema(Condominizar) na modalidade parceiros.

• Estar com as informações da conta corrente e convênio de cobrança.

• Ter as senhas e chave do titular de acesso a conta.

• Ter o aplicativo da conta instalado em um celular, com as notificações habilitadas.

1.1 – Como ativar as notificações no aplicativo do Sicoob

Acesso o aplicativo e no menu principal.

2 – Primeiros passos para cadastrar o acesso a API de integração

• Acessar o portal https://developers.sicoob.com.br/
• Acesse a opção CADASTRO

• O cadastro deve ser realizado com os dados da administradora/escritório e do responsável pela empresa.

• Está é uma área de gestão de todas as contas que serão integradas. Portanto é importante armazenar o e-mail e a senha cadastrada para acessos posteriores.

• Importante: Esse cadastro é feito somente uma vez. O e-mail e a senha vai ser usado por todos os gestores de carteiras da administradora, por isso é importante guardar estas informações para o acesso de todos os colaboradores.

Ao finalizar o cadastro será encaminhado para seu e-mail informações com um link de validação e para cadastrar a senha de acesso.

3 - Como cadastrar uma aplicação.

Acesse o endereço   https://developers.sicoob.com.br/ .

• Efetue o login com o e-mail e senha cadastrados.

• Clique na caixa Cadastrar novo aplicativo.

• Clique em Continuar como PJ

3.1 – Efetue o login da conta do condomínio

O login nesse momento deve ser efetuado com os dados da conta do condomínio a ser criada a aplicação, os mesmos de acesso ao Sicoobnet.

• Selecionar: Pessoa Jurídica;

• Titularidade: 1º titular;

• Número da Cooperativa: (4 dígitos);

• Chave de acesso: mesma chave de acesso da conta Ex: “AA1111”;

• Senha de acesso de 8 dígitos: Senha de números da conta.

• Acesso o aplicativo do Sicoob e verifique em notificações o código enviado para a autenticação do acesso.

4 – Novo Aplicativo

4.1 – Informações

• Defina um nome para o aplicativo: Para facilitar a identificação, sugerimos usar o APPCondominio+agência+conta.

• Defina uma descrição para a aplicação: Ex: Aplicação de API de integração de cobrança.

4.2 – Certificado digital

Informe o tipo do Certificado digital que será utilizado para a integração.

Integração por uma empresa parceira?

Se SIM

• Seleciona: Condominizar – Software para condomínios.

Se NÃO

• Seleciona: O certificado gerado após ser incluído no Condominizar. (Veja abaixo o item 5).

4.3 – API utilizada

Selecione as aplicações de serviços que serão utilizadas: Cobrança bancária e Conta corrente.

Pix não é necessário para a cobrança.

4.4 - Confirmação

Confira as informações na tela a seguir e clique em CRIAR APLICATIVO.

• Pronto, sua APLICAÇÃO foi criada!!!

Ao concluir o processo a aplicação ficará com status PENDENTE para aprovação.

A aprovação é feita pelo portal de negócios Sicoobnet, o mesmo de acesso a conta corrente.

Acesso o portal de negócios Sicoobnet e na tela principal em Transações pendentes ou pelo menu Outras opções - Transações pendentes – ASSINAR.

Retorne ao site developers e verifique se o status alterou para ATIVO copie o Client_id.

5 - Configuração da conta no sistema

5.1 - Cadastrar a conta e o convênio

• Acesse menu FINANCEIRO em seguida CONTAS FINANCEIRAS. 
• Ao lado da conta acesse botão OPÇÔES em ALTERAR INFORMAÇÕES.
• Confira os dados da conta corrente.
• Acesse COBRANÇA e confira os dados do convênio e em TIPO DE INTEGRAÇÃO selecione INTEGRAÇÃO POR API e SALVAR.
• Importante: Altere o tipo de integração e salve antes de configurar as chaves.

5.3 - Certificado do condomínio

• Em APIS DE INTEGRAÇÃO - COBRANÇA inclua o certificado digital A1 do condomínio e SALVAR

• Após ser salvo o Certificado digital, clique para fazer o download para gerar um arquivo da chave pública.
• Salve o arquivo no seu computar para ser incluído no aplicativo do Sicoob.

• Retorne ao site do Sicoob e adicione ao aplicativo o arquivo da chave pública gerada pelo sistema.

6 -  Configurar convênio para o acesso da API

Para configurar a API, em CONTAS FINANCEIRAS acesse as configurações da conta financeira que deseja integrar.

• Acesse a opção COBRANÇAS  e acesse o botão CONFIGURAR ACESSO DA API
• Copie do aplicativo gerado no developers Sicoob a informação CLIENT ID, copie este código e cole no sistema.
• SALVAR

Neste momento a API de Cobranças esta integrada ao sistema de gestão financeira. 

7 - Teste de integração

Para verificar se está tudo funcionando perfeitamente, vamos fazer um teste registrando um título individual.

• Acesse o menu FINANCEIRO em  TÍTULOS A RECEBER
• Cadastre um título para uma outra pessoa que não seja de uma unidade para não gerar nenhum histórico.

• Selecione o título e acesse o botão BOLETO em seguida REGISTRAR.

Consulte o internet bank e verifique se consta o título registrado. Poderá efetuar o pagamento para confirmar a liquidação automática no sistema.

A exclusão de um título irá funcionar da mesma forma, selecione o registro e acesse o botão BOLETO  em EXCLUIR REGISTRO.

O Sicoob também fornece o extrato no formato OFX direto no sistema para a conciliação bancária.