Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Deck of Cards
effectDuration0.5
idPrecificação Faturamento
effectTypefade
Card
defaulttrue
effectDuration0.5
idTestes de Integrações via XML
labelConceito Mensagem única

Conceito

Durante

Com o

processo de consolidação de marcas, iniciado pela TOTVS, várias empresas diferentes foram adquiridas e com elas vários produtos passaram a compor o portfólio de ofertas disponível aos clientes. Esta expansão de ofertas permitiu que clientes de uma marca, antes limitados pelas opções com aquela “etiqueta”, pudesse agora compor o seu ambiente de TI utilizando produtos de origens diferentes (Ex.: BackOffice Protheus + TOTVS Obras e Projetos).

objetivo de padronizar a integrações com outros produtos, foi definida uma nova diretriz para os projetos de integração: os produtos podem se comunicar com uma mensagem XML ou Json única, evitando desta forma o processo de transformação de mensagens.
Neste cenário, teríamos o seguinte quadro:

Image Added

Neste cenário, qualquer produto parceiro trabalhará com o mesmo XML, para uma

Com o objetivo de padronizar a integrações com os produtos TOTVS, foi definida uma nova diretriz para os projetos de integração: todos os produtos TOTVS devem se comunicar com uma mensagem XML única, evitando desta forma o processo de transformação de mensagens. Neste cenário, teríamos o seguinte quadro: 

  Image Removed

Neste cenário, qualquer produto TOTVS trabalhará com o mesmo XML para uma

mesma entidade, ou seja, supondo que tenhamos um

XML

Xml/Json correspondente à mensagem de Cadastro de

CLIENTES

Clientes, ela poderá ser enviada para qualquer um dos produtos que suporte o recebimento desta entidade.

Uma vez que os vários produtos

TOTVS

terão um “idioma” em comum

(o XML Único)

, o Xml/Json único, as integrações entre estes produtos não exigirão mais que as mensagens sejam transformadas de um formato para outro.

Com isto, será possível conectar diretamente dois produtos, sem a necessidade do TOTVS ESB, como no diagrama abaixo:

Image Removed



historysamples

 

Esta opção é utilizada para efetuar a manutenção das Tabelas de Preços, utilize o facilitador clicando na tecla [ F12 ].

Configure os parâmetros, observando a seguir as orientações para preenchimento:

  • Demonstrar por? - As opções são Produto, ou Tabela.

   Ao selecionar Tabela, na alteração são apresentados todos os dados da tabela posicionada para edição (opção padrão).

   Ao selecionar Produto, na alteração são relacionadas todas as tabelas que possuírem este produto.

  • Produto? Se a opção for Demonstrar por Produto, informe o código do produto que deseja visualizar na alteração.

Confirme a parametrização e para prosseguir clique em Alterar.

É apresentada a janela para alteração, conforme a parametrização definida.

Configure as alterações e confirme.

Ajuste as informações de acordo com as orientações descritas no item Principais Campos.

Image Removed

Deck of Cards
effectDuration0.5
false
id
Integração Mensagem única
effectTypefade
defaulttrue2

Clique no botão Incluir;

Preencha as informações de acordo com as orientações  descritas abaixo, de cada campo:

Card
effectDuration
0.5
id
Integração via Mensagem única
label
Incluir e Principais Campos
Informações
titleATENÇÃO
  • O Sistema não permite duplicar o código da tabela de preço
  • A Tabela de preços permite registrar o mesmo produto "n" vezes, não há configuração de bloqueio. Só não permite a linha toda idêntica, ou seja, mesmo preço e mesma data de vigência, neste caso exibe mensagem informando a duplicidade.

Cabeçalho (Tabela DA0)
Campo:Descrição:
Cód. Tabela

Campo alfanumérico que permite definir um código para a Tabela de Preços que se está incluindo.

Quando a opção é Copiar utilizando a opção por Outras Ações o sistema assume para a cópia o próximo código disponível.

Exemplo:

002

Descrição

Campo descritivo que identifica a tabela incluída e/ou a incluir.

Exemplo:

Tabela padrão.

Data Inicial / Data Final

Defina nestes campos quais são as datas de início e de término da vigência da tabela de preços.

Exemplo:

01/07/2020 a 01/07/2021

Hora Inicial/Hora Final

Informe nestes campos os horários de vigência da Tabela de Preços cadastrada. Esta informação é bastante utilizada por empresas que realizam Promoções Relâmpago.

Exemplo:

Uma empresa tenha determinado uma promoção que vale no dia 01/07/2020, das 9h às 10h, deve ter o campo Hora Inicial preenchido com 09:00 e o campo Hora Final com 10:00. As vendas efetuadas a partir das 10h 01min não participam mais da promoção desta Tabela de Preço.

Cond. Pagto

Informe a condição de pagamento válida para aplicação desta tabela de preços. Desta forma, na inclusão do Pedido de Vendas, o sistema somente verificará a condição de pagamento informada na Tabela de Preços, caso contrário, emite um aviso de que a condição é inválida para a Tabela selecionada.

Utilize a lupa ao lado do campo ou a tecla F3 para acessar a consulta padrão e deste modo selecionar a condição de pagamento.

Exemplo:

001 - A vista.

Help que pode ocorrer no pedido de venda, caso a condição de pagamento do pedido de venda seja diferente da tabela de preço:

Image Removed

Tipo de Horário

Utilize a seta para baixo posicionada ao lado do campo, para selecionar entre:

1-Único - A Tabela de Preços vale da data de início (hora inicial), até a data final (hora final). Neste caso, supondo que a Tabela foi cadastrada para vigorar de 1/07 às 10:00 até 20/07 até as 20:00 hs, todos os pedidos de venda que entrarem neste período podem utilizar esta tabela.

2-Recorrente - A tabela vale entre as duas datas somente entre a hora inicial e a hora final. Usando o exemplo anterior, os pedidos somente podem utilizar a tabela nos dias do período, dentro do horário informado, ou seja, de 1/07 10:00 até 20/07 às 20:00.  Se a emissão do pedido for dia 02/07 às 21:00 hs, o sistema não aceita para esta Tabela de Preços.

Tab. Ativa

Utilize a seta para baixo para selecionar entre:

  • 1-Sim ou
  • 2-Não.

Dica

Caso tenha uma tabela de preço gravada no pedido de venda em aberto e inative a tabela de preço, os pedidos já gravados em aberto ira considerar o valor da tabela de preço registrada na SC6, porem para os próximos pedidos a tabela não estará ativa.

E-commerce

Implementada a opção de envio de múltiplas tabelas de preço para E-commerce CiaShop, mediante a sinalização do campo e-commerce

Dica

O cadastro do cabeçalho, onde se definem as regras para uso da tabela na venda, é realizada no E-Commerce CiaShop.

A integração envia os produtos associados à tabela, assim como os respectivos preços.

Utilize essa funcionalidade se deseja ter uma tabela de preço diferenciada por regra.

Os procedimentos para o cadastro da tabela de Preço Padrão e Promocional mantém-se inalterados.

Filial de Publicação e PublicaçãoSão preenchidos quando a Tabela de Preços é gerada a partir de uma Publicação de Preços rotina MATA325.
Data de Exportação e Seq. ExportaçãoIndica se o registro já foi exportado para o e-commerce integração com o Sigaloja (LOJA900F)
Item da Tabela de preço (DA1)
Campo:Descrição:
Tipo Preço 

Identificação do tipo de preço, que pode ser: (1=Preço de Venda; 2=Venda Consumidor; 3=Atacado; 4=Varejo; 5=Promoção)

O preenchimento não é obrigatório. 

Informações
titleImportante

O campo DA1_TIPPRE (Tipo Preço) foi criado para atender a integração de mensagem única PriceListHeaderItem entre Protheus e Bematech Live,  com a finalidade de identificar para cada produto o seu Tipo da Tabela de Preço (Tabela DA1 do Protheus), para maiores informações acesse a documentação de Varejo:

DVARLOJ1-918 DT - PriceListHeaderItem - Tabela de Preço - versão 2.001

Cód. Produto

Utilize a lupa ou a tecla F3 para visualizar a consulta padrão e assim definir o código do produto.

Exemplo:

Produto Padrão

Grupo

Este campo permite o controle da tabela de preço por grupo de produtos.

Para fazer o controle por grupo é necessário que tenha sido informado, no Cadastro de Produtos (MATA010), o grupo ao qual ele pertence (B1_GRUPO).

Observações:

Se for informado na tabela, o preço do produto  e o preço para o grupo ao qual ele pertence, o sistema assume o preço do produto, e não o do grupo.

Quando informado o código do produto, o sistema não informa o código do grupo de produto ao mesmo tempo ou quando informado o grupo de produto, o código do produto ficará em branco, o sistema não consiste os dois campo ao mesmo tempo, ou se utiliza o código do produto ou se utiliza o grupo de produto na tabela de preço.

Preço Base 

O preço base da venda de um produto é definido no seu cadastro, por meio do campo Preço Venda (B1_PRV1).

Observações:

Na inclusão da Tabela de Preços o sistema disponibiliza o preço base preenchido, sendo que os campos Preço de Venda e Valor do Desconto sempre tomarão como referência o preço base do produto.
No entanto, caso não tenha sido cadastrado, pode ser informado diretamente o campo Preço de Venda.

Ref. Grad/CFG

Código da família referência de grade, o qual permitirá que a rotina seja utilizada de forma mais prática, diminuindo a necessidade de cadastramento repetitivo para produtos da mesma referência de grade/configurador.

Saiba mais sobre produto com grade:  MP - SIGAEST - Conceito de grade de Produtos no Protheus

FAT0045 Tabela de Preços e Grade

Preço Venda

Preço de venda praticado para um produto na Tabela de Preços, a partir dos descontos e fatores aplicados.

Exemplo:
Cadastro de uma tabela de preços com a seguinte situação:

  • Produto = Computador
  • Preço Base = 1.000,00
  • Valor do Desconto = 100,00
  • Preço de Venda = 900,00 (Preço Base - Valor Desconto)
Vlr. Desconto 

Valor do desconto a ser aplicado sobre o preço base do produto.

Exemplo:
Cadastro de uma tabela de preços com a seguinte situação:

  • Produto = Computador
  • Preço Base = 1.000,00
  • Valor do Desconto = 100,00
  • Fator = 0,90 (10% de desconto sobre o preço base)
  • Preço de Venda = 900,00 (Preço Base - Valor Desconto)

O valor do desconto determinará o preço de venda, pois será calculado sobre o preço base do produto.

Observações: 

Ao informar este campo o sistema calcula automaticamente o campo Preço de Venda.
O sistema permite que seja aplicado o valor do desconto ou o fator. 

Fator

Este campo determina o fator sobre o Preço Base do produto; é informado ou calculado pelo sistema quando o campo Valor do Desconto é preenchido. Quando informado, o sistema calcula o preço de venda baseado no fator. Ao informar o fator é calculado o preço de venda.

Ativação e Inativação de Registros

O objetivo do campo reservado denominado Status, é permitir a ativação ou a desativação de registros, evitando que os inativos fiquem em uso na aplicação.

1.  A inicialização do campo é sempre como Ativo e apresenta as opções Ativo Inativo.

2.  Quando o conteúdo do campo está definido como Inativo, significa que o registro está bloqueado e é exibido no browse com uma cor diferente.

Estado 

Informe o Estado no qual a Tabela de Preços cadastrada tem vigência.

Observações:

Para os campos Estado e Tp. Operação, existe uma regra de prioridade. Ao informar o Estado o sistema desconsidera o campo Tp. Operação, independente do seu conteúdo.

Portanto, para que as informações contidas no campo Tp.Operação tenham valor, deixe o campo Estado em branco.

Tipo de Operação

Neste campo selecione o tipo de operação realizada:

1-Estadual - Indica que a Tabela de Preço vale apenas para clientes dentro do Estado definido no parâmetro MV_ESTADO.

2-Interestadual - Indica que a Tabela de Preço vale para todos os Estados, exceto o Estado definido no parâmetro MV_ESTADO.

3-Norte e Nordeste Indica que a Tabela de Preços vale apenas para as regiões Norte e Nordeste.

4-Todos - Indica que a Tabela de Preço vale para todos os Estados da tabela 12 - Unidade Federativa.

Observações:

Para os campos Estado e Tp. Operação, existe uma regra de prioridade. Ao informar o Estado o sistema desconsidera o campo Tp. Operação, independente do seu conteúdo.

Portanto, para que as informações contidas no campo Tp.Operação tenham valor, deixe o campo Estado em branco.

Saiba mais: FAT0175_Campo_Tipo_de_operação_da_Tabela_de_Preço (DA1_TPOPER)

FaixaInforme qual a quantidade máxima de produtos para uma determinada tabela de preços. Esta informação é útil quando se quer vincular o preço a uma quantidade definida de venda.
Moeda

Moeda que será utilizada na tabela de preço. 

Caso queira converter a tabela de preço em outra moeda, deve parametrizar o MV_MPRCBAS = 1

Saiba mais: MP - FAT - CONVERSÃO DA TABELA DE PREÇO EM OUTRA MOEDA  

Vigência Utilize o calendário ao lado do campo ou informe a data no formato DD/MM/AAAA com a data de vigência da tabela de preço utilizada.
Item Grade

Item de grade da tabela de preço.

Saiba mais sobre produto com grade:  MP - SIGAEST - Conceito de grade de Produtos no Protheus

Preço Maximo 

Preço máximo do produto é um campo utilizado para uso de processamento do SPEDFISCAL.

Saiba mais: MP - FAT - Uso do campo Preço Máximo DA1_PRCMAX da Tabela de Preço

Seq. Exp e Dt Exp

Para cada exportação de Cadastro, uma sequência de controle é gerada no Campo Seq. Exp e gravado no Campo Dt Exp (data da última exportação).

Integração com a Neogrid rotina FATA801.

Card
defaulttrue
id3
labelAlterar
Card
defaulttrue
id4
labelOutras Ações
Pesquisa
Visualizar
Excluir 
Copiar 
Gerar
Reajustes
Especificações
Conexões 
Anotações
Conectar
Imprimir Browser
Card
defaulttrue
id4
labelPesquisar

Outras Ações / Pesquisar

Permite a pesquisa de informações com a utilização de filtros que as ordenam, baseado no índice selecionado considerando por exemplo, a filial+código.

Image Removed

Card
defaulttrue
id5
labelVisualizar

Outras Ações / Visualizar

Para visualizar a tabela de preço, posicione o cursor no item e para prosseguir clique em Visualizar.

Card
defaulttrue
id6
labelExcluir

Outras Ações / Excluir

Para excluir um item cadastrado, posicione o cursor para prosseguir e acesse Outras Ações / Excluir.

Visualize a tela com a mensagem no alto dizendo Tem certeza que deseja excluir o item abaixo?

A confirmação para esta ação não pode  ser revertida.

Para prosseguir com a exclusão clique em Confirmar.

Caso a tabela de preço esteja vinculada a um pedido de venda, não conseguirá excluir, apresenta o help abaixo. 

Neste caso aconselhamos que deixe a tabela Inativa. 

Image Removed

Card
defaulttrue
id7
labelCopiar

Outras Ações / Copiar

Esta opção permite a criação de novas tabelas de preço, quando estas possuam itens em comum, além disso facilita o cadastramento de tabelas com características semelhantes, tais como itens em comum, para que não seja necessário redigitá-los.

