Manual de Integração Financeiro via API Sicoob

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

1 - O titular da conta do condomínio precisa entrar em contato com o gerente e solicitar a alteração do convênio de cobrança para API de Cobrança Online Sicoob.
2 - Solicitar também a habilitação do boleto híbrido.
3 - Estar com as informações da conta corrente e convênio de cobrança.
4 - Ter as senhas e chaves do titular de acesso a conta.
5 - Ter o aplicativo da conta instalado em um celular, com as notificações habilitadas.

Como ativar as notificações no aplicativo do Sicoob.

1 - Acesso o aplicativo e o menu principal “Outras Opções” e “Notificações”.
2 - Em notificações, habilitar para notificar. 

Primeiros passos para se cadastrar no portal de aplicações APIs da Sicoob.

1 - Acessar o portal https://developers.sicoob.com.br/
2 - Acesse a opção “Cadastro”.
3 - O cadastro deve ser realizado com os dados da administradora/escritório e do responsável pela empresa. 
4 - Esta é uma área de gestão de todas as contas dos condomínios  que serão integradas. Portanto é importante armazenar o e-mail e a senha cadastrada para acessos posteriores.

Importante: Este cadastro é feito somente uma vez. O e-mail e a senha vão ser usados 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.

Como cadastrar uma aplicação.

1 - Acesse o portal Developers do Sicoob no  endereço  https://developers.sicoob.com.br/
2 - Caso não esteja logado no portal, acesse com o e-mail e senha da administradora.
3 - Efetuar o login com os dados da conta do condomínio.

4 - Após efetuar o login, clique em “Cadastrar Novo Aplicativo”

5 - Em seguida, clique em “Ok Continuar” para logar como cooperado.

6 - Para efetuar o login, informar o nº da cooperativa, chave de acesso e senha de 8 dígitos.

7 - O banco solicitará um código de confirmação, acesse o aplicativo do Sicoob e verifique em notificação, verifique também via sms.
8 - Informar o código e “Autorizar”.

Novo Aplicativo.

Informações

1 - Defina um nome para o aplicativo: Para facilitar a identificação, sugerimos usar o APPNomedocondomínio (Condomínio+conta ou nome do condomínio).
2 - Selecione a conta a ser integrada.
3 - Defina uma descrição para a aplicação: Ex: Aplicação de API de integração de cobrança.

Segurança

1 - Integração por uma empresa parceira?
2 - Marcar como “SIM” 
3 - Selecionar: Condominizar – Software para condomínios.

API utilizada

1 - Selecione as aplicações de serviços utilizados: Pix Recebimentos, Cobrança Bancária Pagamentos, Cobrança Bancária V3, Conta Corrente, Convênio Pagamento e Pix Pagamentos.
2 - Obs: Pode selecionar todos as APIs disponíveis para uso futuro.

Confirmação

1 - 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 de aprovação.

1 - Ao concluir o processo a aplicação ficará com status PENDENTE para aprovação.
2 - A aprovação é feita pelo portal de negócios Sicoobnet, o mesmo de acesso a conta corrente.
3 - Acesse o portal de negócios Sicoobnet e na tela principal em Transações pendentes ou pelo Menu - Outras opções - Transações pendentes – ASSINAR.

4 - Ou, através do aplicativo Sicoob, Menu - Serviços - Transações pendentes - Consultar.
5 - Após consultar, marcar a opção “Autorização Para Utilização de API’s”, e depois “Assinar”.
6 - O banco solicitará a senha novamente e depois confirmar!

Retorne ao site Developers.

1 - Verifique se o status alterou para ATIVO, depois clique para entrar na Nova API e copie o Client_id.
2 - O cliente ID deverá ser copiado para utilizarmos na configuração da conta no Condominizar.

No Condominizar, para cadastrar a conta e o convênio

1 - Acesse o Menu “Financeiro” e selecione a opção “Contas Financeiras”.

2 - Ao lado da conta, acesse o botão “Opções” e clique em “Alterar Informações”.

3 - Confira os dados cadastrais da conta corrente.
4 - E em convênios, “Cobrança” e confira os dados do convênio e em “Tipo de integração”, selecione “Integração API” e "SALVAR".

Importante: Altere o tipo de integração e salve antes de configurar as chaves.

Certificado do condomínio quando não é utilizado.

1 - Selecione a versão da API para cobrança bancária V3 e CC V4.
2 - Cadastre o Client_id gerado no developer.sicoob.

Nessa opção a inclusão de certificado é dispensada.

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

Teste de integração.

Para verificar se está tudo funcionando perfeitamente vamos fazer um teste de registro criando um título financeiro para registro de boleto.

1 - Acesse o Menu Financeiro em “Títulos a Receber”.
2 - Cadastre um título (R$25,00 valor sugerido) para uma outra pessoa que não seja de uma unidade para não gerar nenhum histórico.

3 - Selecione o título e acesse o botão “Boleto” em seguida “Registrar”.
4 - Após registro, entrar no boleto e verificar informações, lendo código de barras e QRCODE através do aplicativo bancário.
5 - Consulte o internet bank e verifique se consta o título registrado.
6 - É recomendado que seja feito o pagamento para validar todo o fluxo de pagamento e liquidação.
7 - A exclusão de um título irá funcionar da mesma forma, selecione o registro e acesse o botão “Boleto”, depois “ Excluir Registro".

Ajuda Sicoob: https://developers.sicoob.com.br/#!/documentacao?section=apis-do-sicoob&item=primeiros-passos.