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

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Informações
titleTópicos e Links importantes
Expandir
titleTópicos a serem executados

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


Expandir
titleLinks Importantes

Download do Instalador WSH
http://servicos.pcinformatica.com.br/autoservico/instaladores/WSH/


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


Instalação e informações do WSH
https://tdn.totvs.com/pages/releaseview.action?pageId=766958564


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

 
APIs Logística - Integração Coleta Entrega - Clientes
https://tdn.totvs.com/pages/viewpage.action?pageId=875733350


APIs Logística - Integração Coleta Entrega - Coletas
https://tdn.totvs.com/pages/viewpage.action?pageId=876222405


APIs Logística - Integração Coleta Entrega - Entregas
https://tdn.totvs.com/pages/viewpage.action?pageId=876243611


APIs Logística - Integração Coleta Entrega - Viagens
https://tdn.totvs.com/pages/viewpage.action?pageId=876243813

Expandir
title1 -Instalar o WSH - Winthor Smart Hub.

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

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

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




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

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

Expandir
title3 – Instalar a rotina 2650 – Integração Core no WTA

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


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

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



Expandir
title5 - Rotina 2650/3 – Integrações

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:

Expandir
title6 - Rotina 2650/4 - Rotas:

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:


Expandir
title7 - Rotina 2650/5 – Parâmetros:

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.


Expandir
title8 - Rotina 2650/6 – De/Para

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



Expandir
title9 - Rotina 2650/7 – Fluxos

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

Expandir
titleConclusão

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




...