Histórico da Página

Confira todos os pré-requisitos na documentação principal de configuração do WSH - 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;

Para realizar a instalação, é necessário realizar o download dos arquivos informados no passo anterior e descompactar os mesmo no diretório padrão da instalação do WTA - Winthor Anywhere que por padrão é "C:\pcsist\produtos".

Após ser descompactado deve ficar "C:\pcsist\produtos\winthor-integracao-core" com a estrutura conforme imagem abaixo:

Image Removed

Após ter os arquivos no local correto, precisa-se editar o arquivo "app.properties" e configurar o mesmo de acordo com os dados da instalação conforme indicado na imagem abaixo:

Image Removed

Exemplo dos dados que devem conter no arquivo app.properties;

spring.datasource.initialize=false
#spring.datasource.url= jdbc:oracle:thin:@(DESCRIPTION =    (ADDRESS = (PROTOCOL = TCP)(HOST = gowend01)(PORT = 1521))    (CONNECT_DATA =      (SERVER = DEDICATED)      (SERVICE_NAME = ORCL)    )  )
spring.datasource.url= jdbc\:oracle\:thin\:@127.0.0.1:1521\:ORCL
spring.datasource.username= LOCAL
spring.datasource.password= 54B4C4075463B2E02CD69F5CD139B5B2
spring.datasource.driver-class-name=oracle.jdbc.OracleDriver
path.winthor.ini= C:/winthor/Prod/MOD-000/Winthor.ini
url.ssh.wta=localhost
port.ssh.wta:8101
path.folder.temporary=C:/pcsist/produtos/winthor-integracao-core/temp
app.task.habilitadas=ALL
app.task.recursos.execucao.ativar-log-tempo=true
#app.migration.ambiente.teste=true
#app.task.paginacao-winthor.page-size=10
app.migration.ambiente.teste=true
app.migration.habilitar=true
#app.task.status-pos-integracao.intervalo-milissegundos=1000
#app.task.status-pos-integracao.tempo-maximo-minutos=1
#app.task.recursos.schedule.fixedRate=60000

Os seguintes campos devem ser informados de acordo com as configurações do ambiente onde o mesmo está sendo configurado:

• spring.datasource.url= jdbc\:oracle\:thin\:@127.0.0.1:1521\:ORCL

  • Este campo é responsável pela informação do banco de dados do winthor.

• spring.datasource.username= nome_usuário_banco

  • Este campo é responsável pela informação.

• spring.datasource.password= DED9EFD3B48EBDBB5E69A00393B57EC9

  • Este campo é responsável pela informação da senha do banco de dados que deve ser em formato MD5 sempre em caixa alta.

• spring.datasource.driver-class-name=oracle.jdbc.OracleDriver

  • Este campo é responsável pela informação do driver do banco de dados.

• path.winthor.ini= C:/winthor/Prod/Winthor.ini

  • Este campo é responsável pela informação do local do arquivo de winthor.ini que deve estar dentro do diretório do winthor.

• url.ssh.wta=localhost

  • Este campo é responsável pela informação da url do WTA.

• port.ssh.wta:8101

  • Este campo é responsável pela informação da porta de acesso do WTA.

O objetivo é possibilitar o Cadastro de Rotas de busca e envio de dados, independente das API’s de emitente e destinatário.

Desta forma o serviço WSH(Winthor Smart Hub)  poderá realizar os processos de integração do produto Winthor, criando uma camada de transformação e intermediação de dados onde será possível realizar integrações com parceiros internos e externos.

Para cadastrar uma nova Rota, realize os procedimentos abaixo:

Acesse o WinThor Anywhere, localize/pesquise a rotina 2650 - Winthor Smart Hub

Image Removed

Selecione a opção Rotas no Menu;

Image Removed

Clique no botão Novo, (será apresentado os dados para Cadastro de Rota/Serviço);

Image Removed

 Cadastro de Rota/Serviço 

Image Removed

Tela destinada ao cadastro de uma nova rota

• •  Código - Campo que apresentará o ID único do cadastro, este campo é gerado automaticamente.
  • ID Empresa - Deverá ser informado a empresa da rota que executará a ação.
  • Nome Empresa - Ao selecionar o ID da empresa o nome será apresentado conforme cadastrado no banco de dados.
  • Status - Deverá selecionar uma das opções ATIVO(será executada) / INATIVO(não será executada) para as Rotas.
  • Tipo do Documento - Este campo disponibilizamos algumas opções do Tipo de Documento que poderá ser trafegado na Rota. 
  • Autenticador -  Deverá selecionar as opções SIM/NÃO. Caso a Rota precise de autenticação antes da execução, este campo deverá ser informado igual a SIM, caso contrário informar NÃO.
  • Atualizar Token - Deverá selecionar as opções SIM/NÃO. Caso a Rota precise ATUALIZAR o Token, este campo deverá ser informado igual a SIM, caso contrário informar NÃO.
  • Arquitetura - Informe a arquitetura da sua integração (JSON, XML, outros)
  • Tipo de Processo - O Tipo Processo é muito importante, ele determina a ação que a ROTA executará na integração (BUSCAR/ENVIAR) dados.
  • Nome do Serviço - Adicionar o Nome da Rota que está sendo cadastrada para identificar em demais processos da integração.

• • Layout de Comunicação - Campo destinado a inserção do Layout que faça comunicação com o serviço, deve-se indicar o tipo de requisição e parâmetros necessários para que a ação seja executada, conforme o exemplo abaixo:

{
    "name": "ObterNotaPedido",
    "request": {
        "method": "GET",
        "header": [
            {
                "key": "Authorization",
                "value": "Bearer {{TOKEN}}"
            },
             {
                "key": "Content-Type",
                "value": "application/JSON"
            },
            {
                "key": "Accept",
                "value": "*/*"
            }
        ],
        "url": {
            "raw": "{{URL_BASE}}//users/{{USER_ID}}/orders/{{IDEXTERNO}}/",
            "protocol": "https",
            "host": [
                "api",
                "com"
            ],
            "path": [
                "users",
                "00001",
                ""
            ],
            "query": [
                {
                    "key": "sale",
                    "value": "authorized"
                }
            ]
        }
    },
    "response": []
}

Ao finalizar o Cadastro de Rota/Serviço, será apresentado o botão "Próximo" que levará ao segundo passo de configuração, Layout de Transformação.

Image Removed

• O layout de transformação é dividido em 4 partes que são:
  • JSON de entrada - Campo destinado a adição de como receber a informação.

Image Removed

• JSON de Saída - Campo destinado a informação de como deve ficar o JSON final do processo.

Image Removed

• Mapear JSON - está no centro das informações JSON de entrada e JSON de Saída, este campo é responsável por configurar o que liga os campos de entrada e saída para gerar o JSON de transformação do processo.

Image Removed

• Layout de Transformação - Campo destinado a inserção do Layout que faça transformação dos dados recebidos de forma que o ERP Winthor consiga integrar. Ao clicar no botão "Gerar Layout" será gerado dinamicamente após preenchimento das informações JSON entrada/saída e mapeamento dos campos,

[
  {
    "operation": "shift",
    "spec": {
      "id": "idExterno[0]",
      "shipment": { "logistic_type": "ignorarImportacaoDiferente(regra)" }
    }
  }
]

• Botão Salvar - Salva os dados adicionados.