O sistema apresenta todos os campos, de acordo com a configuração para uma determinada tabela previamente selecionada, na janela de manutenção, possibilitando copia-la.

Ao ativar esta opção o sistema preenche automaticamente o campo Cód.Tabela com a próxima numeração disponível e apenas duplica os itens da tabela, deste modo é necessário ajustar o cabeçalho a cada duplicação.

Na janela de pesquisa, informe o item a copiar e confirme.

O sistema exibe a tela de inclusão apresentando todos os campos preenchidos da mesma forma como foram preenchidos para a tabela selecionada.

Informe o código e a descrição da nova tabela e, se necessário altere/preencha os campos que desejar.

Confira os dados e confirme a inclusão.

Card
defaulttrue
id8
labelGerar

Outras Ações / Gerar

Esta opção permite criar uma tabela de preços baseada no Cadastro de Produtos.

Selecione a filial e confirme.

Selecione os Produtos, os Grupos e também os Tipos.

O sistema traz nos itens da tabela de preços, todos os dados dos produtos já preenchidos, no entanto, informe também os itens do cabeçalho da tabela.

O parâmetro Vigência tem como finalidade a informação da data, a partir da qual o item da tabela é válido, no entanto este não é um campo obrigatório.

O sistema sempre considera para efeito de vigência da tabela de preços, a informação contida nos campos Data Inicial e Data Final, no entanto, os itens da tabela podem ter datas de vigência posteriores.

Confira os dados e confirme.

Image Removed

Card
defaulttrue
id9
labelReajuste e Deságio

Outras Ações / Reajuste

Esta opção permite aplicar um fator de multiplicação para reajustar os preços dos produtos das tabelas indicadas na parametrização.

Acesse a opção, visualize a mensagem do sistema e clique em Parâmetros.

Os parâmetros desta opção possuem preenchimento autoexplicativo, no entanto, devem ser observados os seguintes dados:

  • Produto Inicial e Produto Final utilize a lupa ao lado do campo ou a tecla F3 para acessar a consulta padrão e definir os produtos.
  • Grupo Inicial e Grupo Final, do mesmo modo acesse a consulta padrão e selecione os grupos.
  • Tipo Inicial e Tipo Final, acesse a consulta padrão e selecione os tipos.
  • Tabela Inicial e Tabela Final acesse a consulta padrão e selecione as tabelas.
  • Fator de Reajuste? Informe neste campo qual é o fator de reajuste a ser aplicado.

          Para o Reajuste: Fator de reajuste dos preços da tabela. Ex: 1,20 = 20 % de acréscimo

          Deságio: Fator de deságio Ex: 0,80 = 20% de deságio.  

  • Número de decimais? Informe quantas casas decimais a considerar pra gravar o novo preço.

Exemplo:

Se informado 0 e o cálculo do novo valor for 46,74, será gravado 46,00, desconsiderando os centavos.

