# Relatórios — Troubleshooting

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**.
**Leitura prévia:** Se ainda não conhece a página de Relatórios, veja a [Visão Geral](https://abbiamo-guide.netlify.app/go/products/relatorios/) e o guia [Como Usar](https://abbiamo-guide.netlify.app/go/products/relatorios/como-usar/) antes de continuar.

## 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.
**Onde acontece:** Em **todas** as colunas de data/hora de qualquer relatório (ex.: Data de criação, Prazo prometido, Última atualização, Emissão de NF, Resposta CSAT).

### 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
**Quem gerou o relatório:** O relatório **trava** as datas no fuso de quem clicou no botão **Gerar**. Se um colega em outro país/fuso gerar o arquivo e enviar para você, as horas estarão ajustadas ao relógio dele.

### 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. |
**Relatório expirado:** Se o status estiver **EXPIRADO**, basta solicitar um novo relatório com os mesmos filtros; o arquivo será gerado novamente. Veja como em [Como Usar → Gerar relatório novamente](https://abbiamo-guide.netlify.app/go/products/relatorios/como-usar/#gerar-relatório-novamente).

## 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.