Entidade TIPOS_PRODUTOS

PROD.TIPOS_PRODUTOS

Descrição

Estrutura de agrupamento ou classificação dos produtos. Permite a estruturação dos produtos em, p.ex.: tipo de produto, família, grupo, sub-grupo, categoria, etc.
É conveniente que a estrutura de tipos de produtos seja organizada de tal forma que possa reflitir todas as regras fiscais, legais e operacionais de seus produtos, facilitando o cadastramento do produto propriamente dito.
Desta forma o conhecimento destes detalhes fiscais, legais e operacionais fica sob a responsabilidade de quem gerencia os tipos de produtos cabendo ao responsável de cadastrar o produto apenas a seleção correta de seu tipo de produto.

Atributos

AtributoDomínioRegrasDescrição
IDID(18)Rqd PK FK Id:
Chave de identificação interna

Referência para V_TIPOS_PRODUTOS
TIPO_PRODUTOASC6Rqd UK Tipo de produto:
Nome dado para identificar o tipo de produto.
PAI_IDID(18)FK Especialização de:
Relacionamento para montagem da estrutura hierárquica que define a forma de agrupamento dos produtos em: tipos de produtos, grupos, subgrupos, categorias, etc. Indica o agrupamento superior ('pai') do tipo de produto.

Referência para TIPOS_PRODUTOS
SERVICOFLAG(1)Rqd Serviço:
Indica se este tipo de produto é um serviço ou é um material.

Valor padrão = N
DESCRICAOTEXTDescrição:
Texto livre para descrever o tipo de produto.
UNIDADE_MEDIDA_IDID(18)FK Unidade de medida:
Unidade de medida padrão para este tipo de produto. Se informada, é apresentada como sugestão para os produtos deste tipo.

Referência para UNIDADES_MEDIDAS
TIPO_ITEM_PRINCIPALOPCAO(2)Rqd Tipo do item principal:
Tipo do item principal no tipo de produto, será utilizado como sugestão na inclusão de novos produtos deste tipo.

Valores permitidos:
  • 00 - Mercadoria para revenda
  • 01 - Matéria-prima
  • 02 - Embalagem
  • 03 - Produto em processo
  • 04 - Produto acabado
  • 05 - Subproduto
  • 06 - Produto intermediário
  • 07 - Material de uso e consumo
  • 08 - Ativo imobilizado
  • 09 - Serviços
  • 10 - Outros insumos
  • 99 - Outros

Valor padrão = 00
NCM_IDID(18)FK NCM:
Indica a classificação NCM sugerida para os produtos deste tipo. Se informada, é usada como padrão para os produtos deste tipo.

Referência para CLASSIFICACOES_NCM
SITUACAO_TRIBUTARIA_IDID(18)FK Situação tributária:
Quando informado indica a situação tributária padrão dos produtos deste tipo (válido apenas quando não definido no produto).

Referência para SITUACOES_TRIBUTARIAS
CLASSIFICACAO_CEST_TIPO_IDID(18)FK Classificação CEST:
Código de classificação para substituição tributária, quando não informado será utilizado o valor existente no NCM.

Referência para CLASSIFICACOES_CEST
TEXTO_LEGAL_IDID(18)FK Texto legal:
Indica um carimbo fiscal/legal relacionado aos produtos deste tipo.

Referência para TEXTOS_LEGAIS
VALOR_BASE_SUBSTITUICAOPERCENT(18)% MVA intraestadual:
Percentual de margem de valor agregado aplicado a produtos sujeitos a substituição tributária nas operações de venda dentro do estado do estabelecimento.
P.ex: 42,26% para algodão em embalagens até 100g, 43,70% para espátulas.
ALIQUOTA_ICMS_INTRAESTADUALPERCENT(18)Rqd Alíquota de ICMS intraestadual:
Valor de alíquota de ICMS interna do estado.
P.ex:
17% Normal
25% Bebidas alcoólicas.
AGRUPADORFLAG(1)Rqd Agrupador:
Indica se este tipo de produto é apenas um agrupador.
Agrupador = "S", significa que o tipo de produto pode ser detalhado hierarquicamente, ou seja, tem tipos "filhos" que definem a sua estrutura hierárquica.

