Validador Número de Agência Bancária

Número da agência bancária: 4 dígitos, às vezes um dígito verificador

Numa conta brasileira, a agência é o número da agência — tipicamente 4 dígitos, às vezes seguidos de um dígito verificador após hífen (1234-5). Junto com o código de banco de 3 dígitos e o número da conta, forma o trio banco + agência + conta que localiza unicamente uma conta para boletos, TED/DOC e débito automático. Esta ferramenta confere o formato NNNN / NNNN-D.

Não há padrão nacional de dígito verificador para a agência: se existe um dígito, e como é calculado, é definido por cada banco. Alguns publicam um dígito; outros usam só os quatro dígitos. Por isso um validador portável confere a estrutura, não um checksum universal.

O trio da conta

• Banco (3 dígitos, COMPE): qual instituição.
• Agência (4 dígitos + DV opcional): qual agência.
• Conta (varia + DV): a conta em si.
• Os três são necessários para rotear uma transferência legada; o PIX os dispensa com uma chave.

Onde importa

• Formulários de pagamento: a agência é campo obrigatório para TED/DOC e registro de boleto.
• Folha e pagamento a fornecedores: arquivos em lote (CNAB) carregam a agência por beneficiário.
• Conciliação: casar depósitos à agência de origem.
• Mock data / testes: validar a máscara NNNN-D antes de uma transferência.

Pegadinhas comuns

• Sem dígito verificador universal: não aplique a regra de DV de um banco à agência de outro.
• Mantenha os zeros à esquerda: 0001 é uma agência real (muitas vezes a matriz); armazene como string.
• Hífen opcional: 1234-5 e 12345 podem significar o mesmo; normalize com cuidado.
• A agência muda, a conta talvez não: fusões de agências podem reatribuir o número da agência.

FAQ

A agência tem dígito verificador? Às vezes — é específico de cada banco. Muitas agências são só quatro dígitos; outras anexam um DV.

Ainda preciso da agência para PIX? Não — o PIX roteia por chave (CPF, e-mail, telefone ou aleatória). A agência é para TED/DOC e boletos legados.

0001 é válido? Sim — números de agência com zero à esquerda são comuns; trate o valor como string de 4 caracteres.