Catálogo de Produtos/Serviços

Catálogo de produtos/serviços em Mewayz

O Add-On Produto/Serviço é o catálogo de inventário compartilhado usado por contabilidade, CRM, POS, EcomStore e Bookings.

Mewayz-módulo original — não Mewayz a montante. Documentação de autoria da fonte do pacote em packages/mewayz/ProductService/.

URL de demonstração

Introdução

O complemento de produto/serviço é o única fonte de verdade para cada item vendável na plataforma Mewayz. Em vez de cada módulo (Vendas, PDV, EcomStore, Reservas) manter sua própria lista de produtos, todos eles leem e gravam em um catálogo compartilhado. Isto significa que quando um operador cria um novo produto em Produto/Serviço, esse produto fica imediatamente utilizável em todas as superfícies de venda, com contagens de stock e regras fiscais sincronizadas.

O módulo cobre bens físicos com rastreamento de estoque, serviços não estocáveis com preços por hora ou por sessão, inventário de vários armazéns, categorias hierárquicas, regras fiscais por linha e unidades de medida.

Como habilitar este módulo

Para configurar o complemento de produto/serviço, você pode seguir este link: Complemento de configuração.

O Add-On é bloqueado por PlanModuleCheck:ProductService. A maioria dos planos voltados para vendas o agrupa por padrão – POS, Conta, EcomStore e Reservas dependem de sua ativação.

Itens

Navegar pelos itens

• Navegue até Produto e Serviço → Itens na barra lateral.
• A visualização de lista mostra todos os itens que o operador pode gerenciar, com filtros para Nome, Tipo (produto ou serviço), Categoriae Status Ativo.
• Cada linha exibe SKU, preço de venda, preço de compra, total atual do estoque em armazém e botões de ação rápida (visualizar, editar, excluir).

Crie um novo item

• Clique + Novo item no canto superior direito da lista de itens.
• O formulário possui os seguintes campos:
• Nome — Nome de exibição mostrado em menus suspensos na plataforma
• Tipo — Produto (com estoque rastreado) ou Serviço (sem estoque)
• SKU — Unidade opcional de manutenção de estoque (única por inquilino)
• Categoria — Escolha uma das categorias existentes ou crie uma nova in-line
• Unidade — Unidade de medida (cada, kg, hora, m², etc.)
• Preço de venda — Preço padrão quando este item aparece em uma fatura ou pedido
• Preço de compra — Custo padrão ao receber estoque
• Impostos — Seleção múltipla de taxas de imposto que se aplicam a este item
• Imagem — Imagem do produto usada pela EcomStore + POS
• Descrição — Descrição longa; usado pelas páginas de detalhes da EcomStore
• Clique Salvar para criar o item. Um evento (CreateProductServiceItem) é despachado para que ouvintes em outros módulos possam reagir (por exemplo, reindexação do índice de pesquisa).

Editar/excluir um item

• Na lista de itens, clique no botão de edição da linha para abrir o mesmo formulário preenchido com os dados do item.
• Excluindo despachos de um item DestroyProductServiceItem. Se o item for referenciado por uma fatura, pedido ou venda de PDV existente, a linha subjacente será excluído de forma reversível portanto, os registros históricos mantêm seus dados intactos.

Gestão de estoque

• Navegue até Produto e Serviço → Estoque na barra lateral.
• A visualização de estoque agrupa itens por armazém portanto, um operador com vários locais físicos pode ver as quantidades exatas em cada local.
• Cada linha mostra item, armazém, quantidade atual e data do último movimento.

Adicionar ou ajustar estoque

• Clique Adicionar estoque para registrar um movimento de estoque.
• Selecione o Artigo, o Armazém, o Quantidade (positivo para entrada, negativo para ajuste externo) e um Nota.
• Cada movimento é registrado; o catálogo nunca apenas “atualiza um número” – cada alteração é auditável.

Categorias

• Navegue até Produto e serviço → Categorias.
• As categorias são planas ou hierárquicas (pai → filho). Cada categoria pode ter um etiqueta de cor isso é refletido na lista de itens e nas páginas de listagem da EcomStore.
• As operações de criação/edição/exclusão seguem o padrão CRUD padrão.

Impostos

• Navegue até Produto e Serviço → Impostos.
• Adicione as taxas de imposto que o negócio da operadora precisa (por exemplo, IVA de 15%, imposto sobre vendas de 7,25%, etc.).
• Cada imposto tem um nome, taxa (porcentagem) e um opcional descrição.
• Os impostos são então anexados aos itens por meio da seleção múltipla no formulário do item.

Unidades

• Navegue até Produto e Serviço → Unidades.
• Unidades são os rótulos mostrados na linha do carrinho/fatura — “cada”, “kg”, “hora”, “sessão”, “m²”, etc.
• Mewayz envia um conjunto inicial; adicione ou renomeie para corresponder ao vocabulário do setor da operadora.

Comportamento entre módulos

Outros módulos Mewayz consumir o catálogo de Produtos/Serviços:

• Conta módulo — Faturas de vendas e faturas de compra selecionam itens de linha deste catálogo.
• CRM/Vendas — Itens de linha de negócio e itens de referência de propostas.
• PDV módulo - vendas no PDV extraem a lista de produtos diretamente.
• EcoStore module — Os produtos Storefront são renderizados a partir deste catálogo com navegação baseada em categoria.
• Reservas módulo — Catálogo de serviços para serviços reserváveis.
• Gerador de ApiDocs module — Documenta os endpoints públicos da API para acesso programático (/api/products, etc.).

Permissões

O pacote define permissões granulares:

• manage-product-service-item — Gestão completa
• create-product-service-item - Crie novos itens
• manage-any-product-service-item — Edite qualquer item de inquilino
• manage-own-product-service-item — Edite apenas itens criados por você

Atribua-os por meio de Configurações → Funções e permissões.

Acesso à API

O pacote também expõe GET /api/product-service/items como um endpoint interno autenticado que outros módulos e o API Docs Generator surgem como GET /api/products.

Notas do Operador

• Os movimentos de ações são imutáveis — para "reverter" um movimento, registre um novo movimento na direção oposta em vez de editar a linha original.
• Ao excluir itens que possuem estoque em mãos, o sistema avisa antes de permitir a ação.
• As imagens dos itens são armazenadas em storage/app/public/product-service/ e servido através do storage link simbólico. Após o upload de uma nova imagem, ela é normalizada para um único nome de arquivo no banco de dados; o URL público é calculado no momento da renderização.