Entidade COLECOES

COLECA.COLECOES

Descrição

Coleções são conjuntos de modelos e/ou produtos. Criar uma coleção pode ter vários objetivos:

Um modelo e/ou produto pode pertencer a diversas coleções, que por sua vez, podem ser criadas para atendimento de situações específicas como apresentação em feiras ou por solicitação de um cliente em especial.

As coleções são cíclicas e portanto tem um "tempo de vida útil" limitado ao prazo estipulado para desenvolvimento e comercialização estabelecido pelo departamento comercial.Estes prazos servem como referência para um macro-planejamento das atividades em torno das mesmas.

As coleções também são associadas à criação de novos modelos, pedidos, e desenvolvimento de amostras. Com a utilização desta associação é possível analisar estatisticamente os esforços e os resultados das coleções de forma pormenorizada.

O acesso às coleções segue as seguintes regras:

Atributos

AtributoDomínioRegrasDescrição
IDID(18)Rqd PK Id:
Id do tipo da coleção
COLECAOUPPERRqd UK Coleção:
Nome dado para identificar a lista de preços ou coleção.

Exemplos:
  • PADRÃO
  • PROMOCIONAL
  • INVERNO 2017/2018
  • CLIENTE X
  • FORNECEDOR Y
TITULOTEXTTítulo:
Texto a ser utilizado como "título" em relatórios da coleção. Um título pode ser um pouco mais flexível (e maior) que o nome da coleção.
TIPO_COLECAO_IDID(18)Rqd FK Tipo de coleção:
Identifica o tipo desta coleção.

Referência para TIPOS_COLECOES
FORNECEDOR_IDID(18)FK Fornecedor:
Nome do fornecedor para o qual esta lista pertence. Este campo somente é visível para listas cujo tipo esteja marcado para exigir fornecedor (listas de preços de compras ou representação).

Referência para PESSOAS
REPRESENTANTE_IDID(18)FK Representante:
Indica que esta é uma lista de preços específica para um representante. Ao utilizar esta lista, a comissão será direcionada para o respectivo representante.

Referência para PESSOAS
DATA_INICIO_COMERCIALIZACAODATEInício da comercialização:
Data a partir da qual a lista estará ativa para ser comercializada e utilizada em pedidos.
DATA_FIM_COMERCIALIZACAODATEFim de comercialização:
Data final do período de comercialização dos produtos na lista. Após esta data, o sistema não permitirá mais a emissão de pedidos associados a ela. A data poderá ser livremente alterada pelo comercial conforme condições estabelecidas pelo mercado.
MOED_IDID(18)FK Moeda:
Identifica qual a moeda que é utilizada para representar os preços dos modelos/produtos desta coleção.
Meramente informativo - este atributo não está sendo utilizado no sistema.

Referência para MOEDAS
PERCENTUAL_MINIMOPERCENT(18)Percentual para preço mínimo:
Percentual sugerido para calcular o preço mínimo dos produtos. Este percentual é utilizado apenas como sugestão na inclusão de novos itens. Alterar este percentual NÂO altera os preços mínimos dos produtos já cadastrados.
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.
PERCENTUAL_MAXIMOPERCENT(18)Percentual para preço máximo:
Percentual sugerido para calcular o preço máximo dos produtos. Este percentual é utilizado apenas como sugestão na inclusão de novos itens. Alterar este percentual NÂO altera os preços máximos dos produtos já cadastrados.
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.
PERCENTUAL_PRECO_VENDAPERCENT(18)Percentual para preço de venda:
Percentual utilizado para o cálculo do preço de venda a partir do custo.
Este percentual é utilizado apenas nos processos de atualização de preços a partir das telas de atualização ou do processo de formação de preços de venda.
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.
MARKUP_IDID(18)FK Markup:
Identifica o markup que deve ser utilizado para esta lista de preços.

Referência para MARKUPS
UTILIZAR_COMISSAO_LISTAFLAG(1)Rqd Utilizar comissão da lista:
Quando marcado com "Sim", o valor da comissão dos itens de pedido e/ou itens de documento será calculada com base na comissão definida para a lista de preço.

Valor padrão = N
COMISSAO_PADRAOPERCENT(18)Comissão padrão:
Valor de comissão padrão.
ENVIAR_LISTA_PRECOS_PALMFLAG(1)Rqd Força de vendas:
Indica se esta lista de preços é utilizada no sistema de força de vendas.

Valor padrão = N
NOTASTEXT_LONGNotas:
Texto livre para registro de informações pertinentes à lista de preços.
LISTA_BASE_IDID(18)FK Lista de base:
Quando informada, indica uma lista de preço na qual esta lista é baseada. Basear uma lista em outra permite repetir todos os produtos aplicando preço diferenciado, por exemplo, lista padrão + 10%.

Não é permitido informar uma lista de preços é baseada em outra lista de preços.

Referência para COLECOES
PERCENTUAL_LISTA_BASEPERCENT(18)Percentual sobre a lista de base:
Indica um percentual positivo ou negativo a ser aplicado sobre os preços da lista de base. Informado apenas para listas de preço que são baseadas em outra lista. Se desejar, por exemplo, criar uma lista de preços que represente a lista padrão com um desconto de 10%, então deve-se informar "-10".
TRATAMENTO_PROMOCOESOPTION(1)Rqd Tratamento das promoções:
Quando a lista de preços for baseada em outra, indica como as promoções deverão ser tratadas.

Valores permitidos:
  • N - Não trazer - Promoções da lista base não serão trazidas para a lista estendida.
  • A - Aplicar o mesmo percentual - As promoções serão trazidas para a lista estendida, aplicando o mesmo percentual da lista.
  • C - Copiar os mesmos preços - Os preços promocionais serão copiados literalmente para a lista estendida, indiferente do percentual da lista.

Valor padrão = N
PRODUTOS_ATIVOFLAG(1)Produtos ativos:
Utilizado apenas quando a coleção é baseada em outra. Neste caso, define como os produtos herdados serão inseridos: ativos ou não.

Valor padrão = S
PRIORIDADEINTEGER(3)Prioridade:
Determina a prioridade da lista de preço. Nas buscas pelo preço de um produto, as listas são pesquisados pela prioridade definida aqui. Tanto menor o número informado, maior a prioridade.

Valor padrão = 50
TODOS_ESTABELECIMENTOSFLAG(1)Rqd Todos estabelecimentos:
Define se esta lista de preços é visível para todos os estabelecimentos. Ao desmarcar esta opção, será necessário indicar quais os estabelecimentos que utilizarão a lista.

Valor padrão = S
DATA_FIM_DESENVOLVIMENTODATEFim de desenvolvimento:
Data planejada para encerramento das atividades de desenvolvimento dos modelos da coleção.Quando informada, o sistema aceita que se referencie o desenvolvimento de novos modelos e/ou produtos até a respectiva data. O prazo poderá ser prorrogado ou reduzido de acordo com os trabalhos realizados pelo setor de desenvolvimento.
DATA_ULTIMA_REQUISICAODATEÚltima requisição:
Data da última requisição de amostra para a coleção.

As coleções a serem listadas na tela de requisiçõesde amostra serão ordenadas em ordem decrescente de data para que sejam apresentadas primeiramente as coleções para as quais foram requisitadas amostras mais recentemente.

Este campo é atualizado automaticamente pelo sistema a cada requisição de amostra para a coleção.

DATA_ULTIMA_UTILIZACAODATEÚltima utilização:
Atributo atualizado automaticamente sempre que a coleção sofrer qualquer atualização ou se for emitido um dos relatórios da coleção.Este atributo serve para identificar coleções privadas que não estão sendo utilizadas.
DATA_ULTIMO_DESENVOLVIMENTODATEÚltimo desenvolvimento:
Data do último desenvolvimento de modelo para a coleção.

As coleções a serem listadas na tela de desenvolvimento de novos modelos serão ordenadas em ordem decrescente de data para que sejam apresentadas primeiramente as coleções para as quais foram desenvolvidos modelos mais recentemente.

Este campo é atualizado automaticamente pelo sistema a cada desenvolvimento de um novo modelo para a coleção.

DATA_ULTIMO_PEDIDODATEÚltimo pedido:
Data do último pedido para a coleção.

As coleções a serem listadas na tela de pedidos serão ordenadas em ordem decrescente de data para que sejam apresentadas primeiramente as coleções para as quais foram registrados pedidos mais recentemente.

Este campo é atualizado automaticamente pelo sistema a cada registro de pedido para a coleção.

ESTACAOTEXTEstação:
Indica se a coleção refere-se a calçados "outono-inverno" ou "primavera-verão".
QUANTIDADE_PRODUTOSTEXTQuantidade:
Uma quantidade de produtos padrão para os modelos/produtos 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).
USUARIO_IDID(18)FK Responsável:
Identifica o usuário que é "dono" desta coleção.

Referência para USUARIOS
ANOINTEGERAno:
O ano, juntamente com a estação, indica o período em que a coleção será comercializada para o consumidor final.
PROMOCIONALFLAG(1)Promocional:
Indica se esta é uma lista de preços promocional. Listas promocionais não são consideradas em algumas situações. Conforme configurações, por exemplo, listas promocionais são consideradas apenas para condições de pagamento SEM juros ou consideradas "A VISTA".

Valor padrão = N
TODOS_CLIENTESFLAG(1)Rqd Todos os clientes:
Define se esta lista de preços é visível para todos os clientes. Ao desmarcar esta opção, será necessário indicar quais os clientes que utilizarão a lista.

Valor padrão = S
TODOS_PLANOS_PAGAMENTOFLAG(1)Rqd Todos os planos de pagamento:
Indica se esta lista de preços pode utilizar todos os planos de pagamento cadastrados. Se este campo for desmarcado, então será necessário informar quais os planos de pagamento que são aceitos para a mesma.

Valor padrão = S
APLICAR_PERCENTUAL_DESCONTO_CLIENTE_PROMOCAOFLAG(1)Rqd Aplicar percentual de desconto do cliente na promoção:
Define que se utilizado o preço promocional deve utilizar ou não o desconto existente no cadastro do cliente, caso marcado "N" o preço promocional não sofrerá alterações pelo desconto.

Valor padrão = S
FUNCAO_VISUALIZACAO_IDID(18)FK Cargo/função para visualização:
Função de sistema que define quais os usuários que poderão visualizar a lista de preços e suas respectivas informações (itens/produtos, clientes, estabelecimentos, etc.). Caso não informada, qualquer usuário que tenha direito de acesso à interface poderá alterar a lista de preços.

Atenção
Os usuários que poderão realizar a manutenção na lista de preços, conforme função específica definida no campo "Função para manutenção", também deverão estar configurados, obrigatoriamente, na função de visualização da lista.

Referência para FUNCOES_SISTEMAS
FUNCAO_IDID(18)FK Cargo/função para manutenção:
Função de sistema que define quais os usuários que poderão alterar esta lista de preços (incluir, excluir ou alterar os produtos da lista de preços). Caso não informada, qualquer usuário que tenha direito de acesso à interface poderá alterar a lista de preços.

Atenção
Os usuários que poderão realizar a manutenção na lista de preços também deverão estar configurados, obrigatoriamente, na função de visualização da lista. Caso contrário, a lista de preços não será apresentada para os usuários, mesmo que possuam a função de manutenção da lista.

