Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

01. VISÃO GERAL

Este recurso tem como objetivo preparar o TOTVS Gestão Financeira para utilizar o serviço de registro online da carteira de cobrança registrada do Banco SICOOB.

02. CONFIGURAÇÃO

No cadastro do convênio, na aba 'Registro Online' deve ser marcado a opção "Permite registro de boleto online".

Modelo v1:

Image AddedImage Removed

  • URL do serviço de registro do boletoDeve ser informada a URL do serviço de registro do boleto disponibilizada pelo Banco
  • URL do sistema autorizadorDeve ser informada a URL do serviço de autorização disponibilizado pelo Banco
  • Client Id e Client Secret: Códigos Código do sistema de autorização fornecido pelo Banco
  • URL de Callback: URL de Callback que deve ser informada na geração do código de autorização, onde o mesmo será exibido. (http://[servidor]/Corpore.Net/Source/Fin-Financeiro/RM.Fin.Banco/SicoobCallback.aspx)
  • Código de autorização: Código de acesso do sistema de autorização para criação de tokens. Deve ser gerada no portal do Banco.

Importante:

  • O campo "Refresh token" está disponível apenas no modelo de registro online "v1". Ao ser gerado o código de autorização e informado no cadastro do convênio, deve ser obtido o refresh tokenclicando no botão. Esse refresh token será usado para obter o acess token necessário para registro do boleto no banco. Somente é preciso obter o refresh token uma vez
  • O código de autorização expira em 5 minutos, ou seja, o mesmo deve ser utilizado nesse tempo para obter o refresh token

           Modelo v2:

Image Added

  • URL do serviço de registro do boletoDeve ser informada a URL do serviço de registro do boleto disponibilizada pelo Banco
  • URL do sistema autorizadorDeve ser informada a URL do serviço de autorização disponibilizado pelo Banco
  • Client Id : Código do sistema de autorização fornecido pelo Banco
  • Certificado digital: Certificado digital cadastrado junto ao Banco para o registro de boleto online. (Disponível apenas no modelo v2)

Importante:

  • O Modelo de registro online "v2" está disponível a partir do patch 12.1.2302.118..152.
  • Informações de como gerar o certificado é necessário verificar as instruções disponíveis na documentação da API. Dúvidas a respeito, recomendamos entrar em contato com o suporte do Banco.

https://developers.sicoob.com.br/portal/documentacao?slugItem=apis-do-sicoob&slugSubItem=primeiros-passos

https://developers.sicoob.com.br/portal/documentacao?slugItem=seguranca&slugSubItem=certificado-digital


03. LAYOUT

Para enviar dados de forma flexível para o registro online dos boletos para o banco, devem ser criados os campos, primeiramente via anexo "Layout Registro Online" disponível no cadastro de Bancos e Agências. Os campos devem ser criados conforme manual de cobrança do SICOOB (https://developers.sicoob.com.br/#!/documentacao). Esses campos devem ser associados a fórmulas ou valores fixos, via anexo "Associação do Layout do Registro Online" no cadastro do convênio. Alguns exemplos abaixo:

...

pagador.numeroCpfCnpj

pagador.nome

        mensagensInstrucao.mensagens1

        mensagensInstrucao.mensagens2

        mensagensInstrucao.mensagens3

        mensagensInstrucao.mensagens4

        mensagensInstrucao.mensagens5

04. EXEMPLO DE UTILIZAÇÃO V1

Exemplo de geração do código de autorização.

...