Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
warning
Aviso
titleImportante

Esta funcionalidade está em fase de piloto. Quando for disponibilizada oficialmente O NFC estará disponível a partir do release 12.1.2210 e será disponibilizado no pacote de expedição contínua maior ou igual a 15/12/2023.


CONTEÚDO

titleMingle

Para configurar o TOTVS Mingle, o servidor Appserver deve possuir um IP publico.

Image RemovedImage Removed
Painel
borderColorlightgray
borderWidth1
borderStylesolid
titleVISÃO GERAL

Índice


01. VISÃO GERAL

O Novo Fluxo de Compras auxilia na gestão

Protheus Gestão de Compras auxilia no gerenciamento

, controle e tomada de decisão referente a área de Compras da sua empresa.
A ferramenta permite adotar melhores estratégias para

escolha de fornecedores, PainelborderColorlightgrayborderWidth1borderStylesolidtitle

gerenciamento de solicitações de compras

e cotações.
A partir de cards e telas minimalista projetadas para facilitar o uso e modernizar o processo de cotação.A análise de informações e estatísticas permite aos gestores tomadas de decisões mais assertivas a partir da análise de dados, fazendo com que sua empresa consiga sempre os melhores fornecedores para maximizar os lucros e manter a qualidade e prazos das solicitações de compras.

recebidas, além de entregar uma nova experiência na jornada de cotações. Ao longo dos meses, outros processos de compras serão modernizados e disponibilizados com o objetivo de simplificar processos, otimizar o tempo das operações e agilizar as tarefas melhorando o seu dia a dia. 

02.

EXEMPLO DE UTILIZAÇÃO

Aqui você pode visualizar

um exemplo prático

exemplos práticos das principais funcionalidades

do Portal Gestão title

do Novo Fluxo de Compras.


Expandir
title
Fluxo de trabalho Expandir
Início

Ao acessar a Página Inicial (Início) o Usuário pode visualizar  o nome do usuário logado.

Imagem 1 - InícioImage Removed

Image Added

[Clique na imagem para ampliar]

Expandir
titleNecessidade de Compra
Expandir
titleProcesso de cotação
Expandir
titleNecessidade de Compra

Passo 1: Para iniciar uma solicitação de cotação, selecione no menu lateral a opção de

necessidade

Necessidade de

compras

Compra.

Image Removed

Image Added

[Clique na imagem para ampliar]

Passo 2: Após ter acesso a tela é necessário fazer a seleção dos itens que serão cotados. A partir de um item selecionado o botão Iniciar cotação, localizado no canto inferior direito da tela, ficará habilitado. Clique nele para seguir para o próximo passo. 

Image Removed

Image Added

[Clique na imagem para ampliar]

Passo 3: Em seguida será direcionado para a tela de Solicitação de cotação. Nesta tela há

três

dois campos obrigatórios, referentes aos Dados da cotação, evidenciados com um asterisco '*'. Será necessário o preenchimento dos mesmos pra prosseguir o processo.

Os respectivos campos são: 

  1. Apelido do grupo de cotação: O usuário definirá como a cotação será chamada;
  2. Recebimento cotação: O usuário definirá o prazo para o recebimento de cotações
;Quantidade fornecedores: O usuário definirá a quantidade máxima de fornecedores participantes
  1. .
 
Image Removed

Image Added

[Clique na imagem para ampliar]

Passo 4: Nesta tela ainda é possível conferir as Informações de entrega e Produtos selecionados.  
Em Produtos selecionados há um campo de texto em cada item, onde é possível enviar para o fornecedor observações/especificações sobre o produto. 

Image Removed

Image Added
[Clique na imagem para ampliar]

Passo 5: Quando houver mais de uma solicitação possuindo produtos iguais, com a mesma Data de necessidade, conta contábil, entre outras similaridades, haverá um agrupamento de solicitações. Surgindo então na tela um campo chamado Solicitações agrupadas. Nele o usuário conseguirá visualizar através de um disclaimer azul, o número da Solicitação e o número do item, apresentada nesse mesma ordem Solicitação-Item, somando as quantidades solicitadas à quantidade total.

Image Removed

Image Added

[Clique na imagem para ampliar]

Informações
titleAglutinação de Produtos

Para maiores informações sobre a aglutinação de produtos clique aqui..

Expandir
titleSeleção de Fornecedores
Passo 1: Para continuar com a geração da cotação e necessário selecionar os fornecedores que participaram desta cotação, para auxiliar nesta tarefa a tela de seleção de fornecedores nos mostra quantos fornecedores ainda podem ser selecionados.
Na primeira aba serão mostrados todos os fornecedores cadastrados, e existe uma segunda aba onde

Atenção: Para visualizar essa tela é necessario possuir o parâmetro MV_SELFOR ativo (S).

Passo 1: Na aba Todos os fornecedores será exibido uma lista com todos os fornecedores já cadastrados no Protheus, já na aba Últimos fornecedores podemos acessar de forma fácil os últimos fornecedores

que cotaram algum dos produtos que estão na cotação atual.
Image Removed

listados, conforme as últimas notas fiscais de compras, com o código do produto igual as encontradas para desta cotação. 


Image Added
[Clique na imagem para ampliar]

Passo 2: Além da visualização padrão e possível também seleciona um fornecedor especifico buscando a pelo CNPJ ou pela razão social.
Image Removed

Para incluir nessa cotação um ou mais fornecedores participantes (não cadastrado no sistema), é necessário clicar no botão Novo fornecedor, localizado na parte superior da tela. Nele será necessário adicionar a razão social e e-mail. É obrigatório o preenchimento da razão social para a inclusão do novo fornecedor participante, não será possível duplicar a mesma. Este fornecedor ainda não estará cadastrado oficialmente no sistema, apenas participará do processo de cotação.


Image Added
[Clique na imagem para ampliar]


Passo 2: Através do campo de busca é possível localizar um fornecedor específico digitando o CPF/CNPJ, razão social ou nome fantasia.

Image Added
[Clique na imagem para ampliar]

Passo 3: Caso haja necessidade de atualizar o contato de algum fornecedor

e possível fazer isso

poderá realizar esta tarefa sem sair da tela

,

clicando no botão

atualizar contato e possível atualizar o contato do fornecedor a partir de um novo modal que será apresentado.
Image Removed
Passo 4: Caso seja necessário nesta tela e possível visualizar todas as informações disponíveis de um fornecedor clicando no botão mostrar detalhes.
Image Removed

Atualizar Contato

Image Added
[Clique na imagem para ampliar]

Passo 4: Na opção Mostrar Detalhes conseguirá visualizar mais informações referente ao fornecedor.

Image Added
[Clique na imagem para ampliar]

Passo 5:

E após

Após selecionar os fornecedores

devidamente selecionados basta

deverá clicar no botão

gerar cotação para continuar

Gerar Cotação para concluir o processo de geração de cotação.

Image Removed


Image Added

[Clique na imagem para ampliar]

Passo 6: Após a geração da cotação

gerada Expandir
titleProcesso de Atualização da Cotação e Análise da Cotação
Expandir
titleCotações
Passo 1: Para seguir com o processo e necessário ter pelo menos 1(uma) proposta totalmente respondida, para completar uma proposta basta escolher a cotação desejada e clicar no botão editar.
Image Removed
[Clique na imagem para ampliar]
Passo 2: Após ter selecionado a cotação desejada e preciso selecionar o fornecedor ao qual deseja completar a proposta e clicar novamente em editar.
Image Removed

, uma janela será disponibilizada

uma janela para que caso queira adicionar algum anexo e envio do workflow.
Este passo não e obrigatório. 

Image Removed
[Clique na imagem para ampliar]

, permitindo adicionar anexos à cotação e enviar um Workflow por e-mail aos participantes. Se não desejar enviar anexos ou e-mails aos fornecedores, basta fechar a janela. Se optar por enviar por e-mail, selecione "Sim" no campo "Enviar cotação por e-mail ao fornecedor?". Após selecionar "Sim", outro campo será exibido, perguntando se deseja selecionar as condições de pagamento a serem enviadas aos fornecedores através do Workflow. Caso não deseje selecionar as condições de pagamento, todas as condições que possuem "Adic WF NFC = Sim" (campo E4_ATVWF da tabela SE4), determinadas a partir do cadastro de condições de pagamento no Protheus, serão enviadas aos fornecedores.
Após esse processo, clique no botão "Enviar e-mail(s)".


Image Added

Image Removed


[Clique na imagem para ampliar]

Passo 3: Com a cotação aberta basta completar todos os campos de todos os itens para que haja pelo menos uma proposta com status de completa.


image-2024-3-13_11-33-18.pngImage Added
Protheus - Tela cadastro condições de pagamento [Clique na imagem para ampliar]

Passo 4: Após completar todos os itens de uma cotação, a tag será alterada e mudará para completa e a cotação já poderá ser analisada.


Caso o ambiente esteja configurado com parâmetro MV_SELFOR inativo (N) a tela de Seleção de fornecedores será alterada e habilitará a amarração de produto x fornecedor. Exibindo os produtos e os fornecedores vinculados a ele. Para este ambiente não será possível adicionar fornecedores participantes.

Image Added

Image Removed

[Clique na imagem para ampliar]


Passo

5: Feito isso, na tela de cotações basta seleciona a opção de análise.

1:  Na tela Seleção de Fornecedores X Produto selecione os fornecedores vinculados ao produto como mostra a imagem abaixo.

Image Added

Image Removed

[Clique na imagem para ampliar]

Passo

6: Agora basta selecionar se a proposta será feita por proposta ou por itens e clicar em

2: Caso haja necessidade de atualizar o contato de algum fornecedor poderá realizar esta tarefa sem sair da tela clicando no botão Atualizar Contato

Image Added

Formalizar compra.
Image Removed

[Clique na imagem para ampliar]


Passo 7: Caso opte por não selecionar uma proposta completa, e possível selecionar os itens mais baratos de uma mesma cotação com diferentes fornecedores.

Na tela de analise clique na aba por item para ter acesso ao preço de todos os itens de forma individual.

Expandir
titleWorkflow

Ao enviar um e-mail através do Novo Fluxo de Compras, o fornecedor receberá uma notificação. Nesse e-mail, será possível visualizar quem fez a solicitação e os itens da cotação, conforme exemplificado abaixo.

Image Added

Image Removed

[Clique na imagem para ampliar]

Passo 8: Na analise por itens será permitido que você encontre o melhor preço de cada produto mesmo que sejam de fornecedores diferentes e consiga formalizar a compra.


Ao clicar no link para preenchimento, o fornecedor abrirá o formulário onde poderá detalhar os itens da cotação solicitada.

Image Added

Image Removed Expandir
titleLista Solicitações

Clicando em Necessidade de compra o usuário será redirecionado as Solicitações de Compras disponíveis para visualização.

Image Removed

[Clique na imagem para ampliar]

Expandir
titleFuncionalidades
Expandir
titleNecessidade de compra
Expandir
titleCarrinho

Ao selecionar uma solicitação de compras é possível visualizar qual solicitação já foi selecionada através do botão Registros selecionados, localizado no canto inferior esquerdo da tela. Apenas será possível fazer seleção de solicitações em aberto para iniciar uma cotação

Image Removed
[Clique na imagem para ampliar]

A fim de permitir a utilização dos itens de solicitação em apenas uma cotação, ao tentar adicionar ao carrinho um item de solicitação já selecionado anteriormente, o sistema alertará com uma mensagem, informado que este item já foi selecionado.

Image Removed
[Clique na imagem para ampliar]


A data de entrega é individual por item da cotação , devendo o fornecedor informar a data de entrega de cada item. Caso a data de entrega seja única ou outro cenário do fornecedor, para facilitar a inserção desse dado, o usuário deve colocar a data desejada no primeiro item da cotação e na sequência, clicar no botão Replicar data, que a data do primeiro item será replicada para os demais itens da cotação.

As condições de pagamento exibidas no formulário são estabelecidas de acordo com o que foi selecionado no envio do E-mail via Novo Fluxo de Compras, caso o usuário não tenha pré-estabelecido as condições que o fornecedor poderá visualizar, todas as condições que possuem "Adic WF NFC = Sim" (campo E4_ATVWF da tabela SE4), determinadas a partir do cadastro de condições de pagamento no Protheus, serão enviadas aos fornecedores, como ilustrado nas imagens abaixo.


Image Added


[Clique na imagem para ampliar]

Nessa página as solicitações de compras são divididas e listadas em três abas Em aberto, Parcialmente atendidas e Atendidas 

Image Removed

Image Removed



Image Added
Protheus - Tela cadastro condições de pagamento [Clique na imagem para ampliar]

Para a exibição ou remoção de colunas da tabela há um ícone de configuração, nele é possível fazer o Gerenciamento de colunas deixando marcadas apenas as colunas que serão visualizadas.


Após o envio da proposta respondida pelo fornecedor, a cotação será atualizada com todas as informações enviadas no Novo Fluxo de Compras.

Aviso

 A seleção das condições de pagamento mencionadas acima estará disponível a partir da expedição contínua de 05/04/2024.

Expandir
titleFuncionalidades
Expandir
titleCarrinho

Ao selecionar uma solicitação de compras é possível visualizar qual solicitação já foi selecionada através do botão Registros selecionados, localizado no canto inferior esquerdo da tela. Apenas será possível fazer seleção de solicitações em aberto para iniciar uma cotação.

Image Added

Image Removed


[Clique na imagem para ampliar]

Expandir
titlePaginação

A paginação da tela de necessidade de compras funciona com uma rolagem "infinita" para baixo, enquanto houver solicitações o sistema permitirá rolar a página. É necessário que o cursor esteja posicionado sobre a tabela. 

Image Removed
[Clique na imagem para ampliar]

Acima da tabela visualizada nota-se um contador de solicitações de compras, evidenciando a quantidade de solicitações já exibidas e as solicitações ainda restantes. Ao chegar ao fim da  numeração não será possível carregar mais dados.


A fim de permitir a utilização dos itens de solicitação em apenas uma cotação, ao tentar adicionar ao carrinho um item de solicitação já selecionado anteriormente, o sistema alertará com uma mensagem informado que o item já foi selecionado.

Image Added


[Clique na imagem para ampliar]

Expandir
title
Anexos

As necessidades de compras permitem a visualização de anexos inseridos, quando a solicitação possuir um ou mais anexos, será exibido um ícone clicável na coluna Anexos. Após clicar no ícone, surgirá uma janela listando os anexos disponíveis na solicitação.
Para a visualização desses anexos é necessário fazer o download, clicando no ícone. 

Validação por grupo de produto

A funcionalidade "Validar Grupo de Produto?" tem como objetivo garantir que o usuário não selecione um produto que não pertença ao mesmo grupo de produto. Essa validação é ativada quando o interruptor é acionado e sempre verifica o grupo de produto do primeiro item selecionado. Se o produto não possuir um grupo de produto definido, será exibida uma mensagem informando que apenas é possível selecionar itens sem grupo de produtos.

Image Added
[

Image Removed
[

Clique na imagem para ampliar]

Expandir
title
FiltrosAo acessar uma das listas de solicitações de compras, independente da aba (

O Filtro por Data funciona com intervalo de duas datas (início e fim), após a seleção o filtro buscará solicitações de compras que possuem a Data de necessidade de acordo com o período selecionado.

Image Removed

O Filtro por código de produto, realiza a busca pelocódigo de produto desejado, ao fazer a seleção e possível inserir o código do produto inteiro ou apenas parte dele.
Image Removed
Lista Solicitações

Clicando em Necessidade de Compra o usuário será redirecionado as Solicitações de Compras disponíveis para o processo de cotação.

Image Added

[Clique na imagem para ampliar]

Nessa página as solicitações de compras serão exibidas, divididas e listadas em três abas Em aberto, Parcialmente atendidas e Atendidas

), haverá uma série de Filtros que podem ser utilizados pelo usuário de forma individual ou combinada.

.

  • A aba em aberto exibe todos os itens de solicitação que possuam a quantidade em pedido de compra igual a zero e não tenham sido eliminadas por resíduo (C1_RESIDUO).
  • A aba de parcialmente atendidas irá mostrar todas as solicitações que possuem um pedido de compra com quantidade menor que a quantidade solicitada (C1_QUANT).
  • Na aba de atendidas irá mostrar todos os itens que possuam quantidade em pedido de compra igual à quantidade solicitada.

Image Added

[Clique na imagem para ampliar]

Para a exibição ou remoção de colunas da tabela há um ícone de configuração, nele é possível fazer o Gerenciamento de colunas deixando marcando apenas as colunas que serão visualizadas. É possível ainda reordenar a posição das colunas e restaurar padrão.

Image Added

Image Removed


[Clique na imagem para ampliar]

Através da Busca avançada, é possível fazer uma série de filtros sobre a solicitação desejada, como: 
  • Solicitação;
  • Solicitante;

  • Descrição do produto;

  • Filial solicitante;

  • Filial entrega;

  • Centro de custo;

  • Conta contábil;

  • Item contábil;

  • Classe valor;
Expandir
titlePaginação

A paginação da tela de Necessidade de Compra funciona com uma rolagem "infinita" para baixo, enquanto houver solicitações o sistema permitirá rolar a página. É necessário que o cursor esteja posicionado sobre a tabela. 
Image Added


[Clique na imagem para ampliar]

Acima da tabela, existe um contador de registros listados, evidenciando a quantidade de solicitações já exibidas e as solicitações a serem listadas.

Image Added

[Clique na imagem para ampliar]

Expandir
title
Cotações Expandir
titleLista de cotações

Clicando em Cotações o usuário será redirecionado para as cotações disponíveis para visualização.

Image Removed

Nessa página e possível ter acesso a todas as cotações disponíveis no momento, onde será possível ter acesso a diversas opções de controle e edição das cotações assim como uma busca personalizada por número ou utilizando o apelido atribuído a respectiva cotação.

Image Removed

As cotações podem ser identificadas pelo seu código ou apelido , e cada um terá um status identificado por uma Tag que identifica a situação atual da cotação.

As respectivas tags são: 

  1. Pendente: Situação na qual a cotação ainda não possui nenhuma proposta completa recebida;
  2. Pronto para analisar: Quando existe pelo menos um proposta completa para ser analisada;
  3. Em analise : Quando apenas um item foi cotado deixando assim a cotação parcialmente atendida. 
  4. Finalizada: Quando a cotação tiver sido completamente atendida. 

Image Removed

Expandir
titleAnexos

Na listagem de cotações e possível ver um ícone lateral indicando quando a cotação possuir um anexo  

Image Removed

O ícone de anexos ficara visível caso na criação da cotação tenha sido colocado algum anexo.

Clicando no ícone será mostrado uma nova aba onde encontram-se os anexos daquela cotação, mostrando as opções de exclusão ou download do anexo.

Image Removed

Caso seja necessário e possível adicionar um novo anexo a uma cotação que já possui um anexo, ou até a uma que ainda não tenha anexos.

Image Removed

Ao selecionar um anexo para ser enviado ele automaticamente será vinculado a cotação sem que seja necessário uma segunda confirmação.

E possível anexar mais de um item de uma só vez.

Image Removed

Caso um mesmo documento já exista na base de conhecimento será exibido uma mensagem de erro assim como ocorre no Protheus.

Image Removed

Expandir
titleFiltros

Ao acessar a listagem das cotações existe um campo de busca que permite buscar uma cotação específica utilizando o número da cotação ou a partir do apelido da cotação.

Image Removed

Image Removed

O Filtro por apelido, realiza a busca pelo apelido da cotação desejada, ao fazer a seleção e possível inserir o código da cotação inteira ou apenas parte dele.
Expandir
titleEditar
Expandir
titleEditar

Para avançar com o processo de cotação e necessário editar acessar as opções extras, e clicar na opção EDITAR.

Image Removed

Ao clicar nessa opção lhe será apresentada uma listagem de propostas separadas por fornecedor.

Nesta tela, em cada card será apresentado o nome do fornecedor a qual a proposta pertence, o valor atual da cotação e os itens ainda pendentes de preenchimento de valores e quantidade.

Image Removed

Anexos

As solicitações de compras listadas na tela de Necessidade de Compra, poderão ter anexos vinculados, caso possuam serão evidenciados com ícone de clipe na coluna Anexos.
Ao clicar no ícone, será aberto uma nova janela com a listagem de anexos vinculados a solicitação, possibilitando o download ao clicar no ícone Baixar anexo

Atenção: Os anexos provenientes das solicitações de compras não serão automaticamente vinculados à cotação.
Os arquivos vinculados a cotação serão enviados ao fornecedor via workflow podendo levar informações confidenciais e internas da empresa.
Por este motivo, os documentos deverão ser anexados na cotação durante a geração da mesma.

Image Added
[Clique na imagem para ampliar]

Expandir
titleFiltros

Ao acessar uma das listas de solicitações de compras, independente da aba (Em aberto, Parcialmente atendidas e Atendidas), haverá uma série de Filtros que podem ser utilizados pelo usuário de forma individual ou combinada.

O Filtro por Data funciona com intervalo de duas datas (início e fim), após a seleção o filtro buscará solicitações de compras que possuem a Data de necessidade de acordo com o período selecionado.

Image Added
[Clique na imagem para ampliar]

O filtro de busca por código de produto permite a busca do produto desejado por meio do código, permitindo que o usuário insira o código completo ou parte dele.
Além disso, essa funcionalidade também está disponível na lupa que permite realizar uma busca avançada por código, descrição ou unidade de medida.

Image Added

[Clique na imagem para ampliar]

Através da Busca avançada, é possível fazer uma série de filtros sobre a solicitação desejada, como: 

  • Solicitação;
  • Solicitante;

  • Descrição do produto;

  • Filial solicitante;

  • Filial entrega;

  • Centro de custo;

  • Conta contábil;

  • Item contábil;

  • Classe valor;

Todos os filtros possuem a opção de selecionar a "lupa" para fazer uma busca avançada dentro do filtro desejado, mas seu uso é opcional.

Image Added

[Clique na imagem para ampliar]

Expandir
titleEdição

Ao clicar em editar em um fornecedor especifico, será direcionado para uma listagem da proposta.

Image Removed

Ao abrir edição da cotação por fornecedor será mostrado o numero da cotação, e a identificação do fornecedor.
Logo a baixo terá um cabeçalho que mostrara diversos totalizadores, de valores totais e algumas informações obrigatórias. 

Image Removed

[Clique na imagem para ampliar]

Os primeiros campos obrigatórios para continuar são o tipo de frete, a condição de pagamento da proposta e a quantidade de dias para a entrega

Image Removed

[Clique na imagem para ampliar]

Os totalizadores serão atualizados automaticamente sempre que um produto for atualizado.

Expandir
titleStatus da proposta

A listagem de propostas dispõe de tags informativas para indicar o status de cada proposta.

As respectivas tags são: 

  1. Pendente: Situação na qual a proposta ainda não possui nenhum item com valor e quantidade preenchido;
  2. Parcial: Quando existe pelo menos um item completa para ser analisada;
  3. Completa: Quando todos os itens da proposta estão preenchidos. 
  4. Completa e-mail: Quando todos os itens da proposta estão preenchidos  e foram respondidos via workflow. 
  5. Desqualificada: Quando um fornecedor for desqualificado da cotação.

Image Removed

[Clique na imagem para ampliar]

Expandir
titleReenviar e-mail

Na listagem das cotações e possível reenviar o e-mail com workflow novamente a partir da opção Enviar e-mail.

Image Removed

E permitido enviar o e-mail e workflow para mais de um e-mail, porém apenas a primeira resposta ao workflow será considerada.

Pode ser adicionado ao e-mail também alguma informação complementar ou aviso utilizando o campo observação. E acima existe a possibilidade de escolher reenviar os anexos existentes na cotação. 
Image Removed

[Clique na imagem para ampliar]

Expandir
titleAnexos

Na listagem de cotações também e permitido adicionar novos anexos vinculados a um fornecedor especifico, clicando em outras ações e selecionando a opção Anexo(s).

Image Removed

Expandir
titleDesqualificar

A opção de desqualificar um fornecedor serve para retirar um fornecedor de continuar na cotação. Porém a cotação continuará seu fluxo padrão porém agora o fornecedor especifico não participará.

Image Removed

Ao selecionar esta opção não será mais possível alterar valores ou quantidades desta proposta. Ficando disponível apenas para visualização.

Image Removed

[Clique na imagem para ampliar]

Caso seja necessário e possível ainda requalificar o fornecedor para que ele volte a participar da cotação.

Image Removed

Expandir
titleImpostos

Na tela de edição da cotação após ter preenchido algum item e ter salvo e possível visualizar os impostos padrão.

Image Removed

A pré visualização não permite alteração dos valores, apenas consulta.

Expandir
titleDescontos

Durante o preenchimento de um item e possível, aplicar descontos por item ou global.

O desconto por item e aplicado a somente um item e tem como objetivo poder aplicar alguma oferta especial em apenas um item.

Image Removed

Já o desconto global será distribuído igualmente entre todos os itens da cotação diminuindo assim o valor total da cotação.
Image Removed

Expandir
titleVisualizar

E possível abrir uma proposta em modo visualização para que seja possível visualizar propostas já finalizadas ou de candidatos desqualificados sem poder editar ou alterar nenhum dado.

Image Removed

Expandir
titleAnalisar
Expandir
titleAnálise por proposta

Com a proposta completa e possível seguir para a analise da cotação, existem 2(Dois) tipos de análise. 

A seguir temos a por proposta.

Image Removed

Nesta tela a primeira visualização irá trazer primeiro por menor preço. Nesta tela temos a proposta com menor preço com uma indicação feita por uma tag verde. 

Filtros de usuário:

O sistema permite a aplicação de filtros de usuário. Para isso, é necessário cadastrar o comprador na rotina Compradores (COMA087), no botão Botão Outras Ações > Filtro Necess. NFC, especificar o filtro desejado e ativar o parâmetro MV_FILTNFC. Para mais informações sobre como utilizar os filtros, consulte a documentação PCOM09013 - Compradores (COMA087), na sessão Filtro Necessidade de Compra para o Novo Fluxo de Compras (NFC).

Expandir
titleCompra Centralizada

Dentro da tela de Necessidade de Compra, existe o botão "Compra centralizada", onde é possível realizar a centralização de solicitações de compras para uma única filial.

Por exemplo: Iremos trocar todos os notebooks das filiais, ao invés de iniciar a cotação em cada filial, nós centralizaremos todas as solicitações em uma única filial para poder cotar de uma só vez, posteriormente gerando pedidos de compra para cada uma das filiais das solicitações de compra.
Na tela de compra centralizada, temos duas listas, sendo elas:
(Esquerda) - Solicitações de todas as filiais - menos a logada/centralizadora
(Direita) - Solicitações selecionadas para serem centralizadas/transferidas para filial logada/centralizadora.

As solicitações que foram transferidas, são zeradas na filial de origem e ficam com status roxo.

Já as novas solicitações criadas na filial centralizadora, ficam com status disponível para cotação, passando a aparecer na listagem de necessidade de compra.

Image Added

Todo o processo de cotação com itens centralizado é igual, com apenas duas mudanças do processo comum:

1) Não é possível inserir uma quantidade disponível diferente da quantidade solicitada.

2) É possível configurar a geração dos pedidos de compra de acordo com o parâmetro MV_COTFIAP, sendo:
MV_COTFIAP = E → Os pedidos serão gerados conforme filial de entrega na solicitação de compra, ou seja:

Filial Solicitação de Compra: D MG 02

Filial Centralizadora: D MG 01

Filial do pedido de compra: D MG 02
Filial de entrega do pedido de compra: D MG 02

MV_COTFIAP = C → Os pedidos serão gerados na filial centralizadora com filial de entrega de acordo com a origem da solicitação de compra.

Filial Solicitação de Compra: D MG 02

Filial Centralizadora: D MG 01

Filial do pedido de compra: D MG 01
Filial de entrega do pedido de compra: D MG 02


[Clique na imagem para ampliar]

Expandir
titleContatos x Fornecedores