Referência para FUNCOES_SISTEMAS
CUSTOS_DIRETOSPERCENT(18)Custos diretos (%):
Percentual de custos diretos (originadas em despesas operacionais, administrativas, etc.) a ser considerado na formação de preços desta lista. Este atributo é utilizado nas listas de preços como parâmetro para o calculo do preço de venda.
FRETE_VENDAPERCENT(18)Frete nas vendas (%):
Percentual de frete a ser utilizado para a formação de preços de venda.
PERC_FRETE_VENDAS_ICMSPERCENT(18)Frete vendas ICMS %:
Percentual de crédito de ICMS sobre os fretes de saída, para a formação de preços de venda.
PERC_FRETE_VENDAS_PIS_COFINSPERCENT(18)Frete vendas PIS/COFINS %:
Percentual de crédito de PIS/COFINS sobre os fretes de saída, para a formação de preços de venda.
PERC_FRETE_VENDAS_GERALPERCENT(18)Frete vendas Geral %:
Percentual de crédito de PIS/COFINS/ICMS sobre os fretes de saída, para a formação de preços de venda.
UTILIZA_FORMACAO_PRECOSFLAG(1)Rqd Utiliza formação de preços:
Define se a lista de preços é utilizada na formação de preços.
Caso informado "Sim", os itens da lista de preço serão automaticamente incluídos na formação de preços.

Valor padrão = N
CASAS_DECIMAISINTEGERCasas decimais:
Número de casas decimais a serem usadas nos preços da lista.
Deve ser informado um número maior que zero e menor que dez.
CONTROLAR_QUANTIDADE_MINIMA_ESTOQUEFLAG(1)Rqd Controlar quantidade mínima em estoque:
Quando marcado, indica que se deseja controlar a quantidade mínima de produtos em estoque, permitindo:
  • Informar uma quantidade mínima para cada produto da lista de preços.
  • Emitir relatório comparando a quantidade mínima com a disponível em estoque para planejar compras.

Valor padrão = N
INCLUIR_DOCUMENTOS_MANUTECAO_FORMACAO_PRECOSFLAG(1)Rqd Considerar itens de entrada em manutenção:
Incluir os itens de documentos de entrada que estão em manutenção dos estabelecimentos marcados para cálculo do custo médio dos produtos na formação de preços de venda.

Valor padrão = N
TODOS_ESTABELECIMENTOS_FORMACAO_PRECOSFLAG(1)Rqd Todos estabelecimentos na formação de preços:
Considerar todos os estabelecimentos ativos como base para cálculo do custo médio utilizado na formação de preços de venda.

Valor padrão = S
USAR_SEQUENCIAOPTION(1)Rqd Usar sequência:
Permite definir se a lista de preços deve utilizar um campo sequência para definir a ordem com que os produtos devem ser apresentados.

coleca.colecoes.REMOVER_SEQUENCIAS - ERROR: Não foi possível encontrar um registro em COMPONENTES onde NOME_GLOBAL = COLECA.COLECOES.REMOVER_SEQUENCIAS!

Valores permitidos:
  • N - Não usar - A sequência não será apresentada no itens da lista e os produtos serão ordenados pela descrição do produto.
  • A - Automática - Os produtos serão ordenados conforme o número informado no campo "Sequencia". A sequência será sugerida na inclusão dos itens por padrão com o próximo número a partir da maior sequência informada nos itens (max+1). As sequências subsequentes serão automaticamente ajustadas quando a sequência de um item for alterada.

Valor padrão = N
USAR_PRECO_INDICADOOPTION(1)Rqd Usar preço indicado:
Define se pode ser informado o "Preço indicado" para os itens da lista.

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.

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.

Valores permitidos:
  • N - Não - O preço indicado não será utilizado (nem apresentado nas interfaces).
  • S - Opcional - O preço indicado será apresentado mas seu uso é opcional.
  • R - Requerido - O preço indicado será utilizado e será obrigatório o seu preenchimento.

Valor padrão = N
DESTINATARIO_IDID(18)FK Destinatário:
Pessoa que é utilizada para realização dos cálculos da formação de preços, caso não informado é utilizado o próprio estabelecimento.
Os impostos de saída (ICMS, PIS,COFINS) são calculados com base nesta pessoa e permitem que existam regras para Pessoas Físicas, Jurídicas Contribuintes(com IE) ou Jurídicas não contribuintes (sem IE).

