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 BB11 disponíveis
→
2Integração APIautentica · consulta · importa
→
3Sincronizados11 importados
→
4ERPconciliação existente
Sucesso
Última sincronização
09/08/2026 23:21:13 · modo demonstração
200HTTP1Página11Recebidos11Novos0Duplicados10 msDuração
Fluxo técnico
Execução passo a passo
Abra cada etapa para explicar exatamente o que ocorreu.
{ "execucao": 14, "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": 8450, "registros": 11 }{ "numeroPaginaAtual": 1, "quantidadeRegistroPaginaAtual": 11, "numeroPaginaAnterior": 0, "numeroPaginaProximo": 0, "quantidadeTotalPagina": 1, "quantidadeTotalRegistro": 11, "listaLancamento": [ { "indicadorTipoLancamento": "1", "dataLancamento": "24072026", "dataMovimento": "24072026", "codigoAgenciaOrigem": "1505", "numeroLote": "32901", "numeroDocumento": "DOC46306", "codigoHistorico": "821", "CodigoSubHistorico": "25001", "textoDescricaoHistorico": "Pix - Recebido", "valorLancamento": 3231.43, "indicadorSinalLancamento": "C", "textoInformacaoComplementar": "FAT-463-006 Comércio Estrela do Sul Ltda", "numeroCpfCnpjContrapartida": "28859921912039", "indicadorTipoPessoaContrapartida": "J", "codigoBancoContrapartida": "001", "codigoAgenciaContrapartida": "2469", "numeroContaContrapartida": "469882", "textoDvContaContrapartida": "3", "CodigoIdentificadorSistemaPagamento": "46864822", "TextoIdentificadorUnicoTransacao": "BBV2-463-006", "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": 11, "duplicados": 0, "fallback": "hash de campos estáveis quando o identificador não existir" }{ "recebidos": 11, "importados": 11, "duplicados": 0, "paginas": 1 }