Entidade ITENS_COLECOES

COLECA.ITENS_COLECOES

Descrição

Associação entre coleções e produtos, permitindo indicar a quais coleções o modelo e/ou produto estão vinculados.

Atributos

Atributo	Domínio	Regras	Descrição
ID	ID(18)	Rqd PK FK	Id: Id do item da coleção Referência para V_ITENS_LISTAS_PRECOS
COLECAO_ID	ID(18)	Rqd UK FK	Coleção: Coleção ou lista de preços ao qual o item pertence. Referência para COLECOES
PRODUTO_ID	ID(18)	Rqd UK FK	Produto: Identificação do produto da coleção ou lista de preços. Referência para PRODUTOS
QUANTIDADE_PRODUTOS_MINIMA	NUMBER(18)	Rqd UK	Quantidade mínima de produtos: Quantidade mínima de produtos para que este preço seja considerado válido. O preço básico (independente da quantidade) de um produto dever ser informado com quantidade 0 (zero). Exemplo: Preço base de 1 até 9 unidades do produto. Preço de 10 até 19 unidades do produto. Preço acima igual ou acima de 20 unidades do produto. Valor padrão = 0
TIPO_ANUNCIO_ID	ID(18)	Rqd UK FK	Tipo de anúncio: Tipo de anúncio que será utilizado por exemplo para o Mercado Livre. Valor padrão = 0 Referência para TIPOS_ANUNCIOS
PRECO_SUGERIDO	PRICE(18)		Preço: Preço sugerido para venda do item da coleção ou lista de preços (modelo ou material). Caso não informado, o preço adotado será o informado para o respectivo modelo na mesma coleção.
PRECO_INDICADO	PRICE(18)		Preço indicado: Preço a ser indicado nas operações de venda. O preço indicado difere do preço sugerido (preço lista), pois esse preço é apresentado como "proposta" para que a venda seja realizada com esse valor. Pode ser utilizado, p.ex., para "induzir" a venda a um preço com uma margem de resultado melhor para a empresa, melhorando o caixa flex e a comissão do vendedor, evitando a prática da simples venda pelo preço de lista, sem uma negociação mais favorável para o vendedor. Este campo estará disponível nos itens da lista apenas quando a Listas de preços estiver definida para uso do preço indicado. Para que os pedidos efetuem o tratamento do preço indicado deve ser marcado o campo "Usar preço indicado" no cadastro de Tipos de pedidos.
PERCENTUAL_MINIMO	PERCENT(18)		Percentual mínimo: Percentual sugerido para calcular o preço mínimo dos produtos. Caso informado, o preço mínimo será recalculado diminuindo este percentual do preço sugerido. Caso o usuário informar um preço mínimo, este percentual é automaticamente alterado. Ao incluir um novo produto na lista, este percentual vem sugerido com o que está informado no cabeçalho da lista. Um percentual de 10%, por exemplo, indica que ao informar um preço de 10,00, o preço mínimo será de 9,00.
PRECO_MINIMO_SUGERIDO	PRICE(18)		Preço mínimo: Preço mínimo sugerido para venda do item da coleção ou lista de preços (modelo ou material). Caso não informado, poderá ser informado qualquer preço abaixo do preço de lista nos itens dos pedidos, sem qualquer restrição de preço.
PERCENTUAL_MAXIMO	PERCENT(18)		Percentual máximo: Percentual sugerido para calcular o preço máximo dos produtos. Caso informado, o preço máximo será recalculado aplicando este percentual ao preço sugerido. Caso o usuário informar um preço máximo, este percentual é automaticamente alterado. Ao incluir um novo produto na lista, este percentual vem sugerido com o que está informado no cabeçalho da lista. Um percentual de 30%, por exemplo, indica que ao informar um preço de 10,00, o preço máximo será de 13,00.
PRECO_MAXIMO_SUGERIDO	PRICE(18)		Preço máximo: Preço máximo sugerido para venda do item da coleção ou lista de preços (modelo ou material).
PERCENTUAL_MAXIMO_DESCONTO	PERCENT(18)		Percentual máximo de desconto: Valor percentual máximo de desconto permitido para o item.
DATA_INICIO_COMERCIALIZACAO	DATE_TIME	Rqd	Data início comercialização: Data de início de comercialização do item na coleção ou lista de preços. Valor padrão = [SYSDATE]
DATA_FIM_COMERCIALIZACAO	DATE_TIME		Data fim comercialização: Data de fim de comercialização do item na coleção ou lista de preços.
DATA_ULTIMA_ATUALIZACAO	DATE_TIME		Data da última atualização: Data da última alteração do preço, preço máximo, preço mínimo ou ainda dos parâmetros que definem uma promoção.
NOTAS	TEXT_LONG		Notas: Notas adicionais do modelo/produto na coleção. Esta nota, quando informada, será incluída na maioria dos relatórios associados a coleção.
COMISSAO_ITEM	PERCENT(18)		Comissão do item: Valor da comissão para o item da coleção ou lista de preços. Quando não informado, assume o mesmo valor que consta na comissão padrão da lista.
PRECO_PROMOCIONAL	PRICE(18)		Preço promocional: Preço promocional informado para o produto/serviço. Ao definir uma promoção, pode-se informar este campo OU o percentual promocional.
PERCENTUAL_PROMOCIONAL	PERCENT(18)		Percentual promocional: Percentual de desconto promocional para o produto/serviço. Para definir uma promoção, deve-se informar este campo OU o preço promocional.
VALOR_PROMOCIONAL	PRICE(18)		Valor promocional: Preço promocional para o produto/serviço. Este campo é automaticamente calculado com base no preço promocional informado ou do percentual de desconto promocional. Somente será apresentado SE existir uma promoção.
DATA_TERMINO_PROMOCIONAL	DATE		Data término promocional: Data de término da promoção. Quando informada, indica que deverá ser utilizado o preço promocional até esta data. Quando informada junto com uma quantidade de estoque em promoção, o sistema usará o preço promocional até que uma das 2 condições se encerre, ou seja, a data seja alcançada ou a quantidade seja toda consumida.
DATA_INICIO_PROMOCIONAL	DATE		Data inicio promocional: Apresenta a data que será iniciada a promoção
ITEM_LISTA_BASE_ID	ID(18)	FK	Baseado em: Quando informado, indica que este item da lista é baseado no item de outra lista. Referência para ITENS_COLECOES
QUANTIDADE_PROMOCIONAL	NUMBER(18)		Quantidade promocional: Quando informada, indica que os preços promocionais poderão ser utilizados até que esta quantidade seja consumida. Esta é uma quantidade acumulada, ou seja, para incluir uma segunda promoção por quantidade, acumula-se as quantidades à promoção anterior.
QUANTIDADE_PROMOCIONAL_CONSUMIDA	NUMBER(18)		Quantidade promocional consumida: Quantidade de produtos que já se utilizaram da promoção. Este número é automaticamente calculado pelo sistema através da soma dos itens de pedidos que estão ligados a este item da coleção.
QUANTIDADE_PROMOCIONAL_RESTANTE	NUMBER(18)		Quantidade promocional restante: Quantidade de produtos que ainda podem ser vendidos na promoção. Calculado pela quantidade promocional menos a quantidade promocional consumida.
PERCENTUAL_SOBRE_OUTRO_ITEM_LISTA	PERCENT(18,6)		Percentual sobre outro item da lista (variação): Indica um percentual positivo ou negativo a ser aplicado sobre o preço de um outro item de uma lista base.. Se desejar, por exemplo, criar uma preço baseado em outro com um desconto de 10%, então deve-se informar "-10". Caso informado, é obrigatório o preenchimento do item da lista de preços "ITEM_LISTA_BASE_ID".
PERCENTUAL_APLICADO	PERCENT(18)		Percentual sobre item base: Percentual a ser aplicado sobre o item. Este valor não considera o fator de conversão do item.
ATIVO	FLAG(1)		Ativo: Indica se o item (produto ou serviço) está ou não ativo na lista de preços. Itens inativos, apesar de constarem na lista de preços, não são utilizados nas operações de venda que solicitam preço para os itens dos pedidos ou documentos. No caso de lista de preço baseada em outra lista, este campo é automaticamente preenchido com o que está definido no cabeçalho da lista. Valor padrão = S
PERCENTUAL_PRECO_VENDA	PERCENT(18)		Percentual para preço de venda: Percentual utilizado para o cálculo na formação do preço de venda a partir do custo dos produtos. Este percentual é utilizado apenas nos processos de atualização de preços a partir das telas de atualização de preços ou do processo de formação de preços de venda. Quando não informado, assume o mesmo valor que o percentual informado no cabeçalho da lista de preços. A alteração desse percentual não reprocessa o cálculo dos preços e não altera os preços dos itens nas listas.
MEMORIA_CALCULO_PRECO	TEXT_LONG		Memória de cálculo do preço: Memória de cálculo para formação do preço de venda. Exemplo: + COMPRA = 45,75 + FRETE = 1,70 - CREDITO ICMS = 8,24
QUANTIDADE_MINIMA_ESTOQUE	NUMBER(18)		Quantidade mínima em estoque: Quantidade mínima de produtos que o estabelecimento deve manter em estoque. Este atributo somente é apresentado se a respectiva lista de preços tem o atributo "Controlar quantidade mínima de estoque" marcado e é utilizado como ferramenta para a gestão de compras programar novas aquisições.
SEQUENCIA	INTEGER		Sequência: Número sequencial para os itens dentro da lista de preços. Pode ser utilizada para ordenação de apresentação dos itens em determinadas operações como, p.ex.: apresentação dos produtos para inclusão de itens em pedidos de venda.
PERCENTUAL_REBATE	PERCENT(18)		Percentual de rebate: Informa qual será o percentual de rebate a ser utilizado para as vendas deste produto através desta lista de preços. Caso não informado, o sistema irá utilizar o percentual informado na lista de preços. Este campo estará disponível apenas se o respectivo tipo de coleção permitir.
ESTOQUE_INFORMADO	DECIMAL_VALUE		Estoque informado: Quando este campo estiver informado, essa será a quantidade de estoque que o sistema irá apresentar no anúncio em lojas virtuais. Este campo somente estará visível se a capa da lista de preços estiver com o campo "Usa estoque informado" marcado.
PRECO_FINAL	PRICE(18)		Preço final: Preço final do produto considerando todos os impostos internos e externos do item.
PRECO_FINAL_MINIMO	PRICE(18)		Preço final mínimo: Preço final mínimo do produto considerando todos os impostos internos e externos do item. Por padrão é utilizado o mesmo percentual existente no preço mínimo
PRECO_FINAL_MAXIMO	PRICE(18)		Preço final máximo: Preço final máximo do produto considerando todos os impostos internos e externos do item. Por padrão é utilizado o mesmo percentual existente no preço máximo.
PERCENTUAL_ADICIONAL_SOBRE_LISTA_BASE	PERCENT(18)		Percentual adicional sobre a lista de base: Percentual adicional a ser aplicado sobre o item quando existir uma lista base, seu preenchimento é opcional para listas de preços que possuírem uma lista base; para outras listas obrigatoriamente deve ser nulo. O campo não substitui o percentual aplicado na lista de preços, mas sim apenas agrega ao valor da lista. Por exemplo, na lista está informado 10%, no item está informado 5%; desta forma será calculado 15%.
QUANTIDADE_PRODUTOS	NUMBER(18)		Quantidade mínima para preço promocional: OBSOLETO - USAR OUTRO REGISTRO COM QUANTIDADE_MINIMA E PRECO_SUGERIDO! Quantidade mínima para preço promocional. Uma quantidade de produtos padrão para o modelo/produto. Caso não informado, assume o geral da coleção. Este campo tem diversas aplicações. Pode, por exemplo, informar uma quantidade de produtos disponível no estoque, ou ainda, informar quais os tamanhos podem ser comercializados (caso em que interessa apenas os tamanhos informados e não as respectivas quantidades). Esta quantidade pode ser utilizada para determinar a quantidade promocionais tanto para quantidades mínimas como para quantidades promocionais totais.
VALOR_PRECO_PROMOCIONAL	VALUE(18)		Preço promocional: OBSOLETO - SUBSTITUIR PELO ATRIBUTO PRECO_PROMOCIONAL!!!!!

Regras

Herdar valores do cabeçalho da lista

(Antes de inserir, Antes de alterar)

Caso comissão, percentual mínimo ou percentual máximo não informados, herdar os valores informados no cabeçalho da lista.

Herdar valores da lista base

(Antes de inserir, Antes de alterar)

Caso exista uma lista de base, herda os seguintes valores da mesma:

Ativo/Inativo
Preço sugerido (aplicando percentual sobre a lista base)
Mínimo/máximo sugerido (utilizando os percentuais da própria lista ou aplicando percentual da lista base)
Datas de início e término da comercialização
Notas
Quantidade de produtos mínima
Sequência

Calcular valores mínimo e máximo

(Antes de inserir, Antes de alterar)

Calcular o preço mínimo ou máximo e/ou atualizar os percentuais de mínimo/máximo em uso.

Validar preço da mercadoria VALIDAR_CUSTO

(Antes de alterar, Antes de inserir)

Validar se o preço da mercadoria é superior ao preço da última compra, ou seja, o valor de venda não deve ser menor que o valor pago pelo produto na última compra.

Configurações relacionadas:

COLECA.ITENS_COLECOES.CRITICAR_PRECOS_LISTAS_DEPENDENTES
Indica se deve ou não criticar os preços nas listas criadas por dependência de lista base.
Caso não seja configurado, assume que deve criticar.
Configurando para "Não", melhora a performance nas atualizações das listas de preços.

