Log Integrações
A tela Log Integrações é o diário de bordo das integrações de SKU com os canais de venda — registra cada tentativa de sincronização de produto, preço, estoque ou anúncio (envio para o canal e retorno do canal), com data, ação realizada, status (Sucesso ou Erro), usuário que disparou e a mensagem detalhada da resposta. É a primeira tela que o suporte e o time de e-commerce olham quando algo não está sincronizando como esperado.
A tela tem dois modos de visualização — Tabela (visão linear com paginação) e Linha do tempo (agrupada por dia, com indicadores visuais de sucesso/erro). Cada linha pode ser expandida para mostrar o detalhe da resposta — quando o conteúdo é JSON, o sistema formata para leitura e oferece um botão Copiar JSON. Há filtros rápidos (mostrar só erros, só de hoje, só da última hora) e os filtros padrão (data, integração, ação, SKU, status).
Para auditoria e análise posterior, a tela permite exportar a lista filtrada para Excel (privilégio específico Exportar Log Sku).
Índice
Conceito
- O que é a tela Log Integrações?
- O que cada coluna mostra?
- Quem é o Usuário Server?
- O que significam os status Sucesso e Erro?
Visualização
- Como alternar entre os modos Tabela e Linha do tempo?
- Como ver o detalhe completo de um log (resposta do canal)?
- Como copiar o JSON da resposta?
Busca
- Como usar os filtros rápidos (Erros, Hoje, Última hora, Sistema, Usuário)?
- Como usar os filtros avançados?
- Como ordenar a linha do tempo (mais recentes ou mais antigos primeiro)?
Exportação
Regras de negócio
- Quanto tempo o log fica guardado?
- Por que alguns logs não têm comentários?
- O que fazer quando vejo muitos erros do mesmo tipo?
Referência rápida
O que é a tela Log Integrações?
É o registro detalhado de toda tentativa de sincronização de SKU entre o idworks e os canais de venda — anúncios, preço, estoque, descrição, fotos, etc. Cada linha é uma chamada à API do canal (ou um retorno automático do canal) com data, ação realizada, status (Sucesso ou Erro) e a mensagem completa da resposta.
A tela é somente consulta — não é possível editar ou apagar logs por aqui. Serve para auditoria, suporte e diagnóstico de problemas de integração.
📍 Onde: menu lateral → Integrações (HUB) → Log Integrações.
O que cada coluna mostra?
| Coluna | O que mostra |
|---|---|
| Data | Data e hora exatas em que a ação foi executada. |
| Referência | Código de referência interno do SKU envolvido (em Estoque → Listar Produtos). |
| Nome | Nome completo do produto. Clique no ícone de olho para abrir o cadastro do SKU. |
| Ação | O que foi tentado — Atualizar Anúncio, Sincronizar Estoque, Atualizar Preço, Importar Produto, etc. |
| Integração | Qual canal recebeu/enviou a chamada (Mercado Livre, Shopee, VTEX, etc.). |
| Comentários | Mensagem detalhada da resposta — texto plano ou JSON formatado da API do canal. |
| Usuário | Quem disparou a ação. Pode ser um usuário do sistema (com nome de login) ou Server (ação automática disparada pelo próprio idworks ou pelo canal). |
| Código | Código interno do SKU. |
| Cód. anúncio | Identificador do anúncio no canal (ID do canal, não do idworks). Clique no ícone de olho para abrir o anúncio. |
| Status | Sucesso ou Erro. Bolinha colorida (verde para Sucesso, vermelho para Erro, cinza para outros). |
Quem é o Usuário Server?
Quando a coluna Usuário mostra Server, significa que a ação foi automática — não foi disparada por um usuário humano. Acontece em três situações típicas:
- Cron jobs do idworks — rotinas que sincronizam estoque/preço periodicamente.
- Resposta do canal — quando o canal envia um webhook ou retorna assincronamente (status de pedido, confirmação de anúncio, etc.).
- Workers de fila — processamentos batch que rodam sem usuário associado.
O filtro rápido Sistema lista apenas logs com usuário Server; Usuário mostra apenas os disparados por humanos.
O que significam os status Sucesso e Erro?
| Status | Significado |
|---|---|
| Sucesso (verde) | O canal aceitou a chamada e respondeu sem erro. A operação foi efetivada. |
| Erro (vermelho) | O canal recusou a chamada — a resposta detalhada está na coluna Comentários. Erros típicos: validação rejeitada, anúncio inativo, produto não encontrado, credenciais expiradas, limite de API atingido. |
| Outros (cinza) | Status intermediários ou neutros — geralmente registros informativos sem ação efetiva (consulta, validação, etc.). |
Para investigar um erro, clique na seta de expansão da linha para ver o JSON completo da resposta do canal — geralmente traz o motivo exato do erro.
Como alternar entre os modos Tabela e Linha do tempo?
A tela tem um seletor de modo de visualização no topo:
- Tabela — visão padrão, linear com paginação, ideal para varredura rápida.
- Linha do tempo — agrupada por dia, com ícones de status à esquerda de cada linha, indicada para ver a sequência cronológica de eventos.
Clique no ícone correspondente para alternar. A escolha vale apenas para a sessão atual — ao recarregar a página, volta para o padrão Tabela.
Como ver o detalhe completo de um log (resposta do canal)?
Clique na seta de expansão (►) à esquerda da linha. A linha expande para baixo mostrando:
- Se a resposta for texto plano — exibe direto.
- Se for JSON válido — o sistema formata com indentação e oferece o botão Copiar JSON acima do bloco.
Apenas linhas com algo no campo Comentários podem ser expandidas — quando a resposta veio vazia, o ícone de expansão não aparece.
Como copiar o JSON da resposta?
Expanda a linha do log (clique na seta à esquerda). Quando o conteúdo é JSON, aparece um botão Copiar JSON acima do bloco — clique para copiar o JSON formatado para a área de transferência. Uma notificação de confirmação aparece.
Útil para colar em ferramentas de análise (Postman, Insomnia, editores de JSON) ou para enviar ao suporte do canal de venda quando precisar abrir um chamado.
Como usar os filtros rápidos (Erros, Hoje, Última hora, Sistema, Usuário)?
No topo da tela há botões de filtro rápido que aplicam regras pré-definidas com um clique:
| Filtro | O que mostra |
|---|---|
| Erros | Apenas logs com Status = Erro. Para diagnóstico rápido. |
| Hoje | Apenas logs com data ≥ início de hoje. |
| Última hora | Apenas logs registrados há menos de 1 hora. Útil para acompanhar uma sincronização em andamento. |
| Sistema | Apenas logs com usuário = Server (ações automáticas). |
| Usuário | Apenas logs com usuário humano (exclui Server). |
Os filtros rápidos podem ser combinados — clique em vários para somar critérios (ex.: Erros + Hoje). Clique de novo no botão para desativá-lo.
Junto aos filtros, o cabeçalho mostra estatísticas em tempo real: Total / Sucesso / Erro / Sistema / Usuário — calculadas sobre o resultado filtrado atual.
Como usar os filtros avançados?
Clique em Filtros para abrir o painel lateral com os filtros padrão:
- Conta — separa por conta (subdomínio).
- Data log — intervalo de datas (data início e fim).
- Nome produto — busca textual no nome do SKU.
- Código — código interno do SKU.
- Cód. referência — código de referência do SKU.
- Integração — filtra por canal específico.
- Ação — filtra por tipo de ação (Atualizar Anúncio, Sincronizar Estoque, etc.).
- Status — Sucesso, Erro.
Os filtros são cumulativos e combinam com os filtros rápidos. Clique em Aplicar para atualizar a lista.
Como ordenar a linha do tempo (mais recentes ou mais antigos primeiro)?
No modo Linha do tempo, há um ícone ao lado do seletor de visualização para alternar a ordem:
- Decrescente (mais recentes primeiro — padrão) — útil para ver o que aconteceu por último.
- Crescente (mais antigos primeiro) — útil para acompanhar uma sequência cronológica de eventos do início.
A ordenação não afeta o modo Tabela (que usa a ordenação padrão da coluna Data).
Como exportar o log filtrado para Excel?
Clique em Mais Ações no topo direito da tela e selecione Exportar. O sistema gera um arquivo Excel com todas as linhas atualmente filtradas (respeitando filtros rápidos + filtros avançados).
A planilha inclui as colunas visíveis na tela (Data, Referência, Nome, Ação, Integração, Comentários, Usuário, Status). Para registros com Comentários muito longos, o conteúdo aparece truncado no Excel — para análise detalhada, use a tela diretamente.
Pré-requisito: privilégio Exportar Log Sku.
Quanto tempo o log fica guardado?
Os logs ficam armazenados enquanto a operação mantiver o histórico — por padrão, o idworks preserva os logs por até 90 dias para ações de SKU. Logs antigos são removidos automaticamente por rotinas internas para evitar inflar o banco de dados.
Para investigações de longo prazo (auditoria de compliance, análise de incidentes antigos), exporte para Excel periodicamente — os arquivos exportados são da empresa e podem ser arquivados pelo tempo necessário.
Por que alguns logs não têm comentários?
A coluna Comentários fica vazia quando:
- A ação foi um disparo simples sem resposta (apenas registro de que tentou).
- O canal aceitou silenciosamente — alguns canais não retornam corpo de resposta em operações de sucesso.
- O log foi gerado por uma ação interna que não precisa registrar detalhes.
Quando uma linha não tem Comentários, não é possível expandi-la — o ícone de seta não aparece à esquerda.
O que fazer quando vejo muitos erros do mesmo tipo?
Quando o filtro rápido Erros mostra muitos logs do mesmo SKU + mesma ação + mesma integração, geralmente é um problema sistêmico:
- Credenciais expiradas — a integração precisa ser reconectada em Configurações → Integrações.
- SKU configurado errado — algum atributo do produto está faltando ou inválido para o canal.
- Anúncio inativo no canal — o canal removeu o anúncio mas o idworks continua tentando atualizá-lo.
- Limite de API atingido — alguns canais limitam o número de chamadas por hora/dia.
Expanda a linha do log para ver a mensagem detalhada — ela costuma indicar a causa exata. Se o problema persiste após corrigir, abra um chamado no suporte enviando o JSON da resposta (copiado via botão Copiar JSON).
Privilégios da tela
Esta tela tem privilégios próprios que controlam o que cada usuário pode fazer. Configure os perfis de acesso em Configurações → Perfis de Acesso vinculando os privilégios abaixo aos grupos desejados. Quando o usuário não tem o privilégio, a ação correspondente fica desabilitada na tela.
| Privilégio | Libera |
|---|---|
| Visualizar log integração SKU | Acesso à tela e à lista. |
| Exportar Log Sku | Opção Exportar em Mais Ações (download Excel da lista filtrada). |