TOTVS Omni

Árvore de páginas


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.hostURL do FTP.

Formato: URL

Exemplo: ftp://integrador.omni.totvs.com.br

totvsomni.ftp.passSenha do FTP onde serão armazenados os arquivos de estoque, preço e produto.Formato: Texto
totvsomni.ftp.userLogin do FTP onde serão armazenados os arquivos de estoque, preço e produto.

Formato: Texto

totvswinthor.urlURL 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: 

JSON
totvswinthor.authn.header.namesHeaders 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.valuesValores 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.branchidsLista 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.seperatorSeparador da lista de empresas.

Formato: Texto

Exemplo: ,

Caso não seja especificado o valor padrão é ,

totvswinthor.category.separatorSeparador das categorias.

Formato: Texto

Exemplo: -

Caso não seja especificado o valor padrão é -

totvswinthor.ftp.base.folderDiretó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.fileprefixPrefixo 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.subfolderSub 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.fileprefixPrefixo 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.subfolderSub 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.fileprefixPrefixo 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.subfolderSub 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

  1. Na tela de configuração de site, selecionar o ERP como TOTVS WinThor.

    1. 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.

    2. No conjunto de configurações Site, selecione TOTVS WinThor da lista de ERPs disponíveis




  2. Preencher os parametros do conector TOTVS WinThor.

    1. Logado no Omni > Configurações > Sites > Selecione o Site Principal do Cliente (Vide TOTVS Omni - Estrutura Pedidos Sites e Fluxos) e clique em Alterar.

    2. 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 [].

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: 

JSON 
[
	{
		"storeId": "1",
		"id": "1"
	},
	{
		"storeId": "2",
		"id": "3"
	}
]
winthor.pedidos.cancelamento.sendMessageRca


Formato: True ou False

Exemplo: 


winthor.pedidos.payment.plan

Mapeamento...:

  • channel: ...
  • id: ....
  • installments: ...
  • id: ...


Formato: Objeto JSON

Exemplo: 

JSON 
[
	{
		"channel": 26,
		"id": "1"
	},
	{
		"installments": 1,
		"id": "1"
	}
]
winthor.pedidos.charging

...

Formato: Objeto JSON

Exemplo: 

JSON 
[
	{
		"channel": 26,
		"id": "ECOM"
	},
	{
		"paymentType": 52,
		"id": "DH"
	},
	{
		"paymentType": 51,
		"id": "PAGS"
	},
	{
		"paymentType": 35,
		"id": "MPAG"
	},
	{
		"paymentType": 4,
		"id": "CRED"
	},
	{
		"paymentType": 5,
		"id": "PPAL"
	},
	{
		"paymentType": 44,
		"id": "DH"
	}
]
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: 

JSON 
[
	{
		"id": 1
	}
]
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
Caso uma transportadora tenha códigos diferentes quando a integração for via frete rápido ou diretamente com a transportadora, deverá ser informado 2 vezes, uma sem o "nomeFreteRapido", outra sem o "from", conforme exemplo, onde os dois primeiros blocos ambos referenciam os CORREIOS (61)



Formato: Objeto JSON

Exemplo: 

JSON 
{
		"from": 61,
		"to": 1769,
		"nomeFreteRapido": null
	},
	{
		"from": null,
		"to": 512781,
		"nomeFreteRapido": "CORREIOS"
	},
	{
		"from": null,
		"to": 1913,
		"nomeFreteRapido": "EXPRESSO FR (TESTE)"
	},
	{
		"from": 81,
		"to": 1911,
		"nomeFreteRapido": "LALAMOVE"
	},
	{
		"from": 63,
		"to": 1910,
		"nomeFreteRapido": "JADLOG"
	},
	{
		"from": 64,
		"to": 1912,
		"nomeFreteRapido": "TOTAL EXPRESS"
	}
]
winthor.pedidos.channel

Formato: Objeto JSON

Exemplo: 

JSON 
[
	{
		"channel": 26,
		"cnpj": "01.123.456/0001-00"
	}
]

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

  1. 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):

    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.