Referência para PESSOAS
TODOS_TIPOS_PEDIDOSFLAG(1)Rqd Todos tipos de pedidos:
Permite definir se a coleção será utilizada para todos os tipos de pedidos.

Valor padrão = S
TIPO_FRETE_IDID(18)FK Tipo de Frete
Referência para INCOTERMS
COLECAO_VINCULADA_IDID(18)FK Coleção vinculada:
Lista de preços vinculada ou relacionada para as rotinas de formação de preços.
Quando informado e ocorrer uma atualização na formação de preços de um item da lista, a rotina de formação de preços irá atualizar todas as formações de preços das listas vinculadas.

Exemplo:
Produto X está na lista de preços VENDA e PROMOÇÃO, sendo que a lista PROMOÇÃO está vinculada a VENDA. Quando alterado o "item de documento vinculado" a formação da VENDA, deve atualizar automaticamente a PROMOÇÃO.

Referência para COLECOES
PERC_CREDITO_GENERICOPERCENT(18)Crédito Genérico %:
Percentual de crédito genérico a ser aplicado na composição da formação de preços. Este percentual é aplicado diretamente obre o "valor de compra da mercadoria" já considerados os créditos e débitos da operação.
PERCENTUAL_REBATEPERCENT(18)Percentual de rebate:
Informa qual será o percentual padrão de Rebate a ser utilizado para as vendas dos produtos desta lista de preço.
Este percentual não é copiado para os itens da lista mas deve ser utilizado sempre que o item não tem um percentual informado.
USA_TIPOS_ANUNCIOSFLAG(1)Rqd Usa tipos de anúncios:
Define se esta lista de preços pode receber tipos de anúncios.

Valor padrão = N
MULTIPLOS_ANUNCIOS_ITEMFLAG(1)Rqd Múltiplos anúncios por item:
Define se os itens da lista de preço podem receber anúncios.

Valor padrão = N

Regras

Copiar itens da coleção derivada

(Depois de inserir, Depois de alterar)
Se a lista-base for modificada, garante que os itens da coleção refletem os dados da coleção na qual ela é baseada.
A conferência é tratada em diversas situações:

Preencher moeda na lista estendida

(Antes de inserir, Antes de alterar)
Ao estender uma lista de preços, a moeda deve ser a mesma da lista base.

Excluir produtos

(Antes de excluir)
Caso o sistema esteja configurado com a preferência COLECA.COLECOES.EXCLUSAO_RAPIDA, ao excluir um produto, esta rotina exclui todos os produtos da lista de preços antes dela ser excluída!
Este método é executado com o objetivo de acelerar a exclusão em cascata.

Atualizar estabelecimentos da coleção

(Depois de inserir, Depois de alterar)
Caso informado para utilizar em todos os estabelecimentos, atualizar os registros em COLECOES_ESTABELECIMENTOS.

Atualizar listas derivadas

(Depois de alterar)
Ao alterar o campo "Usar sequência" da lista base, as listas derivadas também são alteradas.

Validar lista base

(Antes de alterar, Antes de inserir)
Valida a lista base informada:

Atualizar os itens da coleção

(Depois de alterar)
Ajusta atributos dos itens da coleção conforme alterações realizadas em sua capa:

Ajustar comissão padrão

(Antes de alterar)
Quando "Utilizar comissão da lista" for desmarcado, deve remover qualquer informação que estiver no campo "Comissão padrão".

Criar anúncios

(Depois de alterar)
Quando a lista de preço for marcada pra receber múltiplos anúncios a regra deve verificar seus itens se tem ou não anuncio padrão, caso não tenha, criar.

A data de fim da comercialização deve ser maior ou igual a data de início de comercialização!

A data de fim de comercialização deve ser menor ou igual a data de início de comercialização.

Não é permitido percentual abaixdo de -100%

(Antes de inserir, Antes de alterar)
Não é permitido que seja informado no atributo PERCENTUAL_LISTA_BASE um valor inferior a -100%

Lista de preço não pode ser utilizada para todos os clientes, pois já existem clientes vinculados!