COLECA.ITENS_COLECOES.VALIDACAO_CUSTO
Define se a rotina irá verificar se o valor do preço sugerido e preço mínimo, informados na lista de preços, são inferiores ao preço de custo fiscal da última aquisição efetuada por um dos estabelecimentos vinculados a lista.
Por padrão valida e apresenta mensagem de alerta caso o preço sugerido seja menor que o custo (valor A).

VALORES:

N: Não validar
A: Avisar quando preço sugerido está abaixo do custo
E: Erro quando preço sugerido está abaixo do custo
AM: Avisar quando preço sugerido está abaixo do custo, mas validar também o preço mínimo caso informado.
EM: Erro quando preço sugerido está abaixo do custo, mas validar também o preço mínimo caso informado.

COLECA.ITENS_COLECOES.VALIDACAO_CUSTO_FINANCEIRO
Define se a rotina irá verificar se o valor do preço sugerido e preço mínimo, informados na lista de preços, são inferiores ao preço de custo financeiro da última aquisição efetuada por um dos estabelecimentos vinculados a lista.
Por padrão não valida.

VALORES:

N: Não validar
A: Avisar quando preço sugerido está abaixo do custo
E: Erro quando preço sugerido está abaixo do custo
AM: Avisar quando preço sugerido está abaixo do custo, mas validar também o preço mínimo caso informado.
EM: Erro quando preço sugerido está abaixo do custo, mas validar também o preço mínimo caso informado.

