Relatórios — Troubleshooting

Troubleshooting: Datas, Timezone e Status

Este guia auxilia na resolução de dúvidas sobre os dados extraídos nos relatórios de Pedidos, Eventos, Envios, Filiais, Integrações e CSAT.

1. Comportamento global de datas (timezone)

Uma dúvida comum é a diferença de horários entre o painel web e o arquivo exportado. Esta funcionalidade é nativa da plataforma para garantir a precisão logística local.

No painel (web)

Os dados são exibidos no padrão UTC, identificado pelo "Z" no final da string (ex.: 2026-02-13T16:18:19.000Z).

No relatório (CSV/JSON)

O sistema detecta o fuso horário da sua máquina (ex.: America/Sao_Paulo -03:00) e converte automaticamente todas as datas para este fuso no momento da exportação.

Exemplo: Um pedido criado às 16:00 no painel (UTC) aparecerá como 13:00 no seu relatório (horário de Brasília).

2. Colunas afetadas por tipo de relatório

Abaixo estão os principais campos de data que sofrem essa conversão automática em cada categoria:

Tipo de relatório	Colunas de data convertidas (exemplos)
Pedidos (ORDERS)	`data_de_entrega`, `data_de_atualizacao`, `data_de_criacao_do_pedido`, `data_de_emissao_da_nf`, `data_de_processamento_do_embarcador`
Eventos (EVENTS)	`data_de_criacao_do_evento`, `data_em_que_o_evento_ocorreu`, `data_prevista_de_finalizacao_do_envio`
Envios (DELIVERIES)	`delivery_created_at`, `delivered_delivery_date`, `delivery_expected_delivery_date`, `delivery_eta_updated_at`
CSAT	`answered_at` (data de resposta), `invoice_issued_at` (emissão de NF)
Integrações	`carrier_integration_created_at`, `order_integration_updated_at`

3. Checklist de verificação

Se os horários não estiverem batendo conforme o esperado, siga estes passos:

Verifique a mensagem de aviso

Ao gerar um Novo Relatório, a plataforma exibe um alerta:

“Identificamos que você está no fuso horário [Seu Fuso]. Todos os campos de data e hora serão exportados neste fuso.”

Confirme se o fuso detectado é o correto.

Origem da extração

Configuração da filial

Alguns relatórios de Filiais (SELLERS) possuem campos específicos de fuso_horario_da_filial e seller_timezone. Certifique-se de que a configuração da filial no cadastro condiz com a região física dela.

4. Status do processamento

Caso o relatório não esteja disponível imediatamente, verifique a coluna Status na tela de relatórios:

Status	Significado
NA FILA (QUEUED)	Aguardando processamento.
PROCESSANDO (PROCESSING)	O arquivo está sendo gerado com os filtros aplicados.
COMPLETO (DONE)	Pronto para download.
EXPIRADO (EXPIRED)	Relatórios antigos são removidos periodicamente; gere-o novamente se necessário.

5. Formato XLSX não disponível

O formato XLSX não é suportado atualmente. Os formatos disponíveis para exportação são CSV e JSON.

Se você precisa de um arquivo .xlsx, exporte em CSV e abra no Excel ou Google Sheets — a conversão é automática ao abrir o arquivo.