Como separar fuso de transação e data contábil na integração

Um pagamento marcado às 01h20 UTC do dia 1 ainda ocorreu no dia 31 em Brasília. O relatório da plataforma pode apresentar essa linha no mês seguinte, enquanto a equipe de caixa usa a data local. A data de competência também pode depender da entrega ou de outro fato documentado. Para evitar diferença de fechamento, preserve o instante original, converta para o fuso de análise e registre cada data com sua função.

Separe evento, disponibilidade e competência

O evento identifica quando a plataforma registrou a operação. A disponibilidade indica quando o saldo ficou utilizável, conforme a definição do provedor. A liquidação bancária aparece na conta de destino quando há saque ou repasse. A competência contábil segue o fato e a política aplicável. A data de importação no ERP serve ao controle interno. Guarde colunas diferentes e defina qual alimenta cada relatório. Evite usar a data mais fácil de exportar para todas as finalidades.

Quando há um timestamp, guarde o valor original com o deslocamento em relação a UTC ou o fuso informado pela fonte. O RFC 3339 descreve uma forma interoperável de registrar data e hora com relação a UTC. Uma marca Z representa UTC. Um deslocamento informa a diferença naquele instante. Para regras de dia local em regiões que mudam de horário, a integração pode usar uma zona reconhecida e guardar a regra usada. Se a fonte apresenta só a data, mantenha a precisão de dia e consulte a definição antes de inventar um horário.

Defina o corte e teste eventos da virada

Escolha o fuso de cada visão gerencial e a janela do fechamento. Para data local em Brasília, converta o instante e então compare o dia. No relatório de saldo do provedor, use a data e a zona correspondentes à seleção do arquivo. A Stripe descreve seus relatórios de saldo e suas opções de período e zona. Antes de mesclar arquivos, confira qual escolha foi feita na exportação. Se o mesmo arquivo é baixado com outra zona, compare o instante e a referência para identificar a transação.

Planeje os movimentos dos dois lados do corte. Se um crédito do último dia aparece disponível no mês seguinte, mostre a ponte no fechamento, preservando o saldo em trânsito ou pendente conforme o controle adotado. Se há disputa ou estorno após a virada, mantenha o evento posterior ligado ao original. Consulte a contabilidade para o registro em competência encerrada, conforme o procedimento aplicável. As orientações do CFC ajudam a identificar a necessidade de preservar escrituração e eventual retificação.

Exemplo de pagamento às 01h20 UTC

Uma prestadora brasileira recebe USD 2.000 com timestamp 1º de setembro às 01h20 UTC. O mesmo instante é 31 de agosto às 22h20 em Brasília, UTC−3. O saldo fica disponível no dia 2 e o saque chega ao banco no dia 3. A tabela de eventos mostra a data original do provedor e a data local. O controle de saldo indica disponibilidade no dia 2 e a conciliação bancária aponta o dia 3. O contador verifica a competência com contrato, aceite e documentos fiscais.

O relatório gerencial de agosto mostra o evento pela regra local e explica que o dinheiro ainda não estava disponível. Um painel extraído por mês UTC mostra a linha em setembro. A equipe confere o identificador e registra a diferença de corte para evitar baixa duplicada. No mês seguinte, o mesmo teste é repetido com horário local que coincide com UTC e com uma linha que traz somente data, para verificar regras distintas.

Documente a configuração de cada origem

• Guarde formato original, fuso ou deslocamento e o campo que representa o evento.
• Registre fuso gerencial, versão do mapeamento e a regra de corte.
• Preserve disponibilidade, liquidação bancária e competência em campos próprios.
• Teste eventos próximos de meia-noite, fim de mês e horários ambíguos em regiões com mudanças sazonais.

Se a empresa decide mudar o fuso de um relatório histórico, estime o efeito nos meses e indique a data de adoção. Antes de reapresentar números, compare os registros movidos entre períodos. No ERP, um campo que recebe apenas data não é suficiente para reconstituir o instante, então guarde o timestamp de origem na base de conciliação.

Quando um fornecedor de dados corrige a zona de um relatório, reproduza o fechamento anterior com os instantes armazenados e liste somente os eventos que mudam de dia local. Peça autorização antes de refletir a diferença em um período já encerrado. Documente a versão da regra.

Inclua uma segunda conferência para eventos próximos ao corte.

Perguntas frequentes

Qual data deve ir para a contabilidade?

Entregue as datas do evento, da disponibilidade e da liquidação junto às evidências do serviço. A contabilidade define a competência e o registro aplicável.

Posso interpretar todo horário da plataforma como Brasília?

Confira a zona do relatório ou o deslocamento informado. Converta com base nessa origem e preserve o valor original.

O mesmo pagamento aparece em dois meses. Como evitar dupla baixa?

Compare o identificador e o instante original. Registre a diferença de corte e ligue as datas do relatório ao mesmo evento.

Fontes oficiais

• RFC Editor — data e hora na internet
• Stripe — relatório de saldo
• CFC — escrituração e retificação do Livro Diário

Leituras relacionadas

• Como fechar a carteira de recebíveis internacionais com uma data-base comum
• Guias para exportadores de serviços

Como a Zen pode ajudar

A contabilidade para exportação de serviços da Zen ajuda a organizar documentos, conciliar recebimentos e analisar as regras da sua operação. Peça uma proposta personalizada para conversar sobre o seu caso.