Histórico da Página

Dica

title	O que é a Integração do WSH Winthor com PDV OmnishopOmni:

A integração do WSH Winthor com o OmnishopTOTVS Varejo PDV Omni via Winthor Smart Hub(WSH), permite ao usuário realizar as operações de PDV integrados no WSHao Winthor.

Aviso

title	Pré-requisitos

Confira todos os pré-requisitos na documentação principal de configuração do WSH - Winthor WinThor Smart Hub assim como toda a configuração inicial que deve ser feita do WSH.

Funcionalidade IP Fixo:

Para IP fixo liberado pelo cliente o mesmo deve ser liberado apenas para o IP indicado pelo Time PDVSYNC com protocolo de segurança habilitado e/ou VPN privada;

DISPONÍVEL APENAS NA VERSÃO 35

Funcionalidade IP dinâmico:

Para clientes que não possuem IP fixo e desejam realizar comunicação Online(Pedido, Consulta de estoque etc.) temos a possibilidade do uso do IP Dinâmico, para isso

deve-se atentar as seguintes premissas:

Se provedor de internet com CGNAT, deve estar liberado para conexão;
Porta do WTA liberado no roteador e Firewall;
Rota liberado sem Redirecionamento de porta ou mascaramento de IP(ex: NAT, proxy, etc.);
Configurar rotas do IP dinâmico no WSH(Rotas 82, 83)
Liberado apenas para o IP indicado pelo Time PDVSYNC;

Rotina de preços 357 - Preço fixo

a Partir da versão 32.0.5.3
a Partir da versão 33.0.4.5
a Partir da versão 34

Monitor de Vendas

A partir da versão 36

Informações

title	Processos Integrados

Expandir

title	Processos

Expandir

title	Filiais, lojas e compartilhamentos

Neste processos são integrados os dados de Lojas, Filiais e o compartilhamento de dados entre as lojas.

Definir nos parâmetros da integração as filiais que deseja integrar.

Expandir

title	Perfil, usuários e operadores

São integrados 3 perfis principais relacionados no Winthor: Operador, Administrador e Vendedor

Os usuários e operadores são integrados e precisam ter CPF cadastrados.

Expandir

title	Cobranças

As cobranças (meios de pagamentos) devem estar devidamente cadastrados na rotina 522:

Tipos:

Expandir

title	Gerais

O que não é PIX ou TEF, segue o padrão do WinThor para pedidos e acerto de caixa.

Expandir

title	Cobranças TEF (Cartão crédito/ débito)

Devem estar configurados os seguintes campos (os dados são validados não só pelas APIs, mas também pela rotina 2099):

Aba Dados cadastrais

Image Added

Cartao de credito: indica que a cobrança é do tipo TEF
Tipo de pagmento: dado solicitado pela SEFAZ
Forma de pagamento NF-e: dado solicitado pela SEFAZ
Nível Venda: indica o acesso do cliente da venda para esta cobrança

Aba Cartão de credito

Image Added

Cliente (Bandeira cartão): cliente para desdobramento de títulos
Cobrança: dado solicitado pelo WinThor, no momento do acerto do caixa
Conta: dado solicitado pelo WinThor, no momento do acerto do caixa
Operadora: código da autorizadora da transação no SiTef
Bandeira da operadora: bandeira do cartão
Prazo (Dias): dado solicitado pelo WinThor, no momento do acerto do caixa
% Taxa Adm: dado solicitado pelo WinThor, no momento do acerto do caixa
Cód. bandeira TEF (SiTef): bandeira do cartão, para o SiTef
Tipo de operação: tipo da transação
Tipo de pagamento: modalidade da transação

Expandir

title	Cobranças PIX (Carteira digital)

Devem estar configurados os seguintes campos (os dados são validados não só pelas APIs, mas também pela rotina 2099):

Aba Dados cadastrais

Image Added

Carteira digital: indica que a cobrança é do tipo carteira digital (PIX)
Tipo de pagmento: dado solicitado pela SEFAZ
Forma de pagamento NF-e: dado solicitado pela SEFAZ
Nível Venda: indica o acesso do cliente da venda para esta cobrança

Aba Carteira Digital

Image Added

Carteiras Digitais: nome da carteira digital (obrigatório). É o que irá definir a qual carteira o pagamento pertence.

Expandir

title	Impostos

Os produtos deverão estar devidamente tributados (com ICMS e PIS/ COFINS):

Parâmetro 'CON_USATRIBUTACAOPORUF' da rotina 132