(Antes de inserir, Antes de alterar)
A opção "Todos os clientes" não pode ser marcada, pois já existem clientes vinculados a lista de preços.

Validar lista de preços estendida

(Antes de inserir, Antes de alterar)
Validar se a lista de preços estendida pode ser utilizada.

Validar casas decimais

(Antes de inserir, Antes de alterar)
Não é permitido informar casas decimais negativas ou maiores que 10.

Atualizar lista de preços da pessoa(campo, pessoa_id)

Atualiza a lista de preços da pessoa.

busca(produto_id, colecao_id)

Busca uma coleção valida

Colecao Produto e Pedido(produto_id, pedido_id)

Função deve retornar o id da coleção utilizando como base o produto e o pedido.

Coleção do produto na pessoa(produto_id, pessoa_id)

Busca qual é a coleção para o produto nesta pessoa.
Retorna: Númmero ID da coleçcão

colecao Produto Pessoa Estabelecimento(produto_id, pessoa_id, estabelecimento_id)

Retornar o Id da coleção a ser utilizada para estes parametros produto, pessoa e estabelecimento

Retornar se a coleção é válida

Retorna se a coleção é válida.

Coleções da pessoas(pessoa_id, estabelecimento_id)

Função deve retornar uma String contendo as listas de preços permitidos para um cliente.Deve possuir as listas de preços da empresa e estabelecimento, além das listas do cliente, caso existam.

Coleções para produtos da pessoas(pessoa_id, estabelecimento_id, produto_id)

Função deve retornar uma String contendo os valores de lista de preços permitidos para um cliente.Deve possuir os valores de Lista de preços da empresa e estabelecimento, além dos valores para cliente.

Consulta a situação da coleção

A situação de uma coleção é atribuída automaticamente conforme o preenchimento dos dados da mesma. Pode ter os seguintes valores:

Copiar coleção(colecao_id)

Método que copia a coleção e seus itens e retorna o identificador desta nova coleção (clone).

Enviar modificações da lista por e-mail

Enviar para os usuários responsáveis as alterações realizadas na lista de preços.

Pesquisar item(produto, quantidade)

Retorna um item válido para o produto/quantidade.
Caso a coleção não esteja válida ou produto não encontrado, então retorna NULL.

Pesquisar preço(produto, quantidade, cliente, estabelecimento, promocoes, moeda, categoria, tipo_pedido, tipo_frete)

Pesquisa o item de lista de preço a ser utilizado para um produto.
Este método apenas localiza a lista de preços e o item da mesma que deverá ser utilizado em uma determinada condição.

Esta rotina considera elementos que estão relacionados a consulta às listas de preço, tais como:

A rotina retorna o item da lista de preço, o que agrega informações como quantidades mínimas, preço mínimo, preço máximo, descontos, comissões, identificação da lista utilizada, etc.

ATENÇÃO

Esta função retorna o preço de lista mas não trata descontos especiais determinados para o cliente ou ajustes do preço em função de um fator de correção de um plano de pagamento.

Pesquisar preço(elemento_base, produto, quantidade, quantidade_inserida, bloco_base)

Permite pesquisar um preço para um determinado produto conforme a quantidade informada.

Ver preferência COLECA.COLECOES.SISTEMA_PESQUISA

OBS: Se a lista de preço tiver quantidade promocional informada será sugerido o preço promocional apenas se o campo Considera promoções do tipo de pedido estiver marcado (valor "S")

Preço do item para o cliente(produto_id, cliente_id)

A função deve retornar o preço do produto, verificando todas as listas de preços que podem ser usadas pelo cliente.

Preco do item na coleção(produto_id, colecao_id)

Processar memorial do calculo de preço(texto)

Função que permite editar o texto de memorial descritivo do calculo do preço, removendo algumas linhas.
Esta função lê a preferência COLECA.COLECOES.SCRIPT_MEMORIAL_CALCULO_PRECO e processa o texto de acordo com o que tem ali.

Retorne coleção(produto_id, documento_id)

Função deve retornar o ID da coleção que deve ser utilizada.