SIEM | Boleto

Emissão Banco do Brasil - Via API

Emissão Banco do Brasil - Via API

Primeiros Passos - Liberação

Cadastro no Portal

Primeiro é necessário possuir uma conta no "Portal Developers BB".

Clique na opção "Cadastre-se" para criar o acesso.

image-1673012332880.png

Será necessário fazer o preenchimento de um CPF (pode ser qualquer pessoa responsável  pela empresa).

image-1672936941487.png

Em seguida deverão ser preenchidos o  nome da mãe, data de nascimento, endereço de e-mail e número de celular válidos.

Após o preenchimento das informações, será enviado um Código de Confirmação para o número de telefone cadastrado.

Ao informar o código enviado para o telefone, será solicitado para cadastrar uma senha (conforme as instruções).

É necessário assinar os termos solicitados.

 

Criação da Aplicação

Após realizar o acesso no portal clique na opção "NOVA APLICAÇÃO".

 

image-1673012416131.png

Preencha os campos Nome da Aplicação (ex: Soften SIEM, Gerencie Aqui...) e Descrição. Os dados serão apenas para identificação, logo não possui um padrão a ser seguido.

image-1672937826035.png

 

Não é obrigatório fazer o preenchimento o Ícone da Aplicação.

image-1672938090871.png

Por fim, selecione a API de integração que será utilizada. Expanda o grupo "APIs com contratação online pelo Portal Developers BB" e maque a opção "Cobranças".

image-1673012451188.png

Depois do preenchimento de todos os passos anteriores, clique em "CRIAR"

 

Importante!

Após a criação de uma nova API seu status será "Em teste", conforme a imagem a seguir. Portanto apenas esse ambiente estará liberado para o envio de boletos. Depois será necessário solicitar a liberação do ambiente de produção.

image-1672938585380.png

*Não é obrigatório realizar a emissão de boletos em homologação para solicitar o ambiente de produção. Ficará a critério da empresa.

 

Credenciais para ambiente de Homologação

Com a Aplicação criada, clique sobre ela para acessar a área do desenvolvedor.

image-1673012696249.png

No Menu lateral, clique na opção "Credenciais".

image-1673012774070.png

Para realizarmos as configurações no sistema serão necessárias as informações developer_application_key e o Basic do Authorization (clicando no botão "Basic" ao final da página). 

image-1673012813897.png

Utilize essas informações para configuração do sistema, conforme a documentação de "Configurações e Emissão".

 

Solicitação do ambiente de produção

No menu lateral, clique na opção "Produção".

image-1673012961291.png

Preencha o CNPJ da empresa e confirme os dados:

image-1673013089860.png

Revise os dados a aplicação e clique em "SOLICITAR PRODUÇÃO".

image-1673013204420.png

Importante!

Para a API de cobrança pode ser necessário ou não a interferência do banco no processo. 

Se a empresa já possuir um convênio de cobrança ativo contratado para o CNPJ a liberação será feita automaticamente.

Caso contrário será necessário aguardar o contato do Banco do Brasil para a contratação de um convênio de cobrança. Enquanto isso a aplicação ficará com o status "Aguardando Aprovação". 

Assim que for liberado o ambiente de produção, a aplicação ficará com o status "Aprovado".

 

Credenciais para ambiente de Produção

As credenciais para o ambiente de produção não são as mesmas de homologação. Acesse o menu "Credenciais"  e confira se o ambiente selecionado (em azul) é "Produção".

image-1673013767358.png

As informações necessárias para a configuração do sistema são developer_application_key e Basic do Authorization (clicar no botão "Copiar Basic").

image-1673013937253.png

 

Emissão Banco do Brasil - Via API

Configurações e Emissão

Configuração do Ambiente de Emissão

Definir o ambiente de emissão na Config. 2: 

FINANCEIRO: AMBIENTE DE ENVIO BANCO DO BRASIL (0=HOMOLOGACAO(PADRAO)/1=PRODUCAO):

image-1672941136749.png

 

Configuração da Carteira

Em Cadastros > Financeiro > Carteira / Conta Mov. cadastre uma nova carteira e selecione a opção "BB2 - Integração BB" em "Banco". 

image-1672942928467.png

É necessário fazer o preenchimento das credenciais* geradas no Portal Developers do Banco do Brasil. Caso não possua as credenciais, veja como gerar na documentação de "Primeiros Passos - Liberação".

Chave da Aplicação - Preencha com a developer_application_key (de homologação ou produção) gerada no portal de desenvolvedores. 

Token da Aplicação - Deve ser preenchido com a o  Basic do Authorization (de homologação ou produção) gerada também no portal. 

O restante das informações deve ser preenchido normalmente para a emissão de boletos, conforme os campos em destaque (em amarelo).

 

Emissão de Boletos

Para realizar o registro de um boleto, é necessário possuir os lançamentos nas "Contas a Receber" (duplicatas). 

As operações com os boletos são acessadas em Financeiro > Relatórios (menu lateral) > Arquivo de Remessa Cobrança BB2.

image-1672948084116.png

É possível filtrar as duplicatas geradas por período (data de vencimento ou data de geração), carteiras  e cliente.

*Nessa tela serão listadas apenas as carteiras do tipo "BB2 - Integração BB".

image-1673032377515.png

Selecione os títulos para registro e clique em "Registrar Boletos". Irá abrir uma tela com a o status do registro do boleto.

