Sistema de ordem de compra

Índice

Itens de cotação de compra

ORCCOM.CAD_PEDIDOS_COTACOES_ITENS

Descrição

Interface para manutenção de itens da cotação de compra

Esta interface é usada em diferentes guias do sistema. Clique nos links de navegação abaixo para obter maiores informações.

Cadastro de pedidos de cotação:

Campos:

Sequência do item no pedido.
Código ou identificação do produto.
Texto que identifica (nome) o produto. Este é o texto utilizado por padrão em todos os documentos fiscais e interfaces de uso interno.
Por padrão é aconselhado o tamanho máximo de 120 caracteres, para não permitir descrições maiores modifique a preferencia PROD.PRODUTOS.VALIDAR_PRODUTO_DESCRICAO
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.
Quantidade de produtos (mercadorias ou serviços) solicitada pelo cliente.
Não é permitido informar quantidades menores que zero.
Somente é permitido informar quantidade zero caso definido no campo Permite itens com quantidade zerada do respectivo tipo de pedido.
Representação abreviada da unidade de medida. P. ex.: kg = quilograma, cx = caixa, m² = metro quadrado.
O valor unitário é preenchido automaticamente quando existe um referência para o produto e o fornecedor informado na cotação.
Será utilizado o preço ou o custo de reposição informados na referência fornecedor.

A preferência ORCCOM.CAD_PEDIDOS_COTACOES_ITENS.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
% 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.
Quantidade solicitada que ainda não foi entregue e nem cancelada.
A quantidade pendente é calculada da seguinte forma:
quantidade pendente = quantidade solicitada - quantidade entregue - quantidade cancelada
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.
Quantidade reservada para o próximo faturamento.
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.
Sub total do item apresentado na LIST
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.
  • 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.
Apresenta as últimas compras feitas do produto informando para o cliente do pedido.
A apresentação é configurada na preferência ORCCOM.CAD_PEDIDOS_COTACOES_ITENS.SQL_HISTORICO_COMPRAS.
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.

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)
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.

Operações

Topo

Listar

Apresenta uma lista com os registros que atendem aos filtros informados.
A lista possui diversos recursos práticos e importantes para o usuário:
Comportamento:Topo

Novo

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].
Comportamento:Topo

Alterar

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].
Comportamento:Topo

Alterar

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].
Comportamento:Topo

Excluir

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

Consultar

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.).
Comportamento:Topo

Cancelar

Cancela o item consultado.
Somente apresentado quando o item não está totalmente cancelado ou entregue.
Topo

Pesquisar

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:

Dúvidas frequentes

  • Como configurar um SQL para histórico de compras na inclusão de itens de uma ordem de compra?
  • Como o valor do item/produto é preenchido automaticamente na Ordem de Compra?
  • Configurações

    ORCCOM.CAD_PEDIDOS_COTACOES_ITENS.APLICAR_MVA_AJUSTADO_REGRAS

    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_PEDIDOS_COTACOES_ITENS.USAR_MVA_TIPO_PRODUTO estiver marcada(S).

    Quando marcado é realizado o ajuste do percentual informado no tipo de produto conforme as regras:


    Exemplo:
    • MVA do tipo de produto: 50%
    • Estado de origem: SP
    • Estado de destino: RS
    • Percentual de ICMS da operação entre SP para RS: 12%
    • Percentual de ICMS interno para o RS neste produto: 17,5%
    • Calculo:
    ((100+mva)*(100-inter)/(100-intra)-100) 
    ((100+50)*(100-12)/(100-17.5)-100) = ((150)*(88)/(82.5)-100) = (150*1,0666667-100) = 60%
    
    • MVA ajustado nesta operação é 60%.

    Tipo: FLAG

    ORCCOM.CAD_PEDIDOS_COTACOES_ITENS.APRESENTA_ULTIMOS_DOCUMENTOS

    Define se deve apresentar um link para os dois últimos documentos de entrada do item.

    Valor padrão: S

    ORCCOM.CAD_PEDIDOS_COTACOES_ITENS.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_PEDIDOS_COTACOES_ITENS.DESTACAR_SITUACAO

    Destacar itens pendentes

    Destaca com cor diferenciada os itens de pedidos de cotação pendentes.

    Tipo: TEXT

    Valor padrão: S

    ORCCOM.CAD_PEDIDOS_COTACOES_ITENS.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:
    NApenas o estabelecimento da cotação: Apenas as informações do estabelecimento do pedido de cotação serão filtrados/pesquisados
    EUnificar informações dos estabelecimentos da empresa: Apenas as informações dos estabelecimentos vinculados a empresa do pedido de cotação serão filtrados/pesquisados
    MUnificar informações de todas empresas: Todas as informações dos estabelecimentos cadastrados serão filtrados/pesquisados


    Tipo: TEXT

    Valor padrão: N

    ORCCOM.CAD_PEDIDOS_COTACOES_ITENS.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_PEDIDOS_COTACOES_ITENS.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_PEDIDOS_COTACOES_ITENS.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_PEDIDOS_COTACOES_ITENS.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.:

    Tipo: TEXT

    Valor padrão: PROD.CAD_PRODUTOS

    ORCCOM.CAD_PEDIDOS_COTACOES_ITENS.SQL_HISTORICO_COMPRAS

    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 cotação 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.

    Ver também:

    Tipo: TEXT_LONG

    ORCCOM.CAD_PEDIDOS_COTACOES_ITENS.SQL_PEDIDO_VENDA

    SQL para apresentar os pedidos de venda para vínculo no pedido de cotação

    SQL para apresentar os pedidos de venda para vínculo no pedido de cotação. 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 cotação.

    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_PEDIDOS_COTACOES_ITENS.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 detalhada (aplicação):
    • Referência do fornecedor:

    Tipo: TEXT

    Valor padrão: 1

    ORCCOM.CAD_PEDIDOS_COTACOES_ITENS.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.

    Ver também:

    Tipo: FLAG

    Valor padrão: N

    ORCCOM.CAD_PEDIDOS_COTACOES_ITENS.UTILIZAR_ESTOQUE_DISPONIVEL

    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 últimas vendas feitas pelo cliente do pedido para o produto selecionado. A apresentação é feita pela preferência ORCCOM.CAD_PEDIDOS_COTACOES_ITENS.SQL_HISTORICO_COMPRAS.

    Caso a preferência acima esteja vazia ou não exista, não será apresentado o campo "histórico 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"

    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ódigo do produto é informado ou alterado.

    O sufixo do campo quantidade é atualizado com a unidade de medida do produto.

    O preço do produto é atualizado com a primeira das seguintes informações:

    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.

    Ver preferências:
    Eventos que disparam esta regra:
    • Ao alterar campo "Produto" do formulário "Novo"

    Apresentar itens de pedido de venda

    Apresenta os itens de pedido de venda que podem ser vinculados ao pedido de cotação.
    Ver preferência: ORCCOM.CAD_PEDIDOS_COTACOES_ITENS.SQL_PEDIDO_VENDA
    Eventos que disparam esta regra:
    • Antes de apresentar uma tela formulário "Alterar"
    • Antes de apresentar uma tela formulário "Novo"
    • Ao alterar campo "Produto" do formulário "Novo"

    Apresentar lupa do cadastro de produtos

    Eventos que disparam esta regra:
    • Antes de apresentar cada registro formulário "Alterar"
    • Antes de apresentar cada registro formulário "Alterar"
    • Antes de apresentar cada registro formulário "Novo"

    Bloquear edição de itens entregues

    Verifica a situação dos itens do pedido e permite alterar somente itens que não estão com a situação "entregue".
    Eventos que disparam esta regra:
    • Antes de alterar formulário "Alterar"
    • Antes de alterar formulário "Alterar"

    Calcular subtotal do item

    Calcula o subtotal to item QUANTIDADE * PRECO
    Eventos que disparam esta regra:
    • Antes de apresentar cada registro formulário "Alterar"
    • Antes de apresentar uma tela formulário "Alterar"
    • Antes de apresentar uma tela formulário "Novo"
    • Ao alterar campo "Preço unitário" do formulário "Alterar"
    • Ao alterar campo "Preço unitário" do formulário "Alterar"
    • Ao alterar campo "Preço unitário" do formulário "Novo"
    • Ao alterar campo "Quantidade" do formulário "Alterar"
    • Ao alterar campo "Quantidade" do formulário "Alterar"
    • Ao alterar campo "Quantidade" do formulário "Novo"

    Calcular valor ICMS ST

    Calcula o valor do ST
    Eventos que disparam esta regra:
    • Antes de apresentar uma tela formulário "Alterar"
    • Antes de apresentar uma tela formulário "Alterar"
    • Antes de apresentar uma tela formulário "Novo"
    • Ao alterar campo "% MVA ST" do formulário "Alterar"
    • Ao alterar campo "% MVA ST" do formulário "Alterar"
    • Ao alterar campo "% MVA ST" do formulário "Novo"

    Calcular valor IPI

    Calcula o valor do IPI baseado no valor total do item.
    Eventos que disparam esta regra:
    • Antes de apresentar uma tela formulário "Alterar"
    • Antes de apresentar uma tela formulário "Alterar"
    • Antes de apresentar uma tela formulário "Novo"
    • Ao alterar campo "% IPI" do formulário "Alterar"
    • Ao alterar campo "% IPI" do formulário "Alterar"
    • Ao alterar campo "% IPI" do formulário "Novo"

    Consultar aliquota insterestadual do pedido

    Executa a chamada da validação da alíquota interestadual apresentando a mensagem para o usúario.
    Eventos que disparam esta regra:
    • Antes de apresentar uma tela formulário "Alterar"
    • Antes de apresentar uma tela formulário "Alterar"
    • Antes de apresentar uma tela formulário "Novo"

    Consultar alíquota de ICMS interestadual para ST

    Consultar a aliquota de ICMS (%) para substituição tributária (ST).

    Definir número de casas decimais nos valores unitário e total do item

    Modificar o número de casas decimais do valor unitário e valor total do item.
    Eventos que disparam esta regra:
    • Antes de apresentar cada registro formulário "Novo"

    Identificar situação dos itens com cores

    Eventos que disparam esta regra:
    • Antes de apresentar cada registro formulário "Listar"

    Incluir motivo do cancelamento

    Na interface de list no campo de complemento, deve ser incluído o motivo do cancelamento caso exista.
    Eventos que disparam esta regra:
    • Antes de apresentar cada registro formulário "Listar"

    Remover botões

    Se o pedido estiver com situação "Entregue" ou "Cancelado" não deverá permitir realizar inclusões, alterações ou exclusões nos itens.

    Remover campos de data conforme tipo de pedido

    Remover os campos de data conforme configurado no tipo de pedido
    Eventos que disparam esta regra:
    • Antes de apresentar cada registro formulário "Alterar"
    • Antes de apresentar cada registro formulário "Alterar"
    • Antes de apresentar cada registro formulário "Novo"
    • Antes de apresentar uma tela formulário "Pesquisar"

    Salvar preço unitário do item

    Salvar o preço unitário quando for informado somente o valor sub-total do item e quantidade.
    Eventos que disparam esta regra:
    • Antes de inserir formulário "Novo"

    remover ações

    Remove ação de alterar conforme definido no tipo de pedido.
    Eventos que disparam esta regra:
    • Antes de apresentar uma tela formulário "Alterar"
    • Antes de apresentar uma tela formulário "Consultar"
    • Antes de apresentar uma tela formulário "Listar"