Ver código fonte para 1061 Grupo Produtos

[[Modulo Produtos e Servicos]]

O '''Grupo Produtos''' é a tela usada para cadastrar um conjunto de dados padrão (fiscais, de estoque e de comercialização) que vale para uma família de produtos parecidos, e para organizar os produtos dessa família por variação, como cor e tamanho. Em vez de cadastrar cada variação manualmente no recurso [[65 Produtos e Servicos]], o usuário monta o "molde" no Grupo Produtos, indica qual produto corresponde a cada variação e deixa o sistema criar os que faltam.

== Objetivo ==
Esta tela serve para quem precisa manter famílias de produtos parecidos, por exemplo a mesma peça de roupa em várias cores e tamanhos, sem repetir o preenchimento fiscal, de estoque e comercial em cada variação.

É usada principalmente por:
* '''Analistas de cadastro''', que criam e mantêm os grupos, suas variações e os produtos de cada variação.
* '''Gestores de produto/comercial''', que definem como uma família de itens deve ser tratada fiscal e comercialmente.
* '''Equipe de estoque''', que se beneficia de dados de localização, lote e estoque mínimo/máximo já padronizados.

O recurso apoia a gestão porque:
* Reduz o retrabalho de preencher os mesmos dados em dezenas de produtos parecidos.
* Evita divergência entre produtos que deveriam ter o mesmo tratamento fiscal (mesmo NCM, mesma unidade de medida etc.).
* Mostra, numa única grade, quais variações já têm produto e quais ainda faltam, e cria os produtos que faltam com poucos cliques.

== Onde este recurso é utilizado ==
* '''Cadastro do produto''': cada produto da grade pertence ao grupo e, ao salvar o grupo, passa a ter na aba Características do [[65 Produtos e Servicos]] as características da sua variação (por exemplo, M e AZUL). Com a opção "Atualizar dados dos produtos com as características gerais" marcada, os dados padrão do grupo também são repassados aos produtos.
* '''Integração com a loja virtual''': as características do produto (tamanho, cor) são enviadas como variações do produto na integração com o e-commerce. Por isso, manter as variações corretas no grupo reflete diretamente na loja.
* '''Outros recursos que usam o grupo do produto''': o grupo é usado como agrupamento em [[177 Tabela Precos Base]], [[129 Roteiro Producao]], na necessidade de compras e em relatórios de vendas.

== Pré-requisitos ==
* Permissão de acesso ao recurso '''1061 - Grupo Produtos'''.
* Cadastros de apoio já existentes: Unidade de Medida, Espécie, Sub-Espécie, Fabricante, Localização, Plano de Contas, Plano de Contas Gerencial, NCM, Gênero, entre outros usados nos campos fiscais e de estoque.
* Para montar as variações: tipos de característica cadastrados em [[1656 Tipo Caracteristica Produto]] (ex.: TAMANHO, COR) e as características de cada tipo em '''1104 - Caracteristica Produtos''' (ex.: P, M, PRETO, AZUL).
* Para usar "Importar Características de um Produto": pelo menos um produto cadastrado no [[65 Produtos e Servicos]] que sirva de modelo.

== Fluxo Principal ==
# Acesse o recurso 1061 - Grupo Produtos e pesquise um grupo existente, ou inicie um novo cadastro.
# Informe a '''Descrição''' do grupo.
# Se já existe um produto parecido, pesquise-o no campo '''Importar Características de um Produto''': o grupo recebe os dados desse produto (veja Funcionalidades). Se preferir, preencha manualmente as abas Cadastro, Estoque, Fiscal, Categorias e Ecommerce dentro da aba '''Características'''.
# Na aba '''Produtos''', informe os '''Tipos de Característica''' (ex.: TAMANHO e COR) e, para cada tipo, as '''Características''' (ex.: P e M; PRETO e AZUL).
# Confira a grade '''Produtos (variações)''': ela mostra uma linha para cada combinação (P PRETO, P AZUL, M PRETO, M AZUL) e os produtos do grupo.
# Na coluna '''Produto''', indique o produto já cadastrado de cada variação. Para incluir no grupo um produto que ainda não está nele, use o botão '''Adicionar (+)''' da grade.
# Clique em '''Gerar Produtos''' para o sistema criar um produto para cada variação que ainda está "Sem produto".
# Para tirar um produto do grupo, selecione a linha dele e clique na '''lixeira''' da grade.
# Se necessário, preencha a aba '''Especificações''' (ficha técnica).
# Salve o grupo. É neste momento que os produtos gerados são criados, os produtos desacoplados saem do grupo e cada produto recebe as características da sua variação.