Image Added

Se a tributação for por região, deverá estar configurado na rotina 271, o código da figura tributária da 514 e, o código da figura de PIS/ COFINS, da rotina 4001.
- Para validar a região da tributação, é usada a regra abaixo;
  - Verifica se existe região no parametro 'NUMREGIAOPADRAOVAREJO'
  - Se não houver, verifica a região padrão da filial no parametro 'FIL_NUMREGIAOPADRAO'.
  - Se não houver, valida a região padrão no parametro PCCONSUM.NUMREGIAOPADRAO.
Se a tributação for por UF, deverá estar configurado na rotina 574, o código da figura tributária da 514 e, o código da figura de PIS/ COFINS, da rotina 4001.

Integramos os seguintes dados fiscais para o PDV:

ICMS
PIS/ COFINS
CEST
NCM
FECP (FUNCEP/ FECP/ FCP)

Expandir

title	Produto

Serão integrados os produtos que, possuírem ao menos uma embalagem cadastrada e, o código de barras do produto exista no cadastro de embalagens.

Sem Formato
PCPRODUT.CODAUXILIAR = PCEMBALAGEM.CODAUXILIAR

Somente produtos marcados como revenda igual a Sim.
Possua registros na rotina 238.

Definir nos parâmetros da integração as filiais que deseja integrar.

Expandir

title	Preços

Para preço por região ativado, são restringidas as seguintes rotinas:

201

São enviados os preços de venda da região padrão do Varejo ('NUMREGIAOPADRAOVAREJO') e, se não houver, o preço da região padrão do parâmetro CiaShop ('CODREGIAOPRECOCIASHOP').

Para preço por embalagem ativado:

2017

Preços de venda e oferta por embalagem são integrados.

Preços de venda de atacado por embalagem são integrados.

Somente ofertas de embalagem (sem atacado) com vigência onde a data de inicio seja menor ou igual a data de fim.

Definir nos parâmetros da integração as filiais e região que deseja integrar.

Expandir

title	Campanhas de descontos/ ofertas

357

Somente campanhas com vigência onde a data de inicio seja menor ou igual a data de fim e com período válido.

Caso a filial seja nula, a integração irá entender que, todas as filiais usarão a campanha.

561/ 4161

Somente campanhas com vigência onde a data de inicio seja menor ou igual a data de fim e com período válido.

São validadas/ enviadas somente campanhas onde as opções abaixo estejam marcadas ou as condições estejam atendidas:

Aplicar desconto automaticamente: deve estar marcado como Sim.

Acréscimo não está contemplado.

Tipo de desconto: C - Comercial.

Tipo de entrega "Call Center": Nenhuma.

Grupos de restrição: caso seja informada restrição de grupo, deverá haver registro desta restrição na rotina 3311, referente aos tipos GR ou CL.

Definir nos parâmetros da integração as filiais e região que deseja integrar.

Expandir

title	Vendas

Vendas SAT e Cancelamentos

Para que a integração consiga trabalhar com Vendas e cancelamento com SAT, é preciso seguir alguns pré requisitos:

Ter um caixa ativo na rotina 2044(Cadastro de caixa) do ERP para SAT e com vínculo para o Equipamento SAT fiscal(tabela PCEQUIPAMENTOSAT) com numero de série do equipamento;Image AddedImage Added
PCEQUIPAMENTOSAT
Serviço winthor-integracao-varejo versão mínima 1.35.4.52 atualizado na rotina 801 WTA;
Filial ser do estado de São Paulo "SP" cadastrado na 535 Cadastro de Filiais;
Servidor de faturamento(2099) Versão mínima 30.1.9.84;
Integração WSH PDVSYNC na versão mínima 1.35.0.9 WTA/2650/2 - Assistente de configuração;Image Added
PDV Omni configurado para SAT;

Expandir

title	Processos não integrados (Fora do escopo)

Expandir

title	Imposto

De acordo com com o tipo de tributação, os campos CODST e CODTRIBPISCOFINS deverão existir na PCTABPR (se 271) ou, PCTABTRIB (se 574).

Sem Formato
PCTABPR.CODST IS NOT NULL OU PCTABTRIB.CODST IS NOT NULL ------------------------------------------ PCTABPR.CODTRIBPISCOFINS IS NOT NULL OU PCTABTRIB.CODTRIBPISCOFINS IS NOT NULL

Os cadastros efetuados pela rotina 2034 não são validados/ enviados.

