Documentação em desenvolvimentoBeta Aberto clique aqui para participar
docs.cloudmes.ai
CloudMES Docs

Cadastros em massa

Importação em lote via planilha XLSX para entidades de produção (produtos, máquinas, operações, etc.).

Objetivo

Agilizar implantações sem preencher modal a modal. Cada entidade usa um template com colunas alinhadas ao cadastro individual correspondente.

Como usar

  1. Acesse Produção > Cadastros > Cadastros em massa (acessar diretamente).
  2. Escolha a entidade (ex.: Produtos, Máquinas, Operações).
  3. Baixar template — não altere cabeçalhos das colunas.
  4. Preencha o XLSX (campos obrigatórios iguais aos modais de cadastro; FKs devem existir — ex.: código de produto, id de máquina conforme template).
  5. Enviar arquivo e acompanhe o resultado linha a linha.

Tela de importação em massa

Colunas e cadastros relacionados

Entidade (exemplo)Cadastro manual equivalenteObservação
ProdutosProdutosSKU único, unidade, etc.
MáquinasMáquinasClasse e códigos devem existir
OperaçõesOperaçõesProduto e máquinas permitidas pré-cadastrados
OrdensOrdensOperações referenciadas no JSON/colunas do template

A tela exibe erros por linha (campo obrigatório, FK inexistente, duplicidade).

Dados e integrações

  • Um endpoint por entidade (ex.: POST /products/ em lote via serviço de importação).
  • Processamento linha a linha — não é transação única.

Erros comuns

  • Cabeçalho alterado: use o template baixado na mesma versão da tela.
  • Erros parciais: linhas válidas são gravadas; corrija só as com erro e reimporte se necessário.
  • FK não encontrada: cadastre antes em Produtos, Máquinas, etc.

Perguntas frequentes

Qual entidade importar primeiro?
Produtos e armazéns antes de operações/ordens que referenciam códigos.

Substitui cadastro manual?
Complementa — use para carga inicial; ajustes finos nas telas de cadastro.

Relacionado