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 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.

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

• Para utilização de pagamentos, solicite a ativação da API de pagamentos online.

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

• Ter as senhas e chaves 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 o menu principal “Outras Opções” e “Notificações”.

• Em notificações, habilitar para notificar. 
  
  

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

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

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

3 – Como cadastrar uma aplicação.

• Acesse o portal Developers do Sicoob no  endereço  https://developers.sicoob.com.br/

• Caso não esteja logado no portal, acesse com o e-mail e senha da administradora.

3.1 – Efetuar o login com os dados da conta do condomínio.

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

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

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

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

• Informar o código e “Autorizar”.

4 – Novo Aplicativo.

4.1 – Informações.

• Defina um nome para o aplicativo: Para facilitar a identificação, sugerimos usar o APPNomedocondomínio (Condomínio+conta ou nome do condomínio).

• Selecione a conta a ser integrada.

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

4.2 – Segurança.

• Integração por uma empresa parceira?

• Marcar como “SIM” 

  Selecionar: Condominizar – Software para condomínios.

4.3 – API utilizada.

• Selecione as aplicações de serviços utilizados: Cobrança bancária, conta corrente, cobrança bancária V3 e pagamentos, em seguida “Prosseguir”.

• Obs: Pode selecionar todos as APIs disponíveis para uso futuro.
  
  

4.4 – Confirmação.

• Confira as informações na tela a seguir e clique em “Criar Aplicativo”.

• Pronto, sua aplicação foi criada!!!

4.5 – Ao concluir o processo a aplicação ficará com status Pendente de aprovação.

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

5 – Retorne ao site Developers.

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

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

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

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

• Confira os dados cadastrais da conta corrente.

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

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

• Selecione a versão da API para cobrança bancária V3 e CC V4.
• 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.

7 – 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.

• Acesse o Menu Financeiro em “Títulos a Receber”.
• 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.

• Selecione o título e acesse o botão “Boleto” em seguida “Registrar” .
• Após registro, entrar no boleto e verificar informações, lendo código de barras e QRCODE através do aplicativo bancário.
• Consulte o internet bank e verifique se consta o título registrado.
• É recomendado que seja feito o pagamento para validar todo o fluxo de pagamento e liquidação.
• 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.