CONTEÚDO
01. VISÃO GERAL
Para parametrizar o conector TOTVS WinThor para o site de um cliente são necessários os seguintes procedimentos.
02. PRODUTO
Para parametrizar o conector TOTVS WinThor para produtos é necessário acessar o banco de dados do Omni conforme o procedimento abaixo:
Parâmetros do Conector TOTVS WinThor Produtos:
Nome do Parâmetro | Descrição | Formato do Parâmetro e Exemplo |
---|---|---|
totvsomni.ftp.host | URL do FTP. | Formato: URL Exemplo: ftp://integrador.omni.totvs.com.br |
totvsomni.ftp.pass | Senha do FTP onde serão armazenados os arquivos de estoque, preço e produto. | Formato: Texto |
totvsomni.ftp.user | Login do FTP onde serão armazenados os arquivos de estoque, preço e produto. | Formato: Texto |
totvswinthor.url | URL base do WinThor, incluindo porta. | Formato: URL Exemplo: http://meuwinthor.com.br:8181 |
totvswinthor.authn.body.json | JSON que contém o login e senha do WinThor que será utilizado pelo conector para consulta de produtos, preço e estoque. | Formato: Objeto JSON Exemplo: |
totvswinthor.authn.header.names | Headers adicionados na requisição de autenticação com o WinThor. | Formato: Texto Caso não seja especificado o valor padrão é Content-Type|Content-Length|Host |
totvswinthor.authn.header.values | Valores dos headers adicionados na requisição de autenticação com o WinThor. | Formato: Texto Caso não seja especificado o valor padrão é application/json|0|https://omni.totvs.com.br |
totvswinthor.branchids | Lista de empresas (separada pelo separador especificado no parametro totvswinthor.branchids.seperator) que são utilizadas para consulta de estoque. | Formato: Texto Exemplo: 1,2,3,4 |
totvswinthor.branchids.seperator | Separador da lista de empresas. | Formato: Texto Exemplo: , Caso não seja especificado o valor padrão é , |
totvswinthor.category.separator | Separador das categorias. | Formato: Texto Exemplo: - Caso não seja especificado o valor padrão é - |
totvswinthor.ftp.base.folder | Diretório base do FTP onde serão armazenados os arquivos de estoque, preço e produto. | Formato: Texto Caso não seja especificado o valor padrão é vazio, indicando o diretório root (raíz) do FTP. |
totvswinthor.ftp.estoque.originaljson.fileprefix | Prefixo dos arquivos JSON de estoque sincronizados gerados pelo pré processo de estoques. | Formato: Texto Caso não seja especificado o valor padrão é ESTOQUE_WT_ |
totvswinthor.ftp.estoque.originaljson.subfolder | Sub diretório do FTP onde será armazenado o arquivo JSON de sincronismo de estoques. | Formato: Texto Caso não seja especificado o valor padrão é ESTOQUE |
totvswinthor.ftp.precos.originaljson.fileprefix | Prefixo dos arquivos JSON de preços sincronizados gerados pelo pré processo de preços. | Formato: Texto Caso não seja especificado o valor padrão é PRECOS_WT_ |
totvswinthor.ftp.precos.originaljson.subfolder | Sub diretório do FTP onde será armazenado o arquivo JSON de sincronismo de preços. | Formato: Texto Caso não seja especificado o valor padrão é PRECO |
totvswinthor.ftp.produtos.originaljson.fileprefix | Prefixo dos arquivos JSON de produtos sincronizados gerados pelo pré processo de produtos. | Formato: Texto Caso não seja especificado o valor padrão é PRODUTOS_WT_ |
totvswinthor.ftp.produtos.originaljson.subfolder | Sub diretório do FTP onde será armazenado o arquivo JSON de sincronismo de produtos. | Formato: Texto Caso não seja especificado o valor padrão é PRODUTO |
totvswinthor.preco.param.names | Lista de parâmetros usados na consulta de preço. Separados por | | Formato: Texto Exemplo: customerId|branchId|page|pageSize |
totvswinthor.preco.param.values | Valores dos parâmetros usados na consulta de preço. Separados por | | Formato: Texto Exemplo: 1|1|1|2000 |
totvswinthor.produtos.param.names | Lista de parâmetros usados na consulta de produtos. Separados por | | Formato: Texto Exemplo: customerId|branchId|page|pageSize |
totvswinthor.produtos.param.values | Valores dos parâmetros usados na consulta de produtos. Separados por | | Formato: Texto Exemplo: 1|1|1|2000 |
totvswinthor.estoque.param.names | Lista de parâmetros usados na consulta de estoque. Separados por | | Formato: Texto Exemplo: page|pageSize |
totvswinthor.estoque.param.values | Valores dos parâmetros usados na consulta de estoque. Separados por | | Formato: Texto Exemplo: 1|2000 |
Alteração de Parâmetros e Limpeza de Cache
Ao ser alterado algum parâmetro do conector de produto, preço ou estoque para que o novo valor seja utilizado na próxima execução é necessário limpar o cache.
A limpeza do cache é realizada através do browser, logado no TOTVS Omni, acessando o integrador e chamando a seguinte URL:
https://moddointegrador-co.moddoplatform.com/integrador/caches/clear-all-caches
03. PEDIDO
- Na tela de configuração de site, selecionar o ERP como TOTVS WinThor.
- Logado no Omni > Configurações > Sites > Selecione o Site Principal do Cliente (Vide Conceito de Sites, Lojas e Estrutura de Pedidos) e clique em Alterar.
- No conjunto de configurações Site, selecione TOTVS WinThor da lista de ERPs disponíveis
- Logado no Omni > Configurações > Sites > Selecione o Site Principal do Cliente (Vide Conceito de Sites, Lojas e Estrutura de Pedidos) e clique em Alterar.
- Preencher os parametros do conector TOTVS WinThor.
- Logado no Omni > Configurações > Sites > Selecione o Site Principal do Cliente (Vide TOTVS Omni - Estrutura Pedidos Sites e Fluxos) e clique em Alterar.
No conjunto de configurações Propriedades de Configuração, expanda o grupo Conector ERP Pedidos - TOTVS WinThor e preencha os parâmetros conforme abaixo:
Parâmetros do Conector TOTVS WinThor Pedidos:
OBS: Todos os campos são obrigatórios de preenchimento, salvo informado ao contrário. Caso um array não tenha valor deve ser passado o valor [].
- Logado no Omni > Configurações > Sites > Selecione o Site Principal do Cliente (Vide TOTVS Omni - Estrutura Pedidos Sites e Fluxos) e clique em Alterar.
Nome do Parâmetro | Descrição | Formato do Parâmetro, Exemplo e Observações |
---|---|---|
winthor.url | Base da URL de acesso ao TOTVS WinThor do cliente (de acordo com o site principal - Teste ou Produção). | Formato: https:// <HOST> : <PORTA> Exemplo: https://meuwinthor.com.br:8181 |
winthor.authn.login | Login que deve ser criado no TOTVS WinThor para acesso de criação de pedidos nas empresas do cliente. | Formato: Texto |
winthor.authn.senha | Senha do usuário criado acima. | Formato: Texto |
winthor.pedidos.saleType | Formato: Número Caso não seja especificado o valor padrão é 1 | |
winthor.pedidos.saleOrigin | Formato: Texto Caso não seja especificado o valor padrão é W | |
winthor.storeId.by.warehouseId | Mapeamento entre os IDs de lojas do Omni e os warehouseIds do WinThor. | Formato: Objeto JSON Exemplo: |
winthor.pedidos.cancelamento.sendMessageRca | Formato: True ou False Exemplo: | |
winthor.pedidos.payment.plan | Mapeamento...:
| Formato: Objeto JSON Exemplo: |
winthor.pedidos.charging | ... | Formato: Objeto JSON Exemplo: |
winthor.clientes.corporate | Formato: True ou False | |
winthor.clientes.finalCostumer | Formato: True ou False | |
winthor.pedidos.seller | Formato: True ou False | |
winthor.pedidos.activity | Formato: Objeto JSON Exemplo: | |
winthor.storeId.by.carrierId | Lista de informações por operador logístico que são necessárias para a criação de pedido. Quando um pedido Omni envolve entrega, o pedido a ser criado no Winthor será criado com a informação do codigo do operador logístico ( "to" )no campo carrierId do pedido. Os códigos aqui presentes devem constar no Winthor. caso não conste ou não seja informado, o Winthor considerará o id 0 Os valores para este parâmetro devem ser analisados juntamente com a equipe Winthor do projeto. OBS: mesmo que não use a integração com a frete rápido deverá ser informado o campo nomeFreteRapido com o valor null | Formato: Objeto JSON Exemplo: |
winthor.pedidos.channel | Formato: Objeto JSON Exemplo: | |
Caso não seja enviado o tipo de frete, essa propriedade deve ser passada como "true". PS: Por padrão ou se a propriedade estiver vazia vai ser assumida como "true". Caso não queira que seja, alterar para "false". | Formato: Texto Exemplo: false |
04. CACHE
Alteração de Parâmetros e Limpeza de Cache
Os módulos do Omni trabalham com cacheamento das informações de parâmetros de conector.
Caso seja necessário alterar um parâmetro e utilizar o novo valor de imediato no conector é necessário a limpeza dos caches dos módulos do Omni.Neste caso é necessário realizar a chamada de 2 URLs através de uma tab nova no browser (Logado na interface web do Omni):
- Produção:
- Limpeza do cache no Core do Omni: https://adminco.modalia.com/hermesCore/properties/<SITE_ID>
- Limpeza de todo o cache de properties no módulo ERP: https://adminco.modalia.com/moddo-erp/cache/properties
Também é possível aguardar o prazo de 1h a 2hs para que a limpeza agendada dos caches aconteça e o conector acesse os novos valores de parâmetros.
- Produção: