Expandir |
---|
title | Como deve ser feita a integração |
---|
|
Para realizar corretamente a integração com do WSH com o PDV Omni, devemos seguir os passos de configuração que serão informados abaixo.
O Winthor em geral, tem muitas rotinas ou serviços que podem ser utilizados, mas nem todos vem instalados por padrão, e para tais procedimentos podem ser necessários a instalação ou atualização de algumas rotinas ou serviços que serão informadas no passo a passo ou nas documentações em anexo, e para realizar a instalação ou atualização.
Para realizar a configuração da integração com o Omni basta realizar os procedimentos a seguir.
Totvs custom tabs box |
---|
tabs | Parar serviço WTA, Alterar arquivo de configurações, Iniciar novamente o WTA |
---|
ids | passo1,passo2,passo3,passo4 |
---|
|
Totvs custom tabs box items |
---|
default | yes |
---|
referencia | passo1 |
---|
|
1 - Instalação dos serviços no WTA Rotina 801 veja como instalar → 01 - Comece por aqui -> Parametrizações WTA
Serviço | Versão >= | Objetos de banco de dados atualizados sempre na ultima versão |
---|
winthor-ferramenta-gateway | última versão disponível | - |
winthor-filial | 1.0.1.28 | trigger TRG_FILIAL_ULT_ALTERACAO |
winthor-tributacao | 0.1.8.212 | tabela PCTRIBNCMFILIAL trigger TRG_PCTRIBNCMFILIAL_ULTALT |
winthor-produto | 0.0.35.49 | tabela PCCESTPRODUTO trigger TRG_PCCESTPRODUTO_DTULTALTER |
winthor-ferramenta-usuario | 1.6.7.25 | - |
winthor-estoque-vtex | 1.0.15.29 | tabela PCEMBALAGEM |
winthor-pedido-venda | 1.3.0.388 | tabela PCPEDC tabela PARAMETRO tabela PCREGIAO tabela PCLOGPEDIDOAPI tabela PCNFCAN tabela PCVINCULOPEDIDOMATCON procedure PRC_VINCULO_MATCON procedure P_PC_CALCULARCMV_INTEGRACAO tabela PCDESCONTO tabela PCPRECOPROMLOG |
winthor-venda | 0.2.46.34 | - |
winthor-integracao-varejo | 1.0.0.542 | package PKG_CREDITOCLIENTE tabela PCPEDCECF tabela PCFILAMENSAGEM tabela PCFILAMENSAGEMERRO tabela PCFILAMENSAGEMHISTORICO tabela PCERROMENSAGEM tabela PCDADOSXMLDOCFISCAL |
winthor-integracao-2650 | 1.0.1.221 | - |
winthor-integracao-config | 1.0.1.117 | - |
2 - Crie um usuário no winthor dedicado para integração:
Veja como em → Criar Usuário Winthor
Adicione as permissões e gere a senha do formato MD5 conforme orientações → Criando Usuário integração via API
3 - Valide os principais parâmetros no Winthor Rotina 132:
Parâmetro | nome | Valor | descrição |
---|
1197 | CON_GERARTROCOCOBDIN | Não | Indica geração de troco na cobrança Dinheiro |
2617 | NUMREGIAOPADRAOVAREJO | De acordo com a regra da empresa | Região padrão utilizada para o buscar tributação e preços |
4257 | CODREGIAOPRECOCIASHOP | De acordo com a regra da empresa | Região padrão utilizada na integração via API para o buscar tributação e preços |
4655 | CODBANCOINTEGRACAOPDV | De acordo com a regra da empresa | Banco padrão para movimentação de caixas via integração via API |
4659 | CODFUNCCXINTEGRACAOPDV | De acordo com a regra da empresa | Operador de caixa padrão para integração Varejo via API |
2314 | CON_TIPOMOVCCRCA | De acordo com a regra da empresa | Determina o tipo de movimento do RCA |
2243 | FIL_OPTANTESIMPLESNAC | De acordo com a regra da empresa | Indica o regime tributário da empresa |
4727 | PERMITEDITNOMEPDV | Parâmetro geral deve está como 'S' | Caso marcado como "Sim", indica que utiliza o PDV Omni integrado com Winthor. |
3 - Valide os principais dados da empresa na rotina 535 - Cadastro de filiais :
Image Removed
Verifique também o campo de "IM - Inscrição municipal" caso não esteja preenchido validar com a empresa esse dado e realizar UPDATE;
Image Removed
5 - Instalação WSH - Winthor Smart Hub
6 - Após finalizar todas as configurações encontradas na documentação de configuração do WSH é necessário parar o serviço do Winthor Anywhere conforme explicado abaixo;
Pressionar no teclado as teclas "Windows + R" e em seguida no campo de texto colocar o somando "services.msc" responsável por exibir os serviços do Windows
Image Removed
Na tela de serviços procurar pelo serviço do Winthor Anywhere:
Image Removed
Clicar com o botão direito sobre o serviço e clicar em "Parar"
Image Removed
7 - Instalar e configurar o Servidor de faturamento -> 2099 - Servidor de faturamento - DR
Rodar as atualizações de tabelas:
Totvs custom tabs box items |
---|
default | no |
---|
referencia | passo2 |
---|
|
Após para o serviço, precisamos editar novamente o arquivo app.properties, que foi configurado na primeira vez que o WSH foi configurado.
Para isso, basta acessar o diretório onde o arquivo ficou configurado, que por padrão é "C:\pcsist\produtos\winthor-integracao-core" e editar o arquivo "app.properties".
Image Removed
Por padrão, a linha onde informa a integração com o Omni, vem comentada, para poder realizar a primeira configuração do WSH.
- #app.migration.ambiente.pdvomnishop=true
E, para subir as configurações da integração, devemos retirar a "hashtag" ( "#" ) da frente desta linha apenas e salvar o arquivo.
- app.migration.ambiente.pdvomnishop=true
Image Removed
Totvs custom tabs box items |
---|
default | no |
---|
referencia | passo3 |
---|
|
Após alterar e salvar o arquivo, podemos subir novamente o serviço do Winthor Anywhere (WTA).
Pressionar no teclado as teclas "Windows + R" e em seguida no campo de texto colocar o somando "services.msc" responsável por exibir os serviços do Windows
Image Removed
Na tela de serviços procurar pelo serviço do Winthor Anywhere:
Image Removed
Clicar com o botão direito sobre o serviço e clicar em "Iniciar"
Image Removed
Após isso, o WTA irá subir e realizar a configuração das rotas e parâmetros iniciais da integração.
Totvs custom tabs box items |
---|
default | no |
---|
referencia | passo3 |
---|
|
Em edição = "Aviso sobre comentar novamente a linha de configuração"
Após o serviço iniciar com sucesso e o usuário conseguir acessar o WTA, devemos comentar novamente a linha onde informa a configuração, para que este processo não seja realizado novamente em caso de reinicialização do WTA.
Após para o serviço, precisamos editar novamente o arquivo app.properties, que foi configurado na primeira vez que o WSH foi configurado.
Para isso, basta acessar o diretório onde o arquivo ficou configurado, que por padrão é "C:\pcsist\produtos\winthor-integracao-core" e editar o arquivo "app.properties".
Image Removed
Por padrão, a linha onde informa a integração com o Omni, vem comentada, para poder realizar a primeira configuração do WSH.
- #app.migration.ambiente.pdvomnishop=true
E, para subir as configurações da integração, devemos retirar a "hashtag" ( "#" ) da frente desta linha apenas e salvar o arquivo.
- app.migration.ambiente.pdvomnishop=true
Image Removed
Expandir |
---|
title | Configurações de Parâmetros |
---|
|
Após realizar as configurações indicadas acima, será necessário realizar as configurações de alguns parâmetros essenciais na rotina 2650 do WTA.
Totvs custom tabs box |
---|
tabs | Acessar WSH (rotina 2650), Configurando os Parâmetros, Alterando dados de Login e Senha, Outros dados que devem ser atualizados |
---|
ids | param1,param2,param3,param4 |
---|
|
Totvs custom tabs box items |
---|
default | yes |
---|
referencia | param1 |
---|
|
Para realizar a alteração dos parametros, devemos acessar o WTA através da URL que foi configurada e com o usuário que também foi configurado durante a instalação do WTA.
Image Removed
Após realizar o login, devemos utilizar o campo de busca no lado superior esquerdo e pesquisar "2650" que é o WSH.
Image Removed
Realizar a busca pelo termo "2650";
Image Removed
Acessar o item referente aos parâmetros;
Image Removed
Totvs custom tabs box items |
---|
default | no |
---|
referencia | param2 |
---|
|
Após acessar a configuração de parâmetros, devemos ver esta tela que é responsável por exibir todos os parâmetros configurados no sistema;
Image Removed
Para facilitar a edição dos dados, podemos utilizar a busca para encontrar os mesmos, e para facilitar um pouco mais, temos 3 opções de filtro no campo busca, que são as buscas realizadas por CÓDIGO, CHAVE e ID DA ROTA que podem ser escolhidos conforme a imagem abaixo:
Image Removed
Para exemplificar vamos realizar a alteração nos parâmetros de LOGIN e SENHA, que são dois dos parâmetros que é necessário atualizar.
Totvs custom tabs box items |
---|
default | no |
---|
referencia | param3 |
---|
|
Para realizar a edição dos dados, basta selecionar o filtro de chave e buscar pelo texto "login";
Image Removed
Após isso, basta clicar no menu de contexto "..." e clicar em editar conforme imagem abaixo;
Image Removed
Após abrir a edição, deve ser alterado, caso necessário, apenas o campo "Valor", onde deve ser informado o login que foi cadastrado para acessar o WTA.
Image Removed
Após alterar, basta clicar em salvar.
Após alterar o login, é necessário alterar também a senha, para que fique de acordo com o login cadastrado, e para isso é muito parecido com o login, onde vamos precisar editar o parâmetro da senha e alterar também o campo valor;
Image Removed
Alterar o campo valor, informado a senha cadastrada, lembrando, que esta senha, precisa estar no formado MD5 e em caixa alta;
Image Removed
Após alterar, basta clicar em salvar.
Totvs custom tabs box items |
---|
default | no |
---|
referencia | param4 |
---|
|
Alguns outros dados devem ser obrigatoriamente atualizados para ter o correto funcionamento do PDV Omni, e para realizar a atualização, basta seguir de acordo com o exemplo do login e senha que foi demonstrado no passo anterior, alterando apenas a busca para o parâmetro correto.
Chave INQUILINO ou IDINQUILINO = Alterar o campo valor e informar o dado correto para integrar com o PDV Omni.
Chave MASTER_ID_PROPRIETARIO = Alterar o campo valor e informar o dado correto para integrar com o PDV Omni.
Expandir |
---|
title | Configurações de Empresa |
---|
|
É necessário atualizar a URL referente aos dados da empresa, por hora, é necessário realizar este procedimento através do banco de dados, pois a tela referente a essa configuração está em construção no WSH. Totvs custom tabs box |
---|
|
tabs | Configurando os dados da empresa |
---|
ids | empresa1,empresa2,empresa3.empresa4 Totvs custom tabs box items |
---|
default | yesno |
---|
referencia | empresa1 |
---|
| Para realizar a alteração, é necessário realizar um update no banco com as informações referentes a empresa, conforme indicado no update abaixo; Bloco de código |
---|
UPDATE PCINTEGRACAODADOSEMPRESA SET URLBASE = 'http://{{host_wta}}:{{port_wta}}' WHERE ID = 1; |
Onde "host_wta" deve ser a URL do WTA e "port_wta" deve ser a porta utilizada pelo WTA que está sendo configurado. Totvs custom tabs box items |
---|
default | no |
---|
referencia | empresa2 | Alguns outros dados devem ser obrigatoriamente atualizados para ter o correto funcionamento do TOTVS Varejo PDV Omni, e para realizar a atualização, basta seguir de acordo com o exemplo do login e senha que foi demonstrado no passo anterior, alterando apenas a busca para o parâmetro correto.
Chave INQUILINO ou IDINQUILINO = Alterar o campo valor e informar o dado correto para integrar com o TOTVS Varejo PDV Omniesses dados são fornecidos pela equipe de implantação. Chave MASTER_ID_PROPRIETARIO = Alterar o campo valor e informar o dado correto para integrar com o TOTVS Varejo PDV Omni.
|
|
|