Conector com Total Express

CONTEÚDO

01. VISÃO GERAL

A Total Express é uma empresa no país com soluções logísticas. Seu negócio como operadora logística está disponibilizado no Totvs Omni by Moddo para atender clientes que contrataram seus serviços e que também se utilizam da solução Totvs Omni by Moddo. O conector desenvolvido com a Total Express funcionada na criação do pedido de entrega e serviço Smartlabel.

Os níveis de serviços aceitos são:
EXP = Expresso
ESP = Especial
PRM = Premium
STD = Standard
Obs: A Total Express trabalha com um único nível de serviço por contrato e no Totvs Omni é possível trabalhar com único contrato também.
Abaixo veremos como parametrizar o conector Total Express para o site de um cliente.

02. CONFIGURAÇÃO

Acesse o Totvs Omni by Moddo.
Informe User e Password e clique no botão SEND.

Selecione o Site Principal do Cliente (Vide Conceito de Sites, Lojas e Estrutura de Pedidos) no campo Busca e clique em Alterar.
Clique em Configurações > dentro desta opção clique na opção Sites

Selecione o Site Principal do Cliente (Vide Conceito de Sites, Lojas e Estrutura de Pedidos) no campo Busca e clique em Alterar.
Clique em Propriedades de Configuração

Expanda o grupo Operador Logístico Total Express e preencha os parâmetros conforme abaixo:

03. PARÂMETROS

Parâmetros do Conector:

Nome do Parâmetro	Descrição	Formato do Parâmetro e Exemplos
totalExpress.smartLabel.user.name	Conta de acesso a API de smarth Label do cliente.	Campo Obrigatório de ser Preenchido Formato: Texto Exemplo: validacaoapi
totalExpress.smartLabel.user.password	Senha da conta da API smath Label.	Campo Obrigatório de ser Preenchido Formato: Texto Exemplo: Total@1234
totalExpress.smartLabel.grantType	Assinatura do método, quando é feito o cadastro da APIU smarth label. Informação fornecida pela Total Express.	Campo Obrigatório de ser Preenchido Formato: Texto Exemplo: password
totalExpress.smartLabel.basicKey	Chave de acesso da API smarth label fornecida ao cliente pela Total Express.	Campo Obrigatório de ser Preenchido Formato: Texto Exemplo: basic SUNTOnRvdGFs
totalExpress.smartLabel.base.url	Endereço da URL do ambiente para acesso.	Campo Obrigatório de ser Preenchido Formato: Texto Exemplo: https://apis-qa.totalexpress.com.br
totalExpress.smartLabel.remetenteID	Número do identificador do registro criado pela Total Express para o cliente por loja. Para cada loja configurada no Omni e que pode atender pedido, deve ser configurado aqui o mapeamento do ID Externo da Loja com o rementente ID no formato Array de JSON.	Campo Obrigatório de ser Preenchido Formato: JSON Exemplo: Exemplo Expandir origem [ { "idLoja": "1", "remetenteId": "111" }, { "idLoja": "2", "remetenteId": "222" } ]

04. 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 servidor PRD BR:
- Limpar cache do modulo central: https://plataforma.omni.totvs.com.br/hermesCore/properties/<SITE PRINCIPAL>
- Limpar cache parametros conector logistico: https://plataforma.omni.totvs.com.br/moddo-logistic/cache/properties
Produção servidor PRD ES:
- 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 Logistico: https://adminco.modalia.com/moddo-logistic/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âmetro

05. REFERÊNCIA

https://totalexpress.com.br/perguntas-frequentes/

Árvore de páginas