Cadastro e manutenção de produtos, incluindo estrutura de lista de materiais (BOM).
Rota
/dashboard/produtos
Objetivo
Manter o catálogo de itens produzidos ou consumidos. Os produtos são referenciados em operações, ordens, estoque WMS e etiquetas.
Pré-requisitos
- Convenção de código de produto definida (SKU, unidade de medida)
Como usar
- Acesse
/dashboard/produtos.
- Use a busca para localizar produtos existentes.
- Clique em + para criar um novo produto.
- Preencha as abas do modal:
- Campos: código, descrição, unidade e atributos dinâmicos
- BOM: lista de materiais com componentes e quantidades (disponível após salvar o produto pela primeira vez)
- JSON: edição avançada direta do payload (para usuários técnicos)
- Para adicionar imagem, clique na área de upload (convertida para base64).
- Salve.
Dados e integrações
GET/POST/PATCH/DELETE /products/
GET/PUT /products/{id}/bom/
Erros comuns
- SKU duplicado: cada código deve ser único no ambiente.
- BOM indisponível: a aba BOM só aparece após o produto ter sido salvo ao menos uma vez.
- JSON inválido na aba avançada: um payload malformado bloqueia o salvamento; use a aba de campos se não tiver certeza.
- Imagem muito grande: imagens são convertidas para base64; arquivos grandes podem causar lentidão.
Print
Ainda não há screenshot versionado. Salve em public/images/cloudmes/telas/produtos.png e substitua este bloco pela imagem.