Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Dica
titleO que é o Winthor Smart Hub

WSH - O Winthor Smart Hub - Integrações

Nota
titleATENÇÂO

A TOTVS não se responsabiliza por aplicações de terceiros instaladas no servidor.

Caso seja encontrada aplicações de terceiros nos diretórios de instalação padrão Winthor e ou Banco de dados, qualquer tipo de atendimento não poderá ser seguido pela TOTVS.

é um produto de Varejo e Distribuição Winthor que pode ser utilizado em diferentes parceiros de integração dentro do nosso ecossistema TOTVS.

Consiste em possibilitar integração entre duas API’s distintas utilizando um mecanismo de transformação chamado Jolt Transform, que, através de um Spec (especificação template) intermediário, trabalha na conversão de um Json retornado para um Json esperado.

Pensado como medware, executa, no modo agendamento de tarefas, o serviço de buscar e enviar dados Json entre duas API’s diferentes, realiza conexão com diversos serviços API utilizando um esquema/template baseado no mesmo gerado pela ferramenta Postman.

Todas as funções e cadastros citados podem ser configurados de forma simples e intuitiva através da rotina 2650 disponibilizada no WTA.

Nota
titleATENÇÃO

A TOTVS não se responsabiliza por aplicações de terceiros instaladas no servidor.

Caso seja encontrada aplicações de terceiros nos diretórios de instalação padrão WinThor e ou banco de dados, qualquer tipo de atendimento não poderá ser seguido pela TOTVS.