=== Orientação para preenchimento de campos ===
{| class="wikitable"
! Nome do campo !! Objetivo !! Orientação de preenchimento
|-
| Descrição || Nome do grupo de produtos || Campo obrigatório. Use um nome claro, pois ele é a base do nome dos produtos gerados automaticamente.
|-
| Importar Características de um Produto || Copiar para o grupo os dados de um produto já cadastrado || Pesquise e escolha um produto. Os dados do grupo são substituídos pelos do produto (veja Funcionalidades).
|-
| Atualizar dados dos produtos com as características gerais || Repassar os dados padrão do grupo aos produtos ao salvar || Vem desmarcado. Marque apenas quando quiser que uma alteração no grupo (por exemplo, mudança de NCM) seja replicada para os produtos do grupo.
|-
| Código Auxiliar || Código do grupo || É a base do código auxiliar dos produtos gerados (código do grupo + códigos das características).
|-
| Unidade Medida || Unidade padrão dos produtos do grupo || Obrigatório.
|-
| Espécie / Sub-Espécie || Classificação do tipo de produto || Obrigatórios. Ao escolher a Espécie, a lista de Sub-Espécie é filtrada.
|-
| Fabricante || Fabricante padrão dos produtos do grupo || Obrigatório.
|-
| Classificação de Produtos || Classificação comercial cadastrada em '''67 - Classificacao Produtos''' || Só aparece, e é obrigatório, quando a empresa utiliza classificação de produtos nas opções de vendas.
|-
| Plano Conta Gerencial || Conta gerencial dos produtos do grupo, cadastrada em [[164 Plano Contas Gerencial]] || Obrigatório. A pesquisa mostra apenas contas analíticas.
|-
| Plano de Contas || Conta contábil dos produtos do grupo, cadastrada em '''160 - Plano Contas''' || Obrigatório. A pesquisa mostra apenas contas analíticas.
|-
| Est. Mínimo / Est. Máximo || Parâmetros de controle de estoque || Obrigatórios. O máximo não pode ser menor que o mínimo.
|-
| Localização || Local de estoque padrão || Obrigatório.
|-
| Volume || Volume do produto || Calculado automaticamente: Largura x Altura x Comprimento.
|-
| Tipo Item Sped / Gênero / NCM || Classificação fiscal do produto || Tipo Item Sped e Gênero são obrigatórios. Ao escolher o Gênero, a lista de NCM é filtrada. O NCM segue a mesma regra do cadastro de produtos.
|-
| Alíquotas fiscais (ICMS, IPI, PIS, COFINS, ISS, IRRF e outras) || Percentuais de tributação aplicados aos produtos do grupo || Preencha conforme o regime tributário. ICMS e ISS são excludentes: informar um zera e desabilita o outro.
|-
| Categorias || Categorias de venda do grupo || Quando houver categorias, exatamente uma deve estar marcada como Principal.
|-
| Tipos de Característica || Tipos de variação da família (ex.: TAMANHO, COR) || Cada tipo vira uma coluna na grade Produtos (variações), na ordem do Índice. Cada tipo precisa ter ao menos uma característica.
|-
| Características || Valores de cada tipo (ex.: P, M; PRETO, AZUL) || Selecione o tipo na grade da esquerda e adicione as características dele na grade da direita.
|-
| Produto (grade Produtos (variações)) || Produto que corresponde a cada variação || Escolha no combo um produto do grupo que ainda não esteja em outra variação. O combo mostra identificador e nome.
|-
| Cód. Auxiliar (grade Produtos (variações)) || Código auxiliar do produto || Pode ser editado na grade. Não pode repetir o código auxiliar de outro produto.
|-
| Unidade / Status (grade Produtos (variações)) || Unidade e situação do produto || Só para consulta. Status marcado indica produto ativo.
|-
| Situação (grade Produtos (variações)) || Mostra o estado de cada linha || "Vinculado": variação com produto. "Sem produto": variação ainda sem produto. "Sem variação": produto do grupo fora das combinações. "Novo - gravado ao salvar": produto gerado, criado ao salvar. "Desacoplado ao salvar": produto que sai do grupo ao salvar.
|}