image-1673032407110.png

Para visualizar os boletos que foram registrados é necessário marcar a caixa "Mostrar registrados". 

Após o registro, marque novamente os títulos e clique em "Imprimir Boletos". Será feito o download do PDF.

image-1673032761901.png

Para as liquidações de boletos é necessário clicar na opção "Atualizar Status". A consulta dos títulos será feita de acordo com o período selecionado.

Carteira Sicredi

Cadastro Carteira BANCO SICREDI

1- Clicar na opção Exibir Menu Completo, Cadastros, Financeiro, Carteira/Conta Mov.

1.png

 

2- Digite o nome do banco, marque a opção emitir boleto, depois clique em salvar.

2.PNG

 

3- Na opção dados da conta selecione o banco Sicredi, preencha todas as informações dos campos amarelos que são os principais. As informações de Cód. Empresa, Posto e Instrução precisam ser fornecidas pelo setor responsável pela homologação de boletos do banco Sicredi.

33.png

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Carteira Caixa Econômica Federal

Carteira Caixa Econômica Federal

Carteira Caixa Econômica Federal

Cadastro Carteira Banco Caixa Econômica Federal

1- Clicar na opção Exibir Menu Completo, Cadastros, Financeiro, Carteira/Conta Mov.

Cadastro Carteira.PNG

 

2- Digite o nome do banco, marque a opção emitir boleto, depois clique em salvar.

Carteira Caixa   111111111111.PNG

 

 

3-  Na opção dados da conta selecione o banco Caixa, preencha todas as informações dos campos amarelos que são os principais. As informações de Cód. Empresa, Instrução 1 e Instrução 2 precisam ser fornecidas pelo setor responsável pela homologação de boletos do banco Caixa. 

Carteira Caixa 22-05.png

 

 

 

Carteira Sicoob

Cadastro Carteira Banco Sicoob

1- Clicar na opção Exibir Menu Completo, Cadastros, Financeiro, Carteira/Conta Mov.

Cadastro Carteira.PNG

 

2- Digite o nome do banco, marque a opção emitir boleto, depois clique em salvar.

 

Carteira Sicoo 2222222222222222.png

 

3-  Na opção dados da conta selecione o banco Sicoob, preencha todas as informações dos campos amarelos que são os principais. As informações de Cód. Empresa, Instrução 1 e Instrução 2 precisam ser fornecidas pelo setor responsável pela homologação de boletos do banco Sicoob. 

Sicoob 33333333333333333333.png

 

 

 

Emitir Boleto Pelo A Receber

Independente da forma escolhida para gerar um titulo. Ambas estarão na opção A Receber, escolha como deseja localizar o titulo Por Período ou Por Cliente.

A receber.png

No modo a receber, temos a consulta por período em que os títulos são listados através de um determinado período, conforme o exemplo: 
Consulta por periodo.png
Selecione o título que deseja emitir o boleto, clicando na caixinha do lado esquerdo. Em seguida clique no botão Reemitir Boleto. (Obs: Caso você queira emitir mais de um boleto, marque dois ou mais títulos na caixinha a esquerda.)
Reemitir boleto.png
Aparecera um tela onde você irar escolher a carteira que deseja emitir o boleto.

image-1723554625961.png

Você pode também localizar o título por período e clicar duas vezes em cima da duplicata para abri-la.
Na seguinte tela, marque a opção Emitir Boleto e clique no botão Finalizar.  

Duplicata a receber.png

 

 

 

 

 

Como Gerar o Arquivo de Remessa

Para gerar o arquivo de remessa no Soften Siem, vamos em Financeiro/ Relatórios/ Arquivo de Remessa Cobrança.

Arquivo de remessa cobrança.png

Em seguida vamos filtrar os títulos pelo o período selecionando a data que o título foi gerado ou pela data de vencimento do título. No campo Banco e Carteira, localize o Banco a qual deseja emitir o boleto, e depois clique em Listar Títulos a Registrar. 

Filtrar titulos remessa cobrança.png

Logo em seguida vai aparecer todos os títulos a registrar de acordo com o filtro que você utilizou.
Marque os títulos que deseja gerar o arquivo de remessa ou clique na opção Selecionar todos os títulos. 
Clique no botão Gerar Arquivo para gerar a remessa 

Listar títulos remessa e registrar.png

Em seguida aparecera uma confirmação da quantidade de remessa gerada. Clique em OK para encerar

Confirmação de registro.png

Depois aparecera uma tela com um relatório

image-1723560025692.png

 

Como importar o Arquivo de Retorno

Para importar o arquivo de retorno do banco no Soften Siem, vamos em Financeiro/ A receber/ Baixa de Recebimento.

A receber_baixa de recebimento.png

Em seguida, vamos selecionar qual banco vamos importar o retorno no sistema. 

Retorno banco sistema.png

Depois de selecionar qual o banco que você vai importar o retorno. Vai pedir para você localizar o arquivo que você baixou no internet banking do banco e importar no sistema.
Selecione o arquivo e clique em Abrir.

Abrir o aquivo de retorno.png

Em seguida, o sistema abrirá uma tela de mensagem: Importado com sucesso! Confira o relatório

image-1723575820945.png

Clique em ok para visualizar o relatório com as informações de registro ou de liquidez dos boletos em abertos. 

Relatorio do retorno.png