Expandir

title	Cobranças/ finalizadoras

Para clientes que utilizam o processo de finalizadoras de venda, cadastradas via rotina 2039, estas não são validadas/ enviadas.

Os dados de parcelamento por classificação mercadológica e, o próprio cadastro de classificação mercadológica também não são validados/ enviados.

Expandir

title	Produtos

Não serão enviados produtos diferentes de cesta básica, kit ou liberado.

Sem Formato
PCPRODUT.TIPOMERC IN ('PA','CB','KT','L')

É obrigatório existir pelo menos uma embalagem para cada produto a ser vendido, em cada filial a ser usada, no PDV.

O produto deve possuir NCM informado.

Expandir

title	Detalhes de preços/ descontos

Para preço por embalagem ativado:

2011

A rotina 2011 não está integrada, ou seja, os tabloides (ofertas programadas) não são validados/ enviados.

Para preço região ativado, são restringidas as seguintes rotinas:

561/ 4161

Campanhas que tenham tipo de desconto como Financeiro ou Simulados não são integradas.

Campanhas com faixa de valor ou quantidades informadas não são integradas.

Campanhas que tratem RCA, Supervisor e/ ou de comissões de vendedor não são integradas.

Campanhas para clientes específicos não serão integradas (apenas cliente padrão, ou seja, CODCLI = 1).

Campanhas que tratem tipo de entrega ou que permita a diferenciação de desconto em item ou rodapé não são validadas.

2010 - Dia de atacado (não contemplado)

Processo de cliente atacado, a partir do cadastro da 302 (não contemplado)

Informações

title	Integração TOTVS Varejo PDV Omni

Expandir

title	Como deve ser feita a integração

Para realizar corretamente a integração com do WSH com o TOTVS Varejo 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,passo5

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	Observações e Serviços dependentes
winthor-ferramenta-gateway	última versão disponível	-	-
winthor-filial	1.35.0.1	trigger TRG_FILIAL_ULT_ALTERACAO	-
winthor-produto	0.35.2.3	tabela PCCESTPRODUTO trigger TRG_PCCESTPRODUTO_DTULTALTER	-
winthor-ferramenta-usuario	1.35.0.1	-	-
winthor-estoque-vtex	1.35.0.1	tabela PCEMBALAGEM	Atualizar 560 para a tabela PCEmbalagem, Pcest e PKg_Estoque
winthor-pedido-venda	1.35.1.18	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-produto winthor-venda
winthor-configuracao	0.0.3	-	-
			-
winthor-cliente	0.35.0.1	-	-
winthor-financeiro	1.35.0.3	-	-
	1.35.0.1	-
winthor-tributacao	0.35.2.24	tabela PCTRIBNCMFILIAL trigger TRG_PCTRIBNCMFILIAL_ULTALT	winthor-filial
winthor-venda	0.35.5.19	-	winthor-produto
winthor-fiscal-bibliotecaNfe	1.35.2.3	-
winthor-integracao-varejo	1.35.4.52	package PKG_CREDITOCLIENTE tabela PCPEDCECF tabela PCFILAMENSAGEM tabela PCFILAMENSAGEMERRO tabela PCFILAMENSAGEMHISTORICO tabela PCERROMENSAGEM tabela PCDADOSXMLDOCFISCAL Procedure P_PC_CALCULARCMV_INTEGRACAO	winthor-produto winthor-venda winthor-fiscal-conversorxml - 1.35.2.5
winthor-integracao-2650	1.35.11.33	tabela PCDEPARAINTEGRACAO	winthor-filial winthor-integracao-config
winthor-integracao-config	1.35.6.46	-	-

Para Utilização dos processos de Pedidos é preciso configurar os seguintes passos:

Serviço

Serviço	Versão >=	Objetos de banco de dados atualizados sempre na ultima versão
winthor-integracao-matcon	1.35.15.44	-

Cadastro:

Rotina 523 - Plano de pagamento: É preciso ter cadastrado um plano de pagamento Padrão para Reserva de produtos Online.

Tipo a Vista, usa no Auto serviço e Ativo.

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

O usuário da integração WTA configurado para o WSH deve ter permissão para cancelamento de pedidos na rotina 530 para utilização de pedidos:

Módulo 3 | opção 4 - PEDIDO DE VENDA | 329 Cancelar pedido de venda > Marcar as opções para cancelamento.

ex:

Image Added

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
--	PCCAIXA.NUMREGIAO FIL_NUMREGIAOPADRAO CON_NUMREGIAOPADRAO	Definir, pelo menos, 1 dos parâmetros	Seguirá a seguinte ordem de busca: PCCAIXA.NUMREGIAO para o caixa (assim como é definido hoje na 2030) Se não existir, a região da filial (parametro 132, 1633 (FIL_NUMREGIAOPADRAO)) se não existir, busca a região geral (parametro 132, 1279 (CON_NUMREGIAOPADRAO))
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 TOTVS Varejo PDV Omni integrado com Winthor.
2273	FIL_TIPOAVALIACAOCOMISSAO	De acordo com a regra da empresa	Tipo de avaliação para comissões de RCA. Deve ter pelo menos uma opção habilitada para cadastro de comissão por filial. Caso não informado nenhum valor a comissão não será calculada.
1185	CON_ORDEMAVALIACAOCOMISSAORCA	De acordo com a regra da empresa	Forma de avaliação de comissões de RCA. Caso não informado nenhum valor a comissão não será calculada.
4755	USAPEDIDOTV1OMNI	De acordo com a regra da empresa	Padrão false. Caso marcado como true os pedidos consultados são os da Distribuição(316) caso contrário será da Matcon(416).

3 - Valide os principais dados da empresa na rotina 535 - Cadastro de filiais :

Image Added

A rotina 535 não possui campo em tela para alterar a inscrição municipal, por isso, é necessário validar via banco de dados.

Caso não esteja preenchido validar com a empresa esse dado e realizar UPDATE;

Image Added

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 Added

Na tela de serviços procurar pelo serviço do Winthor Anywhere:

Image Added

Clicar com o botão direito sobre o serviço e clicar em "Parar"

Image Added

7 - Instalar e configurar o Servidor de faturamento -> 2099 - Servidor de faturamento - DR

Rodar as atualizações de tabelas: Tópico 10 - Atualizar Todas as Estruturas do Banco.

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 Added

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.teste=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.teste=true

Image Added

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 Added

Na tela de serviços procurar pelo serviço do Winthor Anywhere:

Image Added

Clicar com o botão direito sobre o serviço e clicar em "Iniciar"

Image Added

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	passo5

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 Added

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 Added

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 Added

Após realizar o login, devemos utilizar o campo de busca no lado superior esquerdo e pesquisar "2650" que é o WSH.

Image Added

Realizar a busca pelo termo "2650";

Image Added

Acessar o item referente aos parâmetros;

Image Added

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 Added

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 Added

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. veja na aba ao lado

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 Added

Após isso, basta clicar no menu de contexto "..." e clicar em editar conforme imagem abaixo;

Image Added

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 Added

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 Added

Alterar o campo Valor, informado a senha cadastrada, lembrando, que esta senha, precisa estar no formado senha em CaixaAlta-> MD5 -> em caixa alta;

Image Added

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

Expandir

title	Configurações de Empresa

É necessário atualizar a URL referente aos dados da empresa no WSH.

Totvs custom tabs box

tabs	Configurando os dados da empresa
ids	empresa1,empresa2,empresa3.empresa4

Totvs custom tabs box items

default	yes
referencia	empresa1

Selecione a integração "winthor/wta" para configurar os dados da integração

Image Added

Realize a alteração dos dados do WTA e integração como Filial, URL sistema Externo com o IP e porta do WTA conforme exemplo "localhost:8189",

IPWTA: URL do WTA (WinThor Anywhere) - Pode ser verificado no parâmetro IPMOBILE da 132

PORTAWTA: porta do WTA - Pode ser verificado no parâmetro PORTAMOBILE da 132

Image Added

Expandir

title	Configurações de fluxos

É necessário realizar também algumas configurações dos fluxos para o correto funcionamento da integração com o PDV.

Totvs custom tabs box

tabs	Acessando fluxos, Configurando fluxos, Subida de informações para o PDVSync, Habilitando fluxo 4, Habilitando fluxo 5 NCM
ids	fluxo1,fluxo2,fluxo3,fluxo4,fluxo5,fluxo6

Totvs custom tabs box items

default	yes
referencia	fluxo1

O primeiro passo a se fazer nas configurações de fluxo, é acessar a tela de fluxos;

Image Added

Após isso, deverá estar com os dados semelhantes ao da imagem abaixo;

Image Added

Totvs custom tabs box items

default	no
referencia	fluxo2

