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.
Será necessário fazer o preenchimento de um CPF (pode ser qualquer pessoa responsável pela empresa).
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".
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.
Não é obrigatório fazer o preenchimento o Ícone da Aplicação.
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".
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.
*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.
No Menu lateral, clique na opção "Credenciais".
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).
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
Preencha o CNPJ da empresa e confirme os dados:
Revise os dados a aplicação e clique em "SOLICITAR PRODUÇÃO".
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".
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").
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):
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".
É 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.
É 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".
Selecione os títulos para registro e clique em "Registrar Boletos". Irá abrir uma tela com a o status do registro do boleto.
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.
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.