Pedidos em Carteira? Selecione entre Manter ou Atualizar (a opção Atualizar permite atualizar todos os Pedidos de Venda em aberto).
  • Reaplica Fator? Defina entre Preço Base ou Preço Tabela, sendo que:
  •    No preço base é aplicada a fórmula: Preço base x Fator de Multiplicação x Fator (preço base multiplicado pelo fator de multiplicação e multiplicado pelo fator).

       No preço tabela é aplicada a fórmula: Preço de Venda x Fator de Multiplicação (preço de venda multiplicado pelo fator de multiplicação).

    • Atualiza Preço Base (produto)? Selecione entre Sim ou Não.
    • Referência de grade Inicial e Referência de grade Final? Defina quais serão as grades inicial e final a considerar.

    Confira os dados e confirme o reajuste da tabela.

    O sistema reajusta as tabelas conforme parametrização configurada.

    Card
    defaulttrue
    id10
    labelEspecificações

    Outras Ações / Especificações

    Ao acessar esta opção o sistema exibe as especificações cadastradas.

    Esta opção trabalha com as tabelas de especificações (AO0 e AO1), integração com a rotina de CRM(CRMA130).

    As opções no alto da tela são:

    • Visualizar

       Clique nesta opção e visualize a tela.

       Os grids são: Especificações e Entidades (nesta área apresenta-se a estrutura com formato em árvore).

        Esta opção não permite efetuar alterações.

    • Outras Ações
    • Pesquisar
    Card
    defaulttrue
    id11
    labelConexões

    Outras Ações / Conexões

    Esta funcionalidade permite identificar o relacionamento entre os cadastros efetuados no CRM, sendo eles de suspect, prospect, cliente, contatos, concorrentes, fornecedores, parceiros, oportunidades, propostas, pedidos de vendas, notas fiscais, produtos, tabelas de preço, processo de vendas, vendedores, unidade de negócio, equipe de vendas, campanhas e eventos.

    A conexão centraliza informações sobre o relacionamento de uma entidade com outra e facilita as consultas.

    Uma vez acionada esta opção em Outras Ações / Conexões visualize as opções na tela, sendo:

    • Incluir, ao optar por incluir uma nova conexão, o sistema exibe primeiro a tela para seleção da filial.

    Selecione a filial e confirme para prosseguir.

    A próxima tela é a de Cadastro de Conexões com os dados de entidade, código e nome do conector são carregados automaticamente.

     No grid Conectar a informe:

    CampoDescriçãoEntidade

    Utilize a lupa ao lado do campo ou utilize a tecla F3 para ter acesso à consulta padrão e assim poder selecionar este item.

    Exemplo:

    AC3 - Concorrentes

    Código

    Utilize a lupa ao lado do campo ou utilize a tecla F3 para ter acesso à consulta padrão e assim poder selecionar este item.

    Informa o código da entidade Conectada.

    FunçãoUtilize a lupa ao lado do campo ou utilize a tecla F3 para ter acesso à consulta padrão e assim poder selecionar este item.Status

    Utilize a seta para baixo ao lado do campo para visualizar as opções disponibilizadas entre:

    1-Inativo ou 2- Ativo.

    No grid Conectar de informe:

    CampoDescriçãoFunção

    Esta opção permite atrelar informações de um cliente para outro, informando a função da conexão.

    Exemplo:

    Parceiro, Sócio, Influenciador, etc.

    Quando não localize uma função que melhor represente a sua necessidade, efetue o cadastro de outras funções de conexão e relacione-as com as funções correspondentes, ou seja, ao cadastrar a função Tio/Tia a função correspondente será Sobrinho/Sobrinha.

    Data Inicio

    Utilize a opção calendário ao lado do campo ou digite a data no formato DDMMAAAA.

    Data FinalUtilize a opção calendário ao lado do campo ou digite a data no formato DDMMAAAA.
    • Alterar
    • Visualizar
    • Outras Ações
        • Desconectar
    Card
    id12
    labelAnotações

    Outras Ações / Anotações

    Este cadastro possibilita a inclusão, a alteração e a exclusão de comentários ou observações relativas aos registros das seguintes entidades do CRM: Suspects, Clientes, Prospects, Contatos, Concorrentes, Vendedores, Oportunidades, Propostas, Pedidos, Fornecedores, Parceiros, Produtos, Tabela de Preço, Processo de Venda, Unidade de negócio, Equipe de Vendas, Campanha e Eventos.

    A anotação é composta por título, conteúdo e permite anexar arquivos.

    O menu apresenta estas opções:

    • Incluir, ao clicar nesta opção, primeiramente selecione a filial e confirme para visualizar a tela inclusão.

    E preencha os campos a seguir:

    CampoDescriçãoProprietárioUtilize a lupa ao lado do campo ou a tecla F3 para ter acesso à consulta padrão e assim selecionar o proprietário do registro.TítuloInforme um título para a anotação em execução.StatusUtilize a seta para baixo ao lado do campo e selecione entre: 1-Inativo ou 2-Ativo.ConteúdoInforme uma informação neste campo relacionada com a anotação.
    • Alterar,
    • Pesquisar, e
    • Outras Ações .
      • Visualizar;
      • Excluir;
      • Copiar;
      • Anexar;
      • Visualizar Anexo.
    Card
    defaulttrue
    id13
    labelConectar

    Outras Ações / Conectar

    A próxima tela é a de Cadastro de Conexões com os dados de entidade, código e nome do conector são carregados automaticamente.

     No grid Conectar a informe:

    CampoDescriçãoEntidade

    Utilize a lupa ao lado do campo ou utilize a tecla F3 para ter acesso à consulta padrão e assim poder selecionar este item.

    Exemplo:

    AC3 - Concorrentes

    Código

    Utilize a lupa ao lado do campo ou utilize a tecla F3 para ter acesso à consulta padrão e assim poder selecionar este item.

    Informa o código da entidade Conectada.

    FunçãoUtilize a lupa ao lado do campo ou utilize a tecla F3 para ter acesso à consulta padrão e assim poder selecionar este item.Status

    Utilize a seta para baixo ao lado do campo para visualizar as opções disponibilizadas entre:

    1-Inativo ou 2- Ativo.

    No grid Conectar de informe:

    CampoDescriçãoFunção

    Esta opção permite atrelar informações de um cliente para outro, informando a função da conexão.

    Exemplo:

    Parceiro, Sócio, Influenciador, etc.

    Quando não localize uma função que melhor represente a sua necessidade, efetue o cadastro de outras funções de conexão e relacione-as com as funções correspondentes, ou seja, ao cadastrar a função Tio/Tia a função correspondente será Sobrinho/Sobrinha.

    Data Inicio

    Utilize a opção calendário ao lado do campo ou digite a data no formato DDMMAAAA.

    Data FinalUtilize a opção calendário ao lado do campo ou digite a data no formato DDMMAAAA.

    Para confirmar clique em Salvar.

    Card
    defaulttrue
    id14
    labelCriar Visões
    Esta opção estádisponível na tela de acesso à rotina em Manutenção da Tabela de Preços, clique com a seta para baixo para selecionar esta opção.

    À esquerda

    • Configurações, esta tela está dividida pelos grids que descrevemos a seguir
    • Nome da Visão - Atribua um nome para a visão que se está criando.
    • Ordem dos Registros - Selecione entre os índices:

    Cod. Tabela

    Tabela Ativa + Data Inicial + Data Final

    • Visibilidade

    Marque com duplo clique se deseja tornar publica a visão.

    Para prosseguir clique em Confirmar ou para sair e/ou retornar à tela anterior,clique em Fechar.

    • Campos, visualize duas caixas assim denominadas:

    Campos disponíveis para a sua visão - à esquerda

    Posicione o cursor nos campos que deseja visualizar na visão em configuração e com a seta > movimente-o para a direita.

    As setas < e > permitem movimentar os campos de um lado para o outro dos quadros.

    Campos sendo utilizados atualmente - à direita

    Quando movimentados os campos, a visualização é feita neste quadro.

    Para prosseguir clique em Confirmar ou para sair e/ou retornar à tela anterior,clique em Fechar.

    • Filtros

    Selecione os filtros para aplicar à tabela.

    Para criar um novo filtro, clique na opção Criar Filtro.

    Acesse Outras Ações e visualizee/ou selecione entre as opções:
    • Copiar
    • Expressão
    • Relacionar

    O sistema nesta mesma tela permite Excluir e/ou Copiar um filtro existente.

    Para prosseguir clique em Confirmar ou para sair sem ajustes clique em Fechar.

    Card
    defaulttrue
    id15
    labelGerenciar VIsões
    Esta opção estádisponível na tela de acesso à rotina em Manutenção da Tabela de Preços, clique com a seta para baixo para selecionar esta opção.

    Visualize a tela apresentada pelo sistema, tendo na parte inferior as opções:

    Outras Ações /

    Restaurar Visão Padrão

    Configurar

    Alterar Utilize esta opção quando desejar alterar alguma Visão existente.

    Excluir - Utilize esta opção para excluir alguma visão existente.

    Incluir - Utilize esta opção para incluir uma nova visão. Siga as orientações descritas em Criar Visões.

    Definir como Padrão - Para selecionar uma visão como padrão, selecione entre as visões existentes e confirme nesta opção.

    Para sair sem salvar clique em Fechar ou para manter esta configuração clique em Confirmar.

    Card
    defaulttrue
    id16
    labelCadastramento de promoções relâmpago

    As rotinas envolvidas no cadastramento de promoções relâmpago são: Regras de Descontos e Bonificação.

    Nota
    titleImportante:

    Ao abrir uma venda, o sistema verifica todas as Tabelas de Preço ativas naquele momento, excluindo a necessidade de consulta às Tabelas ativas sempre que um novo produto for lançado. Somente após a abertura de uma nova venda, o sistema consultará novamente a existência de outras Tabelas de Preço ativas.

    Para tanto, o parâmetro MV_LJRETVL e um índice na Tabela DA0.

    Este novo parâmetro é configurado somente com os valores 1 ou 2, sendo o valor 1 para o sistema captar o menor preço de um produto entre as Tabelas de Preço ativas, e o valor 2, para o maior preço.

    A tabela de preço tem a possibilidade de registrar as seguintes informações:

    DA0 – Cabeçalho

    • Data e hora inicial / Data de hora final de validade
    • Tipo de hora – Único / Recorrente
    • Tab. Ativa – Sim / Não

    DA1 – Itens

    • Produto ou Grupo de Produtos
    • Preço Base (retorna automaticamente o valor praticado no campo Preço Venda)
    • Preço de Venda (valor que efetivamente será praticado na venda)
    • Desconto / Fator (serão aplicados no campo Preço de Venda)
    • Ativo (se este produto está ativo na grade)
    • Estado
    • Tipo de Operação (Estadual / Interestadual e etc)
    • Faixa / Moeda
    • Vigência

    Devido à condição e forma de pagamento serem definidas apenas no final do processo da venda concomitante, nos módulos Controle de Loja e Front Loja, somente as tabelas de preço que não possuem estas informações definidas são consideradas.

    Os campos de forma e condição de pagamento ficam inibidos no módulo Controle de Loja para a tela de cadastro de Tabela de Preços.

    Na Venda Assistida e Front Loja é tratado apenas o tipo de operação Estadual.

    Possíveis cenários

    Descrição

    Ação

    Uma única tabela de preço, que tenha produto informado na venda.

    É utilizada a regra definida na tabela de preço e aplicada ao valor do item do produto.

    O produto existe em mais de uma tabela de preço ativa.

    É definido pelo parâmetro que identifica se o valor do produto deve ser escolhido com o critério do maior ou menor valor encontrado na busca e aplicado ao valor do item do produto.

    Não encontrar nenhuma tabela de preço ativa para o produto.

    O valor de venda do produto é o cadastrado no produto (campo Preço Venda).

    Não existe nenhuma tabela de preço disponível para o produto e o valor de venda cadastrado no produto é ZERO.

    O aplicativo informa que este produto não pode ser registrado, pois, não tem valor de venda definido.

    Card
    defaulttrue
    id17
    labelInterface para Grade de Produtos

    Conceito

    O recurso de grade agiliza o trabalho de cadastramento de produtos que variam em apenas alguns aspectos, mantendo a sua característica principal.

    Desta forma, não é preciso cadastrar o mesmo produto diversas vezes apenas pelo produto ter uma variedade de características, ou seja, o usuário apenas precisa cadastrar o produto principal e todas as suas variáveis, tais como: cor, modelo etc. Isso permitirá que o Protheus gere automaticamente todos os cadastramentos dos produtos variáveis.

    Nota
    titleImportante:

    Para utilizar o recurso de Grade de Produtos, é necessário configurar o parâmetro MV_GRADE= T, ativando assim, o uso da grade de produtos.

    MP - SIGAEST - Conceito de grade de Produtos no Protheus

    Para utilizar produtos com grade na Tabela de Preço: 

    Selecione a opção Tabela de Preço e inclua uma tabela de preço para um produto referência de grade.

    Para verificar a aplicação da tabela de preços, selecione a opção Pedidos de Venda e inclua um pedido de venda para um produto (código completo) da família de grade relacionada.

    Informe o código da tabela no cabeçalho do pedido.

    Card
    defaulttrue
    id19
    labelLegenda

    Posicione em uma das Tabelas de Preço cadastrada, faça duplo clique sobre a esfera colorida à esquerda e o sistema exibe o quadro com o significado da legenda, sendo:

    Image Removed Tabela de Preços Inativa;

    O campo Data final (DA0_DATATE) deve estar menor que a data base do sistema para ficar com a legenda Tabela Inativa.

    Image Removed Tabela de Preços Ativa;

    O campo Data final (DA0_DATATE) deve estar em branco ou com uma data maior que a data base do sistema.

    Image Removed Tabela de Preços Ativa Especial.

    O campo Data final (DA0_DATATE) deve estar menor que a data base do sistema e o campo tabela ativa deve estar igual a Não.  

    Card
    defaulttrue
    id1
    labelOutras Funcionalidades e Parametrizações
    Dúvidas DocumentaçõesComo faço para atualizar os preços de produtos já inseridos em um Pedido de Vendas ou Orçamento, de acordo com a nova Tabela de Preços

    Utilize o parâmetro MV_PVRECAL como .F., para Pedidos, e o MV_ORRECAL como .F. para Orçamentos.

    FAT0004 Tabela de Preços - Atualização de Pedidos/Orçamentos já existentes

    FAT0278 Utilização do parâmetro MV_PVRECAL

    Ao tentar alterar uma tabela de preços o sistema apresenta mensagem informando

    “Painel de Gestão Habilitado, para alterações de preços ou novos produtos, utilizar a Publicação de Preços.”

    FAT0148_Desabilitar_Painel_de_Gestão_–_Precificação_OMSA010

    Configurar o gatilho para trazer a descrição na Tabela de Preços 

    FAT0270_Gatilho do Grupo na tabela de preçoA pergunta "Gravação da tabela por ?" não funciona na rotina da Tabela de Preços. (F12 no browser) FAT0251 Pergunta descontinuada na rotina da Tabelas de PreçoCarga do conteúdo de campos MEMO de usuário na tabela de preço.FAT0166 - Campos MEMO de usuário na tabela de preçoDescrição do produto não é apresentada ao incluir um Produto em uma Tabela de Preço, porém ao visualizar ou alterar a tabela após sua inclusão a descrição é apresentada.FAT0088_Integridade_dos_campos_Descrição_Produto_Tabela_de_Preço_(Não_carrega_descrição_na_tabela)Help OMSA010PRD1

    Ao alterar a tabela de preço, o sistema gerar a o help "OMSA010PRD1", é por que a tabela está demonstrada por produto e não foi informado o código do produto no menu F12.

    Para que a mensagem não ocorra, ou preenche o código do produto pelo qual deseja que a tabela seja demonstrada ou deixe a pergunta demonstrado por? igual a tabela.

    MP-FAT- Mensagem OMSA010PRD1

    ParâmetrosFuncionalidadesMV_LJCNVDAHabilita a integração entre os módulos SIGALOJA e FRONTLOJA com o cenário de vendas, utilizando as regras de desconto, bônus e tabela de preços.  MV_LJOFFLNDetermina se o ambiente esta trabalhando Off LineMV_LJECOMMIdentifica que o sistema utiliza E - Commerce.MV_TPEFETPVerifica se a tabela foi gerada por publicação de preçosMV_LJGEPRESomente :inclui,altera,exclui tabela de preco se Painel de Gestao estiver Desabilitado.MV_MPRCBAS

    Se igual a 1 converte o preço da tabela de preço.

    MP - FAT - CONVERSÃO DA TABELA DE PREÇO EM OUTRA MOEDA

    MV_REAJSC9Ativado este parâmetro, ao reajustar a Tabela de Preço, também reajusta os preços dos pedidos de venda-SC6 e os preços dos Ped. Liberados-SC9.  MV_REVPLANDefine se utiliza controle de revisão para Planilhas de Formação de Preço.MV_LJRETVLValor da tabela de Preço.1=Retorna menor preço de uma tabela, 2=Retorna maior preço de uma tabela, 3=Retorna o preço da tabela config. no MV_TABPAD  MV_PVRECALRecalculo da tabela no pedido de venda (pedidos em aberto)MV_ORRECALRecalculo da tabela nos orçamentos em aberto Card
    defaulttrue
    id4
    labelPontos de entrada

     

    Pontos de entrada:OM010COR - Alterar as cores do Browse do cadastroOM010MEM - Adiciona Comentários na TabelaOS010BTN - Adiciona BotõesOS010END - Inclui ou Altera Tabela de PreçoOM010DA1 - Grava Itens da Tabela de PreçosOS010MAN - Cabeçalho da Tabela de PreçoOS010EXT - Exclusão da Tabela de PreçoOS010MNP - Atualização do ProdutoOS010GRV - Gravação da Tabela de PreçoOM010FIL - Filtro do Arquivo de ProdutosOS010LCO - Permitir exclusão da linha do acolsOS01Acol - Manipulação da tabela de preçoOM010LOK - Validação dos Itens OkOM010MNU - Inclusão de Novas OpçõesOM010TOK - Retorno da Rotina de ValidaçãoOM010VLD - Valida reajuste Tabela de PreçosOM010REJ - Seleção dos Registros da Tabela de PreçoOM010ATUA - Atualiza os preços dos pedidos em carteiraOM010SC6 - Reajuste de Tabelas de PreçoOM010ESTE - Valida qual o estado do cliente ira utilizar na busca do valorOM010PRC - Retorna Preço de VendaOM010VIG - Valida vigência da tabela de preçosOS010DEL - Exclusão da Tabela de PreçoOM010COL - Retornar conteúdo do ponto de entrada OM010CPOOM010QRY - Inserir campos do cadastro de produtos
    Card
    effectDuration0.5
    idPrecificação Faturamento
    labelFormação de Preço (MATC010)

    Conceito

    A rotina Formação de Preço está presente no módulo de Estoque, localizada no Menu > Consultas > Cadastros > Formação de Preço (MATC010).

    Esta rotina possibilita a formulação de preços de venda com base na estrutura do produto e com o uso de fórmulas definidas pelo usuário, pode-se calcular também a formação de preço através do custo Standard( B1_CUSTD), Custo médio (B1_CM1) e custo em outras moedas como por exemplo: Moeda 2, campo B2_CM2. 

    Saiba mais: 

    Caso ainda tenha alguma dúvida entre em contato com o nosso Suporte Estoque!

    Card
    defaulttrue
    idPrecificação Faturamento
    labelPublicações de Preço (MATA325)

    Conceito

    Esta rotina permite a inclusão, alteração, exclusão e efetivação de uma publicação de preços, sendo todos os processos controlados, assim como, possibilita dois usuários realizarem a manutenção, simultaneamente, na mesma Tabela de Preço. A Publicação de Preços é uma etapa anterior à criação de uma tabela de preço de venda, onde, o usuário que está realizando a publicação tem a possibilidade de compor o preço dos produtos tratados na publicação em qualquer instante.

    localizada no Menu > Faturamento > Cénarios de Vendas > Publicações de Preços  (MATA325).

    Saiba mais: 

    MATA325 - Publicações de Preço 

    Para o sistema atualizar a tabela de preço, é necessário que o parâmetro: MV_LJCNVDA = (.T.) e também tem que verificar se a tabela e ou produto estão com data de vigência correta. Pois se tiver em branco ou com data superior a data base, no momento da efetivação da publicação de preço o sistema cria uma nova tabela. 

    Card
    defaulttrue
    effectDuration0.5
    idPrecificação Faturamento
    labelAplicação de Descontos

    Rotinas do padrão que podem interferir no Preço de Venda ou sugerir desconto automaticamente no Pedido de Vendas são:

    • Tabela de Preços - OMSA010: DA1_VLRDES (Apenas quando há Preço Base cadastro para o Produto) >> Interfere no DA1_PRCVEN >> O qual é levado para C6_PRUNIT e C6_PRCVEN
    • Regras de Desconto - FATA080: ACP_PERDES (percentual) / ACP_VLRDES (valor)
      Obs: Verificar inclusive se o Cliente utilizado na Venda faz parte de um Grupo de Vendas amarrado à uma Regra de Desconto (A1_GRPVEN)
    • Cadastro de Cliente - MATA030: A1_DESC >> Desconto é levado para C5_DESC1

    Obs: Para estes casos é necessário possuir Preço de Lista (C6_PRUNIT) trazido do Cadastro do Produto (B1_PRV1) ou da Tabela de Preço (DA1_PRCVEN)

    O desconto no Pedido de Venda é aplicado sempre sobre o Preço de Lista (C6_PRUNIT) para se obter o Valor Unitário já com desconto (C6_PRCVEN). Quando não há Preço de lista, é aplicado diretamente no Valor unitário recalculando-o para comportar o desconto.
    Esta é uma característica estrutural do Protheus para devidos cálculos fiscais e não é opcional. O desconto sempre irá refletir no Valor unitário. Porém, na DANFE irá exibir separadamente. Valor Unitário / Desconto / Valor Total (obs: Uma exceção dessa regra é o Desconto Financeiro).

    Compreenda a Aplicação de Descontos no Pedido de Venda - Visão Geral

    Observação: Caso possua preço de lista e aplique uma regra de descontos, o sistema sempre irá recalcular o C6_PRCVEN, mesmo ao alterá-lo manualmente, para desabilitar este recalculo configure o parâmetro MV_ALTPREC como vazio, mais detalhes na documentação: Atualização de Preço no Pedido de Venda (MATA410 - SIGAFAT)

    Deck of Cards
    idSPC_2
    Card
    idP_I
    labelFAQs Pontuais
    Card
    idBlc_a
    labelRegra de Desconto (FATA080)

    Conceito

    Informações Gerais
    Expandir
    titleTabelas

    Tabelas utilizadas na Integração EAI:

    • De/Para de Empresas/Filiais Mensagem única (XXD)
    • De/Para de Conteúdos Mensagem Única (XXF)
    • Transações E.A.I. (XX3)
    • Adapters E.A.I. (XX4)
    Expandir
    titleParâmetros

    Parâmetros utilizados na Integração EAI:

    • MV_EAIMETH: Não deve ser alterado
    • MV_EAIUSER
    • MV_EAIPASS
    • MV_EAIURL2: Endereço do WS para comunicação. Podemos informar a Rota da integração neste parâmetro ou através da rotina CFGA020.  Saiba mais: Roteamento E.A.I. Protheus (CFGA020 - SIGACFG)
    • MV_EAIWS: Não precisa ser alterado 

    Dica
    titleIntegração RM TOP x Protheus

    A integração do Top RM com o Protheus envolve o módulo Gestão de Projetos (SIGAPMS), neste módulo não é necessário realizar alguns cadastros de De/Para na tabela XXF e sim configurar alguns parâmetros. 

    Lista dos parâmetros que envolve as integrações deste módulo: Parâmetros da Integração

    Expandir
    titleAdapters

    Os Adapters são responsáveis por realizar o processamento das mensagens enviadas e recebidas, possibilitando a inclusão, alteração e exclusão de dados.
    Veja a Lista Completa dos Adapters utilizados na integração E.A.I (Enterprise Application Integration).

    Dica
    titleEXEMPLO

    Veja o vídeo do processo de cadastro do Adapter em: 01. Cadastro do Adapter

    As integrações via Mensagem Única propõem dois modelos de envio e recebimento de mensagens: 

    • Síncronas: A mensagem é enviada e o sistema que enviou aguarda o processamento da mensagem pelo receptor;
    • Assíncronas: A mensagem é enviada e o sistema que a enviou não aguarda o seu processamento. Posteriormente a mensagem será processada no receptor.


    Aviso
    titleAtenção

    O modelo de mensagem que será utilizado na integração deve ser avaliado com muito cuidado. Apesar do modelo síncrono parecer o mais adequado para uma integração, isto não é de todo verdade. Em um modelo síncrono deve ser levado em consideração o tempo de processamento: O processamento do sistema que envia, a velocidade do trânsito de dados da rede e o tempo de processamento e resposta do receptor.
    Isto pode acarretar um tempo de resposta ao usuário muito maior do que o normal, o que pode transformar a integração de solução ao problema. Já o modelo
    assíncrono, por não aguardar o retorno do processamento do receptor torna o processo mais rápido, porém, neste modelo de mensagem deve-se levar em consideração que o dado será gravado no sistema que envia a mensagem e que o processamento no receptor ocorrerá posteriormente.

    Desta maneira, em algumas situações os dados irão existir no sistema de envio, mas enquanto não forem processados no receptor eles não existirão lá.

    Expandir
    titleDe/Para de Empresas/Filiais

    O Cadastro de De/Para de empresas/filiais irá definir quais empresas e filiais serão integradas entre os dois sistemas.

    Dica
    titleEXEMPLO

    Veja o vídeo do processo de cadastro do De/Para de Empresas/Filiais: 02. De Para de Empresas Filiais

    No XML é necessário identificar a Aplicação de Origem, a Empresa e a Filial para cadastrar o De/Para. As tags a serem verificadas são:

    • SourceApplication = Aplicação de Origem (XXD_REFER)
    • CompanyId = Empresa (XXD_COMPA)
    • BranchId = Filial (XXD_BRANCH)
    Expandir
    titleDe/Para de Mensagem Única

    Na maioria das vezes, os códigos dos registros utilizados nos sistemas que se comunicam via Mensagem Única não são os mesmos, a XXF é a tabela que ira guardar os códigos para relacionar os registros, por exemplo um cliente pode possuir o código no Protheus, e no RM esse mesmo cliente possui o código C0100001. Por isso o sistema realiza o cadastro de um "De/Para de Mensagem Única"

    Ao realizar a inclusão de um cadastro, o sistema verifica se já existe um "De/Para de Mensagem Única", caso já exista, o sistema entende que trata-se de uma alteração, caso não exista, trata-se de uma inclusão, então ele cria automaticamente o "De/Para de Mensagem Única" (XXF).

    Dica
    titleEXEMPLO

    Veja o vídeo do processo de cadastro do De/Para de Mensagem Única (XXF): De Para de Mensagem Única

    O vídeo está no Google Drive do Suporte FAT / SERV / JUR, caso execute no navegador Google Chrome, a qualidade do vídeo pode ficar mais baixa, sendo esse o caso, é possível fazer o Download do arquivo para superior qualidade.

    Caso trate-se de uma inclusão que referencia códigos de outros cadastros, esses códigos necessitam de um "De/Para de Mensagem Única", por exemplo, ao incluir um Pedido de Vendas você precisa referenciar um código de Produto e um código de cliente, mas, nesse momento, você não está incluindo o cliente ou o produto, você está incluindo o Pedido, portanto o cliente e o produto precisam ter um "De/Para de Mensagem Única" (XXF) cadastrado. 

    Expandir
    titleFontes de Integração

    Todos os fontes de integração contém a letra "I" no final do nome da rotina, fontes com processamento a parte em JSON possuem a letra "O" ou "Json" no final.

    Exemplos:

    • A rotina de Pedidos de Venda tem seu fonte com nome "MATA410";
    • Na integração de Pedido de Venda via XML, o fonte que trata a integração chama-se "MATI410";
    • Na integração de Pedido de venda via JSON o fonte que trata a integração chama-se  "MATI410O"

    • A movimentação do Estoque tem seu fonte com nome "MATA240";
    • Na integração da Movimentação via XML, o fonte que trata a integração chama-se "MATI241"
    • Na integração da Movimentação via JSON o fonte que trata a integração chama-se "MATI241JSON"
    Expandir
    titleExtrair Xml-Json Envio e Resposta

    Para realizar os testes e analises de ocorrências envolvendo integração EAI, é necessário validar o Xml/Json de envio e de resposta, para extrair os arquivos para análise, realise os passos abaixo:

    • Acesse o ambiente SIGACFG: Ambiente > Schedule > Adapter EAI

    Na integração do Software com o Protheus, são criados os arquivos de transações.

    • Selecione o arquivo que integrou e para extrair clique na lupa Image Added . Será exibido as opções para extrair
      • ENVIO: Visualizar mensagem original: Xml/Json com os dados que o sistema tentou integrar;
      • RESPOSTA: Visualizar mensagem de resposta: Xml/Json com a resposta da tentativa de integração.

    Nota
    titleIdentificando o XML:

    Através da Tag <Product> consegue visualizar o Software que esta recebendo ou enviando. Exemplo:

    XML de envio (original): <Product version="12.1.18.0" name="RM"/>

    XML de recebimento (resposta): <Product version="12" name="PROTHEUS"/>

    Expandir
    titleLog de Integração

    Durante a análise de ocorrências no processo de integração, pode ser necessário gerar o Profile para analise das funções executadas ou do tempo de processamento.

    Para gerar o Profiler no processo de integração é necessário:

    • Em seu appserver.ini na chave/bloco que carrega o nome do JOB do WebServices [JOB_WS_XXXX]
    • Inclua uma linha: "PROFILE=1" e depois salve o arquivo (Atalho: CTRL + S)

    Bloco de código
    titleProfile
    [JOB_WS_9901]
    TYPE=WEBEX
    ENVIRONMENT=12.1.2310
    INSTANCES=1,1
    SIGAWEB=WS
    INSTANCENAME=ws
    ONSTART=__WSSTART
    ONCONNECT=__WSCONNECT
    PREPAREIN=99,01
    PROFILE=1            <-------- Insira essa chave
    SECURITY=0
    Aviso
    titleImportante
    • Para desabilitar a geração do log, basta alterar para "PROFILE=0"


    Ao integrar/tentar integrar, será gerado um arquivo .txt de log na pasta protheus > protheus_data > wsprofiler:

    Image Added

    Card
    defaulttrue
    effectDuration0.5
    idTestes de Integrações via XML
    labelConfiguração Web Services

    Configurando Web Services

    A configuração inicia-se habilitando o serviço HTTP e configurando a porta que todos os outros serviços dependentes deste irão utilizar para a publicação das informações:

    • Acesse o Wizard de configuração dos Serviços;
    • Em Servidor Internet (HTTP/FTP), verifique se o serviço de HTTP já existe, confirme se está habilitado e para qual porta está configurada. Pois estas são informações indispensáveis para o correto funcionamento dos WebServices e Portais.
    • Caso não tenha o Servidor Internet <HTTP> criado, é necessário seguir o procedimento abaixo:

    Expandir
    titleConfigurando HTTP/FTP
    • Realize o Download dos Arquivos de Portais (web_files) do Portal do Cliente
    • Inclua uma pasta web dentro da Protheus Data do Sistema e insira os web_files
    • Selecionar a opção: <HTTP> e clicar na barra superior <Editar> conforme exemplo
    • O sistema apresentará a tela para Configuração da Seçãoonde os principais campos são:
      1. Flag para Habilitar o Protocolo
      2. Path de Arquivos = Caminho da Pasta Web
      3. Ambiente = Nome do Ambiente
      4. Porta de Conexão = Porta de configuração dos Serviços

    Dica
    titleImportante

    Na configuração da Seção, inserimos como exemplo a porta 92, porém ela pode ser alterada caso prefira.

    Caso definida a porta padrão do serviço HTTP que é a 80, não é necessário especificá-la na configuração do WS e Portais.


    Basta confirmar e gravar as configurações


    Expandir
    titleWS TOTVS Linha Protheus Web Services
    • Realize as configurações básicas, campos importantes:
      1. Módulo Web = WS - TOTVS Linha Protheus Web Services
      2. Nome da Instância = ws
      3. Diretório Raiz das Imagens (Web Path) = Diretório da Pasta Web onde o sistema irá criar a pasta "ws"
      4. Selecione o Environment = Nome do Ambiente
      5. Flag para habilitar processos na inicialização do Servidor

    • Realize a Configuração de Host x Empresas/Filiais, campos importantes:
      1. Host = Server e porta dos Web Services (Deve ser informada a porta informada na Configuração HTTP/FTP)
      2. Selecione a Empresa/Filial = Empresa e Filial de acesso (Para configuração Multifilial, consulte a respectiva aba)
      3. Clique em "Relacionar" e em "Avançar"

    •  Realize a Configuração de Usuários, onde irá definir o número mínimo e máximo de usuários para acesso

    Finalizar e confirmar a configuração.


    Após as configurações acima, o sistema irá inserir as informações de acesso aos Web Services no arquivo AppServer.ini do Protheus, verifique se as informações estão de acordo com o exemplo abaixo, caso não estejam realize ajustes (Lembrando que a Porta e o Nome do Ambiente serão os que preencheu durante a configuração):

    Expandir
    titleAppServer.ini

    [HTTP]

    ENABLE=1

    PORT=81


    [localhost:92/ws]

    ENABLE=1

    PATH=c:\seuambiente\Protheus_Data\web\ws

    ENVIRONMENT=12.1.025

    INSTANCENAME=ws

    RESPONSEJOB=JOB_WS_9901

    DEFAULTPAGE=wsindex.apw


    [JOB_WS_9901]

    TYPE=WEBEX

    ENVIRONMENT=12.1.025                                         

    INSTANCES=1,1

    SIGAWEB=WS

    INSTANCENAME=ws

    ONSTART=__WSSTART

    ONCONNECT=__WSCONNECT

    LOGPROFILE = 0

    PREPAREIN=99,01

    SECURITY=0

    Dica
    titleEXEMPLO

    Veja o vídeo do processo de configuração dos Web Services: Configurando os Web Services

    O vídeo está no Google Drive do Suporte FAT / SERV / JUR, caso execute no Navegador do Chrome, a qualidade do vídeo pode ficar mais baixa, sendo esse o caso, é possível fazer o Download do arquivo e a qualidade será bem melhor.

    A partir da release 12.1.33, torna-se obrigatório o uso da chave SECURITY = 0 na configuração dos WebServices no appserver.ini do AppServer: https://tdn.totvs.com/x/aiErI

    Aviso
    titleAlerta de risco

    Fique atento ao utilizar o parâmetro de configuração com a chave Security=0, pois isso fará com que as integrações (APIs) não exijam autenticação, consequentemente dados do seu ambiente poderão ser consultados sem qualquer controle de autorização.

    Card
    labelConfiguração do REST

    Para realizar a integração EAI utilizando arquivos Json, é necessário ter um REST funcionando no ambiente.

    Para configurar o REST siga as orientações do vídeo: Configuração do REST

    Exemplo de configuração do REST: Exemplo de REST

    Card
    defaulttrue
    idIntegração Mensagem única
    labelConfiguração do SoapUI

    SoapUI

    O SOAPUI é uma ferramenta de mercado onde conseguimos simular o envio do Xml/Json na integração via Mensagem Única, simulando o envio de outros sistemas para o Protheus.
    Ou seja, ao invés de termos que instalar o outro sistema e aprender como fazer o processo neles, nós pegamos um Xml/Json de modelo enviamos para o Protheus usando esta ferramenta.

    Link para baixar o Soaphttps://www.soapui.org/downloads/latest-release/

    Dica
    titleEXEMPLO

    Veja o vídeo do processo de configuração do SOAPUI: Configurando a ferramenta SoapUI

    O vídeo está no Google Drive do Suporte FAT / SERV / JUR, caso execute no navegador Google Chrome, a qualidade do vídeo pode ficar mais baixa, sendo esse o caso, é possível fazer o Download do arquivo para superior qualidade.

    Nota
    titleImportante:

    Caso a integração seja via arquivo Xml, a seguinte Tag deve ser acrescentada:

    Bloco de código
    titleTags SOAPUI
    <![CDATA[
    
    (XML Conteúdo que irá dentro da TAG)
    
    ]]>
    Card
    labelComo realizar testes?
    Deck of Cards
    idTestes
    Card
    labelTestes EAI (Xml)


    Image Added

    Deck of Cards
    idTestes 2
    Card
    labelTeste de Recebimento (Xml)

    Este teste permite testar o recebimento da Mensagem Única de outro sistema para o Protheus.

    Para iniciar os testes é necessário que tenha realizado as etapas:

    1. Cadastro do Adapter
    2. De/Para de Empresas e Filiais
    3. De/Para de Mensagem Única (Se for o teste da rotina MATA410)
    4. Configurando os Web Services
    5. Configurando o SOAPUI


    Simulação da integração:


    Aviso
    titleExemplos de XML

    Exemplos de XML para testes de integração EAI:

    Card
    labelTeste de Envio (Xml)

    Em construção ... =)



    Card
    idIntegração Mensagem única
    labelTestes EAI (JSON)

    Image Added

    Deck of Cards
    idEAI Json
    Card
    labelTeste de Recebimento (Json)

    Este teste permite testar o recebimento da Mensagem Única de outro sistema para o Protheus.

    Para iniciar os testes é necessário que tenha realizado as etapas:

    1. Cadastro do Adapter
    2. De/Para de Empresas e Filiais
    3. Exemplo de REST
    4. Configuração do REST
    5. Configurando o SOAPUI


    Dica
    titleObservação
    • Caso seja necessário a utilização de um Json enviado pelo cliente no teste, é necessário criar um De/Para de Mensagem única para os códigos referenciados no cadastro
      Exemplo: Código de Vendedor no campo A1_VEND, é necessário criar um de/para de mensagem única usando o " VendorInformationInternalID" como "Valor Externo" e no "Valor interno" é preciso informar a empresa, a filial e o código do vendedor como neste exemplo.
    Aviso
    titleImportante
    Card
    idIntegração Mensagem única
    labelTeste de Envio (Json)

    Este teste permite testar o envio da Mensagem única do Protheus para outro sistema.

    Para iniciar os testes é necessário que tenha realizado as etapas:

    1. Cadastro de Rotas EAI
    2. Cadastro do Adapter
    3. Cadastro do Schedule
    4. Cadastro do Agent
    5. Teste de Envio

    Conceito

    Esta rotina permitir definir características padronizadas de vendas, como: tabela de preços, condição e forma de pagamento para um ou todos os clientes. O Sistema aplica a regra de negócio automaticamente, de acordo com as condições do pedido de venda. Sem essa condição, o pedido é bloqueado.

    As regras de negócio devem ser utilizadas como um facilitador para as práticas comerciais e com o objetivo de inibir a venda em condições não favoráveis à empresa.

    IMPORTANTE

    A Rotina Regras de Negócio (FATA100) não possui a função de sugerir desconto automaticamente no Pedido de Vendas. Tem a função de bloquear o Pedido caso alguma das regras do negócio não sejam atendidas (essa rotina pode ser utilizada em conjunto com a Regra de Desconto).

    Aplicação de Regra de Negócio

    1. A regra é avaliada na confirmação da inclusão ou alteração de um pedido de venda.
    2. O pedido é aprovado se não existir regra de negócio cadastrada.
    3. Se na pasta Negociação existirem apenas os itens do tipo Regra, o Sistema assume que o pedido está bloqueado até que um item desse tipo o libere.
    4. O sistema verifica se algum item da pasta Negociação atende ao pedido. Se sim, o pedido é liberado, caso contrário permanece bloqueado.
    5. Nas pastas seguintes, são realizadas as mesmas verificações até que algum item volte a bloquear o pedido, pois caso ocorra uma exceção, tanto no limite de desconto como na pasta Comercialização que o bloqueie novamente o pedido, ele não é liberado.
    6. Se na pasta Negociação existirem apenas os itens do tipo Exceção, o Sistema assume que o pedido estará liberado até que um item desse tipo o bloqueie.

    Observação: Para itens dos tipos Regra e Exceção, localizados na pasta Negociação, inicialmente o pedido fica bloqueado, até que algum item o libere ou o bloqueie novamente, conforme ordem cadastrada na regra de negócios.

    Exemplos de uso: Aplicação de Regra de Negócio

    Fluxo conceitual de Regra de Negócio

    fata100_fluxo_conceito_rotina_de_negocioImage Removed

    Detalhes sobre Forma de pagamento na Regra de Negócio

    Dica
    titleSaiba mais

    Esta rotina permite que sejam criadas regras de descontos a serem aplicados a clientes para um produto ou grupo de produtos, baseando-se em fatores predefinidos, como tabela de preços, condição e forma de pagamento, faixa de valor, intervalo de data e hora. Na inclusão do pedido de venda o sistema verifica as regras de desconto existentes para sua aplicação, consistindo a regra que se adapta ao pedido.

    OBSERVAÇÃO: A Rotina Regras de Negócio (FATA100) não possui a função de sugerir desconto automaticamente no Pedido de Vendas. Tem a função de bloquear o Pedido caso alguma das regras do negócio não sejam atendidas (essa rotina pode ser utilizada em conjunto com a Regra de Desconto).

    Detalhes sobre Regras de Negócio em: Aplicação de Regra de Negócio / Fluxo conceitual de Regra de Negócio / Forma de pagamento na Regra de Negócio

    Card
    defaulttrue
    effectDuration0.5
    idPrecificação Faturamento
    labelRegras de Negócio (FATA100)

    Help_buttonImage RemovedObservação: A regra de negócio prevalece sobre a definição da Tabela de Preços e outras regras.

    Card
    defaulttrue
    id1
    labelManutenção da Tabela de Preço

    No alto da tela visualize a área indicativa para manutenção da tabela de preço.

    Clique na seta para baixo para visualizar e/ou selecionar entre as opções:

    • Exibir Todos;
    • Tabelas de Preços Ativas;
    • Tabelas de Preços Inativas;

    Ao selecionar uma destas opções acima, o sistema atualiza na tela, as informações cadastradas.

    Também estão disponíveis as opções a seguir que dependem de configuração assim que acionadas.

    • Criar Visão;
    • Gerenciar Visões.

    Nesta página clique na tecla F12 para configurar os parâmetros sendo:

    • Demonstrar por? Selecione entre Tabela ou Produto;
    • Produto? Utilize a lupa ao lado do campo ou a tecla F3 para acessar a consulta padrão e selecionar o produto;
    • Gravação da tabela por? Informe se a gravação da tabela deve ser feita por código do produto ou pela referência de grade, quando da demonstração de tabelas por produto (MV_PAR01=2);
    Card
    idPrecificação Faturamento
    labelTratamento em módulos integrados

    Outros tratamentos relacionados em módulos integrados

    VAREJO: Formação de Preço Margem