Um novo cadastro de Contatos x Fornecedores foi criado para ser possível vincular diversos contatos a um fornecedor, possibilitando o envio de workflow para todos eles.
Os contatos poderão ser atualizados de duas formas: 

1) Direto pelo novo fluxo de compras, durante a seleção de fornecedores: 

Image Added


2) Em outras ações no cadastro de fornecedores comum:
Image Added


Cada um dos contatos cadastrados serão automaticamente carregados para tela de envio de workflow, uma vez que tenham o campo "Env WF NFC?" = Sim, caso estejam como não, o cadastro será salvo porém não será carregado automaticamente para envio do WF
Image Added


[Clique na imagem para ampliar]

Expandir
titleCotações
Expandir
titleProcesso de Atualização da Cotação
Expandir
titleCotações

Passo 1: Para acessar as cotações, clique em Cotações, será exibido uma lista com todas as solicitações. Localize a cotação desejada para a atualização, clique na opção editar, abrirá uma página com todos os fornecedores participantes da cotação selecionada, além de exibir no topo da página, um componente para exibir as Solicitações de Compras relacionadas. 

Image Added

[Clique na imagem para ampliar]

Caso um fornecedor tenha respondido a cotação via Workflow o processo de atualização da cotação ocorrerá automaticamente mediante os valores preenchidos no formulário pelo fornecedor.

Image Added

Image Removed Expandir
titleAnalisar por item

Com a proposta completa e possível seguir para a analise da cotação, existem 2(Dois) tipos de análise. 

A seguir temos a por item.

Image Removed

Nesta tela será apresentado todos os itens e todos os valores de todos os fornecedores.

Para melhor visualização existem tags de menor preço e de preço acima da media geral da cotação.

e possível também verificar qual fornecedor adicionou esse preço.

Image Removed

[Clique na imagem para ampliar]

E possível mudar a ordenação de acordo com a necessidade, trazendo primeiro o menor prazo ou o menor preço já considerando os impostos.

Image Removed

Para uma melhor analise ao clicar em detalhes será mostrado um maior detalhamento da proposta.

Image Removed

E para concluir basta selecionar uma proposta e clicar em formalizar compra.


Na hipótese de a cotação conter um fornecedor participante (não cadastrado), não será exibido em tela o código do fornecedor, loja e CNPJ/CPF, no lugar desses valores será apresentado uma indicação de Fornecedor não cadastrado

Image Added

[Clique na imagem para ampliar]

Passo 2: Selecionar o fornecedor que deseja atualizar a cotação e clicar em “Editar”, será direcionado para a página de edição de cotação, como mostra na imagem abaixo.


Image Added
[Clique na imagem para ampliar]

A tela de adição da cotação é dividida em seções de informações referentes a cotação. São Dados do fornecedor, valores referentes a cotação, informações de entrega, impostos totais, dados dos itens cotados  e campos custumizados:

Image Added

[Clique na imagem para ampliar]

E possível na análise por itens, fechar com mais de um fornecedor.

Ao selecionar vários itens no rodapé você terá uma previa dos valores totais.

Image Removed

Expandir
titleFormalizar proposta

Para que o processo seja finalizado e os documentos gerados, e preciso selecionar uma proposta na analise por propostos , ou selecionar todos os produtos na analise por item e clicar 

no botão de Formalizar compra.

Image Removed

Após ter escolhido e formalizado uma compra, a cotação ficará indisponível para edição e com status de finalizada.

Expandir
titleExcluir

Na lateral direita, e possível ter acesso a opção de excluir uma cotação. As cotações excluídas terão seus itens retornados para necessidade de compra.

Vale lembrar que não e possível excluir uma cotação que esteja finalizada, e está ação e irreversível. 

Image Removed

Expandir
titleTroca de Filial

Ao realizar o Login, o sistema possui um Toolbar (barra de ferramentas) na parte superior direita.

Ao clicar no ícone de perfil, ela irá abrir uma janelinha com duas opções:

Image Removed

Ao clicar na opção de 'Trocar de Filial', será aberta uma janela com  dois campos para serem preenchidos: um campo para indicar o Grupo de Empresas e outro campo para indicar a filial (as filiais serão retornadas de acordo com o Grupo de Empresa que foi selecionado). Ao selecionar a filial desejada, basta apenas clicar no botão de 'Confirmar' e a troca de filial será realizada. Ao selecionar uma filial deve se levar em conta a permissão de acesso do usuário.

Image Removed

Painel
borderColorlightgray
borderWidth1
borderStylesolid
titlePRÉ REQUISITOS MÍNIMOS
Aviso

Portal Gestão de Compras necessita do Microsiga Protheus® Release 12.1.2210 ou Superior e arquivos binários com data de expedição igual ou superior a <Em definição>

Aviso

O Portal Gestão de Compras necessita do último pacote da Expedição Contínua do Compras, para manter sua versão sempre atualizada.

E necessário também aplicar pacote de LIB disponibilizado em 27/02/2023.

Informações
titleWORFLOW

PGC (Portal Gestão de Compras) necessita da configuração do Workflow. <Revisar o texto>

Para que seja possível o uso do workflow serão necessárias algumas configurações.

As configurações necessárias são <Revisar a ordem das documentações para facilitar o entendimento>

  1. Configurar o AppServer de e-mail TOTVS;
  2. Configurar o SMTP para envio de relatórios por e-mail;
  3. Configurar webservice SOAP;
Informações
titleREST 2.0

PGC (Portal Gestão de Compras) necessita da configuração do REST 2.0 no de AppServer.

Informações
titleAlias TOTVS Mingle
Para configurar o TOTVS Mingle, o servidor Appserver deve possuir um IP público.
Importante:
Este requisito somente é necessário caso o PGC (Portal Gestão de Compras) seja acessado via navegador através do endereço <Definir endereço>.
O processo embarcado* não necessita deste requisito.<Revisar texto>.
*Embarcado: Acesso via menu do Protheus. Painel
titleCONFIGURAÇÕES

O Portal Gestão de Compras é uma plataforma da web integrada com o modulo Compras (SIGACOM) do Microsiga Protheus®, para efetuar esta integração é necessário que o seu ambiente esteja configurado corretamente com o pré-requisitos listados abaixo:

Aviso
titleLicense Server

Recomendamos a utilização do License Server com data igual ou superior a 14/06/2022.

Totvs custom tabs box
tabs01 - Workflow, 02 - Appserver, 03 - TOTVS Mingle, 04 - Servidor de E-mail
idsconfig1,config2,config3,config4

Passo 3: Preencher os campos editáveis do cabeçalho e os campos editáveis referente aos produtos solicitados conforme a negociação ocorrida com o fornecedor. O preenchimento da Condição de pagamento é obrigatório para a salvar a atualização da cotação. À medida que o usuário preenche os campos com os valores dos itens, o total é calculado automaticamente, permitindo que o usuário visualize os valores enquanto a cotação está sendo preenchida.

O preenchimento da Condição de pagamento é obrigatória para a salvar a atualização da cotação.

Image Added
[Clique na imagem para ampliar]

Para calcular os impostos, referentes aos produtos da cotação, clique em "Outras ações" localizado na parte superior da tela, em seguida selecione a opção Calcular impostos. Os impostos serão calculados em tela e somados ao valor total da cotação. O calculo é baseado nas configurações fiscais cadastradas no produto e no fornecedor realizará os cálculos de impostos


Image Added
[Clique na imagem para ampliar]


Passo 4: Após preencher parcialmente ou totalmente os dados dos produtos solicitados na cotação, o status será atualizado para Parcial ou Completa e a cotação já poderá ser analisada. No exemplo abaixo podemos ver a primeira cotação Completa com zero itens pendentes e  a cotação a baixo Parcial com um item pendente.

Image Added

[Clique na imagem para ampliar]

Passo 5: Caso o ambiente esteja configurado com parâmetro MV_SELFOR inativo (N) ao clicar no botão "Novo participante" será exibida a tela de amarração de Fornecedor x Produto. Exibindo os produtos e os fornecedores vinculados a ele. Para este ambiente não será possível adicionar fornecedores participantes.

Image Added

[Clique na imagem para ampliar]

Passo 6:  Na tela Seleção de Fornecedores X Produto selecione os fornecedores vinculados ao produto como mostra a imagem abaixo.

Image Added

[Clique na imagem para ampliar]

Passo 7: Caso haja necessidade de atualizar o contato de algum fornecedor poderá realizar esta tarefa sem sair da tela clicando no botão Atualizar Contato

Image Added

[Clique na imagem para ampliar]

Passo 8: Após a geração das propostas para o novo fornecedor, será exibida a tela de envio de e-mails e anexos.

Image Added

[Clique na imagem para ampliar]

Expandir
titleProcesso de Análise da Cotação
Expandir
titleAnálise Por proposta


Passo 1: Para iniciar uma análise de cotação e necessário que a cotação possua o status Pronto para Analisar. Na tela de listagem de cotações pressione Outras ações e selecione a opção de Analisar.


Image Added

[Clique na imagem para ampliar]

Passo 2: A análise da cotação poderá ser realizada Por Proposta ou Por Item. A análise por proposta necessita que todos os produtos solicitados tenham passado por atualização da cotação de pelo menos um fornecedor, ou seja, precisam estar com o status Completa apois a edição da cotação.
Através dos cards de proposta pode-se realizar a comparação entre os fornecedores para entender quem tem o Melhor preço sem impostos, Melhor preço com impostos, Menor prazo e Melhor nota

Image Added
[Clique na imagem para ampliar]

Passo 3:Após a decisão do fornecedor vencedor da cotação, clique em Gerar para iniciar o processo de pedido de compras.

Image Added
[Clique na imagem para ampliar]

Passo 3:  Na tela de Formalização da proposta o usuario poderá selecionar se será um pedido ou um contrato para essa cotação, após isso clique no botão de Gerar documentos 
Image Added

[Clique na imagem para ampliar]

Expandir
titleAnálise Por item

Passo 1: Ao selecionar a opção de analisar Por Item conseguirá comparar as propostas de cada fornecedor para o item em questão, e poderá utilizar os status referente a média de preços para auxiliar na escolha do vencedor do item da cotação. 

Observação: A partir da atualização de Julho/2024 o melhor preço já virá selecionado automaticamente.

Image Added

[Clique na imagem para ampliar]

Passo 2: Após a decisão do(s) fornecedor(es) vencedor(es) da cotação clique em Gerar, para iniciar o processo de pedido ou contrato;.

Image Added

[Clique na imagem para ampliar]

Passo 3: Na página de Formalização das propostas, usuário poderá escolher item a item, se será gerado um Pedido de Compra ou um Contrato.

Image Added

  • Para cada item, será exibido o saldo total disponível, bem como o campo Quantidade a ser adquirida, pois quando optado por Item, o comprador pode realizar compras parciais, ou seja, comprar uma determinada quantidade e retornar depois, para comprar o restante da quantidade. Além disso, será exibido o campo de observações, que é exibido ao fornecedor.
  • Por padrão, o campo Quantidade a ser adquirida já é preenchido com o mesmo valor do saldo disponível. O comprador - nesse campo - pode inserir um valor maior que zero e igual ou menor que o saldo disponível, para fechar o pedido. Logo:

    Valor SaldoValor Quantidade a ser adquiridaResultado
    3030Ação será realizada, pois a quantidade inserida está de acordo com o saldo existente (quantidade a ser adquirida igual a saldo disponível).
    3031

    O usuário será alertado, informando que a quantidade inserida é maior que o saldo disponível. Automaticamente, o sistema irá preencher o campo Quantidade a ser adquirida com o valor 30 (valor do saldo).

    3015

    Ação será realizada, pois a quantidade inserida está de acordo com o saldo existente (quantidade a ser adquirida menor que o saldo disponível).

    300

    O usuário será alertado, informando que a quantidade inserida deve ser maior que zero. Automaticamente, o sistema irá preencher o campo Quantidade a ser adquirida com o valor 30 (valor do saldo).

    30-5

    O usuário será alertado, informando que a quantidade inserida deve ser maior que zero. Automaticamente, o sistema irá preencher o campo Quantidade a ser adquirida com o valor 30 (valor do saldo).

  • O comprador pode colocar a quantidade desejada para cada item em tela, selecionando se deseja gerar Pedido de Compra ou Contrato.
  • Após, basta clicar em Gerar documentos, para finalizar o processo.
  • Caso tenha realizado uma compra onde a Quantidade a ser adquirida seja menor que o saldo, o sistema automaticamente irá tirar o valor adquirido do saldo do item para ajustar a compra feita pelo comprador.

    Image Added 


  • Ao tentar realizar uma nova compra, o saldo disponível exibido será menor, visto que já houve compras realizadas anteriormente.

    Image Added
    [Clique na imagem para ampliar]
  • Quando o comprador fechar o pedido ou contrato com valores inferiores ao saldo, a Cotação ficará com o status Atendido Parcialmente, demonstrando que para aquela cotação, o saldo total ainda não foi comprado. Assim, o comprador pode voltar nessa cotação e realizar os mesmos procedimentos descritos nesse item, para realizar a compra do saldo restante, podendo gerar tanto Pedido de Compra ou Contrato, independente de como foi feito a primeira vez. 
    • Quando a cotação fica no status Atendido Parcialmente, ao tentar editar a cotação, não será possível incluir novas propostas, novo participante ou alterar valores, visto que a cotação já teve compras correspondentes.
    • Além disso, quando a compra fica no status Atendido Parcialmente, ao acessar a Análise da Cotação, a aba Por Proposta fica inativa, exibindo uma mensagem e não sendo mais possível fechar a análise por proposta, visto que já temos a análise por item feita.
    • A coluna Quantidade Solicitada informa a quantidade solicitada pelo comprador de acordo com a geração da cotação, a coluna Qtd. disponível Fornecedor informa a quantidade de itens disponíveis no fornecedor.
Informações

Caso queira reabrir a cotação, é necessário ativar o parâmetro MV_PCEXCOT e, em seguida, realizar a exclusão do Pedido de Compra ou Contrato. Para mais informações clique aqui .


Expandir
titleFuncionalidades
Expandir
titleLista de cotações