COLECA.ITENS_COLECOES.VERIFICAR_CUSTO_FINANCEIRO
Define se deve ser verificado se o preço do item está inferior ou não ao custo financeiro médio.
Caso marcado, uma tentativa de alterar o preço para um valor abaixo do custo atual do produto irá gerar um erro.
Caso não configurado, assume "Não".

COLECA.ITENS_COLECOES.VERIFICAR_CUSTO_FORNECEDOR
Define se deve verificar se o valor está inferior ao custo financeiro médio informado no registro de fornecedor.

Validar se coleção é baseada em outra

(Antes de inserir, Antes de alterar)

Se a coleção for baseada em outra, o item da coleção DEVE estar amarrado a um item da respectiva coleção de base.

Calcular quantidades promocionais

(Antes de inserir, Antes de alterar)

Caso exista uma quantidade promocional informada, calcula a quantidade promocional já consumida e a quantidade promocional restante.
A quantidade consumida é calculada totalizando os itens de pedido que estão usando essa promoção.
A quantidade restante é a quantidade promocional informada menos a quantidade consumida.

Preencher o valor promocional

(Antes de inserir, Antes de alterar)

Calcula o valor promocional usando o percentual promocional sobre o preço sugerido e ajustando para o número de casas indicado na lista de preços.

Validar data fim de comercialização

(Antes de inserir, Antes de alterar)

Caso o tipo de coleção esteja configurado para validar o fim da comercialização e o item ou o cabeçalho da coleção tenham uma data de fim da comercialização informada, então gera um erro ou um alerta quando a data atual é superior à informada.

Arredondar valores

(Antes de inserir, Antes de alterar)

Arredonda todos os preços conforme o número de casas decimais definido na respectiva lista de preços.

Validar o preço promocional

(Antes de inserir, Antes de alterar)

Caso o preço promocional seja superior ao preço sugerido para o produto, o sistema gera um aviso (warning) para o usuário.

Atualizar a data de última atualização do item

(Antes de inserir, Antes de alterar)

Sempre que um dos seguintes campos for alterado, a data de atualização será atualizada:

Preço sugerido
Preço máximo
Preço mínimo
Preço ou percentual promocional
Data de término da promoção

Atualizar listas baseadas

(Depois de inserir, Depois de alterar, Antes de excluir)

Não executa se a lista atual já é baseada em outra.
Quando um novo item é criado, cria o mesmo item nas listas que são baseados nesta lista.
Quando um item é excluído, excluir nas listas baseadas nesta lista.
Quando um item é alterado, atualizar o das respectivas listas.
Quando um item é excluído, excluir das respectivas listas.

Incluir formação de preços

(Depois de inserir)

