CONTEÚDO
01. VISÃO GERAL
A Frete Rápido é um HUB de transporte, ou seja, é um portal gerenciador de contratação de transportadoras que faz gestão das entregas das encomendas aos consumidores. Na integração com o TOTVS Omni by Moddo existe dois modelos de fluxo:
- Canais de venda com cotação direta na Freta Rápido: Nesse caso, o TOTVS Omni espera receber todas as informações necessárias para criar o pedido de entrega com as informações fornecidas pelo canal de venda e não é feita nova cotação.
- Canais de venda sem cotação direta na Frete Rápido: Nesse caso, o TOTVS Omni espera receber somente a sinalização que a entrega deve ocorrer através do HUB e realizará nova cotação com a Frete Rápido para adquirir as informações necessárias para criar o pedido de entrega.
Abaixo veremos como parametrizar o conector Frete Rápido 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 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 Frete Rapido 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 |
---|---|---|
freteRapido.param.cnpj | CNPJ registrado no contrato da Frete Rápido. Esta informação deve ser levantado do contrato do cliente com a Frete Rápido. | Campo Obrigatório Formato: 99999999999999 Exemplo: 53113791000122 |
freteRapido.param.token | Token para acesso aos serviços web da Frete Rápido para criação de entrega. Esta informação deve ser levantado do contrato do cliente com a Frete Rápido. | Campo Obrigatório Formato: Texto Exemplo: 4a0350a344f8aa28fcdeb3942f96f7d6 |
freteRapido.param.codPlataforma | Código de Plataforma Esta informação deve ser fornecido pela Frete Rápido para o cliente. | Campo Obrigatório Exemplo: V1w16Rziy |
freteRapido.param.zipCode | CEP - Código de Endereçamento Postal da empresa registrada na Frete Rápido. Esta informação deve ser fornecido pela Frete Rápido para o cliente. | Campo Obrigatório Formato: 9999999 Exemplo: 02511000 |
freteRapido.param.unidade.medida.peso | Sigla da medida do peso que deverá se padrão para o cálculo do frete de todos os produtos a serem entregues. Este parâmetro indica qual é a unidade de medida de peso dos produtos cadastrados no Totvs Omni by Moddo. | Campo Obrigatório Neste parâmetro as opções de cadastramento são somente as informadas nos exemplos abaixo: Exemplo se for quilograma: KG Exemplo se for grama: GR |
freteRapido.param.unidade.medida.dimensao | Sigla da medida da altura, comprimento e largura que deverá se padrão para o cálculo do frete de todos os produtos a serem entregues. Este parâmetro indica qual é a unidade de medida de dimensão dos produtos cadastrados no Totvs Omni by Moddo. | Campo Obrigatório Neste parâmetro as opções de cadastramento são somente as informadas nos exemplos abaixo: Exemplo se for metro: M Exemplo se for centímetro: CM Exemplo se for milímetro: MM |
04. DETALHES DO PEDIDO
Segue abaixo alguns diferencias que serão exibidos na interface do TOTVs Omni by Moddo quando houver um pedido de entrega com o conector Frete Rápido.
- Operador Logístico: Nome do conector logístico que é usado na integração do TOTVs Omni by Moddo.
- Código de serviço logístico: Identificador do tipo do serviço do transporte, exemplo, padrão ou expresso.
- Tipo de pedido: Identifica se é um pedido tipo entrega em domicílio, ou, retirada em loja.
- [NOVO] Transportador Responsável: Nome do transportador que realizará a entrega através da intermediação do conector Frete Rápido.
- [NOVO] Id cotação logístico: Identificador da cotação contratada do transportador através da intermediação do conector Frete Rápido.
- [NOVO] oferta logística: Identificador do serviço da oferta contratada do transportador através da intermediação do conector Frete Rápido.
Observação
Quando uma destas informações não for informado no pedido: Transportador Responsável, Id cotação logístico e oferta logística será solicitado uma cotação para a Frete Rápido antes de criar no ERP.
05. CACHE
Os módulos do Totvs Omni by Moddo 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):
- 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
06. REFERÊNCIA
https://freterapido.movidesk.com/kb