Clicando em Cotações o usuário será direcionado para a listagem de cotações.


A tela de Cotações é possível:

  • Buscar cotação por código, apelido da cotação e status.
  • Editar, excluir e análisar cotação.
  • Download, adição e exclusão de anexos.

Image Added
[Clique na imagem para ampliar]

As cotações podem ser identificadas por código ou apelido, e a situação pode ser identificada através dos status abaixo: 

  1. Pendente: Situação na qual a cotação ainda não possui nenhuma proposta completa recebida;
  2. Pronto para analisar: Quando existe pelo menos uma proposta completa para ser analisada;
  3. Em análise : Quando apenas um item foi cotado deixando assim a cotação parcialmente atendida. 
  4. Finalizada: Quando a cotação tiver sido completamente atendida. 
Expandir
titleAnexos

Na tela de listagem de cotações, será possível identificar cotações que possuam anexos através do ícone de clipe na coluna Anexo.

Image Added
[Clique na imagem para ampliar]

O ícone ficará visível nas seguintes situações:

  1.  Na Necessidade de Compras foi adicionado anexos à cotação no monento da geração.
  2.  Foi adicionado anexo posteriormente na tela de listagem de cotações.

Ao clicar no ícone, será aberta uma nova janela, onde estarão listados todos anexos vinculados aquela cotação, podendo realizar o download e exclusão dos arquivos.

Importante: Os anexos listados estão vinculados a cotação e não aos fornecedores.


Image Added

[Clique na imagem para ampliar]

É possível adicionar novos anexos a uma cotação. Após a adição caso a cotação não possua anexo, passará a ter o ícone de clipe, evidenciando que a cotação agora possui anexo. Sendo possível anexar um ou mais arquivos de uma vez.

Image Added
[Clique na imagem para ampliar]


Se um documento a ser anexado já existir na base de conhecimento, será apresentada a mensagem abaixo:

Image Added
[Clique na imagem para ampliar]

Expandir
titleFiltros

Ao acessar uma das listas de cotações, haverá dois campos de busca que podem ser utilizados pelo usuário de forma individual ou combinada.


O Filtro por número ou apelido da cotação, realiza a busca pelo código da cotação desejado (informado na solicitação de cotação) ou apelido (estabelecido pelo usuário no momento da geração), para esta utilização e possível inserir o código ou apelido inteiro ou apenas parte dele.

Image Added
[Clique na imagem para ampliar]

Image Added
[Clique na imagem para ampliar]

O Filtro por Tipo de status, por padrão ao acessar a lista de cotações, já virá pré-estabelecido como Todos. Porém o usuário poderá definir qual status de cotação deseja visualizar, sendo eles:

  • Todos;
  • Pendente;

  • Pronto para analisar;

  • Em análise;

  • Finalizada.

Image Added

[Clique na imagem para ampliar]

O Filtro por Comprador permite a busca com base no(s) Comprador(es) desejado(s). O usuário pode pesquisar todas as solicitações geradas por um ou mais compradores selecionados no filtro como mostra a imagem a baixo.

Image Added
Clique na imagem para ampliar]

Expandir
titleEditar
Expandir
titleEditar

Com os orçamentos dos fornecedores em mãos, deverá ser realizada a edição da proposta a fim de inserir os valores passados por orçamento.

Para isto, na tela de listagem de cotações, ao clicar nos três pontos no início linha, existe a opção Editar.

Image Added
[Clique na imagem para ampliar]

Será apresentada a tela com todos os fornecedores que estão participando do processo com algumas informações pertinentes a proposta, são elas:

  • Status da proposta:
    • Pendente;
    • Completa;
    • Completa (E-mail);
    • Parcial;
    • Parcial (E-mail);
    • Desqualificada;
    • Recusada;
    • Não atende;
    • Não atende (E-mail).
  • Nome do fornecedor;
  • Código e loja do fornecedor;
  • CNPJ ou CPF;
  • Total da proposta de cotação deste fornecedor(Caso ainda não foi atualizada, estará zero);
  • Itens pendentes de atualização de preço.
  • Botão de edição.

Em outras ações:

  • Visualização da cotação;
  • Desqualificar fornecedo;
  • Enviar e-mail;
  • Anexos;
  • Nova proposta manual;
  • Nova proposta workflow;
  • Excluir proposta.

Image Added
[Clique na imagem para ampliar]

Expandir
titleNovo participante

Se o usuário desejar incorporar um novo participante após a criação da cotação, ele poderá fazê-lo na tela de Edição da Cotação, onde encontrará um botão localizado no canto superior direito com essa finalidade (Novo participante). Ao clicar nesse botão, o usuário será redirecionado para uma página onde poderá inserir as informações do novo fornecedor participante. No caso de um fornecedor já cadastrado, após inserir o código do fornecedor, os dados serão automaticamente preenchidos, como exemplificado na imagem abaixo.

Atenção: Quando uma cotação é gerada com amarração de produto x fornecedor não será possível adicionar um novo participante. 


Image Added

[Clique na imagem para ampliar]

Para fornecedores ainda não cadastrados selecione a opção "Não" no campo "Fornecedor cadastrado?" e preencha o campo de Razão social


Image Added

[Clique na imagem para ampliar]

Expandir
titleEdição

Ao clicar em Editar, será aberta a tela de edição da proposta do fornecedor.

Image Added
[Clique na imagem para ampliar]

Essa tela é dividida em seções de informações , como detalhado abaixo:

1.    Dados do Fornecedor:

     ●    Código do fornecedor;
     ●    Loja;
     ●    Nome do contato;
     ●    E-mail;
     ●    Número da proposta.

2.    Detalhes de valores referentes a Cotação:
     ●    Total de itens;
     ●    Total da cotação (considerando todos os valores, como itens, frete, descontos, impostos, entre outros);
     ●    Descontos;
     ●    Tipo de frete;
     ●    Valor do frete;
     ●    Despesas;
     ●    Condições de pagamento;
     ●    Moeda;
     ●    Seguro.

3.    Informações de entrega:
     ●    Dias para entrega;
     ●    Endereço entrega;
     ●    Cidade;
     ●    Bairro;
     ●    CEP.

4.    Impostos totais:
     ●    Valor IPI;
     ●    Valor ICMS ;
     ●    Valor ISS;
     ●    Entre outros impostos.
 

5.    Informações dos Itens da Cotação:

     ●    Código do Produto;
     ●    Descrição;
     ●    Unidade de medida;
     ●    Situação do item (considera, sem estoque, não vende);
     ●    Quantidade solicitada;
     ●    Quantidade disponível;
     ●    Preço unitário;
     ●    Total do item;
     ●    Descontos;
     ●    Tipo de entrada;
     ●    Observações;
     ●    Campos customizados;
     ●    Impostos Item.

Descontos:

  • Os descontos poderão ser inseridos de duas formas:
  1. Global para cotação, ou seja, ao preencher o desconto % ou descontos em valor no cabeçalho, o desconto será rateado para todos os produtos;

    Image Added
    [Clique na imagem para ampliar]

  2. Por item, ou seja, ao preencher o desconto no item, o desconto é aplicado somente naquele item e somado no totalizador Descontos no cabeçalho.

    Image Added
    [Clique na imagem para ampliar]

Importante¹: Não é possível inserir desconto global em combinação com desconto por item.

Importante²: Os totalizadores serão atualizados automaticamente sempre que um produto for atualizado.

Expandir
titleStatus da proposta

A listagem de propostas dispõe de tags informativas para indicar o status de cada proposta.

As respectivas tags são: 

  1. Pendente: Situação na qual a proposta ainda não possui nenhum item com valor e quantidade preenchido;
  2. Parcial: Quando existe ao menos um item preenchido;
  3. Parcial (E-mail): Quando existe ao menos um item preenchido respondido via workflow;
  4. Completa: Quando todos os itens da proposta estão preenchidos.;
  5. Completa (E-mail): Quando todos os itens da proposta estão preenchidos e foram respondidos via workflow;
  6. Desqualificada: Quando um fornecedor for desqualificado da cotação;
  7. Recusada: Ocorre quando o fornecedor recusa a proposta;
  8. Não atende: A proposta foi respondida como sem estoque ou Não vende;
  9. Não atende (E-mail): A proposta foi respondida como sem estoque ou Não vende via Workflow.

Image Added

[Clique na imagem para ampliar]

Expandir
titleEnviar e-mail

Na listagem das cotações é possível enviar um e-mail de cotação via workflow para o participante a partir da opção Enviar e-mail. Além disso é também é possível selecionar as condições de pagamento que o fornecedor poderá visualizar no formulário de resposta da cotação.

Image Added
[Clique na imagem para ampliar]

É possível enviar o formulário de workflow para múltiplos e-mails, ou seja, para vários vendedores. Contudo, apenas a primeira resposta recebida será considerada e processada.

Caso necessário, poderá ser enviado alguma informação complementar utilizando o campo observação e escolher se deseja enviar os anexos vinculados a cotação neste e-mail.

Image Added

[Clique na imagem para ampliar]

Expandir
titleAnexos

Na listagem de fornecedores participantes da cotação, é possível adicionar anexos que serão vinculados aos fornecedores. A opção se encontra em outras ações, Anexo(s).

Image Added
[Clique na imagem para ampliar]

Expandir
titleDesqualificar

Caso necessário retirar um fornecedor da cotação, poderá ser utilizada a opção de desqualificação.

Nesta opção, o fornecedor não será considerado para as próximas etapas, bem como terá os valores inseridos na proposta zerados.
Também é possível inserir uma justificativa ou observação para desqualificação do fornecedor.

Image Added
[Clique na imagem para ampliar]

Quando o fornecedor for desqualificado, não será possível atualizar valores da proposta. Sendo possível apenas a visualização.

Caso seja necessário, será possível Qualificar o fornecedor novamente, para que ele volte a participar da cotação.

Importante: Ao Qualificar o fornecedor, a proposta terá todos os valores zerados e voltará para o status Pendente.

Image Added
[Clique na imagem para ampliar]

Expandir
titleImpostos

Na tela de edição da cotação, é possível calcular e visualizar uma prévia do cálculo dos impostos seja da proposta como um todo ou por item.

Importante: Para o cálculo ocorrer corretamente, devemos:

  • Ter uma TES vinculada ao produto em questão (Campo B1_TE)
  • Preencher os valores de todos os itens
  • Selecionar uma condição de pagamento

Ao clicar no botão Calcular impostos o processo será iniciado, após finalização será possível visualizar os valores referentes aos impostos na seção Impostos totais e na seção de Itens da cotação, como demostrado abaixo.

Importante: O cálculo de impostos é apenas para visualização, não sendo possível alterar valores.

Image Added
[Clique na imagem para ampliar]


Expandir
titleDescontos

Durante o preenchimento de uma proposta, temos Descontos por item e global.

Desconto por item:

O desconto por item é aplicado somente a um ou mais itens, sendo somados os valores no campo de Desconto no cabeçalho.

Image Added
[Clique na imagem para ampliar]

Desconto global:

O desconto global será disparado ao preencher o desconto por % ou valor,  tendo o valor de desconto rateado para todos os itens proporcionalmente.
Image Added
[Clique na imagem para ampliar]

Expandir
titleVisualizar

É possível visualizar uma proposta apenas para checagem de dados, sem possibilidade de alterar, inserir ou excluir dados. Esta opção é muito importante para visualizar propostas desqualificadas ou finalizadas.

Image Added
[Clique na imagem para ampliar]

Expandir
titleNova proposta

É possível gerar uma nova proposta para alterar valores e conseguir manter um histórico de negociações.

Image Added
[Clique na imagem para ampliar]

Nova proposta manual:

Ao escolher a opção de criar uma nova proposta manual, você será direcionado para uma tela onde terá a opção de manter ou não os valores da proposta atual. Após essa etapa, você terá acesso a uma nova tela onde poderá preencher, ou alterar, os valores antes de finalizar a criação da nova proposta.

Image Added

[Clique na imagem para ampliar]

Nova proposta workflow:
Ao selecionar a opção de nova proposta workflow, será exibida uma tela onde é possível informar se deseja ou não manter os valores da proposta atual, selecionar as condições de pagamento, informar um ou mais e-mails para receber o formulário e a obervação. Ao clicar em enviar e-mail, será gerada uma nova proposta e enviado um novo workflow.

Image Added

[Clique na imagem para ampliar]

Se o fornecedor tiver mais de uma proposta, e se necessário, é possível fazer a exclusão da proposta vigente, como podemos observar abaixo.

Image Added

[Clique na imagem para ampliar]

Expandir
titleItens da cotação - Excluir item não utilizado

Na tela de Editar Cotação, temos um grupo inicial chamado Itens da Cotação.

Ao clicar nesse grupo, a lista é expandida e exibe todos os itens que estão associados na cotação atual, ou seja, exibe os produtos que estão sendo cotados. Caso entenda que um item não seja mais necessário e deseja excluir esse item da cotação, temos a opção Remover, que fica na frente de cada item constante na cotação.

Ao clicar em remover, o sistema exibe uma modal, informando se deseja realmente excluir o item da cotação, detalhando o item selecionado e informando que ao realizar a remoção, não é possível reverter o processo. 

Aviso
titleAtenção

Caso o item a ser deletado tenha sido agrupado, apesar de ser mostrado separadamente cada item no grupo Itens da Cotação, ao excluir qualquer um que esteja no agrupamento, todos serão deletados, visto que o sistema grava o agrupamento como item único na SC8.

Image Added
[Clique na imagem para ampliar]

Expandir
titleAnalisar
Expandir
titleAnálise por proposta

Quando o status da cotação estiver igual a Pronto para analisar será possível iniciar o processo de análise, a fim de verificar as melhores condições ofertadas.
O processo de análise, se divide em dois tipos: 

  1. Análise por proposta.
  2. Análise por item.

Análise por proposta:

Consiste em mostrar todas as propostas completas, ou seja, que possuem todos os itens preenchidos, para análise das condições.

Na tela de listagem de cotações, ao clicar nos três pontos no início da linha, temos a opção Analisar.

Image Added
[Clique na imagem para ampliar]