Ao incluir um novo preço, e se determinado na coleção que utiliza formação, será incluído na entidade de formações de preços.

Atualizar a data de última atualização do produto

(Depois de inserir, Depois de alterar, Depois de excluir)

Ajusta a data da última atualização do produto sempre que inserir ou alterar um preço.
Observações:

Este método não é executado para listas baseadas em outras listas
Este método não é executado caso a preferencia COLECA.ITENS_COLECOES.ATUALIZAR_DATA_PRODUTO esteja configurada com "N".

Atualizar formação de preços

(Depois de alterar)

Atualizar a formação de preços quando ocorrer alteração no valor unitário, caso não exista uma formação de preços. Somente é executada se a lista utiliza formação de preços.

Atualizar histórico de preços

(Depois de inserir, Depois de alterar)

Quando o preço sugerido é alterado e a lista de preço não é baseada em outra, atualiza o histórico de preços do item de coleção.

Excluir formação de preços

(Depois de excluir)

Exclui todas formações de preços para o produto do item da lista de preço.

Atualizar margem de lucro na formação de preços

(Depois de alterar)

Atualiza o percentual da margem de lucro nas formações de preços de venda quando alterar o percentual para preço de venda. Não é executado em listas dependentes de outras listas.

Adicionar registro na fila de integração

(Depois de inserir, Depois de alterar, Depois de excluir)

Caso exista um sistema externo ativo e que tem a lista de preço associação ao item deve-se adicionar na fila de integração o registro

Adicionar anúncio padrão

(Depois de inserir)

Quando a lista de preço está configurada para ter múltiplos anúncios, deve criar o anúncio padrão assim que um preço novo for criado

Data de fim deve ser superior a data de início de comercialização!

(Antes de alterar, Antes de inserir)

Data de fim de comercialização deve ser superior a data de início.

Valores negativos (<0) não são permitidos!

(Antes de inserir, Antes de alterar)

Valores informados para os preços devem ser maiores que 0 (zero).

Valor 0 (zero) não é permitido!

(Antes de inserir, Antes de alterar)

Caso o respectivo tipo de coleção esteja informado com "Permite preços zerados" = "N" (desmarcado), então não será permitido incluir um produto sem preço informado ou com preço zero.

Legado

Antigamente isso era configurado pela preferência COLECA.ITENS_COLECOES.PERMITE_PRECO_ZERO,
se S permite informar preço zero e N não permite preço zero (padrão).

Valor máximo do produto deve ser superior ou igual ao preço base!

(Antes de inserir, Antes de alterar)

O valor máximo do produto deve ser maior ou igual ao preço base.

Percentual máximo para desconto deve ser inferior a 100%!

(Antes de inserir, Antes de alterar)

Percentual informado para desconto é superior a 100%!

Para preços promocionais é obrigatório informar uma data de término ou quantidade promocional!

(Antes de inserir, Antes de alterar)

Ao informar o valor percentual deve ser obrigatoriamente preenchida a data de término da promoção.

Validar vinculo com a lista base

(Antes de inserir)

Caso a lista de preços utilizada seja baseada em outra lista, deve exigir o preenchimento do campo de item da lista de preços base.

Valor mínimo do produto deve ser inferior ou igual ao preço base!

(Antes de inserir, Antes de alterar)

Valor mínimo do produto deve ser inferior ou igual ao preço base.

Preço indicado inferior ao preço mínimo da lista

(Antes de inserir, Antes de alterar)

Valida o preço indicado:

Verifica se o preço indicado deve ser preenchido ou não.
Verifica se o preço indicado está dentro dos limites de preço mínimo e preço máximo do item da lista de preços.

Validar percentual adicional para lista de preços

(Antes de inserir, Antes de alterar)

Validar se o percentual adicional pode ser informado nos itens

Retornar Produto Nome(produto, pedi, preco, quantidade)

Procedimento deve retornar o nome do produto.

find By Colecao Id Produto Id(colecao_id, produto_id)

Procurar a coleção, por padrão ele coloca a quantidade = 0

Verificar validade

Verifica se o item está ativo/válido/disponível. O item não será válido se a data atual estiver fora do prazo de comercialização ou se o produto estiver cancelado.

Retornar preço(desconto, acrescimo)

Retorna o preço sugerido para o produto considerando percentual de desconto e acréscimo quando existir.

Tem promoção?(quantidade)

Retorna se o preço é promocional ou não. Retorna TRUE caso existir um preço promocional vigente no item da lista ou se a lista toda é promocional.