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 uma ação em massa, que é processada pelo sistema em segundo plano e devolve um relatório linha-a-linha de sucesso e erro.
A tela apresenta a lista das ações em massa criadas 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 mostra o resultado completo: cabeçalho com datas e usuário; lista de cada linha processada com Linha, Status (Sucesso/Erro) e Comentários; 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. — todas despejam ações em massa 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 uma ação em massa?
- Como ver o resultado de uma ação em massa?
- 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?
Boas práticas
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 toda ação em massa criada por qualquer usuário da conta — vinda da tela de Ação em massa diretamente ou disparada 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 a ação em massa com status pendente.
- A ação entra em fila e é processada em segundo plano — pode levar de segundos a vários minutos, dependendo do tamanho e do tipo.
- 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). Em alguns tipos de importação (por exemplo, atualização de atributos de anúncio), o resultado mostra também a coluna Aba com o nome da aba da planilha.
- Quando a ação termina, um e-mail é enviado para o usuário que disparou.
- Você pode acompanhar o andamento a qualquer momento abrindo a linha 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 a ação roda.
Quais tipos de ação posso disparar?
A lista completa, agrupada por área. 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.
Algumas ações só ficam disponíveis a partir da tela de origem (ex.: Importar extrato OFX só dispara pela tela de Extrato Bancário, Importar conciliação adquirente só pela tela de Conciliação Adquirente). Essas estão marcadas com ▸ tela específica na tabela; as demais aparecem no seletor Tipo ação do modal genérico de Ação em massa.
Produtos / SKU
| Ação | O que faz |
|---|---|
| Criar sku/produto | Cadastra novos produtos e SKUs em lote, com identificação (nome, código de referência), código de barras, categoria, marca, departamento fiscal, medidas, unidade. |
| Atualizar especificações produto | Atualiza atributos descritivos do produto (especificações técnicas, características). |
| Item (sku, kit, produto) editar | Atualiza campos do cadastro de itens já existentes. |
| Atualizar departamento e regras fiscais | Troca em lote o departamento fiscal e as regras fiscais aplicadas aos SKUs. |
| Vincular SKU/KIT ao produto pai | Associa SKUs e KITs ao produto-pai (estrutura de variação). |
| Cadastrar variação de grade | Cria as variações de grade (tamanho, cor) para os produtos. |
| Criar variação de grade | Outra ação relacionada à criação de variações de grade (campos específicos da grade). |
| Preço adicionar | Cadastra preços de venda para SKUs em uma ou mais políticas comerciais. |
| Preço editar | Altera preços já cadastrados. |
| Preço excluir | Remove preços cadastrados em lote. |
| Adicionar código de barras embalagem | Cadastra códigos de barras adicionais por unidade de embalagem (caixa, fardo, etc.). |
| Adicionar tags do produto | Aplica tags em lote a produtos para filtros e classificação. |
| Adicionar Imagens itens | Vincula imagens a SKUs/produtos a partir de URLs ou referências. |
| Remover Imagens itens | Remove imagens já vinculadas. |
| Categoria similar adicionar | Vincula SKUs a uma categoria similar (códigos equivalentes entre fornecedores). |
| Categoria similar excluir | Remove o vínculo de categoria similar. |
| Kit criar ▸ tela específica | Cria estruturas de KIT (item composto) em lote, a partir da tela Cadastro de Produtos. |
| Kit atualizar ▸ tela específica | Atualiza KITs existentes. |
| Kit deletar ▸ tela específica | Remove KITs em lote. |
| Atualizar Composição de Kit | Atualiza os itens componentes (filhos) de KITs existentes. |
Fornecedores
| Ação | O que faz |
|---|---|
| Criar Fornecedores | Cadastra novos fornecedores em lote, com identificação (nome, CPF/CNPJ), contatos, endereço, categoria. |
| Código fornecedor SKU adicionar | Vincula o código do fornecedor a SKUs (cada fornecedor pode ter seu próprio código para o mesmo SKU). |
| Código fornecedor SKU editar | Edita os códigos já vinculados. |
| Código fornecedor SKU excluir | Remove o vínculo do código do fornecedor. |
Clientes
| Ação | O que faz |
|---|---|
| Criar cliente | Cadastra novos clientes em lote (identificação, endereços, contatos). |
| Cliente X vendedor - vincular | Associa clientes a vendedores (carteira de clientes). |
| Cliente X vendedor - remover vinculo | Remove a associação cliente × vendedor. |
Pedidos e Compras
| Ação | O que faz |
|---|---|
| Criar pedido | Cadastra pedidos de venda em lote (cabeçalho, itens, pagamentos). |
| Criar pedido de compra | Cadastra pedidos de compra (cabeçalho, itens). |
Financeiro
| Ação | O que faz |
|---|---|
| Criar Contas a pagar | Cadastra títulos a pagar (fornecedor, valor, vencimentos, plano de contas, tipo de documento). |
| Criar Contas a receber | Cadastra títulos a receber (cliente, valor, vencimentos, plano de contas). |
| Adicionar pagamento contas receber | Lança baixas de pagamento em títulos a receber existentes. |
| Criar nota serviço | Cadastra notas de serviço (NFS-e) em lote. |
| Importar extrato OFX ▸ tela específica | Importa arquivo OFX de extrato bancário direto na conta bancária de destino. Dispara pela tela de Extrato Bancário. |
| Importar conciliação adquirente ▸ tela específica | Importa extrato de adquirente (TEF) para conciliação. Dispara pela tela de Conciliação Adquirente. |
| Importar extrato Marketplace ▸ tela específica | Importa extrato financeiro do marketplace para conciliação. Dispara pela tela de Conciliação marketplace. |
Logística / Armazenagem
| Ação | O que faz |
|---|---|
| Criar endereço | Cadastra posições de endereço (rua, prateleira, nível) no CD. |
| Criar ressuprimento | Gera ordens de ressuprimento (movimentação de SKUs entre endereços). |
| Transferência sku endereço | Movimenta saldo de SKUs entre endereços do mesmo CD. |
| Adicionar itens inventário | Adiciona itens a um inventário em andamento. |
| Criar romaneio com pedidos | Cria romaneios já carregando os pedidos listados na planilha. |
| Criar cesto Picking | Cria cestos de picking com os pedidos/itens listados. |
Frete / Transportadora
| Ação | O que faz |
|---|---|
| Importar faturamento transportadora | Importa a planilha de faturamento do transportador para conciliar com os fretes pagos. |
| Criar/atualizar tabela frete ▸ tela específica | Cadastra ou atualiza tabelas de frete da transportadora. Dispara pela tela de Transportadoras / Hub Transportadora. |
| Criar/atualizar tabela frete correios ▸ tela específica | Versão específica para tabelas dos Correios. |
| Criar/atualizar frete padrão intelipost ▸ tela específica | Atualiza tabelas de frete via Intelipost. |
Anúncios (Hub)
| Ação | O que faz |
|---|---|
| Atualizar vínculo anúncio | Vincula ou desvincula SKUs aos anúncios dos canais. |
| Atualizar anúncio | Atualiza campos do anúncio (título, preço, estoque, descrição). |
| Atualizar variação do anúncio | Atualiza variações do anúncio (tamanho, cor) — preço, estoque, código. |
| Atualizar atributos do anúncio | Atualiza atributos/specs do anúncio exigidos pelo canal (cor, gênero, faixa etária, etc.). |
| Importação de anúncios direto canal ▸ tela específica | Puxa os anúncios já publicados no canal para dentro do idworks. Dispara pela tela de Hub Anúncios. |
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 da ação — você pode usar esse código para localizar a ação em massa na listagem depois (coluna Código).
A partir desse momento, a ação entra em processamento e você pode fechar o modal. Acompanhe pelo Visualizar na linha da ação 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 a ação 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 uma ação em massa?
A listagem de Configurações → Ação em massa já carrega todas as ações da conta, da mais recente para a mais antiga. Para encontrar uma ação específica:
- 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 as ações em massa à 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 uma ação em massa?
Na linha da ação em massa, 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 Linha (número da linha na planilha), Status (Sucesso/Erro), Comentários (detalhe do resultado — inclusive o que foi criado/atualizado ou o motivo do erro) e Código (identificador da linha de resultado). Em alguns tipos de importação aparece também a coluna Aba (nome da aba da planilha).
- Botões no topo da tabela:
- Atualizar Dados — recarrega o resultado (útil para acompanhar ações 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 ações 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 a ação em massa em Visualizar e clique em Baixar Planilha no topo da seção Resultado. O arquivo abre em nova aba através de um link temporário, válido 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, a ação foi criada 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 da ação, 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 uma ação 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. O detalhe do que foi gerado aparece na coluna Comentários. |
| 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 a ação anterior ainda está processando, o sistema reaproveita a ação anterior e devolve o mesmo código — sem criar uma nova nem reprocessar.
- Se a planilha mudou (qualquer byte diferente), uma nova ação em massa é criada normalmente.
- Se a ação anterior já terminou, uma nova é criada 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últiplas ações em massa.
- Número de linhas: não há limite fixo no banco, mas a tela de visualização paginar de 5000 em 5000 — ações em massa muito grandes ficam pesadas 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 é um link temporário, válido por 2 dias a partir do momento em que você abre a tela de visualização da ação em massa. A cada vez que você reabre a visualização, o link é renovado — 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 da ação em massa novamente para gerar um link novo.
Boas práticas para importações em massa
Algumas práticas evitam duplicação de registros, importações que travam e relatórios difíceis de ler:
- Baixe sempre o modelo pela própria tela. Cada tipo de ação tem o seu formato de planilha — usar o modelo que a tela gera garante os cabeçalhos e colunas certos. Planilha de outra fonte (ou de uma versão antiga) costuma falhar no cabeçalho.
- Garanta antes tudo que a planilha referencia. Fornecedor, cliente, SKU, plano de contas, conta bancária, transportadora — o que a planilha aponta precisa já existir no sistema. Linhas que apontam para algo não cadastrado voltam com Erro.
- Ao corrigir erros, reenvie só as linhas com erro. O sistema não desfaz as linhas que deram certo. Se você reenviar a planilha inteira depois que a ação terminou, as linhas de sucesso são reprocessadas e podem criar registros duplicados (ex.: contas a pagar repetidas). Filtre a planilha para deixar apenas o que deu erro.
- Aproveite a proteção anti-duplicação enquanto processa. Reenviar exatamente a mesma planilha enquanto a anterior ainda está processando reaproveita a ação e devolve o mesmo código — sem duplicar. Mas isso só vale enquanto a primeira não terminou; depois de concluída, um novo envio reprocessa do zero.
- Quebre volumes grandes em arquivos menores. O limite é 5 MB por arquivo e a visualização do resultado carrega de 5000 linhas por vez. Arquivos menores processam mais rápido e ficam bem mais fáceis de auditar linha a linha.
- Confira os parâmetros extras quando disparar pela tela genérica. Ações como importar extrato OFX (conta bancária), conciliação de adquirente (integração) ou tabela de frete (transportadora) precisam de um identificador além da planilha. Disparando pela tela de destino esses campos já vêm preenchidos; pela tela genérica, confirme antes de enviar — sem eles a importação aborta.
- Acompanhe pelo código da ação. Anote o código mostrado na mensagem após o envio e procure por ele na coluna Código para acompanhar o andamento — ou aguarde o e-mail que chega quando a ação termina.
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 ações em massa, à 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.