Hardware - Requisitos de Instalação:

  • Equipamento: Servidor dedicado
  • Sistema Operacional: Windows 10 ou Superior 64bits;
  • Processador: De 4+ núcleos e 2ghz+ de processamento;
  • Memória RAM: mínimo de 8GB (recomendado 16GB);
  • Conexão com Internet.
  • Espaço em Disco: Mínimo de 50gb disponíveis;
  • Conexão com o banco de dados do WinThor;
  • Serviço WTA Winthor disponível em IP público.
    Aviso
    titlePré-requisitos

    Antes de iniciar a implantação, verifique se todos os pré-requisitos foram atendidos:


    • Requisitos de hardware


      • Equipamento: Servidor dedicado
      • Sistema Operacional: Windows 10 ou Superior 64bits;
      • Processador: De 4+ núcleos e 2ghz+ de processamento;
      • Memória RAM: mínimo de 8GB (recomendado 16GB);
      • Conexão com Internet.
      • Espaço em Disco: Mínimo de 50gb disponíveis;
      • Java 1.8.0
      • Conexão com o banco de dados do WinThor;
      • Serviço WTA Winthor disponível em IP público.




    Aviso
    titleATENÇÃO
    • Caso a instalação seja feita em uma estação comum de trabalho ou em servidor compartilhado com outra aplicaçãoa performance pode ser seriamente afetada
    • O compartilhamento de recursos pode não só deixar lento quanto também travar a aplicação. Isso acontece porque quando não há recursos suficientes para o processamento da JVM, a sua instancia é fechada, paralisando todos processos dependentes. Desse modo, não poderemos garantir a perfeita execução da aplicação conforme é planejado para ser.



    • Requisitos de software


    Aviso
    titlePré-requisitos
    Aviso
    titleATENÇÂO
    • Caso a instalação seja feita em uma estação comum de trabalho ou em servidor compartilhado com outra aplicaçãoa performance pode ser seriamente afetada
    • O compartilhamento de recursos pode não só deixar lento quanto também travar a aplicação. Isso acontece porque quando não há recursos suficientes para o processamento da JVM, a sua instancia é fechada, paralisando todos processos dependentes. Desse modo, não poderemos garantir a perfeita execução da aplicação conforme é planejado para ser.
    Informações
    titleWSH - Configuração e Instalação
    Expandir
    titleConfiguração
    Totvs custom tabs box
    tabsRotina 2650 - Winthor Smart Hub
    idspasso1,passo2

    Esta solução unifica os processos destinados ao WSH(Winthor Smart Hub), a rotina 2650 tem por objetivo permitir as configurações e acompanhamento dos fluxos integrados no Winthor.

    Totvs custom tabs box
    tabsProcedimentos Iniciais, Integração, Rotas, Parâmetros, Fluxo, Detalhes Técnicos
    idspasso1,passo2,passo3,passo4,passo5,passo6
    Totvs custom tabs box items
    defaultno
    referenciapasso1
    1. Caso


    Informações
    titleInstalação
    Expandir
    titleDownloads
    Expandir
    titleDownload pacote WSH

    O download dos arquivos necessário parar realizar a instalação do WSH - Winthor Smart Hub podem ser feitos através do link abaixo:

    • Download WSH (jre.zip, service.zip, winthor-integracao-core.jar)
    Expandir
    titleInstalação

    2. Acesse o WinThor Anywhere e no menu principal, preencha no campo de Pesquisar a rotina 801 - Atualização de Serviços Web e tecle Enter (ou clique diretamente sobre a rotina no menu principal); 

    2.1  Na tela Gerenciador de Rotinas e Serviços, clique o botão Instalações;

    3. Instale os serviços winthor-integracao-config e winthor-integracao-2650 na última versão disponível. 

    Em construção
    Totvs custom tabs box
    tabsDescompactando os arquivos, Editando arquivo de propriedades "app.properties", Parando o servido WTA, Executando jar para finalizar as configurações iniciais
    idspasso1,passo2,passo3,passo4
    Totvs custom tabs box items
    defaultno
    referenciapasso2
    no
    Totvs custom tabs box items
    default
    yes
    referenciapasso1


    Crie o diretório "C:\pcsist\produtos\winthor-integracao-core";

    Realizar o download dos arquivos informados no passo anterior e descompactá-los no diretório acima criado "C:\pcsist\produtos\winthor-integracao-core".

    Após ser descompactado, a estrutura deve ser a seguinte, conforme imagem abaixo:

    Exibindo image.pngImage Added
    apps-fileview.texmex_20231019.01_p2

    image.png

    Exibindo image.png…

    Totvs custom tabs box items
    defaultno
    referenciapasso2

    Agora, é necessário criar, manualmente, p arquivo "app.properties" e configurar o mesmo de acordo com os dados da instalação conforme indicado na imagem abaixo, no diretório "C:\pcsist\produtos\winthor-integracao-core":

    Image Added


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


    Bloco de código
    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.pdvomnishop=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.


    Totvs custom tabs box items
    defaultno
    referenciapasso3

    Antes de executar o arquivo de configuração do WSH, devemos parar o serviço do WTA que fica nos serviços do Windows:

    Acesse os serviços do Windows ('services.msc' via 'Executar') .

    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


    Totvs custom tabs box items
    defaultno
    referenciapasso4

    Após parar o serviço, podemos executar os arquivos de configurações do WSH.

    Para configurar os dados mencionados, deve se executar o arquivo "winthor-integracao-core.jar" via prompt de comando para que todas as configurações sejam realizadas para iniciar o WSH:

    Para isto, basta executar no prompt no local onde o arquivo se encontra "C:\pcsist\produtos\winthor-integracao-core" o comando "java -jar winthor-integracao-core.jar".

    Image Added

    Se se todas as configurações do arquivo "app.properties" estiverem certas, as migrations serão executadas e assim que começarem a ser executados os fluxos, para a aplicação podemos conferir as migrations no log.

    Image Added

    Após finalizar o processo, podemos verificar no banco de dados, realizando uma consulta simples para verificar os migrations.

    Consulta a realizar (utilize o sqlplus ou gerenciador de banco de dados de seu conhecimento:

    "SELECT * FROM PCINTEGRACAOCOREMIGRATION;"

    Verifique a coluna "SUCESSO" onde todas devem estar com um "S".

    Image Added

    Após as migrations executadas pode instalar a aplicação como serviço:

    Para isso, no CMD, em modo administrador e, acesse a pasta service "C:\pcsist\produtos\winthor-integracao-core\service" e rode o comando para instalar

    Image Added


    Bloco de código
    winthor-integracao-core.exe install


    Image Added

    OBS: caso precise desinstalar rode o comando com uninstall

    Acesse os serviços do Windows ('services.msc' via 'Executar') e procure por 'WSH - Winthor Smart Hub'.

    Image Added

    Image Added

    Expandir
    titleConfiguração de rotinas
    Expandir
    titleConfigurando rotina 2650
    • Acesse o WinThor Anywhere e no menu principal, preencha no campo de Pesquisar a rotina 801 - Atualização de Serviços Web e tecle Enter (ou clique diretamente sobre a rotina no menu principal do lado esquerdo);

    Image Added


    • Na tela Gerenciador de Rotinas e Serviços, clique o botão Instalações;

    Image Added

    • Instale os serviços winthor-integracao-config e winthor-integracao-2650 na última versão disponível. 


    Expandir
    titleConfiguração de integrações
    Expandir
    titleCadastro de integrações

    O objetivo é possibilitar o Cadastro de Integrações no Winthor Smart Hub.


    Para realizar uma nova integração, devemos acessar as configurações de integrações através da rotina 2650 do WSH.



    Totvs custom tabs box
    tabsPasso 1, Passo 2, Passo 3, Passo 4
    idsitem-int1,item-int2,item-int3,item-int4
    Totvs custom tabs box items
    defaultyes
    referenciaitem-int1

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


    Image Added



    Totvs custom tabs box items
    defaultyes
    referenciaitem-int2

    Selecione a opção Integrações no Menu;


    Image Added

    Totvs custom tabs box items
    defaultno
    referenciaitem-int3

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


    Image Added

    Totvs custom tabs box items
    defaultno
    referenciaitem-int4

     Cadastro de Integração nova


    Image Added 


    Tela destinada ao cadastro de uma nova integração:

      •  Código - Campo que apresentará o ID único do cadastro, este campo é gerado automaticamente.
      • Nome - Deverá ser informado o nome da integração para identificação da mesma.
      • URL Sistema Externo - Deverá ser informada a URL da API que será usada na integração externa.
      • Utiliza WTA - Deverá ser informado se será utilizado como processo WTA (Sim ou Não ).
      • Filial - Deverá ser selecionado o nome da filial.
      • Tempo de expiração - Deve ser informado o tempo (em segundos) para expiração do token. 
      • Token - Este campo será gerado automaticamente após a criação da Integração
      • Botão Salvar - Salva os dados adicionados.
    Expandir
    titleConfiguração de rotas
    Expandir
    titleCadastro de rotas/serviço

    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:


    Totvs custom tabs box
    tabsPasso 1, Passo 2, Passo 3, Passo 4, Passo 5, Passo 6
    idsitem-rota1,item-rota2,item-rota3,item-rota4,item-rota5,item-rota6
    Totvs custom tabs box items
    defaultyes
    referenciaitem-rota1

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


    Image Added

    Totvs custom tabs box items
    defaultno
    referenciaitem-rota2

    Selecione a opção Rotas no Menu;


    Image Added

    Totvs custom tabs box items
    defaultno
    referenciaitem-rota3

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


    Image Added

    Totvs custom tabs box items
    defaultno
    referenciaitem-rota4

     Cadastro de Rota/Serviço 


    Image Added


    Tela destinada ao cadastro de uma nova rota

      •  Código - Campo que apresentará o ID único do cadastro, este campo é gerado automaticamente.
      • ID Integração - Deverá ser informado a empresa da rota que executará a ação.
      • Descrição da Integração - Ao selecionar o ID da empresa o nome será apresentado conforme cadastrado no banco de dados.
      • Status -O status ele define se a própria rota que tá sendo criada vai ser executada ou não. Deverá selecionar uma das opções ATIVO(será executada) / INATIVO(não será executada).
      • 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.
      • Nome do Serviço - É o nome que o usuário pode dar à rota pra identificá-la depois.


    Totvs custom tabs box items
    defaultno
    referenciaitem-rota5

     Cadastro de Rota/Serviço 


    Image Added



    Tela destinada ao cadastro de uma nova rota

      • Nome do Serviço / Nome Layout - É o nome que o usuário pode dar ao layout pra identificá-la depois.
      • Método HTTP - É o método que será utilizado pelo layout (GET, POST, PUT, DELETE, PATCH).
      • URL - A url a qual o layout irá utilizar.
      • Query -  Query utilizada no layout para realizar as consultas necessárias conforme configurações desejadas.
      • Body - Irá preencher o bodyraw do JSON
      • Parâmetros de Header - Permite adicionar novos parâmetros ao JSON do layut
      • 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:
    Bloco de código
    languagejs
    titleExemplo Comunicação
    {
      "name": "",
      "request": {
        "method": "",
        "header": [],
        "url": {
          "raw": "",
          "query": ""
        },
        "bodyraw": ""
      },
      "response": []
    }

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


    Image Added



    Totvs custom tabs box items
    defaultno
    referenciaitem-rota6
    • 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 Added

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

    Image Added


    • 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 Added

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


    Bloco de código
    languagejs
    titleExemplo Transformação
    [
      {
        "operation": "shift",
        "spec": {
          "id": "idExterno[0]",
          "shipment": { "logistic_type": "ignorarImportacaoDiferente(regra)" }
        }
      }
    ]
    
    
    • Botão Salvar - Salva os dados adicionados.


    Expandir
    titleConfiguração de Parâmetros
    Expandir
    titleCadastro de parâmetros

    O objetivo é possibilitar o Cadastro de parâmetros no Winthor Smart Hub.


    Para cadastrar um novo Parâmetro, devemos acessar as configurações de parâmetros através da rotina 2650 do WSH.


    Expandir
    titleCadastro de parâmetros

    Totvs custom tabs box
    tabsPasso 1, Passo 2, Passo 3
    idsitem-param1,item-param2,item-param3
    Totvs custom tabs box items
    defaultyes
    referenciaitem-param1

    No WSH, acessar o item 3 da rotina 2650, que é a configuração de parâmetros;


    Image Added

    Totvs custom tabs box items
    defaultno
    referenciaitem-param2

    Clique no botão Novo, (será apresentado os dados para Cadastro de parâmetro);


    Image Added

    Totvs custom tabs box items
    defaultno
    referenciaitem-param3

    Cadastro de Parâmetro


    Image Added


    Tela destinada ao cadastro de um novo parâmetro;

      • Código - Campo que apresentará o ID único do cadastro, este campo é gerado automaticamente.
      • ID Rota Serviço- Deverá ser informado o ID da rota para qual o parâmetro será vinculado.
      • Global- Ao selecionar o checkbox Global, será utilizado a rota global ao invés de alguma outra selecionada (Ao selecionar a Global, a seleção de ID Rota Serviço fica desabilitada).
      • Tipo Chave - Deverá selecionar o tipo da chave que será utilizada, se vai ser um parâmetro de BODY, PARAMS ou HEADER.
      • Chave - Será o nome do parâmetro.
      • Tipo Valor -  Informação que identifica de qual natureza é o valor, pode ser uma STRING pura, um SELECT no banco ou um ENCRYPTED, um valor que armazena codificado.
      • Valor - Deverá informar o valor referente ao campo.
      • Botão Salvar - Salva os dados adicionados.

    Abaixo um exemplo de cadastro:


    Image Added

    Expandir
    titleConfiguração de fluxos
    Expandir
    titleCadastro de fluxos

    O objetivo é possibilitar o Cadastro de fluxos no Winthor Smart Hub.

    Os fluxo basicamente são os passos que devem ser feitos para que os dados sejam trafegados da maneira adequada no winthor. É basicamente um conjunto de rotas configuradas para serem executadas em uma ordem específica

    Para cadastrar um novo Fluxo, devemos acessar as configurações de parâmetros através da rotina 2650 do WSH.


    Totvs custom tabs box
    tabsPasso 1, Passo 2, Passo 3, Passo 4, Passo 5
    idsitem-fluxo1,item-fluxo2,item-fluxo3,item-fluxo4,item-fluxo5
    Totvs custom tabs box items
    defaultyes
    referenciaitem-fluxo1

    Já no WSH, acessar o item 4 da rotina 2650, que é a configuração de fluxos;


    Image Added

    Totvs custom tabs box items
    defaultno
    referenciaitem-fluxo2

    Clique no botão Novo, (será apresentado os dados para Cadastro de fluxos);


    Image Added

    Totvs custom tabs box items
    defaultno
    referenciaitem-fluxo3

    Cadastro de fluxos


    Image Added


    Nesta dela, podemos montar os fluxos de acordo com o necessário simplesmente selecionando no lado esquerdo o fluxo necessário e arrastando para a tela em branco da direita.


    Caso tenham vários fluxos já adicionados, e a ordem não esteja de acordo com o esperado, podemos mover os fluxos já adicionados entre eles, também arrastando os mesmos com o mouse.


    Temos uma lista com vários recursos que podem ser utilizados:


    AutenticadorRefreshTokenApi =

    BuscaRotaServicoNaoPaginada =

    BuscaRotaServicoPaginada =

    CriaVariavelTemporaria =

    FinalizaVariavelTemporaria =

    PersisteIntegracao =

    EnvioIntegracaoStatusRecebido =

    EnvioIntegracaoStatusEmProcessamento =

    ConsultarStatusPosIntegracao =

    EnvioIntegracaoStatusRecebidoLote =


    Após adicionar os itens que forem necessários, podemos ir para a Seleção de rotas clicando em próximo passo;


    Image Added



    Totvs custom tabs box items
    defaultno
    referenciaitem-fluxo4

    Neste passo, devemos vincular as rotas em cada fluxo que foi adicionar, clicando na lupa para realizar a busca da rota;

    Image Added


    Após clicar na lupa, devemos procurar a rota necessária de acordo com o fluxo, como no exemplo abaixo, buscamos a rota de autenticação para o fluxo de AutenticadorRefreshTokenApi;


    Buscando a rota digitando pelo nome, ou listando as mesmas sem a necessidade de digitar;

    Clicar sobre a rota para selecionar a mesma;

    Confirmar a rota selecionada.


    Image Added


    Após selecionar as rotas para cada fluxo podemos ir para a revisão dos dados ou em caso de necessidade, podemos voltar um passo para selecionar ou remover outro item no fluxo voltando a página anterior;


    Image Added



    Totvs custom tabs box items
    defaultno
    referenciaitem-fluxo5

    Ao chegar no último passo, o passo de revisão, podemos ficará ativo ou não, também definir IDs independentes e também podemos alterar novamente a ordem de cada item arrastando os mesmos para cima e para baixo.


    Obs: No caso de alterar a ordem, podemos verificar que o primeiro item da tabela, "Ordem de execução" também irá alterar, respeitando a ordem de cima para baixo.


    Image Added


    Ativar ou desativar o fluxo, irá definir se o fluxo vai ficar operante ou não;

    A informação do ID independente serve para informar se uma rota depende da execução de outra para funcionar.

    Ex: Se for necessário enviar uma requisição pro WTA, vai precisar fazer o login antes, então a rota que comunica com o WTA é dependente de uma rota de login que o usuário precisa definir no cadastro do fluxo


    Ao clicar em concluir o fluxo é salvo.

    Expandir
    titleConfiguração de detalhes técnicos
    Expandir
    titleDetalhes técnicos

    O objetivo é possibilitar o acesso aos detalhes técnicos do Winthor Smart Hub.

    Para consultar os detalhes técnicos, devemos acessar a rotina 2650 do WSH.





    Totvs custom tabs box
    tabsPasso 1, Passo 2
    idsitem-detalhes1,item-detalhes2,item-detalhes3
    Totvs custom tabs box items
    defaultyes
    referenciaitem-detalhes1

    Já no WSH, acessar o item 5 da rotina 2650, que é a configuração de detalhes técnicos;


    Image Added

    Totvs custom tabs box items
    defaultno
    referenciaitem-detalhes2

    Na tela dos detalhes técnicos, podemos realizar as devidas consultas podendo filtrar as mesmas por período de data, por rota, por status sendo esses apenas um ou múltiplos e também controlar a quantidade itens exibidos por página.


    Image Added



    Expandir
    titleCadastro e consulta de DE/PARA

    Para realizar a pesquisa de uma determinada Rota, tempos duas opções Código e Nome do Serviço, sendo necessário após selecionar o Filtro, adicionar a informação no campo Pesquisa ao lado direito da tela.

    Image Removed

    Na grid, teremos opções de Editar/Excluir dados de uma determinada rota.

    Image Removed

    Expandir
    titleDetalhes técnicos

    O objetivo é possibilitar o acesso aos dados de DE/PARA do Winthor Smart Hub.

    Para consultar editar ou cadastrar um novo dado, devemos acessar a rotina 2650 do WSH.


    • 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,
    Totvs custom tabs box
    tabsPasso 1, Passo 2, Passo 3, Passo 4, ´Passo 5
    idsitem-depara1,item-depara2,item-depara3,item-depara4,item-depara5

     Cadastro de Rota/Serviço 

    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:
    Totvs custom tabs box items
    defaultyes
    referenciaitem-depara1

    Já no WSH, acessar o item 5 da rotina 2650, que é a configuração de DE/PARA;


    Image Added

    passo3

    Em construção - rotas

    O objetivo desta tela é 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:

    1. Acesse o WinThor Anywhere, localize/pesquise a rotina 2650 - Winthor Smart Hub
    2. Selecione a opção Rotas no Menu;
    3. Clique no botão Novo, (será apresentado os dados para Cadastro de Rota/Serviço);
    Expandir
    titleBotão Novo
    Expandir
    titleCadastro de Rota/Serviço
    Bloco de código
    languagejs
    titleExemplo Comunicação
    {
        "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.

    Expandir
    titleLayout de Transformação.
    Bloco de código
    languagejs
    titleExemplo Transformação
    [
      {
        "operation": "shift",
        "spec": {
          "id": "idExterno[0]",
          "shipment": { "logistic_type": "ignorarImportacaoDiferente(regra)" }
        }
      }
    ]
    
    
    • Botão Salvar - Salva os dados adicionados.
    Expandir
    titlePesquisa de Rota
    Totvs custom tabs box items
    defaultno
    referenciapasso4

    Em construção

    Totvs custom tabs box items
    defaultno
    referenciapasso5
    item-depara2

    Na tela inicial do cadastro de de/para, temos uma visualização geral dos itens já cadastrados, e também podemos utilizar os filtros para uma melhor visualização dos dados de interesse.


    Image AddedEm construção

    Em construção

    O Objetivo desta seção permite verificar os registros processados e integrados além de reprocessar dados que apresentaram falha durante a integração, possibilitando o reenvio após correção de tais divergências.

    Para reprocessar os registros realize os procedimentos abaixo:

    1. Acesse o WinThor Anywhere, localize/pesquise a rotina 2650 - Winthor Smart Hub
    2. Selecione a opção Detalhes técnicos no Menu;
    3. Na caixa Status será apresentada todas opções por padrão, caso houver necessidade pode-se realizar modificação; 
    4. Utilize os demais filtros conforme necessidade e clique o botão Pesquisar;

    Image Removed

    Image Removed

     O processo de reenvio pode ser realizado quando houver registros de integração com status Image Removed Falha.

    Para reenviar um único registro, basta clicar no botão Image Removed disponível na Grid de dados referente ao registro desejado.

    Image Removed

    Caso queira reenviar mais de um registro o botão Image Removed será habilitado quando houver seleção de vários registros, conforme demonstra a imagem:

    Image Removed

    Após o processo de reenvio note que o status do registro foi alterado para Image Removed Recebido conforme indica o dicionário de legendas.

    Ao acessar a página Monitoria e realizar a pesquisa, serão apresentados 10 registros na página,  se houver necessidade pode-se buscar mais registros através do botão Image Removedque estará disponível abaixo da grid de registros;

    Ao acionar o botão acima mencionado, apresentaremos mais 10 registros e assim em diante. 

    No rodapé da página temos a opção de selecionar a quantidade de registros que serão apresentados na grid. 

    Image Removed

    Image Removed Processando  - Indica que recebemos o registro e o dado está processando.

    Image Removed Falha  -Indica inconsistência no registro. 

    Image Removed Sucesso - Indica que o registro foi integrado.

    Image Removed Recebido - Indica que o registro faz parte de uma nova carga de reenvio.

         

    Na Grid será possível avaliar as informações de integração realizando a explanação conforme demonstrado:

    Image Removed

    Totvs custom tabs box items
    defaultno
    referenciapasso6
    Expandir
    titleDicionário de Legendas 
    Expandir
    titlePrincipais dúvidas e conflitos
    item-depara3

    Cadastro de novo item


    Para cadastrar um novo item de de/para, basta clicar em novo e informar os campos solicitados:


    Image Added


    Neste exemplo usamos a tabela de produtos(PCPRODUT) para cadastrar um código alternativo para um produto:


    Image Added


    Após preencher todos os dados, basta salvar e depois em confirmar:


    Image Added


    Então o novo item já deve aparecer salvo na coluna de exibição:


    Image Added


    Totvs custom tabs box items
    defaultno
    referenciaitem-depara4

    Edição de itens


    Para editar um item de de/para, basta clicar no botão de contexto (...) e editar o item que desejar:


    Image Added


    Os dados devem vir carregados com as informações já existentes:


    Image Added


    Basta editar o item que desejar e salvar.


    Neste caso vamos apenas mudar o código externo para exemplificar:


    Image Added


    Após salvar, o item deve estar atualizado na listagem:


    Image Added

    Totvs custom tabs box items
    defaultno
    referenciaitem-depara5

    Exclusão de itens


    Para excluir um item de de/para, basta clicar no botão de contexto (...) e excluir o item que desejar (esta alteração é Irreversível):


    Image Added


    Após clicar em excluir, é necessário confirmar a exclusão:


    Image Added


    Após confirmar, um toast de confirmação será exibido informando que o item foi excluído, e o mesmo não irá mais aparecer na listagem:


    Image Added

    Integração com PDV Omnishop

    WSH - Winthor Smart Hub - Integrações


    Informações
    titleIntegrações
    Informações
    titleIntegrações

    Integração com Fulfillment

    Expandir
    titleOmni Fulfillment
    Expandir
    titlePDV Omnishop
    Page Tree
    root