1. Página inicial
  2. Voltar para a pesquisa
  3. Solução de problemas
  4. Financeiro
  5. Contas a Pagar
Como realizar a migração do servidor da API de Pagamentos do Banco do Brasil no Consistem ERP?
2 min
Criado por Documentação Técnica em 23/09/2026 14:17
Atualizado por Documentação Técnica em 23/09/2026 14:29

Para realizar a migração do servidor e garantir que a API de Pagamentos continue operando sem interrupções, siga o passo a passo abaixo:

  1. Garanta que o Consistem ERP esteja atualizado no último release da versão.
  2. Acesse o programa Integração (CSINTEGRACAO010), selecione a integração IBBP e acione a opção Editar.
  3. No programa Cadastro de Integração (CSINTEGRACAO010A), vá até a aba Endpoints e ative os novos endpoints com o prefixo /v1/ (ex: /v1/boletos/{id} e /v1/transferencias/{id}), definindo um período de log.
  4. Na aba Dados Gerais, acione o botão Empresa para abertura do programa Configurações Gerais por Empresa (CSINTEGRACAO010ATAB1A).
  5. Selecione a linha correspondente ao Certificado, clique na coluna Valor e pressione F7para selecionar o certificado digital que será utilizado.
    1. O certificado digital deve ser previamente cadastrado na Aba Certificados (CSMEN210TAB1).
  6. Exporte ou obtenha a cadeia completa do certificado digital no formato PEM.
    1. Caso possua o arquivo no formato .pfx, utilize o programa Gerenciar Certificados (CSMEN210), Aba Certificados (CSMEN210TAB1), para exportá-lo.
  7. Crie uma pasta no computador com o certificado .pfx, abra o terminal de comando no local e execute: 
    openssl pkcs12 -in "<ARQUIVO_CERTIFICADO>.pfx" -out "<ARQUIVO_CERTIFICADO>.pem" -nodes
    1. Se ocorrer erro de versão unsupported, adicione o parâmetro -legacy ao final.
  8. Abra o arquivo .pem em um editor de texto e verifique se a propriedade localKeyID está preenchida com uma numeração longa em formato hexadecimal.
  9. Cadastre o certificado com a cadeia completa no formato PEM no Portal Developers do Banco do Brasil, na API Pagamentos em Lote.
  10. Para forçar o teste de conexão com o novo servidor, execute a task Buscar Documentos Liquidados Banco Brasil através do programa Cadastro de Agendamento de Tarefas (CSTASK010).
    1. Caso não existam documentos pendentes, execute no terminal o comando: set sc=$$ObterTokenBB^CCFFERG001, substituindo pelo código da sua empresa.
  11. Acesse o programa Consulta Logs de Integração (CSINTEGRACAO100) e consulte os logs. O resultado esperado para validação de sucesso é o registro do erro HTTP 400 - "Não há dados para os Critérios Informados" (por se tratar de uma consulta de teste com ID fictício).
  12. Após a validação com sucesso, retorne ao programa Integração (CSINTEGRACAO010) e confirme se o servidor (host) foi alterado automaticamente de https://api-ip.bb.com.br para https://pagamentos-lote.mtls.api.bb.com.br.
Últimos artigos visitados