CloudMES Docs
CloudMES Docs

Cadastros em massa

Importação de grandes volumes de dados via planilha template para qualquer entidade suportada.

Rota

/dashboard/producao/cadastros-massa

Objetivo

Agilizar implantações e atualizações em lote, permitindo criar ou atualizar registros (produtos, máquinas, operações, etc.) a partir de um arquivo XLSX sem precisar preencher formulários individuais.

Pré-requisitos

  • Template correto para a entidade escolhida
  • Dados validados conforme regras de cada campo obrigatório

Como usar

  1. Acesse /dashboard/producao/cadastros-massa.
  2. Selecione a entidade que deseja importar (ex.: Produtos, Máquinas).
  3. Clique em Baixar template para obter o arquivo XLSX com as colunas corretas.
  4. Preencha o template com os dados (não altere os cabeçalhos).
  5. Clique em Enviar arquivo e selecione o XLSX preenchido.
  6. Acompanhe o resultado linha a linha: cada registro exibe status de sucesso ou erro com descrição.

Dados e integrações

  • Cada entidade usa seu próprio endpoint (ex.: POST /products/ para produtos).
  • A importação é processada linha a linha — registros com erro são ignorados, os demais são criados.

Erros comuns

  • Coluna fora do template: não renomeie nem remova colunas do arquivo template.
  • Erros parciais: a importação não é transacional — parte dos registros pode ser criada mesmo com erros em outros.
  • Performance em arquivos grandes: arquivos com centenas de linhas podem demorar; acompanhe o progresso na tela.
  • Campos obrigatórios vazios: registros sem campos obrigatórios são rejeitados com mensagem de erro.

Print

Ainda não há screenshot versionado. Salve em public/images/cloudmes/telas/cadastros-massa.png e substitua este bloco pela imagem.