TOTVS Distribuição e Varejo - linha Winthor

Páginas filhas
  • Como configurar a integração dos dados logísticos do Winthor com a API Coleta Entrega ?

Tópicos e Links importantes

1 – Instalação do WSH - Winthor Smart Hub.

2 – Atualização dos objetos pela rotina 814, do WTA.

3 – Instalar a rotina 2650 – Integração Core, no WTA

4 – Rotina 2650/2 - Importação do layout de integração

5 - Rotina 2650/3 – Integrações

6 - Rotina 2650/4 - Rotas

7 - Rotina 2650/5 – Parâmetros

8 - Rotina 2650/6 – De/Para

9 - Rotina 2650/7 – Fluxos


1 -Instalar o WSH - Winthor Smart Hub.


O WSH é um serviço necessário para integrar o Winthor com a API do Coleta Entrega.


Nome do instalador: winthor-integracao-core

Versão mínima: 1.35.0.10


Segue abaixo um link do TDN com orientação de Instalação e demais informações do WSH.

https://tdn.totvs.com/pages/releaseview.action?pageId=766958564


Download do Instalador

http://servicos.pcinformatica.com.br/autoservico/instaladores/WSH/


Para colaboradores Totvs é possível baixar a versão 1.35.0.10 através do link:

https://dev.azure.com/totvstfs/Linha-Winthor/_build/results?buildId=2915768&view=artifacts&pathAsName=false&type=publishedArtifacts




O que é o Winthor Anywhere (WTA)?

https://tdn.totvs.com/pages/releaseview.action?pageId=315885666


Como instalar o Winthor Anywhere?

https://tdn.totvs.com/pages/releaseview.action?pageId=272708475


No WTA, acesse a rotina 814 e efetue a instalação dos seguintes objetos de banco


PCNFENT                                                     - 6.0.04.000 ou superior

PCNFSAID                                                   - 6.0.02.000 ou superior

PCCARREG                                                  - 6.0.04.000 ou superior

PCDETALHECOLETAENTREGA                     - 6.0.01.000 ou superior

PCINTEGRACAOLOGEXCLUSAODADOS     - 5.0.01.000 ou superior

PCINTEGRACAOCOREMIGRATION             - 5.0.01.000 ou superior

PCINTEGRACAOFLUXOEXECUCAO             - 6.0.01.000 ou superior

PCINTEGRACAOAGENDAMENTOFLUXO    - 5.0.02.000 ou superior

PCINTEGRACAOAGENDAMENTO               - 5.0.01.000 ou superior

PCINTEGRACAOVARIAVEIS                         - 6.0.02.000 ou superior

PCINTEGRACAOVARIAVEISTEMP                - 5.0.02.000 ou superior

PCINTEGRACAOERROREQUISICAO            - 5.0.02.000 ou superior

PCINTEGRACAOCORE                                - 6.0.01.000 ou superior

PCINTEGRACAODADOSRECEBIDOS          - 5.0.02.000 ou superior

PCINTEGRACAOFLUXOONLINE                 - 6.0.01.000 ou superior

PCINTEGRACAOVARIAVEISONLINE           - 6.0.01.000 ou superior

PCINTEGRACAOROTASERVICO                  - 6.0.01.000 ou superior

PCINTEGRACAODADOSEMPRESA             - 5.0.01.000 ou superior

PCINTEGRACAODEPARA                           - 5.0.02.000 ou superior

TRG_INTEGRA_PRECEDENCIA                   - 6.0.03.000 ou superior

Em seu WTA, acesse a rotina 801 – Atualização de Serviços Web, opção Instalações e efetue a instalações dos seguintes serviços e suas respectivas versões. Caso o serviço não aparece na opção instalações, verifique na opção Atualizações.

Na rotina 812, do WTA, é possível verificar a versão atual do serviço.


winthor-logistica-apis                 - 1.35.9.6    ou superior

winthor-ferramenta-gateway      - 1.0.7          ou superior

winthor-pedido-venda                - 1.35.1.32  ou superior

winthor-compras-produto          - 1.35.2.1      ou superior