Valor padrão = N
PESO_LIQUIDONUMBER(18)Peso líquido:
Peso líquido a ser considerado caso não seja informado no respectivo produto ou modelo.
PESO_EMBALAGEMNUMBER(18)Peso embalagem:
Peso a ser considerado para a embalagem caso não seja informado no respectivo produto ou modelo.
PERCENTUAL_PERDAPERCENT(18)Percentual de perda:
Percentual de perda padrão dos produtos deste tipo (produtos que acabam estragando nas prateleiras). Exemplo: queijos podem possuir um percentual de perda de 5%. Algumas verduras e frutas podem possuir uma perda de até 20%. Este percentual é considerado nas ferramentas de formação de preço de venda. Caso não informado, então o sistema assume o fator de perda configurado no respectivo tipo de produto (se houver). O percentual informado aqui será utilizado por todos os produtos deste tipo que não indicarem um percentual específico.

Caso exista um programa de reposição em que o próprio fornecedor substitui as perdas com novos produtos, então deve-se informar 0% (ou o percentual de perda residual que fica a cargo do estabelecimento).
PRODUTO_IDID(18)FK Produto:
Modelo/produto padrão associado.

Referência para PRODUTOS
ENGENHARIA_PRODUTO_IDID(18)FK Engenharia de produto:
Para tipos de produto que não são agrupadores, indica qual a engenharia de produto que rege as regras deste tipo.

Referência para ENGENHARIAS_PRODUTOS
PADRAO_CLASSIFICACAO_QUALIDADE_IDID(18)FK Padrão de classificação da qualidade:
Quando informado, indica que os produtos deste tipo podem ser classificados quanto a sua qualidade conforme este padrão.
Esta informação é automaticamente copiada para todos os tipos de produtos abaixo deste e que tinham o mesmo padrão que o pai.

Referência para PADROES_CLASSIFICACAO_QUALIDADE
VALOR_PERCENTUAL_COMISSAOPERCENT(18)Valor percentual de comissão:
Percentual de comissão para as operações de venda realizadas para os serviços ou produtos e mercadorias do tipo de produto.
SEQUENCIAINTEGERRqd Sequência:
Número de sequência entre os tipos de produto que estão abaixo do mesmo pai.
UTILIZA_LOTEFLAG(1)Rqd Utiliza lote:
Quando marcado, indica que os produtos deste tipo deverão ser referenciados por lote:
  • Todas as movimentações de estoque serão feitas pelo respectivo lote
  • Processos de produção irão gerar novos lotes do produto
  • Documentos de entrada e saída deverão informar os lotes

Valor padrão = N
UNIDADE_PRODUTOOPCAO(1)Rqd Controle por número de série:
Define se devem/podem ser cadastradas as unidades individuais de produtos (p.ex: equipamentos com número de série) para os produtos deste tipo.
A informação das unidades de produto (números de série) nos documentos de entrada/saída é regulada conforme o valor configurado.

Valores permitidos:
  • N - Não permitido - Não é permitido o cadastro de unidades individuais de produto para os produtos deste tipo.
  • O - Opcional - Não obriga, mas permite informar as unidades individuais de produto para os produtos deste tipo.
  • S - Obrigatório - Exige que seja cadastrada uma unidade individual de produto para os produtos deste tipo.

Valor padrão = N
IDENTIFICACAO_LOTEOPTION(1)Rqd Identificação do lote:
Define se o campo de identificação para o lote de ser preenchido manualmente, automaticamente(via script) ou não preenchido.

Valores permitidos:
  • N - Não requerido - Campo não será aberto para preenchimento do usuário
  • O - Manual (opcional) - Campo deve ser preenchido pelo usuário manualmente
  • R - Manual (requerido) - Campo deve ser preenchido pelo usuário, mas é obrigatório o preenchimento da identificação do lote para o registro.
  • A - Automático - Identificação para o lote será automaticamente preenchida conforme script definido no tipo de pedido.

