Com o objetivo de otimizar a gestão financeira e expandir as opções de recebimento para os nossos clientes, o Yzidro ERP agora conta com a integração nativa para a emissão de boletos bancários junto ao Banco do Brasil.
A partir desta atualização, o sistema passa a gerenciar de forma totalmente automatizada o registro de cobranças e o processamento de arquivos de retorno. Essa inovação elimina a necessidade de intervenções manuais externas, garantindo maior agilidade, mitigação de erros operacionais e um fluxo de conciliação bancária muito mais eficiente e seguro para a sua empresa.
¶ Portal Developers
O procedimento inicial para a configuração da rotina exige o acesso ao Portal Developers do Banco do Brasil, a plataforma oficial do banco voltada para a integração de sistemas (APIs).
Nesse ambiente, o usuário deverá realizar o credenciamento da empresa, efetuando a criação de uma conta corporativa. Esse passo é fundamental e indispensável, pois é através deste portal que serão geradas as credenciais de segurança necessárias para que o Yzidro ERP consiga se comunicar diretamente com o banco.
Após efetuar o login com sucesso na plataforma, o usuário deverá navegar até a opção "Criar Nova Aplicação", conforme exemplificado detalhadamente na Figura 01.
Esta ação dará início ao processo de configuração do ambiente virtual onde a integração será homologada, permitindo que o sistema identifique e vincule corretamente a conta da sua empresa às ferramentas de automação do boleto bancário.
Figura 01 - Portal Developers - Criando Aplicação
Em seguida, o usuário deverá preencher os campos de identificação do projeto, fornecendo um nome e uma descrição específicos para a nova aplicação, conforme ilustrado na Figura 02.
Recomendação: É aconselhável utilizar termos claros e objetivos (como, por exemplo, "Integração Yzidro ERP"), facilitando a posterior identificação e gestão do canal de comunicação estabelecido entre o ERP e a instituição financeira.
Figura 02 - Portal Developers - Nomeando Aplicação
Na sequência, é imprescindível selecionar a API denominada "Cobranças (v2)" para que as funcionalidades de emissão e conciliação de boletos sejam devidamente vinculadas à aplicação em desenvolvimento, conforme apresentado na Figura 03.
Após certificar-se de que a API correta foi selecionada, o usuário deverá clicar no botão "Criar". Esta ação consolidará a abertura do projeto no portal, gerando as diretrizes necessárias para a próxima fase da integração.
Figura 03 - Portal Developers - API Cobranças
Uma vez concluída a criação do projeto, o usuário deverá localizar e clicar sobre a aplicação recém-criada, conforme exemplificado na Figura 04.
Este procedimento é necessário para acessar o painel de gerenciamento do aplicativo, onde estarão centralizadas as informações técnicas e as chaves de autenticação essenciais que serão utilizadas posteriormente na configuração do Yzidro ERP.
Figura 04 - Portal Developers - Gerenciar Aplicação
No painel de gerenciamento da aplicação, o usuário deverá clicar na opção "Credenciais", conforme apresentado detalhadamente na Figura 05.
Esta seção restrita exibe os códigos de identificação e autenticação de segurança do cliente, os quais desempenham o papel de "chave de acesso" para que o ambiente de integração seja validado com total proteção de dados.
Figura 05 - Portal Developers - Credenciais
Após acessar a seção correspondente, o usuário deverá clicar no botão "Gerar Credenciais", conforme ilustrado na Figura 06. Este comando solicitará ao servidor do banco a criação imediata das chaves de criptografia exclusivas para a sua empresa.
Na sequência, o sistema exibirá as chaves de acesso geradas. O usuário deverá, obrigatoriamente, copiar integralmente esses dados (conforme apresentado na Figura 07) e guardá-los em um local seguro.
Figura 06 - Portal Developers - Gerar Credenciais
Figura 07 - Portal Developers - Credenciais Geradas
Após realizar a cópia e o armazenamento seguro das credenciais, o usuário deverá retornar à tela de "Detalhes da Aplicação" (o mesmo painel de gerenciamento onde se encontrava a opção "Credenciais").
Neste ambiente, deverá localizar e clicar no comando "Enviar para Produção", conforme indicado na Figura 08. Este procedimento é de suma importância, pois formaliza a solicitação junto à instituição financeira para que a aplicação migre do cenário de testes e seja efetivamente habilitada para operar com dados reais de cobrança no mercado.
Figura 07 - Portal Developers - API em Produção
¶ Parâmetros do Boleto
Após a conclusão dos procedimentos no portal bancário, o usuário deverá acessar o Yzidro ERP para realizar a vinculação das chaves de segurança. Para isso, navegue pelo menu através do caminho Financeiro > Boleto > Parâmetros do Boleto.
Ao iniciar a configuração de uma carteira de cobrança vinculada ao Banco do Brasil, o sistema disponibilizará os campos específicos para a inserção das credenciais previamente geradas e copiadas do portal de desenvolvedores, conforme exemplificado na Figura 09. O preenchimento correto desses dados é o que garantirá a comunicação automatizada e segura entre o ERP e a instituição financeira.
Figura 09 - Configuração da API
Uma vez concluída a inserção das credenciais e salvas as alterações, o processo de parametrização estará plenamente finalizado. A partir deste momento, o Yzidro ERP estará devidamente homologado e integrado aos serviços do Banco do Brasil.
A plataforma encontra-se totalmente apta para realizar a emissão instantânea de boletos bancários, bem como para executar o processamento automatizado dos arquivos de retorno. Essa sinergia tecnológica garante que as baixas de pagamento, conciliações e atualizações de status de cobrança ocorram de forma fluida, segura e sem a necessidade de digitação ou conferência manual.