winthor-estoque-vtex                 - 1.35.0.1      ou superior

winthor-integracao-2650            - 1.36.12.33 ou superior

winthor-integracao-config          - 1.36.18.31 ou superior

winthor-filial                                - 1.0.1.28      ou superior


No WTA, no menu à esquerda, pesquise por 2650 e abra a opção 2 Assistente de Configuração


Selecione a Integração: coleta-entrega

Versão Disponível: 1.36.0.73 (Tem que ser essa versão). As demais versões disponíveis são de outras integrações

Ambiente: Homologação ou Produção (Conforme a sua necessidade)

Clique no botão Atualizar



No WTA, no menu à esquerda, acessar a opção 3, da rotina 2650.

Editar os dois itens da lista: COLETA-ENTRADA e WA-COLETA-ENTREGA

Tela inicial da opção 3 (antes de Editar).


Na opção COLETA-ENTREGA editar os campos:
Utiliza WTA = NÃO
URL Sistema Externo = nulo (Remover a informação contida nesse campo)


Clicar em Próximo e depois em Salvar.


Na opção WTA-COLETA-ENTREGA, editar os seguintes campos:
Utiliza WTA = Sim

URL Sistema Externo = http://localhost:81 (Endereço do Servidor WTA + a porta do WTA)


Após a edição a tela inicial deve ficar da seguinte forma:

No campo Filtro por, selecione a opção Serviço

No campo Pesquisa, digite login

 

Anote o Código dos Serviços COLENT – RAC LOGIN e WTA-COLENT – LOGIN, que no meu caso são os códigos 329 e 344, respectivamente. Esses códigos podem variar de cliente para cliente.
Veja a tela abaixo:


Acessar a opção 5 - Parâmetros e filtrar por “Id da Rota” utilizando os códigos que buscamos no passo anterior:

Vamos iniciar pelo serviço 329 - COLENT – RAC LOGIN.
Filtre pelo ID de Rota, do serviço COLENT – RAC LOGIN, que nesse caso é o 329, acesse a opção de Editar e deixa as chaves configuradas da seguinte forma:

{{CLIENTE_ID}}  = winthor_colent
{{CLIENT_SECRET}} = *** (Pegar essa informação com a Totvs)

{{SENHA_RAC}} =      *** (Senha do usuário Coleta Entrega)

{{URL_RAC_COLETA_ENTREGA}} = https://winthor-log.rac.totvs.app/totvs.rac/connect/token

{{USUARIO_RAC}} = nome_usuário (login do usuário Coleta Entrega)


Ainda na opção 5, da rotina 2650, informe o Id da rota WTA-COLENT – LOGIN, que nesse caso é o 344.

Na chave LOGIN informe o usuário PCADMIN e na chave SENHA informe a senha do usuário PCADMIN (a mesma usada no Winthor) em seguida marque a opção WTA para que, ao Salvar, a senha seja criptografada.

Veja a imagem abaixo:

Obs:  Caso prefira, também pode criptografar a senha seguindo os passos do tutorial:
(veja como criptografar aqui: https://tdn.totvs.com/pages/viewpage.action?pageId=741845526 )

Contudo, caso seja informado a senha já criptografada, NÃO deverá ativar a opção WTA.


Clique em Novo para incluir um novo cadastro


Em seguida, informe os seguintes dados:

Tabela: PCFILIAL

Campo: CODFILIAL

Código Interno: 1 (Filial do Winthor a ser parametrizada)

Inserir o código externo: Essa informação é individual para cada cliente e é fornecido pela Totvs



Nesse passo contém os fluxos de integração. Se atentar, pois, para realizar o fluxo completo de integração de cliente é necessário ativar os seguintes fluxos:

Clique na opção Ativar todos

Esses são os passos necessários para iniciar a integração do Winthor com o Coleta Entrega


Na rotina 2650/1 – Detalhes Técnicos é feito o acompanhamento das integrações.


O arquivo de log da integração fica no diretório:

C:\pcsist\produtos\winthor-integracao-core\logs