Valor padrão = N
SCRIPT_IDENTIFICACAO_LOTESOURCE_CODEScript identificação do lote:
Código (Script Velocity) para geração da identificação do lote de produção/fabricação dos produtos. Deve ser preenchido somente quando informado "Automático" para o campo "Campo de identificação do lote".
Exemplos:
  • Data de produção com sequência de itens produzidos no dia (p.ex.: 18.D.A01):
$item.findPedido().getDataConclusao().format("yy'.'D'.A$sequencia'").toText()
  • Número do pedido de produção:
$item.findPedido().getPedido().toText()
PERCENTUAL_MAXIMO_DESCONTOPERCENT(18)Percentual máximo de desconto:
Valor máximo de percentual de desconto para o tipo de produto
EXIGE_CODIGO_ANPFLAG(1)Rqd Exige código ANP:
Define se deve ser obrigatório ser informado o código ANP do produto.

Valor padrão = N
EXIGE_MARCAFLAG(1)Rqd Exige marca:
Define se ao utilizar este tipo de produto deve ser exigido a marca do produto

Valor padrão = N
EXIGE_FABRICANTE_REFERENCIAFLAG(1)Rqd Exige fabricante e referência:
Define se ao utilizar este tipo de produto deve ser exigido a informação do fabricante e da referência do produto/serviço.

Valor padrão = N
EXIGE_DESCRICAO_DETALHADAFLAG(1)Rqd Exige descrição detalhada:
Define se deve ser exigido no produto informar a descrição detalhada do mesmo.

Valor padrão = N
PERFIL_IDID(18)FK Perfil de características:
Define um perfil de características que devem ser agregadas ao produto.

Referência para PERFIS_PRODUTOS
UTILIZAR_UNIDADES_ALTERNATIVASFLAG(1)Rqd Utilizar unidades alternativas:
Quando marcado, será possível cadastrar unidades de medida alternativas para o produto. Isso é especialmente importante quando existe alguma legislação exigindo que os documentos fiscais de determinado produto utilizem uma unidade de medida diferente daquela que o estabelecimento utiliza para os processos internos (controle de estoque, pedidos de venda, ordens de compra, etc.).

Exemplo: Produtos plásticos do NCM 3924.90.00 que o fabricante controla em unidades e que para exportar DEVEM ser quantificados em KG.

Valor padrão = N
TRATAR_EXCLUSIVIDADEOPTION(1)Rqd Exclusividade de produtos:
Indica o comportamento a ser considerado para os produtos do tipo nos pedidos dos tipos que estiverem configurados para tratamento da exclusividade de comercialização.

Valores permitidos:
  • N - Sem exclusividade - Não é verificada a exclusividade comercial dos produtos inseridos nos pedidos.
  • S - Por cliente - Produtos serão exclusivos de um cliente.
  • C - Por cidade - Produtos serão exclusivos de um cliente dentro de uma cidade.
  • B - Por bairro - Produtos serão exclusivos de um cliente dentro de uma cidade e um bairro.

Valor padrão = N
MODELO_PDFTEXTModelo PDF:
Permite informar um modelo PDF padrão a ser utilizado na impressão de produtos.

Este modelo é utilizado em impressão de lotes de produtos.
DATA_VALIDADEOPCAO(1)Rqd Informar a data de validade nos documentos:
Indica como os produtos deste tipo se comportam com relação ao preenchimento da data de validade nos documentos de entrada.

Valores permitidos:
  • N - Não informar - Não será solicitada a data de validade dos produtos nas suas respectivas entradas.
  • O - Opcional - O preenchimento da data de validade na entrada dos produtos é opcional.
  • R - Requerido - É obrigatório informar uma data de validade na entrada de produtos deste tipo.

Valor padrão = N
ATIVOFLAG(1)Rqd Ativo:
Indica se o tipo de produto está ou não ativo.

Valor padrão = S
CODIGO_HIERARQUICOOPTION_INPUT(30)Tipo de produto:
Este campo permite filtrar os registros por tipo de produto. Informando um tipo de produto "Agrupador", irá filtrar todos os tipos que estão abaixo deste tipo agrupador.
COMERCIALIZAVELFLAG(1)Rqd Comercializável:
Indica quais os tipos de produtos que podem ser comercializados, ou seja, que podem ser emitidos pedidos. Todos os tipos "comercializáveis" deverão ser do tipo "material".

