Integração técnica
Integração com a API
Integração com a API
de Extratos do BB
Da autenticação à entrega dos lançamentos para o ERP — com cada decisão técnica visível.
SIMULAÇÃO DECLARADAEstrutura, campos e fluxo seguem a documentação fornecida. Token, mTLS e conexão externa são simulados; nenhuma requisição é enviada ao BB.
1Fonte BB25 disponíveis
→
2Integração APIautentica · consulta · importa
→
3Sincronizados25 importados
→
4ERPconciliação existente
Sucesso
Última sincronização
09/08/2026 20:23:57 · modo demonstração
200HTTP1Página25Recebidos0Novos25Duplicados15 msDuração
Fluxo técnico
Execução passo a passo
Abra cada etapa para explicar exatamente o que ocorreu.
{ "execucao": 7, "modo": "demo" }{ "agencia": "1505", "conta": "1348", "timeout_conexao": "10s", "timeout_total": "30s", "registros_por_pagina": 120 }{ "Authorization": "Bearer ••••••••••••", "simulado": true }{ "protocolo": "TLS 1.2+", "certificado_cliente": "certificado-a1-••••.pfx", "simulado": true }{ "method": "GET", "endpoint": "https://extratos.mtls.api.hm.bb.com.br/v2/conta-corrente/agencia/1505/conta/1348", "headers": { "Authorization": "Bearer ••••••••••••", "Content-Type": "application/json", "x-br-com-bb-ipa-mciteste": "••••••••" }, "query": { "gw-dev-app-key": "••••••••", "numeroPaginaSolicitacao": 1, "quantidadeRegistroPaginaSolicitacao": 120 }, "body": null }{ "dns_ms": 7, "tcp_ms": 12, "tls_ms": 31, "destino": "extratos.mtls.api.hm.bb.com.br", "simulado": true }{ "pagina": 1, "payload_request": null, "observacao": "GET não possui body" }{ "status": 200, "content_type": "application/json", "bytes": 18953, "registros": 25 }{ "numeroPaginaAtual": 1, "quantidadeRegistroPaginaAtual": 25, "numeroPaginaAnterior": 0, "numeroPaginaProximo": 0, "quantidadeTotalPagina": 1, "quantidadeTotalRegistro": 25, "listaLancamento": [ { "indicadorTipoLancamento": "1", "dataLancamento": "02082026", "dataMovimento": "02082026", "codigoAgenciaOrigem": "1505", "numeroLote": "57694", "numeroDocumento": "DOC912015", "codigoHistorico": "821", "CodigoSubHistorico": "25001", "textoDescricaoHistorico": "Pix - Recebido", "valorLancamento": 3141.54, "indicadorSinalLancamento": "C", "textoInformacaoComplementar": "FAT-912-015 Logística Nacional Ltda", "numeroCpfCnpjContrapartida": "83495988957789", "indicadorTipoPessoaContrapartida": "J", "codigoBancoContrapartida": "001", "codigoAgenciaContrapartida": "5539", "numeroContaContrapartida": "931620", "textoDvContaContrapartida": "5", "CodigoIdentificadorSistemaPagamento": "21059546", "TextoIdentificadorUnicoTransacao": "BBV2-912-015", "CodigoConfederacaoNacionalBancos": "" } ], "_nota": "Amostra limitada a 1 lançamento." }{ "pagina_atual": 1, "proxima_pagina": 0, "total_paginas": 1 }{ "dataLancamento": "transaction_date", "textoDescricaoHistorico": "description", "indicadorSinalLancamento": "signal", "valorLancamento": "amount" }{ "novos": 0, "duplicados": 25, "fallback": "hash de campos estáveis quando o identificador não existir" }{ "recebidos": 25, "importados": 0, "duplicados": 25, "paginas": 1 }