Máquinas

Cadastro e manutenção de máquinas produtivas: identificação, metas de desempenho, paradas, velocidade, manutenção e vínculos com logística e hierarquia.

Objetivo

Registrar as máquinas usadas no Cockpit, no sequenciamento e nos reportes, com metas para indicadores (OEE, disponibilidade, qualidade, MTBF/MTTR) e, quando aplicável, endereço WMS padrão e linha produtiva.

Como usar

Acesse Produção > Cadastros > Máquinas (acessar diretamente).
Use a busca e o filtro Mostrar deletados para localizar registros.
Clique em Nova máquina (ou no ícone de lápis em uma linha) para abrir o modal.
Preencha as abas do modal e clique em Salvar.
Máquinas inativas não aparecem como opção no Cockpit até serem reativadas.

Lista de máquinas

Campos por aba

Na coluna Obrigatório, * indica campo com asterisco na interface. Campos de outras telas indicam onde cadastrar o valor antes de vincular.

Identificação

Aba Identificação

Campo	Obrigatório	Descrição
Código	Sim *	Identificador único da máquina no ambiente.
Apelido	Não	Nome curto exibido em listas e no Cockpit.
Nome	Sim *	Nome completo da máquina.
Descrição	Não	Texto livre; opcional.
Classe da máquina	Sim *	Lista de `GET /machine-classes/`. Se vazio, cadastre classes no backend antes de criar máquinas.
Código ERP	Não	Referência opcional ao ERP.
Endereço padrão (logística)	Não	Combobox de endereços WMS do tipo produção. Cadastre em Logística > Cadastros > Endereços.
Linha produtiva	Condicional (ativo)	Com Hierarquia produtiva ligada nas Preferências de produção, selecione a linha cadastrada em Hierarquia. A lista mostra código/nome da linha; máquinas sem linha não entram em filtros de relatório por linha.

Campo Linha produtiva (hierarquia ativa)

| Ativo | Sim * | Máquina ativa ou inativa (flgenable). |

Metas OEE e qualidade

Aba Metas OEE e qualidade

Metas em percentual usadas no cálculo de indicadores e comparações no Cockpit / relatórios. Todas opcionais; deixe em branco se não houver alvo definido.

Campo	Descrição
Meta de eficiência (%)	Eficiência geral alvo.
Meta OEE (%)	Overall Equipment Effectiveness.
Meta OE (%) / Meta AE (%)	Eficiência operacional e de ativos.
Meta de disponibilidade (%)	Disponibilidade alvo.
Meta de utilização (%) / Meta de performance (%)	Utilização e performance.
Meta de qualidade (%) / Meta FTT (%)	Qualidade e first time through.
Meta de retrabalho (%) / Meta de tempo de retrabalho (%)	Retrabalho.
Meta de sucata (%) / Meta de falhas (%)	Sucata e falhas.

Paradas e programação

Aba Paradas e programação

Campo	Descrição
Meta de tempo de parada (%)	Alvo de tempo em parada programada.
Meta fora de programação (%)	Tempo fora do cronograma de turnos.
Meta DTM (%)	Downtime management.

Velocidade e contagem

Aba Velocidade e contagem

Campo	Descrição
Contabilizar durante parada	Se marcado, a contagem de produção continua durante eventos de parada (padrão: não).

Manutenção (MTBF/MTTR)

Aba Manutenção

Campo	Descrição
MTTR (min) / MTBF (min)	Tempos médios reais (somente leitura ou informados conforme integração).
Meta MTBF (%) / Meta MTTR (%) / Meta MTTA (%)	Metas percentuais de manutenção.

Rodapé do modal (somente leitura)

Campo	Descrição
ID máquina	`idmachine` interno.
Criado em / Última atualização	Auditoria de datas.

Dados e integrações

GET/POST/PATCH/DELETE — /machine-registry/
GET — /machine-classes/
GET — /wms/locations/ (endereços para combobox)
GET — /production-preferences/ (flag de hierarquia)
Endpoints de hierarquia — plantas, áreas, linhas

Erros comuns

Classe obrigatória: selecione uma classe antes de salvar.
Máquina inativa no Cockpit: confira Ativo e se a máquina não foi excluída logicamente.
Linha produtiva ausente: ative a hierarquia em Preferências de produção e cadastre linhas em Hierarquia.
Endereço WMS não listado: cadastre endereço do tipo produção em Endereços.
Parâmetros numéricos inválidos: metas aceitam apenas números; não use texto ou símbolos extras.

Perguntas frequentes

Qual aba devo preencher primeiro?
Identificação (código, nome, classe, ativo). Depois Velocidade e Metas se usar OEE; Paradas para tipos de parada permitidos.

Máquina não aparece no Cockpit?
Ativa, não excluída, operação com máquina em Máquinas permitidas e item em Sequenciamento para a fila.

Relatório por linha não mostra minha máquina?
Preencha Linha produtiva e salve; confira se a linha corresponde ao filtro planta/área/linha do relatório.

Relacionado

Hierarquia · Operações · Sequenciamento · Cockpit · Endereços