As informações mais relevantes além dos dados do fornecedor, serão mostradas dentro do card, como:

  • Total sem impostos
  • Total com impostos
  • Valor total de frete
  • Prazo de entrega

Image Added
[Clique na imagem para ampliar]

As propostas poderão ser ordenadas por:

  • Melhor preço sem impostos
  • Melhor preço com impostos (considera IPI e ICMS Solidário como critério de ordenação)
  • Menor prazo
  • Melhor nota.

Por padrão, a ordenação é realizada pelo melhor preço sem impostos.

Image Added
[Clique na imagem para ampliar]

É possível obter mais informações da proposta ao clicar no botão detalhes. Será listado todos dados relevantes da proposta, tais como valores, produtos, fretes, etc.

Image Added
[Clique na imagem para ampliar]

Expandir
titleAnalisar por item

Quando o status da cotação for Pronto para analisar será possível iniciar o processo de análise, a fim de verificar as melhores condições.
O processo de análise se dará de duas formas: 

  1. Análise por proposta
  2. Análise por item

Análise por item:

Na tela de listagem de cotações, ao clicar nos três pontos no início da linha, temos a opção Analisar.

Consiste em mostrar todas as propostas, ou seja, as que estão completas ou parciais. A análise por item, permite você realizar a compra de produtos diferentes com mais de um fornecedor na mesma cotação.

Exemplo: Estou cotando material para o meu escritório. O fornecedor A possui o melhor preço para PAPEL A4, porém A Caneta está bem mais caro comparado ao fornecedor B

Utilizando a análise por item, podemos comprar o Papel A4 com o fornecedor A e a Caneta com o fornecedor B na mesma cotação.


Image Added

[Clique na imagem para ampliar]

A listagem é feita por produto, em cada item teremos as respectivas propostas dos fornecedores para ele.

Para auxiliar na análise, temos as informações de média de valores unitários e totais, juntamente com uma tag mencionando se o valor do item está acima da média, dentro da média ou é o melhor preço para aquele produto.

Além disso, serão listadas as informações como quantidade disponível, valor unitário, dias para entrega, frete e total a pagar.

Image Added

[Clique na imagem para ampliar]

Conforme é feita a análise, os itens selecionados são somados e demonstrados no rodapé, como:

  • Total dos itens(bruto)
  • Frete
  • Descontos
  • Outro valores (Seguro e/ou despesas)
  • Total a pagar (líquido sem impostos)

Image Added
[Clique na imagem para ampliar]


Expandir
titleMapa da cotação

Ao acessar a tela de análise de cotação, temos o mapa da cotação, uma ferramantea utilizada para comparar preços de produtos ou serviços de diferentes fornecedores ou fontes. O principal objetivo do mapa de cotação é fornecer uma visão clara e organizada dos preços de produtos ou serviços oferecidos por diferentes fornecedores. Isso permite que os compradores identifiquem facilmente as opções mais econômicas e competitivas.

Para facilitar a análise o mapa de cotação traz de forma simplificada Item vs Fornecedor, exibindo as informação abaixo :

  • Descrição do item;
  • Valor Unitário;
  • Valor total do item;
  • Quantidade solicitada;
  • Unidade de medida;
  • Fornecedor e valores referente a proposta feita.

Image Added
[Clique na imagem para ampliar]

Expandir
titleFormalizar proposta

Ao escolher a proposta ou os itens vencedores, será habilitado o botão de Gerar para a inicializar o processo de pedido ou contrato.

Image Added
[Clique na imagem para ampliar]

No entanto, caso o fornecedor selecionado não apresente o melhor preço, um campo será exibido na tela para que o usuário possa justificar sua escolha. Isso é exemplificado nas imagens abaixo:

Image Added

Tela de Justificativa Análise por proposta[Clique na imagem para ampliar]


Justificativa tela análise por item:
Justificativa Análise por itemImage Added

Tela de Justificativa Análise por item[Clique na imagem para ampliar]

Caso o vencedor seja um fornecedor participante (não cadastrado), será exibido um alerta sobre a condição do mesmo, exigindo cadastro para a conclusão do processo.

Image Added
[Clique na imagem para ampliar]

A tela de cadastro de fornecedor possui quatro abas: 

  1. Cadastrais: Formulário para preenchimento de dados do fornecedor;
  2. Adm/fin.: Formulário para preenchimento de dados administrativos e financeiros;
  3. Fiscais: Formulário para preenchimento de dados fiscais;
  4. Campos obrigatórios: Formulário para preenchimento de campos obrigatórios.
  5. Campos customizados: Formulário para preenchimento de campos customizados.

Campos obrigatórios serão sinalizados com asterisco (*) no fim do seu nome, e somente após a obtenção dos mesmos o botão Salvar ficará habilitado para o cadastro do fornecedor.

Informações

Para obter alguns campos de informações do fornecedor após o preenchimento do CNPJ, é necessário a utilização do parâmetro MV_APIFOR (com valor .T. ), para habilitar o preenchimento automático utilizando a TOTVS CAROL.


Image Added

[Clique na imagem para ampliar]

Após clicar no botão gerar será direcinado a uma tela contendo o resumo dos produtos e fornecedor/fornecedores selecionados, Nessa tela o usuário poderá escolher se será um pedido ou contrato. 

A figura abaixo representa o processo de Análise por Proposta, ou seja, apenas um fornecedor. Neste ponto, o usuário terá a opção de gerar um contrato ou um pedido para esta cotação. Após fazer sua escolha, basta clicar em Gerar Documentos, conforme exemplificado a seguir:

Image Added
[Clique na imagem para ampliar]

No caso do processo de Análise por Item, o usuário terá a flexibilidade de gerar tanto pedidos quanto contratos para fornecedores diferentes, como demonstrado na imagem abaixo:

Image Added
[Clique na imagem para ampliar]


Para a geração de contratos o usuário deverá escolher a forma de pagamento e o tipo de contrato, como podemos ver abaixo:

Image Added
[Clique na imagem para ampliar]

Após a geração do documento e a contenplação de todos os itens solicitados, o status da cotação é atualizado para "Finalizada". Se algum item não for gerado pedido ou contrato, o status será alterado para "Em análise" ou "Atendido parcialmente", dependendo do caso.

Expandir
titleExcluir

Na tela de listagem de cotações, é possível excluir a cotação ao clicar nos três pontos e opção Excluir. As cotações excluídas terão seus itens retornados para Necessidade de Compra.

Importante: Não será possível excluir uma cotação que esteja Finalizada ou Em análise.

Image Added
[Clique na imagem para ampliar]

Expandir
titleVisualizar Pedido de Compra/Contrato

Na tela de listagem de cotações, é possível visualizar os Pedidos de Compras e Contratos gerados a partir da cotação, quando a cotação estiver nos status Em Análise e Finalizada. Para exibir, basta clicar na seta a esquerda do grid, que o sistema irá exibir os Pedidos de Compra e Contratos localizados para a cotação. 

Importante: Caso exista apenas Pedido de Compras, será exibido apenas os pedidos de compras, ao clicar na seta. O mesmo ocorre quando temos apenas Contratos. 
Quando existir contratos e pedidos de compras, ambos serão exibidos.


Image Added
[Clique na imagem para ampliar]

Expandir
titleMigrar cotações

É possível migrar cotações geradas pelas rotinas de "Gera cotação, atualiza cotação e analisa cotação" para o Novo Fluxo de Compras através do migrador disponibilizado no botão do canto superior direito.

Esta opção realiza a compatibilização de cotações já existentes na base para que sejam compatíveis com o novo fluxo de compras, podendo então ter o seu processo continuado através das novas rotinas do NFC ou até mesmo possuir o histórico de cotações já finalizadas.

Todo o processo é realizado em segundo plano e o usuário possui a opção de receber uma notificação por e-mail quando a migração for finalizada. Caso o servidor de e-mail necessite de autenticação, será necessário ativar o parâmetro MV_RELAUTH.

Importante: A migração é irreversível, não há como desfazer a compatibilização e voltar as cotações para as rotinas legadas.

Image Added





03. PRÉ-REQUISITOS MÍNIMOS

Aviso

O Novo Fluxo de Compras necessita da LIB do Framework Protheus® igual ou superior a data de 27/02/2023 que pode ser baixada no endereço: LIB-download.


04. CONFIGURAÇÕES

Abaixo seguem os processos que devem ser configurados:

Totvs custom tabs box
tabs01- Acesso, 02 - Workflow, 03 - Porta Multiprotocolo
idsconfig1,config2,config3,config4
Totvs custom tabs box items
defaultyes
referenciaconfig1
Informações
titleAcesso Embarcado - Protheus

*Embarcado: Acesso via menu do Protheus.

Necessário adicionar ao menu do Compras a rotina PGCA010 para acesso ao NFC via menu do Protheus. A partir do release 12.1.2410 a rotina estará no menu por padrão.

Exemplo:

Image Added

Totvs custom tabs box items
defaultno
referenciaconfig2
Informações
titleWORKFLOW

O Workflow poderá ser configurado para envio da solicitação de cotação diretamente aos fornecedores participantes.
Possibilitando o fornecedor, através de um formulário recebido no e-mail, informar preço, prazo e condições de oferta de seu produto, atualizando automaticamente a cotação no Protheus.

Informações
titleCOMO CONFIGURAR O WORKFLOW
Informações
titleAtenção

O Workflow pode ser configurado de duas maneiras: via Wizard (Configurador do Workflow), que é um assistente passo-a-passo para facilitar a configuração, disponível na página do NFC, somente para usuários administradores; bem como pode ser configurado manualmente, seguindo as orientações do presente documento.

Temos também o wizard para criação da caixa de e-mail para os compradores - direto no workflow - que fica disponível apenas se o parâmetro MV_PGCWF estiver ativo na base ou então, a configuração pode ser de forma manual.

Caso queira utilizar o Wizard para configurar o WorkFlow, leia a instruções contidas clique na aba Via Wizard. Caso queira configurar manualmente, leias as instruções da aba Via Manual.

Aviso
titleDica

Utilize o facilitador de teste WFTEST padrão do Protheus para validar de forma fácil a configuração e funcionamento do workflow. Acesse a documentação: Clique aqui | WFTEST

Totvs custom tabs box
tabsVia Wizard, Via Manual
idswizard,manual
Totvs custom tabs box items
defaultyes
referenciawizard
Expandir
titleConfiguração WorkFlow
  • Para iniciar o processo de configuração de Workflow via NFC, o usuário logado deve ser do tipo administrador no Protheus. Para configuração, siga as etapas abaixo:
    • Acesse o NFC com usuário administrador;
    • Clique no botão de perfil (ícone a direita, na parte superior da tela), para exibir os submenus existentes. Clique no menu com o nome Configuração Workflow
      Image Added

    • Siga as etapas do wizard, informando os dados solicitados:
      • No primeiro passo do configurador - o sistema irá explicar para que serve o Wizard de WorkFlow e seus objetivos, para que o usuário possa compreender seu funcionamento.
        Image Added
      • Na segunda etapa do wizard - Parâmetros e arquivos - informe no campo Diretório de trabalho do Workflow - o local (pasta) onde os arquivos físicos do wizard serão gravados no servidor. Por exemplo, se os arquivos serão gravados na estrutura Protheus_Data\workflow, informe \workflow no campo.
        OBS: O valor do campo será armazenado nos parâmetros (SX6) MV_WFDIR e MV_WFDHTTP
        Além disso, constará nessa tela links para acesso da documentação de referência do NFC, bem como dos dois arquivos html que são usados para envio do e-mail aos fornecedores. Realize o download desses arquivos e coloque-os na mesma pasta do campo acima.
        Clique no botão Próxima Etapa, para avançar no wizard.
        Image Added
      • Na terceira etapa - Dados do servidor - informe o Endereço (IP) público do servidor de workflow; informe a Porta do Servidor de workflow; informe o Nome do Ambiente onde o workflow é executado e no campo Nome/IP e porta do servidor , o sistema monta automaticamente a sugestão, com o endereço ip, porta e nome do ambiente.
        OBS: O valor do campo Nome/IP e porta do servidor de workflow será armazenado no parâmetro (SX6) MV_WFBRWSR.
        Clique no botão Próxima Etapa, para avançar no wizard.
        Image Added

      • Na quarta etapa - Porta Multiprotocolo - o sistema avisará se existe a chave[MULTIPROTOCOL] no ambiente e se está ativa.
        Clique no botão Próxima Etapa, para avançar no wizard.
        Image Added

      • Na quinta etapa - Parâmetros de e-mail dos compradores - informe os dados solicitados na tela, como endereço e porta do servidor SMTP e POP3/MAP, para que quando o parâmetro MV_PGCWF estiver ativo, os usuários não necessitem e informar estes campos no wizard de configuração de e-mail.
      • OBS: Os valores dos campos dessa etapa serão gravados nos parâmetro (SX6):
        MV_PGCPISV - Servidor de e-mail POP 3/ IMAP dos compradores;
        MV_PGCPIPO - Porta de e-mail POP 3/ IMAP dos compradores;
        MV_PGCSMSR - Servidor de e-mail SMTP dos compradores;
        MV_PGCSMPO - Porta de e-mail SMTP dos compradores;
        MV_PGCTAUT - Tipo de autenticação do servidor de e-mail: TLS, SSL ou nenhum
        Clique no botão Próxima Etapa, para avançar no wizard.
        Image Added

      • Na sexta etapa - Finalização - o sistema alerta que ao avançar, os dados serão gravados na base e o sistema irá montar o modelo de appserver.ini, além de apresentar uma notificação de sucesso.

Image Added