Valor padrão = N
SITUACAO_TIPO_PRODUTOOPCAO(1)Rqd Situação:
ATENÇÃO
DEPRECIADO!!! NÃO USAR!!!

SUBSTITUIR PELO ATRIBUTO "ATIVO".

Valores permitidos:
  • A - Ativo
  • I - Inativo

Valor padrão = A

Regras

Preencher valores padrão

(Antes de inserir, Antes de alterar)
Valores padrão para o tipo de produto podem ter características do tipo pai, quando representa uma hierarquia de tipos de produtos, p.ex: sub-grupo de um grupo já registrado.
O sub-grupo herda (recebe) as características do grupo podendo ser alteradas caso seja necessário.

Preencher campo sequência quando vazio

(Antes de inserir, Antes de alterar)

Atualizar o valor de comissão dos filhos

(Depois de inserir, Depois de alterar)
Atualizar o valor de comissão dos tipos de produtos filhos

Atualizar NCM dos produtos

(Depois de alterar)
Ao atualizar os produtos que seguem o mesmo NCM do tipo de produto.

Validar utiliza de lote

(Antes de inserir, Antes de alterar)
Tipos de produtos que utilizam lote não podem ter identificação do lote e nem utilizar unidade de produto.

Herdar padrão de classificação de qualidade

(Antes de inserir)
Ao incluir um tipo de pedido sem informar o padrão de classificação de qualidade, copiar o mesmo padrão utilizado no tipo de pedido pai.

Atualizar tipos de pedidos filhos

(Antes de alterar)
Quando o padrão de classificação de qualidade for alterado, os tipos "filhos" são automaticamente atualizados de forma que os que estavam iguais ao pai também são alterados.

Validar alteração do padrão de qualidade

(Antes de alterar)
Não é permitido alterar o padrão de classificação de qualidade de um tipo que já tem produtos classificados.

Atualizar regras de tributos

(Depois de alterar)
Caso alterado o nome do tipo de produto deve atualizar as configurações de tributações

Calcular código hierárquico

(Antes de inserir, Antes de alterar)
Calcula o código hierárquico que será formado pela concatenação do código hierárquico do tipo de produto "pai" + "." + ID do tipo de produto.

Tipos não agrupadores devem ter NCM informados!

(Antes de inserir, Antes de alterar)
A regra deveria ser:
Porém, no SICV não é obrigatório e optou-se por deixar sem esta obrigatoriedade.

Tipo não agrupador não podem ser alterado para agrupador!

(Antes de alterar)

Produtos padrão ou engenharia de produtos inválidos!

(Antes de inserir, Antes de alterar)

Tipo de produto agrupador não pode possuir engenharia de produto!

(Antes de inserir, Antes de alterar)
Valida a existência de engenharia de produto para tipos de produtos agrupadores, pois esses não podem ser configurados com uma engenharia.

O tipo de produto sendo especializado forma uma recursividade inválida!

(Antes de alterar)
Verificar se a operação não deixará a estrutura de produtos recursiva (em loop). O teste é realizado buscando o ID deste tipo de produto no caminho da estrutura de tipos de produtos até a raiz.

Validar script para geração do lote

(Antes de inserir, Antes de alterar)
Validar script para geração do lote

Não pode inativar tipo de produto que tenha produtos ativos!

(Antes de alterar)
Não pode inativar um produto se existem produtos não cancelados vinculados ao mesmo.

Atualizar situação tipo de produto

(Antes de alterar)
Regra utilizada para manter rotinas que utilizavam o atributo SITUACAO_TIPO_PRODUTO. Atualiza conforme o atributo ATIVO.

Calculo MVA ajustado(mva, inter, intra)

Calculo do MVA ajustado para transferências interestaduais com ST.

Is on root path(id)

Verifica se o tipo de produto informado aparece na hierarquia até a raiz.


Esta função é usada para testar recursividades inválidas na hierarquia dos tipos de produtos.

Retorna Filhos

Retornar ID dos filhos em um Array de LONG

retorna Tipos Filhos(tipo_produto_id)

Retornar os filhos deste tipo de produto separados por "," ( virgula ).