== Funcionalidades ==
* '''Importar Características de um Produto''': ao escolher um produto, o grupo recebe:
** os dados das abas Cadastro, Estoque, Fiscal, Categorias e Ecommerce, substituindo o que já estava preenchido;
** as características de variação do produto: o tipo de cada característica entra em Tipos de Característica e a característica entra nesse tipo, sem repetir o que o grupo já tem;
** a ficha técnica do produto, informada em [[831 Informacoes Adicionais Do Produto]], que entra na aba Especificações. Se o grupo já tiver o mesmo modelo de ficha, os valores são substituídos pelos do produto.
: Em um grupo já salvo, o sistema pede confirmação antes de substituir. Nada é gravado até salvar o grupo.
* '''Grade Produtos (variações)''': reúne, na aba Produtos, todas as combinações das características e os produtos do grupo. As primeiras colunas variam conforme os tipos informados: uma coluna por tipo (uma, duas, três ou mais). Sem nenhum tipo informado, a grade mostra só os produtos do grupo, que podem ser incluídos e desacoplados normalmente.
* '''Vínculo do produto à variação''': na coluna Produto de cada variação, o combo lista os produtos do grupo que ainda não estão em nenhuma variação. Um produto só pode estar em uma variação. Ao escolher um produto que estava "Sem variação", a linha própria dele some e a variação passa a "Vinculado". Ao limpar o combo, o produto volta a ter a sua linha "Sem variação" e continua no grupo.
* '''Reconhecimento automático''': ao abrir o grupo, cada variação já vem com o produto do grupo que tem exatamente aquelas características no [[65 Produtos e Servicos]].
* '''Adicionar (+)''': pesquisa produtos já cadastrados e os inclui no grupo, sem repetir. Se as características do produto formarem uma variação que ainda não tem produto, ele é vinculado direto a ela. Se essa variação já tiver outro produto, ou se as características não formarem uma variação do grupo, ele entra como "Sem variação".
* '''Gerar Produtos''': cria um produto para cada variação "Sem produto"; variações com produto não geram nada. O nome do produto gerado é a descrição do grupo mais os códigos das características, e o código auxiliar é o código do grupo mais os códigos das características. O produto aparece na grade como "Novo - gravado ao salvar" e só é criado ao salvar o grupo.
* '''Desacoplar (lixeira)''': selecione a linha do produto e clique na lixeira. A linha fica amarela, com a situação "Desacoplado ao salvar". Ao salvar, o produto deixa de pertencer ao grupo, sem ser excluído do cadastro e sem perder as características que já tem, e a variação dele volta a "Sem produto". Um produto gerado e ainda não salvo sai da grade na hora.
* '''Características do produto atualizadas ao salvar''': cada produto indicado em uma variação passa a ter, na aba Características do [[65 Produtos e Servicos]], as características dessa variação. Se o produto tinha outra característica de um tipo usado no grupo (outra cor, por exemplo), ela é trocada pela da variação; características de outros tipos não são alteradas. Ao tirar o produto de uma variação, ele perde as características dela.
* '''Hot-Links "Ativar Produtos" e "Inativar Produtos"''': ativam ou inativam de uma só vez todos os produtos do grupo, com confirmação antes de aplicar.
* '''Atualizar dados dos produtos com as características gerais''': quando marcada, replica os dados padrão do grupo (fiscal, geometria, estoque) para os produtos do grupo ao salvar.
* '''Categoria Principal automática''': quando nenhuma categoria está marcada como Principal, a primeira é marcada automaticamente.
* '''Ficha técnica''': na aba Especificações, escolha um Modelo de Ficha Técnica, cadastrado em [[128 Modelo Ficha Tecnica]], e informe os valores de cada item.

== Problemas e Soluções ==
{| class="wikitable"
! Problema !! Solução
|-
| Não consigo salvar: aparece mensagem pedindo Descrição, Unidade de Medida, Espécie, Subespécie, Fabricante, Conta Contábil, Localização ou outro campo obrigatório || Preencha o campo indicado na mensagem e salve novamente.
|-
| "Informe ao menos uma característica para o tipo COR." || Um tipo de característica foi informado sem nenhuma característica. Selecione o tipo e adicione as características dele, ou remova o tipo.
|-
| "O código auxiliar CPOLOMAZUL já é usado pelo produto 1187 - CAMISA POLO M PRETO." || O código auxiliar não pode repetir o de outro produto. Altere o Cód. Auxiliar do produto na grade e salve novamente.
|-
| O produto que quero escolher não aparece no combo Produto || O combo só lista produtos do grupo que ainda não estão em outra variação. Inclua o produto no grupo pelo botão Adicionar (+) ou retire-o da variação em que está.
|-
| Incluí um produto pelo + e ele ficou como "Sem variação" || As características dele não formam uma variação do grupo, ou a variação correspondente já tem outro produto. Escolha o produto no combo Produto da variação desejada.
|-
| "Gerar Produtos" não criou nenhum produto || Todas as variações já têm produto, ou não há tipos de característica informados. Confira a coluna Situação.
|-
| Desacoplei um produto por engano || Antes de salvar, saia do grupo sem salvar para descartar a alteração. Depois de salvo, inclua o produto de novo pelo botão Adicionar (+).
|-
| Usei "Importar Características de um Produto" e dados que eu já tinha preenchido mudaram || É o comportamento esperado: a importação substitui os dados do grupo pelos do produto escolhido. Use-a preferencialmente no início do cadastro.
|-
| "Nenhuma categoria foi definida como Principal." / "Apenas uma categoria pode ser marcada como principal." || Na aba Categorias, deixe exatamente uma categoria marcada como Principal.
|-
| "Valor de Estoque Máximo não pode ser menor que o Mínimo." || Ajuste os valores de Est. Mínimo e Est. Máximo na aba Estoque.
|-
| Ativei/Inativei os produtos do grupo sem querer || Repita a ação com a opção contrária (Ativar/Inativar) para reverter.
|}

