Sistema de ordem de compra

Índice

Solicitações de compra

ORCCOM.CAD_SOLICITACOES_INTERNAS_ITENS

Descrição

Interface para manutenção de itens das solicitações de compra.

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.
  • Encomendada - Ordem de compra já foi emitida.
  • Enviado - Pelo menos uma cotação já foi enviada para algum fornecedor.
  • Cotada - Pelo menos uma cotação já foi preenchida por um fornecedor.
  • Encomendada - Já foi emitida uma ordem de compra para o fornecedor.
  • Cancelada - O solicitação de compra foi cancelada.
Código ou identificação do produto.
Sequência do item no pedido.
Nome da marca.
Ex:
  • COCA-COLA
  • PEPSI
  • FRUKI
Código de referência do produto usado pelo fabricante.
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.
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.

Ver também:
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.
Número da ordem de compra (se já estiver uma criada) para esta solicitação.
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.
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.

Indica o modelo de e-mail que deve ser utilizado quando for chamada a função "Enviar".
As opções apresentadas, são todos os modelos de e-mail indicados para o respectivo tipo de pedido.
Caso existir apenas um modelo, não será necessário informar.
Apresenta as cotações recebidas de fornecedores para que seja escolhido um 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 1COMPRAEncomendadaPEPSI
FILIAL 2AMOSTRAEnviadoFRUKI
CD-RSORDEM_DE_SERVICOCotadaCOCA-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].
COCA-COLA
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].
MATRIZ
VENDA
Pendente
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.).
MATRIZ
VENDA
Pendente
COCA-COLA
Comportamento:Topo

Enviar

Envia um e-mail com as cotações para os fornecedores.
Topo

Importar

Funcionalidade que permite importar dados para o bloco desejado.
Topo

Exportar

Funcionalidade que permite exportar os dados de um bloco.
MATRIZVENDAPendenteCOCA-COLA
FILIAL 1COMPRAEncomendadaPEPSI
FILIAL 2AMOSTRAEnviadoFRUKI
CD-RSORDEM_DE_SERVICOCotadaCOCA-COLA
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

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.
COCA-COLA
Comportamento: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

Aprovar

Aprova o item informado e volta para a listagem.
Topo

Acessar solicitações de todos os usuários

Chave de acesso para acessar as solicitações de outros usuários.
Topo

Excluir todos

Ação que permite excluir todos os registros que obedecem ao filtro informado!
Topo

Planilha

Gera uma planilha eletrônica com os dados dos registros filtrados. Funciona de forma semelhante à operação [b:Listar], porém resulta em um arquivo de planilha (Excel).
MATRIZVENDAPendenteCOCA-COLA
FILIAL 1COMPRAEncomendadaPEPSI
FILIAL 2AMOSTRAEnviadoFRUKI
CD-RSORDEM_DE_SERVICOCotadaCOCA-COLA

Dúvidas frequentes

  • 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.APROVACAO_COTACAO_SEM_ENVIO

    Caso marcado indica que é possível aprovar uma cotação sem ter enviado ela.

    Tipo: FLAG

    ORCCOM.CAD_SOLICITACOES_INTERNAS_ITENS.DESTACAR_SITUACAO

    Destacar itens pendentes

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

    Tipo: FLAG

    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.
    • Não aceita incluir, alterar ou excluir itens conforme a situação do pedido, respeitando o que estiver configurado no respectivo tipo de pedido.
    • Não permite cancelar itens já cancelados ou totalmente entregues.
    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 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 é 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

    Se a preferência ORCCOM.CAD_SOLICITACOES_INTERNAS_ITENS.DESTACAR_SITUACAO estiver marcada, muda a cor de background dos campos quando estiver na situação "P".
    Eventos que disparam esta regra:
    • Antes de apresentar cada registro formulário "Listar"

    Popular fornecedores aprovação

    Popula as opções de cotações recebidas para selecionar/aprovar a melhor.
    Eventos que disparam esta regra:
    • Antes de apresentar uma tela formulário "Selecionar/aprovar cotação"