Sistema de ordem de compra

Índice

Itens de solicitação interna

ORCCOM.CAD_SOLICITACOES_INTERNAS_ITENS

Descrição

Interface para manutenção de itens da solicitação interna.

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

Solicitações de compra internas:

Campos:

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.
Nome (ou código) de identificação do estabelecimento. Na maioria das vezes, apenas os estabelecimentos que o usuário tem acesso estarão disponíveis como opção.
Ex:
  • MATRIZ
  • FILIAL 1
  • FILIAL 2
  • CD-RS
Nome dado para identificar o tipo de pedido.

Os tipos de pedidos são apresentados de acordo com o estabelecimento selecionado.
Ex:
  • VENDA
  • COMPRA
  • AMOSTRA
  • ORDEM_DE_SERVICO
  • PRODUCAO
  • TRANSFERENCIA
  • REPRESENTACAO
Situação específica deste item.
  • Pendente - O item foi solicitado, mas nenhum pedido de cotação foi enviado para os fornecedores.
  • Em cotação - Pelo menos uma cotação já foi enviada para o fornecedor.
  • Cotada - Pelo menos um fornecedor já preencheu uma cotação.
  • Aprovada - A melhor cotação já foi selecionada/aprovada.
  • Encomendada - Já foi emitida uma ordem de compra para o fornecedor.
Sequência do item no pedido.
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.
Código ou identificação do produto.
Nome da marca.
Ex:
  • COCA-COLA
  • PEPSI
  • FRUKI
Código de referência do produto usado pelo fabricante.
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.
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.
Apresenta as cotações por fornecedor que foram criadas para o item do pedido interno.
Data para a qual a entrega dos produtos ou serviços foi requisitada pelo cliente. O sistema não permite informar uma data maior que a data limite (caso informada).
Data limite para entrega.
Quando não for informada poderá ser automaticamente calculada conforme estabelecido na preferência PEDIDOS.PEDIDOS.DIAS_LIMITE.
Identificação do cliente para o qual este produto será utilizado.
Nome completo do cliente para o qual este produto está destinado (opcional).
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.
Apresenta as últimas compras feitas do produto informando para o cliente do pedido.
A apresentação é configurada na preferência ORCCOM.CAD_SOLICITACOES_INTERNAS_ITENS.SQL_HISTORICO_COMPRAS.
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_SOLICITACOES_INTERNAS_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.
Permite selecionar um fornecedor para incluir uma nova cotação para o item do pedido interno.
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.

Apresenta as opções de fornecedores, produto e valor, os que forem selecionados serão utilizados para gerar as ordens de compra.

Operações

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: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:
MATRIZVENDAPendenteCOCA-COLA
FILIAL 1COMPRAEm cotaçãoPEPSI
FILIAL 2AMOSTRACotadaFRUKI
CD-RSORDEM_DE_SERVICOAprovadaCOCA-COLA
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

Incluir fornecedor

Permite informar um novo fornecedor para o qual se deseja cotar este produto.
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

Importar

Funcionalidade que permite importar dados para o bloco desejado.
Topo

Exportar

Funcionalidade que permite exportar os dados de um bloco.
Topo

Cancelar

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

Sugerir

Gera solicitações para compra com base em regras pré-definidas, tais como médias de venda, demandas de produção, interesses de produtos, estoque mínimo, etc.
A sugestão é baseada em um SQL configurado por preferência. Veja preferencia XXXX para maiores detalhes.
Topo

Gerar OCs

Gera uma ordem de compra para os itens da solicitação que tiverem um fornecedor escolhido ou adiciona o item à uma ordem de compra em manutenção já existente para este fornecedor.
Topo

Selecionar/aprovar cotação

Permite selecionar um dos fornecedores que já preencheu a cotação e aprova o item da cotação que foi selecionado.
Caso algum item já tenha sido aprovado e aprove um novo, tira a aprovação do que tinha sido aprovado anteriormente.
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_SOLICITACOES_INTERNAS_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_SOLICITACOES_INTERNAS_ITENS.DESTACAR_SITUACAO

    Destacar itens pendentes

    Destaca com cor diferenciada os itens de pedidos da solicitação interna pendentes.

    Tipo: TEXT

    Valor padrão: S

    ORCCOM.CAD_SOLICITACOES_INTERNAS_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_SOLICITACOES_INTERNAS_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_SOLICITACOES_INTERNAS_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_SOLICITACOES_INTERNAS_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 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.

    Ver também:

    Tipo: TEXT_LONG

    ORCCOM.CAD_SOLICITACOES_INTERNAS_ITENS.SQL_PEDIDO_VENDA

    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_SOLICITACOES_INTERNAS_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_SOLICITACOES_INTERNAS_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 ações conforme o contexto

    Remove ações que não fazem sentido para o contexto do registro.
    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"

    Ajustar campos conforme o parâmetro

    Quando o parâmetro do pedido for informado, deve esconder os campos do pedido.
    Eventos que disparam esta regra:
    • Antes de apresentar uma tela formulário "Consultar"
    • Antes de apresentar uma tela formulário "Listar"
    • Antes de apresentar uma tela formulário "Pesquisar"

    Apresentar fornecedores aprovação

    Apresenta a relação de fornecedores que já preencheram a cotação para aprovação.
    Eventos que disparam esta regra:
    • Antes de apresentar uma tela formulário "Selecionar/aprovar cotação"

    Apresentar historico de compras

    Apresenta as ultimas vendas feitas pelo cliente do pedido para o produto selecionado. O conteúdo do que é apresentado é definido na preferencia ORCCOM.CAD_ITENS_COMPRA.SQL_HISTORICO_COMPRAS.

    Caso a preferencia 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"

    Criar capa do pedido

    Na inclusão de uma solicitação "solta", a capa do pedido deverá ser criada de forma automática com as informações presentes na tela.
    Eventos que disparam esta regra:
    • Antes de validar formulário "Novo"

    Identificar situação dos itens com cores

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