Expandir
titleConfiguração - e-mail do comprador
  • Para iniciar o processo de configuração de E-mail de comprador via NFC, o parâmetro MV_PGCWF deve estar ativo no ambiente. Para configuração, siga as etapas abaixo:
    • Acesse o NFC;
    • Clique no botão de perfil (ícone a direita, na parte superior da tela), para exibir os submenus existentes. Clique no menu com o nome Wizard E-mail comprador
    • Siga as etapas do wizard, informando os dados solicitados:
      • No primeira etapa do configurador - o sistema irá explicar para que serve o Wizard de e-mail do comprador e seus objetivos, para que o usuário possa compreender seu funcionamento.
      • Na segunda etapa do wizard - E-mail do comprador - o sistema permite que o usuário informe o nome da caixa de e-mail (por padrão, será o e-mail do usuário, sem caracteres especiais), o nome do comprador (que irá no e-mail) e o e-mail do usuário (que consta no cadastro de usuários do sistema, não permitindo alteração).
        Clique no botão Próxima Etapa, para avançar no wizard.
      • Na terceira etapa - Autenticação - o campo de e-mail será preenchido automaticamente, conforme e-mail cadastrado no usuário, e deve informar a senha do e-mail, que será usada na autenticação dos servidores de e-mail.
        Clique no botão Próxima Etapa, para avançar no wizard.
      • Na quarta etapa - Servidores SMTP e POP 3/IMAP - caso o usuário administrador tenha usado o wizard de configuração de parâmetros e webservice ou preenchido os parâmetros MV_PGCPISV, MV_PGCPIPO, MV_PGCSMSR, MV_PGCSMPO e MV_PGCTAUT, as informações de servidores SMTP e PO3/IMAP estarão preenchidas automaticamente, bastando seguir para a próxima etapa. Mas caso seja necessário o usuário pode mudar manualmente, conforme sua necessidade.
        Clique no botão Próxima Etapa, para avançar no wizard.
      • Na quinta etapa - Finalização - o sistema alerta que ao avançar, será criada uma nova caixa de e-mail e será disparado um e-mail de teste, para conferência dos dados imputados. No final, será exibido o alerta de sucesso, indicando que a conta foi criada com sucesso.

Image Added


  • Para editar senha ou outra característica do e-mail criado do comprador:
    • Basta refazer os passos acima, para que o sistema entenda que se trata de uma alteração e salve os novos valores no sistema. No final, o sistema emitirá um alerta, informando que o e-mail foi alterado com sucesso.
    • Importante: Caso altere o nome da caixa de e-mail, o sistema irá verificar se já existe para aquela filial, um nome igual. Se existir, por medida de integridade de dados, o novo nome será desconsiderado e mantido o atual.
      • Ao nomear a caixa de e-mail, utilize apenas letras, números e sublinhado (_), para criar o nome. Caso coloque espaço em branco, será automaticamente convertido para sublinhado e outros caracteres especiais serão desconsiderados, além do sistema converter tudo para maiúsculo. Por exemplo, se colocar o nome "Rt 78%#o", o sistema irá converter para "RT_78O".
      • Por padrão, o sistema irá trazer como sugestão de nome o e-mail do usuário, mas sem os caracteres especiais (apenas o sublinhado é aceito). Ou seja, se o e-mail do usuário for [email protected], será exibido COMPRASFINANCEIROTESTECOMBR;
      • No campo Nome da Caixa de e-mail, serão aceitos apenas letras, números e sublinhado (_, conhecido como underline). Qualquer outro caractere será desconsiderado, ou seja, se for digitado compr.$a_s1@teste, será convertido para COMPRA_S1TESTE;
      • Espaço em branco no nome será convertido para sublinhado, por exemplo, minhA CAI2a, será convertido para MINHA_CAI2A.
Totvs custom tabs box items
defaultno
referenciamanual
Expandir
titlePasso 1 - Configuração do WebService no appserver.ini
  • Atualizar o appserver.ini do seu ambiente com configurações essenciais que possibilitará o fornecedor receber e responder o formulário de solicitação de cotação.

    Copie e insira no seu ambiente o exemplo abaixo, altere as informações em negrito para informações do seu ambiente, tais como:
    PATH: Caminho de pastas no seu servidor até o diretório Protheus_data\http-root (se a pasta http-root não existir, pode-se cria-la)
    PORT: Porta de comunicação do WebService ( Normalmente inicia-se com 80 )
    ENVIRONMENT: Nome do ambiente/RPO
    localhost:8091: IP público e porta aberta para que o fornecedor consiga enviar a resposta do formulário de cotação
    ONSTART: Caso o seu appserver.ini já possua uma chave ONSTART, adicione os jobs JOB_WS_T1,WF_INDEX nesta chave.

    Informações
    iconfalse
    titleEXEMPLO WEBSERVICE PGC

    ;-------------------------------- WEBSERVICE - NFC--------------------------------------------

    [HTTP]
    ENABLE=1
    PATH=C:\TOTVS\Protheus12_2310\Protheus_data\http-root
    PORT=8091
    ENVIRONMENT=P2310
    INSTANCES=1,10
    XFRAMEOPTIONS=ALLOW-FROM *
    UPLOADPATH=\web

    [localhost:8091/ws]
    ENABLE=1
    PATH=C:\TOTVS\Protheus12_2310\Protheus_data\web\ws
    ENVIRONMENT=P2310
    INSTANCENAME=WS
    RESPONSEJOB=JOB_WS_T1
    DEFAULTPAGE=wsindex.apw

    [JOB_WS_T1]
    TYPE=WEBEX
    ENVIRONMENT=P2310
    INSTANCES=1,10
    SIGAWEB=WS
    INSTANCENAME=WS
    ONSTART=__WSSTART
    ONCONNECT=__WSCONNECT
    PREPAREIN=ALL

    [localhost:8091/wf]
    enable=1
    port=8091
    PATH=C:\TOTVS\Protheus12_2310\Protheus_data
    environment=P2310
    responsejob=WF_INDEX
    DEFAULTPAGE=wsindex.apw

    [WF_INDEX] 
    TYPE=WEB
    environment=P2310
    INSTANCES=1,10
    SIGAWEB=WF
    INSTANCENAME=WF
    ONSTART=STARTWEBEX
    ONCONNECT=CONNECTWEBEX
    ONEXIT=FINISHWEBEX

    [MAIL]
    Protocol=SMTP
    ExtendSMTP=1
    SSLVersion=3
    AuthLOGIN=1
    AuthPLAIN=1
    TLSVersion=3

    [OnStart]
    jobs=JOB_WS_T1,WF_INDEX



Expandir
titlePasso 2 - Configuração do parâmetro MV_WFBRWSR

Realizar a configuração do parâmetro que indicará a URL ou nome do servidor HTTP.

  • No passo 1, definimos o IP e Porta público que será utilizado para receber o retorno da solicitação de cotação do nosso fornecedor, este mesmo IP e Porta deverá ser informado no parâmetro MV_WFBRWSR.

    Aviso
    titleImportante:

    O parâmetro deverá ser preenchido iniciado por http:// ou https://
    Exemplo: http://localhost:8091/wf
     
    Onde localhost:8091 será o seu IP e porta Público definido no passo 1.                                                                                                                                                       


    Image Added


Expandir
titlePasso 3 - Diretório de disponibilização de HTMLs

Verificar a existência da pasta "workflow" dentro da pasta "Protheus_data" no diretório de instalação do Protheus. Caso não exista, pode-se cria-la.

  • Realizar o download conforme as orientações baixo, descompactar e coloca-los dentro da pasta workflow citada acima.

Exemplo:

Image Added


  • Aviso
    titleImportante:

    Caso opte por disponibilizar os arquivos em outro diretório, não deixe de atualizar o parâmetro MV_WFDIR do passo 4.                                                                                                                                                    

  • Versionamento:
    • É essencial verificar a versão correta dos arquivos do formulário workflow. Se não forem encontrados ou estiverem em uma versão incorreta, o sistema apresentará a seguinte mensagem: 'O arquivo pgca030_mailXXX_AAAAMMDD.HTML utilizado pelo workflow não foi encontrado ou está desatualizado. Para baixar o arquivo atual, consulte a documentação do NFC na seção de Workflow'.
  • Observações:
    • Para pacotes de expedição contínua anteriores a , deve-se utilizar o arquivo formulario_workflow_sem_versao.zip
    • Para preservar a integridade da funcionalidade do workflow, é importante não alterar o nome dos arquivos HTML.
  • Versões:
Expandir
titlePasso 4 - Configuração do parâmetro MV_WFDIR

Realizar a configuração do parâmetro que indicará o diretório onde os arquivos HTMLs do passo 4 foram disponibilizados.

  • No passo 3, definimos o diretório onde será disponibilizado os arquivos HTMLs, este mesmo diretório deverá ser informado no parâmetro MV_WFDIR
    Exemplo de conteúdo do parâmetro MV_WFDIR: \workflow

    Image Added

    Aviso
    titleImportante:

    Caso opte por disponibilizar os arquivos em outro diretório, não deixe de mover os arquivos HTMLs para o diretório correto, seguindo o passo 3.                                                                                                                                           

    Aviso
    titleAtenção - WFTEST

    O workflow do NFC se comporta igual a rotina WFTEST - rotina que visa testar se as configurações de workflow estão corretas, enviando e-mail de teste.
    Logo, se ao executar a rotina WFTEST ocorrer erro - o workflow do NFC também não será enviado, por seguir o mesmo comportamento - verificar se as configurações de parâmetros (SX6) e do appserver.ini do ambiente estão corretas - verificando as informações presentes nesse manual - para que o workflow do NFC funcione adequadamente.

    Informações sobre a rotina WFTEST estão no tópico Assuntos Relacionados.

Expandir
titlePasso 5 - Configuração de e-mail no Protheus

Realizar a configuração do e-mail que enviará o formulário para o fornecedor solicitando a cotação:

  • Acessar o módulo do configurador > Ambiente > WorkFlow > Contas de e-mail > Incluir
    Image Added

    Exemplo de configuração do e-mail do GMAIL:

    mceclip0.pngImage Added

    Informações
    titleObservações:
    • Atualmente a maioria dos provedores SMTP utilizam uma porta diferente da padrão, geralmente usam a 465 ou 587. 
    • O Gmail utiliza a porta 465 quando a segurança utilizada é a SSL e a porta 587 quando a segurança é a TLS.
    Aviso
    titleImportante:

    O processo acima não está relacionado a configuração de e-mail para relatórios, descrito na documentação: Configurar o SMTP para envio de relatórios por e-mail;



Expandir
titlePasso 6 - (Opcional) - Envio de solicitação de cotação com e-mail do Comprador

É possível enviar a solicitação de cotação para o fornecedor utilizando o e-mail do Comprador, assim possibilitando ao fornecedor responder diretamente ao comprador alguma dúvida ou pergunta.

Como habilitar este recurso?

  1. Habilite o parâmetro MV_PGCWF
  2. Realize o passo 5 da configuração, cadastrando o e-mail do comprador (Esta rotina de cadastro poderá ser disponibilizada no menu do comprador para ele mesmo realizar o cadastro - WFC003).
  3. O e-mail cadastrado deverá constar no cadastro de usuário do mesmo.

    Image Added

    Aviso
    titleImportante:

    O valor padrão do parâmetro MV_PGCWF é desativado, onde usará a conta de e-mail padrão do Protheus definida no MV_WFMLBOX.

Totvs custom tabs box items
defaultno
referenciaconfig3
Informações
titlePorta Multiprotocolo
  • Na seção GENERAL, deve-se incluir a chave “App_Environment”, cujo valor deve ser o nome do ambiente onde os serviços serão executados. 
  • Na seção DRIVERS,  deve-se habilitar a porta multiprotocolo na chave “MultiProtocolPort” com o valor = 1.
  • Por padrão a conexão SSL está ativa na porta multiprotocolo, os detalhes das configurações estão disponíveis na documentação Application Server - Porta Multiprotocolo. Para desabilitar a conexão por SSL é necessário informar a chave “MultiProtocolPortSecure = 0”

Para mais informações sobre essa configuração acesse a página Application Server - Porta Multiprotocolo.

05. NOTAS DE VERSÃO

Abaixo você pode visualizar todas novidades liberadas em cada versão:

Expandir
titleExpandir
Expandir
titleJulho/2024
  1. Atualização para melhor visualização das colunas e seus nomes em tabelas/listagens.
  2. Implementação de funcionalidade para guardar configuração do usuário em campos selecionados para serem visualizados ou ocultados em tabelas/listagens.
  3. Implementação de funcionalidade para selecionar automaticamente vencedor com melhor preço na análise por item
  4. Implementação de "desistência da compra" onde permite remover item da cotação durante o andamento da mesma.
  5. Implementação do migrador de cotações
Expandir
titleJunho/2024
  1. Implementação da funcionalidade de compra centralizada.
  2. Implementação da funcionalidade de contatos x fornecedores para envio do workflow.
Expandir
titleAbril/2024
  1. Implementação de nova interface MVC para edição da cotação
  2. Implementação da edição de impostos via nova interface de edição da cotação
  3. Implementação de impostos IPI e ICMS-ST no formulário workflow a serem editados pelo fornecedor
  4. Implementação de seleção de condição de pagamento flexível no envio do workflow
  5. Implementação de rotina automática de edição de cotação
  6. Implementação de possibilidade de pontos de entrada durante a edição da cotação via nova interface.
  7. Correções gerais de usabilidade e performance
Expandir
titleMarço/2024
  1. Implementação da opção "salvar rascunho" no formulário workflow.
  2. Correções gerais de usabilidade e performance
Expandir
titleFevereiro/2024
  1. Implementação da análise de cotação por item parcial
  2. Correções gerais de usabilidade e performance
Expandir
titleJaneiro/2024
  1. Implementação da visualização da observação da solicitação de compras
  2. Implementação de filtro por comprador na listagem de cotações
  3. Visualização de dados do fornecedor na tela de edição da cotação
  4. Visualização clara de moeda utilizada na edição da cotação
  5. Correções gerais de usabilidade
Expandir
titleDezembro/2023
  1. Implementação de geração de cotação utilizando Produto x Fornecedor e MV_SELFOR = N
  2. Implementação de visualização de solicitações de compras vinculadas a cotação.
  3. Implementação de listagem de pedidos e contratos gerados pela cotação.
  4. Correção de ordenação de proposta por preço considerando impostos.
  5. Alteração de texto para melhor entendimento de análise por proposta completa.
  6. Ajuste para permitir alteração da TES quando a cotação foi preenchida por Workflow.
  7. Implementação de Guia de configuração do e-mail do comprador.
  8. Implementação de Guia de configuração e sugestão do Workflow.
