Para análise em ferramentas externas (Excel, Power BI, contabilidade), o ShopIA exporta pedidos em CSV ou Excel. Esta página descreve filtros, formatos e limitações.
Onde exportar
Pedidos > Exportar (botão no topo da página).
Formatos disponíveis
| Formato | Quando usar |
|---|---|
| CSV (UTF-8) | Importar em Excel, Sheets, BI |
| Excel (XLSX) | Abrir direto no Excel sem import |
| JSON | Integração técnica |
CSV é o mais universal. Excel é mais "bonito" abrindo direto.
Filtros antes de exportar
Antes de clicar Exportar, aplique filtros para limitar resultado:
| Filtro | Exemplo |
|---|---|
| Período | Últimos 30 dias, mês específico |
| Status | Aprovado, enviado, entregue, cancelado |
| Cliente | Específico, ou tag de cliente |
| Valor mínimo / máximo | Pedidos acima de R$ 500 |
| Plataforma origem | WooCommerce, Shopify, etc. (multi-loja) |
Atenção: sem filtro, ShopIA exporta todos os pedidos da loja, podendo ser muito (anos de histórico). Sempre filtre o necessário.
Colunas exportadas
Padrão (CSV/Excel):
| Coluna | Descrição |
|---|---|
order_id | ID interno ShopIA |
external_id | ID na plataforma origem |
order_number | Número visível ao cliente |
created_at | Data/hora criação |
customer_email | Email do cliente |
customer_name | Nome |
customer_phone | Telefone |
total | Valor total |
subtotal | Subtotal antes de descontos |
discount | Desconto total |
shipping | Frete |
tax | Imposto se aplicável |
status | Status atual |
payment_method | Forma de pagamento |
shipping_address | Endereço entrega |
items_count | Quantidade de itens |
platform | Plataforma de origem |
Colunas opcionais (toggle)
- Itens detalhados (uma linha por produto do pedido)
- Histórico de status (mudanças de estado)
- Tags de cliente
- Atributos custom
Configuração: Pedidos > Exportar > Colunas.
Exportação detalhada (uma linha por item)
Quando você marca incluir itens detalhados, o CSV ganha mais linhas:
order_id,product_id,product_name,quantity,price
123,prod_xyz,"Camiseta Roxa",2,89.90
123,prod_abc,"Calça Preta",1,149.90Útil para análise de produtos.
Exportação agregada
Em Painel > Resultados > Exportar, você pode exportar resumos agregados:
- Receita por dia/mês
- Pedidos por categoria
- Top 10 produtos
- Performance por canal
Mais leve, ideal para BI.
Detalhes em Página de resultados / ROI.
Limites de exportação
| Item | Limite |
|---|---|
| Linhas por exportação | 50.000 |
| Tamanho do arquivo | 50 MB |
| Exportações simultâneas | 1 por usuário |
| Frequência | Sem limite explícito |
Para volumes maiores, divida por período (ex: trimestres).
Tempo de geração
| Volume | Tempo típico |
|---|---|
| <1.000 linhas | <5 segundos |
| 1.000-10.000 | 10-60 segundos |
| 10.000-50.000 | 1-3 minutos |
Para exportações longas, ShopIA gera em background:
- Clique em Exportar.
- Notificação "exportação em andamento".
- Quando pronto, download fica disponível em Pedidos > Exportações (ou notificação push).
- Link expira em 48h.
Encoding e caracteres especiais
CSV exporta em UTF-8 com BOM — abre corretamente no Excel brasileiro com acentos.
Se você abrir e os acentos saírem errados:
- Excel: Dados > De arquivo > De Texto/CSV > escolha UTF-8
- LibreOffice: detecta automático
- Google Sheets: cole como valor se import direto falhar
Exportação automática (recorrente)
Para receber export semanalmente por email:
- Configurações > Relatórios > Exportações automáticas.
- Tipo: pedidos.
- Filtros: padrão (últimos 7 dias).
- Frequência: semanal, segunda 8h.
- Email de destino.
- Salve.
ShopIA gera e manda automaticamente.
<!-- TODO: confirmar com Gabriel se exportação automática é entrega ativa ou roadmap -->
Privacidade dos dados exportados
Export contém dados pessoais (nome, email, telefone, endereço). LGPD aplica:
- Trate o arquivo como sensível
- Não compartilhe sem necessidade
- Apague após uso
- Não armazene em pastas públicas
Detalhes em LGPD: responsabilidades do lojista.
Pedidos cancelados
Padrão: pedidos cancelados estão no export (com status cancelled).
Para excluir cancelados, use filtro de status.
Pedidos de teste / sandbox
Se sua loja teve pedidos de teste, eles aparecem normalmente no export. Para distinguir:
- Filtro de período (separa antes/depois de produção)
- Filtro de valor (testes geralmente são R$ 0,01)
- Tag manual em clientes de teste
Sandbox e exportação
Sandbox não afeta exportação — você pode exportar dados normalmente, mesmo com sandbox ativo.
Importando export em Excel
- Abra Excel.
- Dados > Obter Dados > De arquivo > De Texto/CSV.
- Selecione o CSV.
- Origem: 65001 UTF-8.
- Delimitador: vírgula.
- Carregar.
Pivot tables, gráficos, análises ficam disponíveis.
Exportação para BI
Para integração com Power BI, Looker, Metabase:
- Use export JSON (mais estruturado)
- Ou conecte direto ao banco (Pro/Enterprise apenas)
Detalhes em Stack de BI (apontamento técnico).