Após acessar a tela de visualização e edição dos fluxos, é necessário desativar todos os fluxos de execução, para que seja realizada a primeira carga de um por um.

Importante, caso já tenha fluxos configurados anteriormente, atentar-se para como estavam as configurações de cada um, para poder voltar ao normal após realizar a primeira carga geral dos fluxos.

Para desativar um fluxo, basta seguir o passo a seguir;

Clicar nos "..." (3 pontos) para abrir o menu de contexto de cada item;

Image Added

Serão exibidas as seguintes informações;

Editar;

Ativar;

Desativar;

Excluir;

Image Added

Para desativar ou ativar o fluxo, basta clicar nas opções correspondentes ao desejado, nesse caso, vamos clicar em Desativar.

Ao clicar na seta do lado direito, podemos expandir cada fluxo, para verificar os detalhes do mesmo;

No final da tela também temos a opção de expandir todos os fluxos de uma só vez;

Image Added

Após expandir o fluxo, podemos verificar se o mesmo está desativado, conforme indicado na imagem abaixo;

Image Added

Após desativar/ativar os fluxos, devemos reiniciar o serviço do WSH para efetivar as alterações realizadas nos fluxos.

Totvs custom tabs box items

default	no
referencia	fluxo3

A equipe do PDVSync, nesse momento, já deverá ter subido as informações referentes a compartilhamento e loja.

E para verificar tal feito precisamos conferir as seguintes informações:

- Compartilhamento
  - id_proprietario, id_retaguarda e id_retaguarda_loja do compartilhamento nível 1 deve ser correspondente a filial que o cliente irá usar;
- Loja
  - id_retaguarda da loja deve ser correspondente a filial que o cliente irá usar;

Conferir com a equipe PDVSync:

Totvs custom tabs box items

default	no
referencia	fluxo4

Anteriormente desabilitamos todos os fluxos, para poder realizar as configurações necessárias, e partir desse momento será necessário subir alguns fluxos novamente.

Os fluxos 1, 2 e 3 podem continuar desabilitados, pois são informações que o pessoal do PDVSync já configura no momento de instalar o ambiente;

O fluxo cujo id é o 4, deve ser ativado, e para isso, basta seguir os passos abaixo;

Quando expandimos o fluxo 4 nesse momento, podemos perceber que o mesmo está desativado;

Image Added

Para reativar, basta selecionar o menu de contexto (...) do fluxo 4 e clicar em ativar;

Image Added

Ao expandir novamente o fluxo 4, podemos ver que o mesmo está totalmente ativo.

Image Added

Informações

title	Integração PDV Omnishop

Para realizar corretamente a integração com do WSH com o PDV Omnishop, 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 Omnishop basta realizar os procedimentos a seguir.

1 - Instalação dos serviços no WTA Rotina 801 veja como instalar → 01 - Comece por aqui -> Parametrizações WTA

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:

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:

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 Omnishop, 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

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.

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 Omnishop, 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

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.

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

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.

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.

Alguns outros dados devem ser obrigatoriamente atualizados para ter o correto funcionamento do PDV Omnishop, 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 Omnishop.

Chave MASTER_ID_PROPRIETARIO = Alterar o campo valor e informar o dado correto para integrar com o PDV Omnishop.

É 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.

Para realizar a alteração, é necessário realizar um update no banco com as informações referentes a empresa, conforme indicado no update abaixo;

Expandir

title	Como deve ser feita a integração

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

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.182

tabela PCTRIBNCMFILIAL

trigger TRG_PCTRIBNCMFILIAL_ULTALT

winthor-produto

0.0.35.45

tabela PCCESTPRODUTO

trigger TRG_PCCESTPRODUTO_DTULTALTER

winthor-ferramenta-usuario

1.6.7.23

-

winthor-estoque-vtex

1.0.15.29

tabela PCEMBALAGEM

winthor-pedido-venda

1.3.0.353

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.28

-

winthor-integracao-varejo

1.0.1.406

package PKG_CREDITOCLIENTE
tabela PCPEDCECF
tabela PCFILAMENSAGEM
tabela PCFILAMENSAGEMERRO
tabela PCFILAMENSAGEMHISTORICO
tabela PCERROMENSAGEM
tabela PCDADOSXMLDOCFISCAL

winthor-integracao-2650

1.0.1.221

-

Parâmetro

nome

Valor

descrição

1197

CON_GERARTROCOCOBDIN

Não

Indica geração de troco na cobrança Dinheiro

2617

NUMREGIAOPADRAOVAREJO