Expandir
titleNovembro/2023
  1. Correção no funcionamento do WorkFlow, possibilitando a utilização do "WFTEST" padrão para testar funcionamento.
  2. Correção na listagem de solicitações de compras quando campo C1_DATPRF marcado como browse.
  3. Correções gerais de usabilidade e performance.
Expandir
titleOutubro/2023
  1. Correções diversas nos anexos;
  2. Correção no filtro da necessidade de compras;
  3. Correção no cadastro de novo participante;
  4. Correção no refresh do carrinho de compras;
  5. Correção no formulário de workflow;
  6. Correções gerais de performance e usabilidade;
Expandir
titleSetembro/2023
  1. Implementada funcionalidade para obter informações do CNPJ do fornecedor, através da API da TOTVS Carol.
  2. Implementada geração de cotação para fornecedor Participantes.
  3. Incluída nova coluna que exibe a quantidade de respostas dos fornecedores recebidas pela cotação.
  4. Implementada geração de contrato.
  5. Implementada funcionalidade para geração de novo fornecedor para a cotação.
  6. Correção para limpeza do localStorage na inicialização da aplicação.
  7. Correção para encontrar os anexos corretamente quando o fornecedor for participante.
  8. Removido carregamento de campos do tipo Memo para a tela de Necessidade de Compras.
  9. Correção para validar tipo de contrato e planilha fixos independentemente do parâmetro MV_VLDTPFI.
  10. Correção para que as colunas retornem a quantidade de propostas respondidas e descartadas.
Expandir
titleJunho/2023
  1. Implementado Campos customizados no Browse de Necessidade de Compras e Cotações.
  2. Implementado funcionalidade de salvar preferências de campos do tipo suite em Necessidade de Compras.
  3. Efetuada melhoria do retorno das mensagens da API de Workflow para facilitar implantação.
  4. Correção para que após efetuar a busca por código de produto e limpar o campo.
  5. Correção para remover obrigatoriedade dos campos na atualização dos contatos.
  6. Correção para que ao declinar Proposta do Workflow o processo ocorra corretamente.
  7. Correção para que ao utilizar outras moedas no formulário de Workflow a gravação ocorra corretamente.
  8. Correção para o bloqueio de produtos que ocorria de forma intermitente na Geração de Cotação.
  9. Correção do ícone de anexo ao visualizar anexos e fechar a lista.
  10. Correção para considerar os valores de despesa e seguro na Análise Por item.
  11. Correção para que após efetuar Análise "Por Item" de Cotação Parcial seja possível dar continuidade ao processo com a quantidade restante.
  12. Correção para que executar a URL correta da API de Análise de Cotação.
  13. Correção para que ao deletar todos os anexos antes de enviar Workflow, não ocorra validação de Anexo não encontrado.
  14. Correção para que não seja permitido data de recebimento da cotação inferior a data atual.
Expandir
titleMaio/2023
  1. Implementado Mapa de Cotação.
  2. Implementado Filtro por Grupo de Produto.
  3. Inclusão do Campo de TES na Edição da Cotação.
  4. Inclusão de funcionalidade de Exclusão de Proposta.
  5. Correção de documento Anexo não Encontrado.
  6. Correção de descrição do Título da Tela de Edição da Cotação.
  7. Correção do campo de desconto ao utilizar Nova Proposta.
  8. Correção para não permitir desconto negativo na Edição da Cotação.
  9. Correção de erro ao desistir de baixar o anexo.
  10. Correção no Endpoint para retornar propostas parciais de Fornecedores.
  11. Correção de mensagem de produto bloqueado para produtos liberados.
  12. Correção de erro exibido ao realizar filtro na aba Atendidas.
  13. Correção no loading da busca de produto.
  14. Correção na tela de Demais Campos para não salvar dados ao clicar em Fechar.
  15. Correção do campo quantidade disponível quando MV_ZERPROP = 1.
  16. Correção na exibição dos Impostos Complementares na Tela de Impostos por item.
  17. Correção no campo Tipo de Frete da Edição de Cotação para mesmo comportamento do legado.
  18. Correção do retorno das cotações por ordem do total da cotação.
Expandir
titleAbril/2023
  1. Implementação dos campos de Quantidade de fornecedores participantes e quantidade de produtos cotados na listagem de cotações.
  2. Implementação de filtro por status "Todos, pendente, em análise e finalizado" na listagem de cotações.
  3. Implementação dos campos customizados da tabela SC8 na edição de cotação.
  4. Implementação de edição da observação a ser levado para o pedido de compra na análise de cotação
  5. Implementação de opção para gerar novas propostas, manual e via workflow.
  6. Correção no envio de e-mail por workflow.
  7. Correção para mostrar mensagem de aviso ao atualizar contato de fornecedor que esteja aberto por outro usuário.
  8. Correções gerais de usabilidade e desempenho.

06. TABELAS E PARÂMETROS

Abaixo você pode visualizar os parâmetros e tabelas utilizados pelo NFC:

Expandir
titleTabelas
  • DHU (Cabeçalho da Cotação)
  • DHV (Produtos da Cotação)
  • SA2 (Fornecedores)
  • SB1 (Descrição Genérica do Produto)
  • SC1 (Solicitações de Compra)
  • SC8 (Cotações)
  • AC9 (Relação de Objetos x Entidades)
  • ACB (Bancos de Conhecimentos)
  • SCE (Encerramento de Cotações)
  • SC7 (Pedido de Compra)
  • DKI (Contatos x Fornecedores)
Expandir
titleParâmetros
  • MV_PGCWF - Permite utilizar o e-mail do comprador para enviar o formulário de workflow ao fornecedor.
  • MV_SELFOR - Permite o comprador escolher os fornecedores livremente ou somente dentre os amarrados no Produto x Fornecedor.
  • MV_PCEXCOT - Habilita a reabertura da cotação ao excluir um Pedido de Compra ou Contrato.
  • MV_TPPLA - Tipo da planilha a ser utilizado ao gerar um contrato proveniente da cotação.
  • MV_APIFOR - Habilita o preenchimento automático de dados do fornecedor com a API TOTVS Carol (Utilizado preenchendo o CNPJ ao transformar participante da cotação em fornecedor)
  • MV_PGCPISV - Servidor de e-mail POP 3/ IMAP dos compradores.
  • MV_PGCPIPO - Porta de e-mail POP 3/ IMAP dos compradores.
  • MV_PGCSMSR - Servidor de e-mail SMTP dos compradores.
  • MV_PGCSMPO - Porta de e-mail SMTP dos compradores.
  • MV_PGCTAUT - Tipo de autenticação do servidor de e-mail: TLS, SSL ou nenhum.
  • MV_COTFIAP- Em caso de cotação com compra centralizada, os pedidos serão gerados na filial de entrega ou filial de compra.

07. PONTOS DE ENTRADA E ROTINA AUTOMÁTICA

Expandir
titleRotina automática - Edição da cotação

A rotina automática de edição de cotação é realizada através do instanciamento do modelo NFCA020.
Esta rotina tem como objetivo realizar somente a edição da cotação com os dados que forem passados para processamento.

Abaixo, um exemplo de utilização:

Bloco de código
languagevb
#Include 'TOTVS.ch'
#Include 'FWMVCDef.ch'
#Include 'Protheus.ch'
  
Function EdicaoComp()
Local aArea			:= GetArea()
Local aDados        := {}
Local cNumCotacao   := "000011"
Local oModel      	:= nil
Local oGridSC8		:= nil
local nFor			:= 0
local cMsg			:= ""
    
DHU->( DbSetOrder(1) ) //DHU_FILIAL+DHU_NUM
if ( DHU->( DbSeek(xFilial("DHU") + cNumCotacao) ) )
    oModel := FwLoadModel("NFCA020")
    oGridSC8 := oModel:GetModel("SC8DETAIL")
    oModel:SetOperation(MODEL_OPERATION_UPDATE) 	
    oModel:Activate()

	for nFor := 1 to oGridSC8:Length()
		oGridSC8:GoLine(nX)
		oGridSC8:setValue("C8_PRECO", 40.00)
 		oGridSC8:setValue("C8_QTDISP", 1)  
		oGridSC8:LoadValue("C8_CONTATO", "JOAO SANTOS")
	next nX   
    
    if ( oModel:VldData() )
		oModel:commitData()
    else  
		cMsg := oModel:getErrorMessage()[6] + " - " + oModel:getErrorMessage()[4] + CRLF
		cMsg += oModel:getErrorMessage()[8], '')  //https://tdn.totvs.com/display/public/framework/FWFormModel - GetErrorMessage
	endif

endif

Restarea(aArea)
FWFreeObj(oModel)
FWFreeObj(oGridSC8)

return nil




Expandir
titlePontos de Entrada MVC - Edição da cotação

Pontos de Entrada MVC na rotina de Edição de Cotação híbrida NFCA020

Por ser uma rotina em MVC, a Edição de Cotação híbrida possibilita aos usuários a utilização de diversos Pontos de Entrada, para que possam fazer os desvios e processamentos personalizados, adequados à realidade da organização.

Breve explicação sobre pontos de entrada MVC:

Nos fontes convencionais temos um "nome" para cada ponto de entrada criado, por exemplo, na rotina MATA010 – Cadastro de Produtos temos os pontos de entrada: MT010BRW, MTA010OK, MT010CAN, etc. Em MVC, não é desta forma, criamos um único ponto de entrada e este é chamado em vários momentos.

Este ponto de entrada único deve ser uma User Function e ter como nome o ID do Modelo de Dados (Model) do Fonte.

Para o funcionamento do ponto de entrada MVC da edição da cotação, deve-se utilizar o nome da função NFCA020:

Sugestão do nome do fonte: MYNFCA020.prw

Bloco de código
languagedelphi
User Function NFCA020()
Local aParam := PARAMIXB
Local xRet   := .T.
...

Return xRet


O ponto de entrada criado recebe via parâmetro (PARAMIXB) um vetor com informações referentes ao fonte. Estes parâmetros variam para cada situação, em comum todos eles tem os 3 primeiros elementos que são listados abaixo, no quadro seguinte existe a relação de parâmetros de cada ID:

Posições do array de parâmetros comuns a todos os IDs:

POS.

TIPO

DESCRIÇÃO

1

O (Objeto)

Objeto do formulário ou do modelo, conforme o caso

2

ID do local de execução do ponto de entrada

3

C

ID do formulário


O ponto de entrada é chamado em vários momentos dentro do fonte, na 2ª posição da estrutura do vetor é passado um ID que identifica qual é este momento. Ela pode ter como conteúdo:

ID

MOMENTO DE EXECUÇÃO DO PONTO DE ENTRADA

MODELPRE

Antes da alteração de qualquer campo do modelo.


Parâmetros Recebidos:


1 O Objeto do formulário ou do modelo, conforme o caso

2 C ID do local de execução do ponto de entrada

3 C ID do formulário


Retorno:

Requer um retorno lógico

MODELPOS

Na validação total do modelo.


Parâmetros Recebidos:


1 O Objeto do formulário ou do modelo, conforme o caso

2 C ID do local de execução do ponto de entrada

3 C ID do formulário


Retorno:

Requer um retorno lógico

FORMPRE

Antes da alteração de qualquer campo do formulário.


Parâmetros Recebidos:


1 O Objeto do formulário ou do modelo, conforme o caso

2 C ID do local de execução do ponto de entrada

3 C ID do formulário


Retorno:

Requer um retorno lógico

FORMPOS

Na validação total do formulário.


Parâmetros Recebidos:


1 O Objeto do formulário ou do modelo, conforme o caso

2 C ID do local de execução do ponto de entrada

3 C ID do formulário


Retorno:

Requer um retorno lógico

FORMLINEPRE

Antes da alteração da linha do formulário FWFORMGRID.


Parâmetros Recebidos:


1 O Objeto do formulário ou do modelo, conforme o caso

2 C ID do local de execução do ponto de entrada

3 C ID do formulário

4 N Número da Linha da FWFORMGRID

5 C Ação da FWFORMGRID

6 C Id do campo




Retorno:

Requer um retorno lógico

FORMLINEPOS

Na validação total da linha do formulário FWFORMGRID.


Parâmetros Recebidos:


1 O Objeto do formulário ou do modelo, conforme o caso

2 C ID do local de execução do ponto de entrada

3 C ID do formulário

4 N Número da Linha da FWFORMGRID




Retorno:

Requer um retorno lógico

MODELCOMMITTTS

Após a gravação total do modelo e dentro da transação.


Parâmetros Recebidos:


1 O Objeto do formulário ou do modelo, conforme o caso

2 C ID do local de execução do ponto de entrada

3 C ID do formulário




Retorno:

Não espera retorno

MODELCOMMITNTTS

Após a gravação total do modelo e fora da transação.


Parâmetros Recebidos:


1 O Objeto do formulário ou do modelo, conforme o caso

2 C ID do local de execução do ponto de entrada

3 C ID do formulário




Retorno:

Não espera retorno

FORMCOMMITTTSPRE

Antes da gravação da tabela do formulário.


Parâmetros Recebidos:


1 O Objeto do formulário ou do modelo, conforme o caso

2 C ID do local de execução do ponto de entrada

3 C ID do formulário

4 L Se .T. indica novo registro (Inclusão) se .F. registro já existente (Alteração / Exclusão)




Retorno:

Não espera retorno

FORMCOMMITTTSPOS

Após a gravação da tabela do formulário.


Parâmetros Recebidos:


1 O Objeto do formulário ou do modelo, conforme o caso

2 C ID do local de execução do ponto de entrada

3 C ID do formulário

4 L Se .T. indica novo registro (Inclusão) se .F. registro já existente (Alteração / Exclusão)




Retorno:

Não espera retorno

MODELCANCEL

No cancelamento do botão.


Parâmetros Recebidos:


1 O Objeto do formulário ou do modelo, conforme o caso

2 C ID do local de execução do ponto de entrada

3 C ID do formulário




Retorno:

Requer um retorno lógico

BUTTONBAR

Para a inclusão de botões na ControlBar.


Para criar os botões deve-se retornar um array bi-dimensional com a seguinte estrutura de cada item:


1 C Titulo para o botão

