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
- Acesse
/dashboard/producao/cadastros-massa.
- Selecione a entidade que deseja importar (ex.: Produtos, Máquinas).
- Clique em Baixar template para obter o arquivo XLSX com as colunas corretas.
- Preencha o template com os dados (não altere os cabeçalhos).
- Clique em Enviar arquivo e selecione o XLSX preenchido.
- 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.