Ação em massa
A tela de Ação em massa é a central de importações por planilha do idworks. A partir dela você cadastra, atualiza ou edita em lote produtos, pedidos, contas a pagar e a receber, tabelas de frete, conciliações, anúncios, endereços, ressuprimento, fornecedores e muito mais — tudo a partir de um arquivo .xlsx ou .xls. Cada importação vira um job, que é processado pelo sistema em segundo plano e devolve um relatório linha-a-linha de sucesso e erro.
A tela apresenta a lista dos jobs criados pela conta com data de cadastro, data de início, data de fim, código, tipo de ação, usuário e conta. O botão Importar Arquivo no canto superior direito abre o modal de envio (selecionar conta, escolher o tipo de ação, baixar o modelo e enviar a planilha). A ação Visualizar na linha do job mostra o resultado completo: cabeçalho com datas e usuário; lista de cada linha processada com Sheet, Linha, Status (Sucesso/Erro) e Descrição; botão para baixar a planilha original (link válido por 2 dias); e Exportar Resultado para gerar um Excel com o resultado mostrado.
A central recebe ações de muitas telas: o botão de importação distribuído em telas como Cadastro de Produtos, Contas a Pagar, Contas a Receber, Pedido de Compra, Extrato Bancário, Conciliação Adquirente, Hub Anúncios etc. — todos despejam jobs aqui. Esta é a tela onde você acompanha tudo de forma unificada.
Índice
Conceito
Cadastro e edição
- Como disparar uma ação em massa (importar planilha)?
- Como baixar o modelo da planilha?
- Quais ações exigem informações adicionais (banco, integração, fornecedor)?
- Quais cadastros preciso ter antes?
Busca e visualização
- Como filtrar e localizar um job?
- Como ver o resultado de um job?
- Como baixar a planilha original que foi enviada?
- Como exportar o resultado para uma nova planilha?
Regras de negócio
- O que significa cada status no resultado (Sucesso, Erro)?
- O que acontece se eu reenviar a mesma planilha enquanto a anterior está processando?
- Quais limites tenho ao importar (tamanho, formato)?
- Por quanto tempo o arquivo original fica disponível para download?
Referência rápida
O que é a tela Ação em massa?
É o histórico unificado das importações por planilha da empresa. A lista mostra todo job criado por qualquer usuário da conta — vindo da tela de Ação em massa diretamente ou disparado pelo botão Importar de outras telas (Cadastro de Produtos, Contas a Pagar, Pedido de Compra, Extrato Bancário, etc.). De aqui você acompanha o status de cada importação, consulta os erros linha a linha, baixa a planilha original e exporta o relatório.
📍 Onde: menu lateral → Configurações → Ação em massa.
Como o processamento funciona?
O processamento é assíncrono:
- Você envia a planilha em Importar Arquivo (ou pelo botão de importar em outra tela).
- O idworks faz upload do arquivo, calcula um identificador único baseado no conteúdo e cria o job com status pendente.
- O job entra em fila e é processado em background — pode levar de segundos a vários minutos, dependendo do tamanho e do tipo da ação.
- Para cada linha da planilha, o sistema grava no resultado se a linha foi processada com sucesso ou se houve erro (com a descrição do motivo). Se a planilha tem mais de uma aba, o resultado mostra também o nome da aba.
- Quando o job termina, um e-mail é enviado para o usuário que criou.
- Você pode acompanhar o andamento a qualquer momento abrindo a linha do job e clicando em Atualizar Dados dentro da visualização — o resultado vai aparecendo conforme as linhas são processadas.
Esse fluxo evita travar a interface durante importações grandes e permite continuar usando o sistema enquanto o job roda.
Quais tipos de ação posso disparar?
A lista de tipos disponíveis vem do catálogo de TypeJob do sistema, e cobre as principais entidades. Resumo por área (a lista completa aparece no campo Tipo ação do modal de importação):
| Área | Exemplos de ação |
|---|---|
| Produtos | Criar SKU, atualizar especificações, criar/atualizar/excluir preço, adicionar/excluir código de barras adicional, criar/excluir variação, criar/atualizar/excluir códigos de barras de embalagem, atualizar atributos, atualizar departamento e regras fiscais, remover/adicionar imagens, adicionar tags, criar variação de grade, kit criar/atualizar/excluir. |
| Fornecedores | Criar Fornecedores, código fornecedor SKU adicionar/editar/excluir. |
| Pedidos e financeiro | Criar pedido, criar pedido de compra, criar Contas a pagar, criar Contas a receber, adicionar pagamento contas receber, criar nota serviço. |
| Clientes | Criar cliente, cliente × vendedor vincular/desvincular. |
| Logística | Criar endereço, criar ressuprimento, transferência sku endereço, criar romaneio com pedidos, criar cesto Picking, adicionar itens inventário. |
| Anúncios (Hub) | Atualizar vínculo anúncio, atualizar anúncio, atualizar variação do anúncio, importação de anúncios direto do canal. |
| Fretes / transportadora | Criar/atualizar tabela frete, tabela frete Correios, frete padrão Intelipost, importar faturamento transportadora. |
| Categoria similar | Adicionar e excluir. |
| Conciliação financeira | Importar extrato OFX, importar conciliação adquirente, importar extrato marketplace. |
Cada tipo tem o seu próprio formato de planilha — use sempre o modelo baixado pela própria tela para evitar problemas de cabeçalho ou colunas.
Como disparar uma ação em massa (importar planilha)?
- Acesse Configurações → Ação em massa.
- Clique em Importar Arquivo no canto superior direito. Um modal abre.
- Se a empresa tem mais de uma conta cadastrada, selecione a Conta no canto esquerdo.
- Em Tipo ação, escolha o que você quer fazer (ex.: Criar Contas a pagar, Criar sku/produto, Importar extrato OFX). A lista mostra todos os tipos disponíveis para a conta.
- Clique em Baixar Modelo para gerar a planilha modelo daquele tipo (ver pergunta seguinte). Preencha os dados e salve.
- Clique em Importar Planilha e selecione o arquivo
.xlsxou.xls(máximo 5 MB). - Quando o upload terminar, clique em Processar Importação.
- Uma mensagem confirma o envio e mostra o código do job — você pode usar esse código para localizar o job na listagem depois.
A partir desse momento, o job entra em processamento e você pode fechar o modal. Acompanhe pelo Visualizar na linha do job ou aguarde o e-mail.
Pré-requisito: privilégio Visualizar Ação em Massa (para acessar a tela). Algumas ações específicas exigem privilégios adicionais relacionados à tela de destino (ex.: criar contas a pagar exige Criar contas a pagar).
Como baixar o modelo da planilha?
Dentro do modal de importação, após escolher o Tipo ação, clique em Baixar Modelo. Duas coisas podem acontecer:
- Modelo público — para alguns tipos (ex.: Criar/atualizar tabela frete, Frete padrão Intelipost, Importar faturamento transportadora), o modelo é um arquivo público fixo. Ele é aberto em uma nova aba para download direto.
- Modelo via Relatórios — para tipos mais elaborados (ex.: Atualizar especificações produto, Criar Fornecedores, Atualizar anúncio), o modelo é gerado a partir de um relatório personalizado com os filtros que você quiser. Uma janela de confirmação avisa: "Relatório modelo indisponível, você será redirecionado para gerar o relatório com os filtros que desejar." Confirme para abrir a tela de Relatórios já com o modelo selecionado — gere o relatório, baixe, edite a planilha e volte para importar.
Use sempre o modelo gerado pela tela: ele já vem com os cabeçalhos e o formato esperados pela importação.
Quais ações exigem informações adicionais (banco, integração, fornecedor)?
Algumas ações precisam de um identificador extra além da planilha:
| Tipo de ação | O que pedir |
|---|---|
| Importar extrato OFX | Conta bancária — a importação grava as movimentações nessa conta. |
| Importar conciliação adquirente | Integração de adquirente — define para qual adquirente a conciliação será importada. |
| Criar/atualizar tabela frete e variações (Correios, Intelipost) | Fornecedor/transportadora — define para qual transportadora a tabela é cadastrada. |
Na maioria das vezes esses parâmetros já vêm preenchidos automaticamente quando você dispara o job a partir da tela de destino (ex.: importar OFX direto da tela de Extrato Bancário já fixa a conta bancária). Se você dispara da tela genérica de Ação em massa, garanta que as informações estejam corretas — sem elas, a importação aborta com uma mensagem informando que o campo obrigatório (conta bancária ou integração) está faltando.
Quais cadastros preciso ter antes?
Depende do tipo de ação que você vai importar. A regra geral é: tudo que a planilha referencia precisa existir antes. Exemplos comuns:
- Criar Contas a pagar — fornecedor (ou cliente), tipo documento, plano de contas e tipo pagamento precisam estar cadastrados.
- Criar pedido — cliente, vendedor (se houver), tipo pedido, plano de contas e SKUs precisam existir.
- Criar sku/produto — marca, departamento fiscal, unidade de medida e categorias precisam estar cadastrados.
- Importar tabela frete — a transportadora (fornecedor com tipo Transportadora) precisa estar cadastrada.
- Importar extrato OFX — a conta bancária de destino precisa estar cadastrada.
Linhas com referência a algo não cadastrado aparecem com Status = Erro e descrição indicando o que está faltando.
Como filtrar e localizar um job?
A listagem de Configurações → Ação em massa já carrega todos os jobs da conta, do mais recente para o mais antigo. Para encontrar um job específico:
- Filtros nas colunas (cabeçalho da tabela) — cada coluna (Data cadastro, Data início, Data fim, Código, Tipo ação, Usuário, Conta) tem busca textual ou por data. Clique no ícone de filtro na coluna e informe o valor.
- Filtro Conta (botão Filtros) — disponível apenas quando a empresa tem mais de uma conta cadastrada; restringe os jobs à conta selecionada.
Para acompanhar uma importação que acabou de ser disparada, anote o código mostrado na mensagem após o envio e procure por ele na coluna Código.
Como ver o resultado de um job?
Na linha do job, clique no ícone Visualizar (lupa). Abre uma tela com:
- Cabeçalho — Código, Data criação, Data início, Data fim, Nome do tipo de ação, Usuário que disparou.
- Resultado — uma tabela com cada linha processada, mostrando Sheet (aba da planilha — quando há mais de uma), Linha (número da linha na planilha), Status (Sucesso/Erro), Descrição do resultado, ID e Nome do recurso afetado (ex.: id da conta a pagar criada, código do SKU).
- Botões no topo da tabela:
- Atualizar Dados — recarrega o resultado (útil para acompanhar jobs em andamento).
- Exportar Resultado — gera um Excel com o conteúdo atual da tabela.
- Baixar Planilha — abre o arquivo original que você enviou (link válido por 2 dias).
Para jobs com muitas linhas, o sistema carrega 5000 por vez — use Carregar Mais Resultados no rodapé para puxar mais.
Como baixar a planilha original que foi enviada?
Abra o job em Visualizar e clique em Baixar Planilha no topo da seção Resultado. O arquivo abre em nova aba através de uma URL pré-assinada do nosso armazenamento, válida por 2 dias a partir do momento em que você abre a visualização (o link é renovado a cada vez que você reabre a tela).
Se o botão não aparece, o job foi criado sem upload (por exemplo, ações como Recalcular custo que partem da própria tela sem planilha) — não há arquivo associado.
Como exportar o resultado para uma nova planilha?
Dentro da visualização do job, clique em Exportar Resultado (ícone de download na seção Resultado). O idworks gera um Excel com o conteúdo atual da tabela — incluindo apenas as linhas já carregadas. Para exportar tudo de um job grande, clique em Carregar Mais Resultados até carregar todas as linhas antes de exportar.
O Excel é útil para distribuir o resultado por outras pessoas, anotar correções para uma nova importação ou consolidar erros de várias importações.
O que significa cada status no resultado (Sucesso, Erro)?
| Status | Significado |
|---|---|
| Sucesso | A linha da planilha foi processada e o recurso correspondente foi criado/atualizado/excluído. Quando aplicável, ID e Nome mostram o que foi gerado (ex.: id da conta a pagar criada). |
| Erro | A linha não foi processada. A Descrição mostra o motivo — campo obrigatório faltando, valor inválido, referência a algo não cadastrado (fornecedor, SKU, plano de contas), regra de negócio violada, etc. Linhas com erro são ignoradas — não bloqueiam as outras. |
Uma importação pode ter mistura dos dois — o sistema não desfaz as linhas que deram sucesso por causa de linhas com erro. Corrija os erros na planilha e reenvie apenas as linhas com erro para fazer uma nova rodada.
O que acontece se eu reenviar a mesma planilha enquanto a anterior está processando?
O idworks tem proteção anti-duplicação baseada no conteúdo do arquivo:
- Se você enviar exatamente a mesma planilha (mesmos bytes) enquanto o job anterior ainda está processando, o sistema reaproveita o job anterior e devolve o mesmo código — sem criar um novo nem reprocessar.
- Se a planilha mudou (qualquer byte diferente), um novo job é criado normalmente.
- Se o job anterior já terminou, um novo job é criado e a planilha é reprocessada do zero — inclusive linhas que já tinham dado sucesso (cuidado para não duplicar registros: por exemplo, ao reimportar uma planilha de Criar Contas a pagar sem alterar, ela vai criar contas a pagar duplicadas).
Boa prática: ao reenviar para corrigir erros, filtre a planilha para deixar apenas as linhas que deram erro. Assim você evita duplicação e o reprocessamento fica mais rápido.
Quais limites tenho ao importar (tamanho, formato)?
- Formato: apenas
.xlsxou.xls. Outros tipos (CSV, ODS, PDF) são rejeitados. - Tamanho: até 5 MB por arquivo. Arquivos maiores são bloqueados na tela com o aviso "O arquivo excede o tamanho máximo permitido de 5MB". Para volumes grandes, divida em arquivos menores e dispare múltiplos jobs.
- Número de linhas: não há limite fixo no banco, mas a tela de visualização paginar de 5000 em 5000 — jobs muito grandes ficam pesados de auditar. Recomenda-se quebrar grandes volumes em vários arquivos para facilitar a leitura do resultado.
Por quanto tempo o arquivo original fica disponível para download?
O link de Baixar Planilha é uma URL pré-assinada do nosso armazenamento (S3), válida por 2 dias a partir do momento em que você abre a tela de visualização do job. A cada vez que você reabre a visualização, a URL é renovada — então, na prática, o arquivo continua acessível por 2 dias após o último acesso.
O arquivo em si permanece armazenado por mais tempo no nosso ambiente — se você precisar baixar uma planilha antiga e o link estiver expirado, basta abrir a visualização do job novamente para gerar uma URL nova.
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 Ação em Massa | Acesso à tela e à listagem de jobs, à visualização do resultado, ao download da planilha original e à exportação do resultado. Também necessário para usar o botão Importar Arquivo desta tela e os botões de importação distribuídos em outras telas (Cadastro de Produtos, Contas a Pagar, etc.). |
A criação efetiva dos registros (SKUs, contas a pagar, etc.) ainda precisa dos privilégios da tela de destino — por exemplo, Criar contas a pagar para que linhas do tipo Criar Contas a pagar sejam processadas com sucesso. Sem o privilégio de destino, as linhas vão com Status Erro.