== Exemplos de Uso ==
* '''Analista de cadastro''' cria o grupo CAMISA POLO com os tipos TAMANHO (P, M) e COR (PRETO, AZUL). A grade mostra 4 variações. Os produtos 1201 - CAMISA POLO P PRETO e 1187 - CAMISA POLO M PRETO já existiam e são indicados nas variações P PRETO e M PRETO. Ela clica em Gerar Produtos e o sistema cria CAMISA POLO P AZUL e CAMISA POLO M AZUL. Ao salvar, cada produto fica com seu tamanho e sua cor na aba Características do produto.
* '''Analista de cadastro''' vai criar um grupo parecido com um produto que já existe. Ela pesquisa o produto em Importar Características de um Produto: o grupo já recebe os dados fiscais e de estoque, os tipos e características de variação do produto e a ficha técnica.
* '''Analista de cadastro''' inclui pelo botão + o produto 1215, que já tem M e AZUL: ele vai direto para a variação M AZUL. Já o produto 1150 - CAMISA POLO LISA, sem tamanho e cor, entra como "Sem variação" e depois é escolhido no combo da variação P AZUL.
* '''Gestor comercial''' quer tirar de linha toda uma coleção. Ele abre o grupo e usa o Hot-Link "Inativar Produtos", inativando todos os produtos de uma vez.

== Observações Gerais ==
* Os produtos gerados, os produtos desacoplados e as características de cada produto só são gravados quando o grupo é salvo.
* Desacoplar não exclui o produto: ele continua no [[65 Produtos e Servicos]], apenas deixa de pertencer ao grupo.
* "Importar Características de um Produto" substitui dados já preenchidos. Use-a no início do cadastro.
* A opção "Atualizar dados dos produtos com as características gerais" vem desmarcada para evitar alterações em massa não intencionais. Marque-a conscientemente.
* Como as características do produto são usadas na integração com a loja virtual, confira as variações antes de salvar.

== Benefícios do Recurso ==
* Reduz o tempo de cadastro de famílias de produtos com muitas variações (cores, tamanhos, voltagens etc.).
* Mostra numa só grade o que já tem produto e o que falta, evitando produtos duplicados para a mesma variação.
* Diminui erros e inconsistência fiscal entre produtos que devem ter o mesmo tratamento.
* Mantém as características de cada produto alinhadas com a sua variação, inclusive para a loja virtual.
* Aproveita produtos já cadastrados como modelo, em vez de recomeçar do zero.

== Glossário de Termos ==
* '''Grupo de Produtos''' — Conjunto de dados padrão (fiscal, estoque, comercial) de uma família de produtos.
* '''Tipo de Característica''' — O tipo de variação da família, como TAMANHO ou COR.
* '''Característica''' — O valor de um tipo, como M ou AZUL.
* '''Variação''' — Uma combinação com uma característica de cada tipo, como M AZUL.
* '''Sem variação''' — Produto do grupo que não está em nenhuma variação.
* '''Desacoplar''' — Tirar um produto do grupo, sem excluí-lo do cadastro.
* '''Hot-Link''' — Ação rápida da tela, como Ativar ou Inativar Produtos.
* '''Ficha Técnica''' — Especificações técnicas do grupo, organizadas por um Modelo de Ficha Técnica.

== Links Relacionados ==
* [[65 Produtos e Servicos]]
* [[1656 Tipo Caracteristica Produto]]
* '''1104 - Caracteristica Produtos'''
* [[831 Informacoes Adicionais Do Produto]]
* [[128 Modelo Ficha Tecnica]]
* '''67 - Classificacao Produtos'''
* '''160 - Plano Contas'''
* [[164 Plano Contas Gerencial]]
* [[177 Tabela Precos Base]]
* [[129 Roteiro Producao]]