2 C Nome do Bitmap para exibição

3 B CodeBlock a ser executado

4 C ToolTip (Opcional)




Parâmetros Recebidos:


1 O Objeto do formulário ou do modelo, conforme o caso

2 C ID do local de execução do ponto de entrada

3 C ID do formulário




Retorno:

Requer um array de retorno com estrutura pré definida

MODELVLDACTIVE

Na ativação do modelo.


Parâmetros Recebidos:


1 O Objeto do formulário ou do modelo, conforme o caso

2 C ID do local de execução do ponto de entrada

3 C ID do formulário




Retorno:

Requer um retorno lógico.


Observações:

  • Quando o modelo de dados possui vários componentes (por exemplo, vários FWFORMGRIDs), a 3ª posição do vetor trará o ID deste componente.
  • Quando o tipo de retorno de um determinado momento de execução não for passado ou for passado com o tipo errado será exibida uma mensagem no console avisando sobre isso. Todos IDs que esperam retorno devem ser tratados no Ponto de entrada.
  • Ao se escrever um fonte em MVC que será uma User Function, cuidado ao se atribuir o ID do modelo de dados (Model), pois ele não poderá ter o mesmo nome do fonte. Se o fonte tiver o nome FONT001, o ID do Modelo de Dados (Model) não poderá ser também FONT001.


Bloco de código
languagevb
linenumberstrue
#INCLUDE 'PROTHEUS.CH'
#INCLUDE 'FWMVCDEF.CH'
#INCLUDE "FWEVENTVIEWCONSTS.CH"
#INCLUDE 'FWLIBVERSION.CH' 
#INCLUDE "MATA130.CH"
#INCLUDE 'TOPCONN.ch'

USER FUNCTION NFCA020()
Local aParam     := PARAMIXB
Local xRet       := .T.
Local oObj       := ''
Local cIdPonto   := ''
Local cIdModel   := ''
Local lIsGrid    := .F.
Local nLinha     := 0
Local nQtdLinhas := 0
Local cMsg       := ''

If ( aParam <> NIL )
	oObj       := aParam[1]
    cIdPonto   := aParam[2]
	cIdModel   := aParam[3]
	lIsGrid    := iif(aParam[3] == "SC8DETAIL", .t., .f.)

	If ( lIsGrid )
		nQtdLinhas := oObj:GetQtdLine()
        nLinha     := oObj:nLine
	EndIf

	If ( cIdPonto == 'MODELPOS' )
		cMsg := 'Chamada na validação total do modelo (MODELPOS).' + CRLF
		cMsg += 'ID ' + cIdModel + CRLF
		
		If !( xRet := ApMsgYesNo( cMsg + 'Continua ?' ) )
			 Help( ,, 'Help',, 'O MODELPOS retornou .F.', 1, 0 )
		EndIf

		ElseIf ( cIdPonto == 'FORMPOS' )
			cMsg := 'Chamada na validação total do formulário (FORMPOS).' + CRLF
			cMsg += 'ID ' + cIdModel + CRLF
			
			If ( cClasse == 'FWFORMGRID' )
				cMsg += 'É um FORMGRID com ' + Alltrim( Str( nQtdLinhas ) ) + ' linha(s).' + CRLF
				cMsg += 'Posicionado na linha ' + Alltrim( Str( nLinha     ) ) + CRLF
			
			ElseIf ( cClasse == 'FWFORMFIELD' )
		        cMsg += 'É um FORMFIELD' + CRLF
			EndIf

			If !( xRet := ApMsgYesNo( cMsg + 'Continua ?' ) )
				Help( ,, 'Help',, 'O FORMPOS retornou .F.', 1, 0 )
			EndIf

            
		ElseIf ( cIdPonto == 'FORMLINEPRE' )
			If ( aParam[5] == 'DELETE' )
				cMsg := 'Chamada na pre validação da linha do formulário (FORMLINEPRE).' + CRLF
				cMsg += 'Onde esta se tentando deletar uma linha' + CRLF
				cMsg += 'É um FORMGRID com ' + Alltrim( Str( nQtdLinhas ) ) + ' linha(s).' + CRLF
				cMsg += 'Posicionado na linha ' + Alltrim( Str( nLinha     ) ) + CRLF
				cMsg += 'ID ' + cIdModel + CRLF
			
				If !( xRet := ApMsgYesNo( cMsg + 'Continua ?' ) )
					Help( ,, 'Help',, 'O FORMLINEPRE retornou .F.', 1, 0 )
				EndIf

             EndIf

       ElseIf ( cIdPonto == 'FORMLINEPOS' )
			cMsg := 'Chamada na validação da linha do formulário (FORMLINEPOS).' + CRLF
			cMsg += 'ID ' + cIdModel + CRLF
			cMsg += 'É um FORMGRID com ' + Alltrim( Str( nQtdLinhas ) ) + ' linha(s).' + CRLF
			cMsg += 'Posicionado na linha ' + Alltrim( Str( nLinha     ) ) + CRLF

			If !( xRet := ApMsgYesNo( cMsg + 'Continua ?' ) )
				Help( ,, 'Help',, 'O FORMLINEPOS retornou .F.', 1, 0 )
			EndIf

		ElseIf ( cIdPonto == 'MODELCOMMITTTS' )
			ApMsgInfo('Chamada apos a gravação total do modelo e dentro da transação (MODELCOMMITTTS).' + CRLF + 'ID ' + cIdModel )

		ElseIf ( cIdPonto == 'MODELCOMMITNTTS' )
			ApMsgInfo('Chamada apos a gravação total do modelo e fora da transação (MODELCOMMITNTTS).' + CRLF + 'ID ' + cIdModel)

		ElseIf ( cIdPonto == 'FORMCOMMITTTSPOS' )
			ApMsgInfo('Chamada apos a gravação da tabela do formulário (FORMCOMMITTTSPOS).' + CRLF + 'ID ' + cIdModel)

		ElseIf ( cIdPonto == 'MODELCANCEL' )
			cMsg := 'Chamada no Botão Cancelar (MODELCANCEL).' + CRLF + 'Deseja Realmente Sair ?'

			If !( xRet := ApMsgYesNo( cMsg ) )
				Help( ,, 'Help',, 'O MODELCANCEL retornou .F.', 1, 0 )
			EndIf

		ElseIf cIdPonto == 'BUTTONBAR'
			ApMsgInfo('Adicionando Botao na Barra de Botoes (BUTTONBAR).' + CRLF + 'ID ' + cIdModel )
			xRet := { {'Salvar', 'SALVAR', { || Alert( 'Salvou' ) }, 'Este botao Salva' } }
		EndIf

EndIf

Return xRet
Expandir
titlePonto de entrada - Edição dos pedidos gerados na análise

Nome do ponto de entrada: AVALCOT

Objetivo: Permitir a edição dos pedidos de compra gerados via análise de cotação (depois da gravação).

DocumentaçãoClique Aqui - Documentação AVALCOT


Expandir
titlePonto de entrada - Edição dos itens dos pedidos gerados na análise

Nome do ponto de entrada: AVALCOPC

Objetivo: Permitir a edição dos itens dos pedidos de compra gerados via análise de cotação (depois da gravação).

DocumentaçãoClique Aqui - Documentação AVALCOPC


08. ASSUNTOS RELACIONADOS

Totvs custom tabs box items
defaultyes
referenciaconfig1

Para o funcionamento do Worflow.

Aviso
titleConfiguração ODBC

Para ambientes que utilizem banco de dados PostgreSQL, recomendamos a configuração do ODBC conforme documento abaixo.

Como criar uma fonte de dados ODBC para uso com PostgreSQL

Totvs custom tabs box items
defaultno
referenciaconfig2

Comunicação REST

  • O Portal Gestão de Vendas efetua comunicação com o servidor Protheus através de requisições HTTP. Para que essa comunicação ocorra será necessário efetuar algumas configurações no servidor APPServer.
  • Para maiores informações sobre REST consulte o documento de referenciada da rotina.
Aviso
titleChave de Segurança

Caso a Chave Security não seja informado no "appserver.ini" ou seja informado com o valor 0, não serão validados as permissões de acesso do usuário.

Para maiores informações consulte o documento de referenciada da rotina clicando aqui.

Aviso
titleChave PrepareIn

Caso a chave PrepareIn esteja apontando para empresas específicas, na funcionalidade de Troca de Filial, os usuários terão acesso apenas às empresas informadas nesta chave. Caso não seja necessário este tipo de restrição, mantê-la como "All".

Para maiores informações, consulte a documentação clicando aqui.

Informações
titleImportante

Recomendamos a configuração do REST seguindo o exemplo abaixo

Bloco de código
titleexemplo appserver.ini
[ENVIRONMENT]
	SourcePath=\TOTVS\apo\
	RootPath=\TOTVS\Protheus_data\
	StartPath=\system\
	RpoDb=Top
	RpoLanguage=multi
	RegionalLanguage=BRA
	RpoVersion=120
	dbserver=localhost
	dbdatabase=MSSQL
	dbalias=ENVIRONMENT
	dbport=7890
	TOPMemoMega=30

[Drivers]
	Active=TCP
	MultiProtocolPort=1	
	multiprotocolportsecure=0
	Secure=SSL

[HTTPJOB]
	ENVIRONMENT=ENVIRONMENT
	MAIN=HTTP_START

[HTTPREST]
	BUGS=0
	HSM=0	
	MaxQueue=10	
	Port=8282
	SECURITY=1
	SSL2=0
	SSL3=0
	State=0
	TLS1=0
	URIs=HTTPURI
	Verbose=0	

[HTTPURI]
	AllowOrigin=*
	CORSEnable=0
	Instances=1,2
	OnConnect=REST_CONNECT
	OnExit=REST_EXIT
	OnStart=REST_START
	PrepareIn=All
	URL=/rest/
	Stateless=1

[HTTPV11]
	ADVPL=0
	Enable=1
	Sockets=HTTPREST
	TimeOut=120
			
[HTTPSERVER]
	Enable=0
	Servers=HTTP_REST
​
[HTTP_REST]
	hostname=localhost
	port=9995
	locations=HTTP_ROOT
​
[HTTP_ROOT]
	Path=/rest/
	RootPath=root/web
	ThreadPool=THREAD_POOL
	​
[THREAD_POOL]
	Environment=ENVIRONMENT
	MinFreeThreads=1
	MinThreads=1
	MaxThreads=10

[OnStart]
	JOBS=HTTPJOB
	REFRESHRATE=120
Totvs custom tabs box items
defaultno
referenciaconfig3
Informações
titleAlias TOTVS Mingle

Para configurar o TOTVS Mingle, o servidor Appserver deve possuir um IP publico.

  • A plataforma Portal Gestão de Venda é armazenada em uma nuvem TOTVS. Para que a aplicação possa se comunicar com o servidor Protheus é necessário efetuar a configuração do TOTVS Mingle, que executa o papel de um gateway entre a aplicação é o servidor Protheus. Além disso, ao configurar o TOTVS Mingle, a aplicação passa a utilizar os dados de Autenticação padrão do Protheus.
  • Para configurar o TOTVS Mingle, o servidor Appserver deve possuir um IP publico.
  • O Administrador do sistema deve solicitar um Alias, através da pagina TOTVS MINGLE e informar o app Portal Gestão de Vendas.
  • O Usuário deve receber a chave de acesso por e-mail.
Informações
titleEmpresa/Filial

Deve ser informado ao menos uma empresa e filial no cadastro do Mingle

Image Removed

  • O Alias recebido deve ser o mesmo utilizado para acessar a plataforma e deve ser inserido junto com os dados do Login do usuário.

Image Removed

Painel
borderColorlightgray
borderWidth1
borderStylesolid
titleCONFIGURAÇÕES

O workflow e uma ferramenta usada para facilitar o preenchimento da proposta de cada Fornecedor dando mais agilidade ao processo como um todo.

O Workflow do processo de Cotações será enviado no final do passo 1.2 mas pode ser reenviado de forma individual com as cotações já criadas. Vale lembrar que caso um mesmo workflow seja compartilhado com mais de uma pessoa, somente a primeira resposta será considerada.

Expandir
titleWorkflow: e-mail

Ao ser enviado o workflow, o fornecedor receberá um e-mail como o exemplo a baixo.

Image Removed

[Clique na imagem para ampliar]

Com e-mail em mãos basta clicar na opção em destaque para preencher de fato o arquivo.
Image Removed

[Clique na imagem para ampliar]

Com o workflow aberto, basta que o fornecedor preencha todas as informações que a cotação será preenchida automaticamente no sistema e pronto para a analise.

Painel
borderColorlightgray
borderWidth1
borderStylesolid
titleASSUNTOS RELACIONADOS
  • TOTVS Mingle
  • Schedule - Como agendar a execução de rotinas
  • REST ADVPL
  • Entendendo as novidades do REST (2.0)
  • REST com ERP Microsiga Protheus
  • DBAccess - Seção [Environment], chave UseRowStamp
  • Controle de dados protegidos - Protheus 12


    HTML
    <!-- esconder o menu --> 
    
    
    <style>
    div.theme-default .ia-splitter #main {
        margin-left: 0px;
    }
    .ia-fixed-sidebar, .ia-splitter-left {
        display: none;
    }
    #main {
        padding-left: 10px;
        padding-right: 10px;
        overflow-x: hidden;
    }
    
    .aui-header-primary .aui-nav,  .aui-page-panel {
        margin-left: 0px !important;
    }
    .aui-header-primary .aui-nav {
        margin-left: 0px !important;
    }
    </style>
    
    
    Painel
    borderColorlightgray
    borderWidth1
    borderStylesolid
    titleHOW TO 

    <Em desenvolvimento>

    Painel
    borderColorlightgray
    borderWidth1
    borderStylesolid
    titleTABELAS UTILIZADAS
    TabelaNomeDHU Cabeçalho da Cotação

    DHV

    Produtos da CotaçãoSA2 FornecedoresSB1 Descrição Genérica do ProdutoSC1 Solicitações de CompraSC8 CotaçõesAC9 Relação de Objetos x EntidadesACB Bancos de ConhecimentosSCEEncerramento de CotaçõesSC7Pedido de Compra