Texto que descreve o produto. Este é o texto utilizado por padrão em todos os documentos fiscais e interfaces de uso interno.
Texto livre com uma descrição complementar detalhada do produto. Esta descrição pode acrescentar característcas diversas como peso, dimensões, composição, aplicação, etc.
Nome da marca.
Ex:
COCA-COLA
PEPSI
FRUKI
Código de referência do produto usado pelo fabricante.
Observações adicionais sobre o item de pedido. Esta informação será repassada para o documento conforme configurado no campo "Incluir observações itens pedidos" da natureza de operação.
Informações adicionais para o produto, é apresentado conforme customizado pela preferência ORCCOM.CAD_ITENS_COMPRA.OBSERVACOES_ADICIONAIS.SCRIPT.
Quantidade de produtos a serem compradas.
Unidade de medida utilizada para a quantidade.
O valor unitário é preenchido automaticamente quando existe um referência para o produto e o fornecedor informado na OC. Será utilizado o preço ou o custo de reposição informados na referência fornecedor. A preferência ORCCOM.CAD_ITENS_COMPRA.ORIGEM_PRECO: Determina como será feita a preço do produto para inserir como sugestão no campo Preço unitário
G: Geral - retorna o preço que tem a data de atualização mais recente em REFERENCIAS_PRODUTOS_PESSOAS.
E: Estabelecimento - retorna o custo com data de atualização mais recente em PRODUTOS_PESSOAS_ESTABELECIMENTOS, se não encontrar um custo por estabelecimento, retorna o preço que tem a data de atualização mais recente em REFERENCIAS_PRODUTOS_PESSOAS (situação atual)
SELECT...: É possível informar uma expressão SQL que receberá 2 parâmetros: ${pedidoId} e ${produto} e retorne uma única coluna com o preço informado.
Ex:
select ppe.valor_custo_reposicao as valor
from pedidos ped
join PRODUTOS_PESSOAS_ESTABELECIMENTOS ppe on ppe.pessoa_id = ped.fornecedor_id
and ppe.estabelecimento_id = ped.estabelecimento_id
join produtos p on p.id = ppe.produto_id
where ped.id = ${pedido_id}
and p.produto = '${produto}'
order by data_atualizacao_custo desc
limit 1
Valor total do item considerando o valor unitário e a quantidade pedida para o item. Não é considerado o desconto informado diretamente no pedido.
Sub total do item.
Percentual de IPI
Valor percentual de alíquota para o IPI
Valor de IPI para o item considerando apenas o produto. Este valor não inclui o IPI referente ao frete do pedido. A soma do IPI dos itens pode não ser igual à soma do IPI de todo o pedido.
% de MVA para cálculo da Substituição Tributária do ICMS. Para utilizar o percentual do tipo de produto marque a opção de ORCCOM.CAD_ITENS_COMPRA.USAR_MVA_TIPO_PRODUTO, caso contrário deve existir regras de SUBST para o produto ou tipo de produto.
Valor de ICMS ST para o item.
Cancelar
Quantidade solicitada que ainda não foi entregue e nem cancelada. A quantidade pendente é calculada da seguinte forma:
No caso de quantidade entrega maior do que a quantidade solicitada, a quantidade pendente será sempre 0.
Valor de quantidade temporária (será utilizada para realizar a próxima saída/faturamento). Deve ser usada para realizar a entrega parcial. Obrigatoriamente deve ser preenchido com o valor pendente. A quantidade é automaticamente atualizada quando ocorrer alteração da quantidade ou quando a preferencia PEDIDOS.ITENS_PEDIDOS.ATUALIZAR_QUANTIDADE_TEMPORARIA estiver ativa e ocorrer alteração na quantidade pendente.
Quantidade reservada para o próximo faturamento. Este campo de quantidade é automaticamente atualizada quando ocorrer alteração da quantidade ou quando a preferencia PEDIDOS.ITENS_PEDIDOS.ATUALIZAR_QUANTIDADE_TEMPORARIA estiver ativa e ocorrer alteração na quantidade pendente.
Quantidade de produtos já entregues para o destinatário do pedido. Este valor é atualizado automaticamente através dos registros de entregas. Note que, dependendo da tolerância informada no respectivo tipo de pedido, é possível entregar uma quantidade maior do que a quantidade do pedido.
Domínio utilizado para armazenar valores monetários.
Quantidade fornecida acima da quantidade pedida. A quantidade fornecida acima da quantidade pedida é calculada da seguinte forma: quantidade acima da quantidade pedida = quantidade entregue - quantidade pedida
Quantidade de produtos que foi cancelada por desistência ou por divergência comercial. Quando um item é parcialmente entregue e o cliente não desejar que o saldo seja entregue, então este saldo deve ser cancelado.
Situação específica deste item.
Pendente - O ítem ainda não foi entregue e não está cancelado.
Aprovado - Item de pedido aprovado para ser executado.
Em execução - Item está em execução.
Pronto - O item do pedido está pronto para ser entregue, somente será considerado caso informado a quantidade efetiva e data de termino preenchida.
Entregue - O ítem já foi entregue.
Qualificado - Identifica que o cliente sinalizou que o produto/serviço entregue estava em conformidade com a qualidade esperada.
Cancelado - O ítem foi cancelado.
Perdido - Foi informada uma data de perda. Indica que o item não poderá mais ser atendido. Equivale ao cancelado.
Classificação/curva ABC dada para informar a importância do produto no cenário de vendas. Apresenta a classificação informada no cadastro por estabelecimento, caso não tenha informado apresenta a classificação genérica do produto.
Peso líquido total dos produtos deste item expresso em quilogramas.
Cubagem total em m3 do produto, considerando a cubagem informada no cadastro do produto e a quantidade pedida.
Domínio utilizado para identificar todo os registros da base de dados. Todas as entidades possuem uma chave primária deste tipo.
Em condições normais, atributos deste domínio não são apresentados na Interface.
Informações sobre a cotação e/ou solicitação que originaram esta ordem de compra, se houver. As informações contidas neste campo podem ser customizadas por script.
Item do pedido de venda que está vinculado ao item de compra. Campo é aresentado somente quando informado a preferência ORCCOM.CAD_ITENS_COMPRA.SQL_PEDIDO_VENDA
Identificação ou numeração do pedido. A numeração do pedido pode ser gerada automaticamente conforme regra estabelecida no tipo de pedido. O número do pedido é único dentro da mesma série e versão, independente de seu tipo. Isso significa, por exemplo, que não podemos ter um pedido de venda com o mesmo número de uma ordem de compra.
Sequência do item no pedido.
Domínio utilizado para identificar todo os registros da base de dados. Todas as entidades possuem uma chave primária deste tipo.
Em condições normais, atributos deste domínio não são apresentados na Interface.
Motivo ou justificativa do cancelamento do item de pedido.
Ex:
DESISTÊNCIA DO CLIENTE
SEM ESTOQUE
PREÇO ELEVADO
valor unitário do item considerando os impostos (IPI+ST)
valor total do item considerando os impostos (IPI+ST)
Em caso de compra é permitido realizar uma tarifa adicional livre. No caso de pedidos de produção este campo é utilizado para informar o valor de serviço prestado pelo terceiro.
Código de referencia para importação dos produtos, caso informado obrigatoriamente deve preenchido o campo de descrição do item de pedido.
Data prevista para realização da entrega do item do pedido. Caso exista mais uma de data prevista par ao mesmo produto, deve ser realizado a separação do item.
Data em que está previso o faturamento deste item de pedido.
Script com as documentos onde o item da ordem de compra foi vinculado.
Sub-item de NFE importada
Item de NFE importada
Sub-item de item de documento
Item de documento.
Lista com os interesses que este registro é baseado
Marca de produtos.
Tipo de produto.
Recebe o valor "S" ou "N". Na interface é representado por um check-box que quando selecionado representa o valor "S". Nas telas de query, a interface utiliza uma pop-list com as opções "Sim", "Não" e em branco (nulo).
Propriedades (format)
label-suffix
Quando informado "label-suffix:true", o label aparece no lugar do sufixo, ou seja, após o check-box. Por padrão, o label aparece sempre à esquerda do check-box.
multi-row-check
Quando informado "multi-row-check:true", define que em telas Multi Row terá um "checkbox" no top da lista onde é possível marcar e desmarcar todos campos correspondentes.
Classificação do produto
Produtos cadastrados a partir de
?
S/Estoque(Pendência)
Zerados
C/Estoque
Comparar com outros fornecedores, fabricantes, marcas.
Modelo de ordenação dos itens sugeridos
Código produto
Descrição do produto
Referência fabricante
Classificação dos produtos
Unificar informações de outros estabelecimentos.
Apenas o estabelecimento da ordem de compra - Apenas as informações do estabelecimento do pedido de compra serão filtrados/pesquisados
Unificar informações dos estabelecimentos da empresa - Apenas as informações dos estabelecimentos vinculados a empresa do pedido de compra serão filtrados/pesquisados
Unificar informações de todas empresas - Todas as informações dos estabelecimentos cadastrados serão filtrados/pesquisados
Produto (tempo aproximado para atendimento do pedido: 0 dias)
Define o procedimento que deve ser realizado no interesse vinculado
Remover vinculo
Liberar e cancelar interesse
Cancelar compra e interesse
Quantidade a ser ajustada no interesse
Quantidade que deve ser desmembrado
Valor unitário que foi desmembrado
Define se deve gerar um novo pedido para o desmembramento
Apresenta uma lista com os registros que atendem aos filtros informados. A lista possui diversos recursos práticos e importantes para o usuário:
Clique no link apresentado na primeira coluna para acessar um registro específico. Você também pode usar as teclas (seta para baixo) e (seta para cima) para navegar entre os registros apresentados para acessá-lo.
Normalmente, o cursor fica ativo no link do primeiro registro, ou no registro que estava sendo acessado no caso do usuário voltar para a lista após acessar um registro específico.
É possível reordenar a lista clicando no título da coluna desejada. Clicar no título de uma coluna que já está sendo ordenada, inverte o sentido da ordenação (ascendente/descendente). Clicar no link juntamente com a tecla SHIFT, acrescenta a coluna à ordenação já imposta, permitindo ordenar primeiro por uma coluna e segundo por outra.
Ao clicar no ícone de agrupamento, a lista é refeita apresentando todas as informações totalizáveis dos registros agrupados pela respectiva coluna.
No canto superior direito da tabela com a lista, existe um ícone que, ao ser clicado, abre um pequeno menu que permite o usuário configurar a tabela.
No menu de configuração da tabela, o usuário pode escolher quais colunas devem ser apresentadas e em que posição.
No menu de configuração da tabela, o usuário pode gerar uma pivot da mesma.
Antes da lista, são apresentados os filtros aplicados. Cada filtro possui um pequeno "x" que pode ser utilizado para exclui-lo. Ao fazer isso, a lista é automaticamente atualizada.
Permite criar novos registros no sistema. Ao ser executado, o sistema apresenta um formulário com todos os campos do registro que deverão ser preenchidos. Quando todos os campos desejados estiverem preenchidos, clique em [b:Salvar].
A partir da tela de consulta de um registro, esta operação permite alterar os dados do mesmo. O sistema abre um formulário com os campos editáveis. Após alterar os campos, o usuário deverá clicar em [b:Salvar].
A partir da tela de consulta de um registro, esta operação permite alterar os dados do mesmo. O sistema abre um formulário com os campos editáveis. Após alterar os campos, o usuário deverá clicar em [b:Salvar].
Permite criar novos registros no sistema. Ao ser executado, o sistema apresenta um formulário com todos os campos do registro que deverão ser preenchidos. Quando todos os campos desejados estiverem preenchidos, clique em [b:Salvar].
Exclui o registro selecionado. A exclusão do registro pode ser disparada a partir da tela de consulta e/ou de manutenção do mesmo. O registro somente será excluído se todas as condições necessárias forem encontradas, gerando um erro, caso alguma destas condições não estiver sendo atendida. Topo
Sugestão
Apresenta a sugestão de compras de produtos do fornecedor da ordem de compra. Os produtos apresentados na sugestão de compras serão apenas os produtos referenciados ao fornecedor, caso o produto não possua a referência criada para o fornecedor da OC, ele não será apresentado. As referências do fornecedor são criadas ao incluir itens no documento de entrada.
Cálculo da média de vendas
Quantidade movimentada = soma da quantidade de operações de saída em documentos do produto nos últimos 3 meses e do mês atual.
Média de saídas do período = média de vendas do período, dividida pela quantidade de dias do período, multiplicada por 30 (aproximado).
Previsão =
Utilizando média, é calculado uma previsão para estoque conforme a classificação do produto mais o tempo para recebimento do produto. MEDIA_DIA = (D1 + D2 + D3 + D4) / DIAS MEDIA_GERAL = (MEDIA_DIA) * 30 Exemplo: MEDIA_DIA = ( 90[Out] + 170[Nov] + 112[Dez] + 301[Jan] )/ 102 = 6,59 MEDIA_GERAL = 6,59 * 30 = 197,94 = 198
Cálculo da previsão de consumo/venda
PREVISAO = (MEDIA_DIA) * (DIAS PARA ESTOQUE DA CLASSIFICAÇÃO + TEMPO ATENDIMENTO DO FORNECEDOR) Exemplo: PREVISAO = (6,59) * (30+30) = 395,40
Cálculo da sugestão de compra
SUGESTAO = PREVISAO - ESTOQUE ATUAL - QUANTIDADE EM ORDEM COMPRA - QUANTIDADE EM PROCESSO DE LIBERAÇÃO Exemplo: SUGESTAO = 395,40 - (-121) - 52 - 0 = 464.40 = 464
Preço
Preço definido na guia "Ref. fornec." do produto.
% IPI
IPI definido na tributação do produto ou dos respectivo tipo de produto.
% MVA
ST do produto, definido no tipo de produto (campo "% MVA intraestadual").
A consulta de um registro é realizada quando o usuário clica no primeiro link de um dos registros resultantes a operação [b:Listar]. A tela apresenta as informações detalhadas do registro, bem como as ações que o usuário pode disparar a partir dele (alterar, excluir, cancelar, etc.).
Tela para realizar o desmembramento do item de serviço. O item terá o valor ou quantidade reduzidos, e criado um novo registro com o valor informado. Exemplo:
Item de serviço, com quantidade 1 e valor de 100.000,00.
Ao executar a rotina, foi informado o valor de 25.000,00; como resultado:
Ao pesquisar, o usuário poderá informar critérios de filtro para listar apenas os registros desejados. Normalmente depois de informar os filtros desejados, o usuário deverá executar a operação [b:Listar]. Obtenha maiores detalhes em Como utilizar a tela de pesquisa?. Comportamento:
Aplicar o MVA ajustado na operação de ordem de compra
Preferencia define se deve ser aplicado o MVA ajustado no momento que o sistema calcula o percentual de ICMS-ST para a operação. Ela é utilizada somente quando a preferencia ORCCOM.CAD_ITENS_COMPRA.USAR_MVA_TIPO_PRODUTO estiver marcada(S).
Quando marcado é realizado o ajuste do percentual informado no tipo de produto conforme as regras:
Define se deve apresentar um link para os dois últimos documentos de entrada do item.
Valor padrão: S
ORCCOM.CAD_ITENS_COMPRA.CALCULAR_ICMS_ST
Calcular o valor de ICMS-ST na operação de compra
Calcula o valor de ICMS-ST na operação de compra.
Tipo: FLAG
Valor padrão: S
ORCCOM.CAD_ITENS_COMPRA.DESTACAR_SITUACAO
Destacar itens pendentes
Destaca com cor diferenciada os itens de pedidos de compra (ordens de compra) pendentes.
Tipo: TEXT
Valor padrão: S
ORCCOM.CAD_ITENS_COMPRA.FILTRO_ESTABELECIMENTO
Valor padrão para o campo de filtro para estabelecimento
Valor padrão para o campo estabelecimento na operação de [b:Sugestão].
Valores:
N
Apenas o estabelecimento da ordem de compra: Apenas as informações do estabelecimento do pedido de compra serão filtrados/pesquisados
E
Unificar informações dos estabelecimentos da empresa: Apenas as informações dos estabelecimentos vinculados a empresa do pedido de compra serão filtrados/pesquisados
M
Unificar informações de todas empresas: Todas as informações dos estabelecimentos cadastrados serão filtrados/pesquisados
Tipo: TEXT
Valor padrão: N
ORCCOM.CAD_ITENS_COMPRA.FILTRO_SUGERIDO_ESTOQUE
Filtro adicional para estoque do produto
Filtro SQL adicional para filtrar o estoque atual do produto, a entidade base é "ep" = estoques_produtos.
Tipo: TEXT
ORCCOM.CAD_ITENS_COMPRA.INFORMAR_FATOR_CONVERSAO
Informar o fator de conversão do fornecedor
Define se deve ser apresentado o fator de conversão da unidade de medida do produto para a unidade de medida do produto para o fornecedor conforme informado na guia "Ref Fornec" (Referências de produtos para fornecedores) do Produtos.
Tipo: FLAG
Valor padrão: N
ORCCOM.CAD_ITENS_COMPRA.INFORMAR_SUGESTAO
Define se deve preencher o campo de quantidade sugerida com a quantidade calculada.
Marcado (valor = S): Preenche a quantidade informada com a sugestão.
Desmarcado (valor = N): Não preenche o campo de quantidade sugerida (permite ao usuário preenchê-lo manualmente) e é apresentada a quantidade sugerida calculada em coluna específica.
Tipo: TEXT
Valor padrão: S
ORCCOM.CAD_ITENS_COMPRA.ORIGEM_PRECO
Origem preço
Determina como será feita a preço do produto para inserir como sugestão no campo Preço unitário
G: Geral - retorna o preço que tem a data de atualização mais recente em REFERENCIAS_PRODUTOS_PESSOAS.
E: Estabelecimento - retorna o custo com data de atualização mais recente em PRODUTOS_PESSOAS_ESTABELECIMENTOS, se não encontrar um custo por estabelecimento, retorna o preço que tem a data de atualização mais recente em REFERENCIAS_PRODUTOS_PESSOAS (situação atual)
SELECT...: É possível informar uma expressão SQL que receberá 2 parâmetros: ${pedidoId} e ${produto} e retorne uma única coluna com o preço informado.
Ex:
select ppe.valor_custo_reposicao as valor
from pedidos ped
join PRODUTOS_PESSOAS_ESTABELECIMENTOS ppe on ppe.pessoa_id = ped.fornecedor_id
and ppe.estabelecimento_id = ped.estabelecimento_id
join produtos p on p.id = ppe.produto_id
where ped.id = ${pedido_id}
and p.produto = '${produto}'
order by data_atualizacao_custo desc
limit 1
Tipo: TEXT_LONG
Valor padrão: E
ORCCOM.CAD_ITENS_COMPRA.PESQUISA_PRODUTO
Interface para LOV de produtos
Define qual deve ser a interface que deve abrir ao clicar na lupa do campo de produtos. P.ex.:
SQL para apresentar histórico de compras do produto
SQL utilizado para apresentar o histórico de compras do produto. Quando informado, este campo representa um script que gera informações adicionais sobre este produto. Normalmente, esta preferência é utilizada para apresentar o histórico de compras realizadas para o fornecedor da respectiva ordem de compra, mas pode ser utilizada para agregar qualquer outra informação neste contexto.
A configuração da preferência pode ser realizada por estabelecimento, permitindo contextualizar as informações de acordo com as necessidades de cada empresa. O preenchimento deve seguir a sintaxe do Telescope Script Engine que deve utilizar as seguintes variáveis de contexto (macros):
${produto}: Código do produto informado na tela.
${pedido_id}: ID do pedido que está sendo realizado.
SQL para apresentar os pedidos de venda para vínculo no pedido de compra
SQL para apresentar os pedidos de venda para vínculo no pedido de compra. Caso não informado o campo não será apresentado. Serão aceitos os parâmetros:
PRODUTO_ID: ID do produto.
PEDIDO_ID: ID do pedido de compra.
Exemplo:
select ip.id
, pedido||' - '|| ip.sequencia ||' - '|| clie.nome_completo
from itens_pedidos ip
inner join pedidos p on p.id = ip.pedido_id
inner join pessoas clie on clie.id = p.cliente_id
inner join tipos_pedidos tp on tp.id = p.tipo_pedido_id
left join itens_pedidos ipcompra on ipcompra.item_pedido_venda_id = ip.id
where tp.categoria in ('V')
and ip.produto_id = ${PRODUTO_ID}
and ipcompra.item_pedido_venda_id is null
Tipo: SOURCE_CODE
ORCCOM.CAD_ITENS_COMPRA.SUGESTAO_ORDENACAO
Ordenação dos itens
Define a ordenação da listagem dos itens da sugestão de compras.
Opções:
- Produto: Código do produto = Id produto
- Descrição do produto: Descrição do produto + descrição detalhada (aplicação)
- Referência do fornecedor:
- Classificação dos produtos:
Tipo: TEXT
Valor padrão: 1
ORCCOM.CAD_ITENS_COMPRA.USAR_MVA_TIPO_PRODUTO
Aplicar MVA do tipo de produto nos itens de OC
Aplica o MVA que está informado nos Tipos de produtos e/ou serviços como base para cálculo do ICMS ST nos produtos das ordens de compra.
Utilizar estoque disponível para sugestão de compra
Caso marcado será utilizado o estoque disponível para cálculos de sugestão de compra. Caso desmarcado será utilizado o estoque atual do produto.
Tipo: FLAG
Valor padrão: S
Regras
Ajustar historico de compras
Apresenta as ultimas vendas feitas pelo cliente do pedido para o produto selecionado. A apresentação é feita pela preferencia "ORCCOM.CAD_ITENS_COMPRA.SQL_HISTORICO_COMPRAS". Caso a preferencia acima esteja vazia ou não exista, não será apresentado o campo "historico de compras". Eventos que disparam esta regra:
Antes de apresentar uma tela formulário "Alterar"
Ao alterar campo "Produto" do formulário "Alterar"
Ao alterar campo "Produto" do formulário "Novo"
Ao alterar campo "Produto" do formulário "Novo (vários)"
Apresentar informações adicionais
Interpreta o script ORCCOM.CAD_ITENS_COMPRA.OBSERVACOES_ADICIONAIS.SCRIPT e apresenta o resultado na tela. Eventos que disparam esta regra:
Antes de apresentar cada registro formulário "Alterar"
Antes de apresentar cada registro formulário "Consultar"
Antes de apresentar uma tela formulário "Novo"
Ao alterar campo "Produto" do formulário "Novo"
Apresentar informações do produto
Apresenta as informações sobre o produto:
Preço unitário
Unidade de medida
% de IPI
% de MVA
As informações são preenchidas quando o códifo do produto é informado ou alterado. O sufixo do campo quantidade é atualizado com a unidade de medida do produto. O preço do produto é sugerido conforme configurado na preferência abaixo:
Determina como será feita a preço do produto para inserir como sugestão no campo Preço unitário
G: Geral - retorna o preço que tem a data de atualização mais recente em REFERENCIAS_PRODUTOS_PESSOAS.
E: Estabelecimento - retorna o custo com data de atualização mais recente em PRODUTOS_PESSOAS_ESTABELECIMENTOS, se não encontrar um custo por estabelecimento, retorna o preço que tem a data de atualização mais recente em REFERENCIAS_PRODUTOS_PESSOAS (situação atual)
SELECT...: É possível informar uma expressão SQL que receberá 2 parâmetros: ${pedidoId} e ${produto} e retorne uma única coluna com o preço informado.
Ex:
select ppe.valor_custo_reposicao as valor
from pedidos ped
join PRODUTOS_PESSOAS_ESTABELECIMENTOS ppe on ppe.pessoa_id = ped.fornecedor_id
and ppe.estabelecimento_id = ped.estabelecimento_id
join produtos p on p.id = ppe.produto_id
where ped.id = ${pedido_id}
and p.produto = '${produto}'
order by data_atualizacao_custo desc
limit 1
O % de IPI é obtido das tributações do produto ou, caso não encontrar, do NCM do produto. O percentual de alíquota para ST (MVA) Os de percentual de MVA para uso na ST são obtidos dos seguintes campos:
ICMS Fornecedor (inter): Utilizado os valores da entidade REGIOES_ICMS
MVA intraestadual (mva): Utilizado o valor existente no tipo de produto.
% ICMS intraestadual (intra): Utilizado o valor existente no tipo de produto.
Calculo:
((100+mva)*(100-inter)/(100-intra)-100)
Observações:
Quando o valor existente em (intra) for inferior ao (inter), o valor de intra será igualado ao inter.
Somente serão calculados itens que possuírem o valor de (mva) informado e superior a zero.
Quando não localizado ou não informado o percentual de (intra) será considerado o percentual 12.
