Entendendo a diferença entre Data da Transação e a Data de Lançamento – Central de Atendimento

Entendendo as Datas em Transações Bancárias

Conceito	Definição Clara	O que o OpenFinance Prioriza (Campo date)
Data da Transação (Data de Ocorrência)	É o dia exato em que a movimentação financeira foi realizada (e.g., o dia que você passou o cartão na loja).	Não é fornecida de forma consistente por todos os bancos (e.g., Bradesco) e, portanto, não é usada como campo principal.
Data de Lançamento (Data de Postagem)	É o dia em que a transação é efetivamente contabilizada no seu extrato e o saldo da conta é alterado. O banco 'lança' o valor em sua conta.	Esta é a data mapeada no campo `date` da nossa API. É a única data confiável para cálculos financeiros e conciliação.

O Motivo da Diferença (E por que padronizamos)

Ao integrar com contas correntes através de APIs Open Finance, é comum observar que a data de uma transação retornada pelo banco (Data de Lançamento) é diferente do dia em que o cliente realizou a operação (Data da Transação).

Este comportamento é esperado e está relacionado à forma como o banco processa e disponibiliza os dados:

Processamento Interno: Muitas instituições, como o Bradesco, podem realizar o lançamento (contabilização) de uma operação um ou mais dias úteis após a data real da transação.
Consistência e Confiabilidade: Para garantir a consistência e confiabilidade dos relatórios financeiros em todas as instituições, o OpenFinance sempre entrega a Data de Lançamento no campo date do objeto de transação. Esta é a data em que o saldo foi, de fato, afetado.

Importante: A Data de Transação (data real da ocorrência) não é perdida, mas ela simplesmente não é exposta por canais digitais ou APIs de integração de certos bancos. Portanto pode não estar disponível para uso.

Quais Bancos Apresentam Essa Diferença?

Essa prática é comum em várias instituições financeiras. Abaixo estão alguns exemplos onde essa diferença é claramente identificada, mas a lista pode se expandir:

Banco	Pode haver diferença de datas
Bradesco	✔️
Itaú	✔️
Santander	✔️

Boas Práticas de Uso

Para garantir a melhor experiência do usuário e a integridade financeira:

Controle de Saldo e Conciliação: Utilize sempre a data retornada no campo date (Data de Lançamento). Ele reflete o momento exato em que a transação passou a compor o extrato oficial para fins contábeis e fiscais.
Exibição ao Usuário: Ao mostrar o extrato ao cliente final, informe claramente que a data exibida é a Data de Lançamento ou Data de Processamento.

Exemplo de Explicação ao Usuário:

Se um usuário relatar que fez uma compra no dia 09/10/2025, mas o sistema mostra a data 10/10/2025:

"O banco processou sua transação de R$ 23,89 (descrição: COMPRA POSTO OASIS) na data de 10/10/2025. Essa data é conhecida como Data de Lançamento, o dia em que o valor foi efetivamente contabilizado em seu extrato, conforme a política interna da instituição financeira. Para fins de controle de saldo, essa é a data mais confiável."

Benefícios de Manter a Data de Lançamento como Padrão

O OpenFinance mantém a Data de Lançamento (campo date) como referência para assegurar:

Consistência de Dados: Padronização de dados entre diferentes instituições financeiras.
Confiabilidade: Garantia de integridade no cálculo de saldos e históricos.
Integração Contábil: Precisão nas conciliações financeiras, uma vez que se baseia na data em que o dinheiro realmente saiu ou entrou na conta.