A Frenet é uma plataforma de soluções logísticas para e-commerce que conecta lojas virtuais a transportadoras e oferece recursos para cálculo e gestão de fretes.
Na Uappi, a integração permite utilizar os serviços da Frenet diretamente na operação logística da loja, incluindo cotação de frete, rastreamento e envio de informações de pedidos.
Importante: este conteúdo apresenta a configuração da integração Frenet atual, disponibilizada via WAPI. No painel da Uappi também pode ser exibida uma integração identificada como Frenet — Legado. Para novas configurações, localize a Frenet atual, identificada pelo hash: frenet-api.
A integração da Uappi com a Frenet possui suporte aos seguintes recursos:
Para realizar a configuração, você precisa:
Atenção: tokens e outras chaves de integração são informações confidenciais. Não compartilhe esses dados publicamente.
Antes de configurar o gateway na Uappi, obtenha o Token da conta que será utilizada na integração.
Acesse o Painel do Cliente da Frenet e faça login na sua conta.
No canto superior direito:
Esse Token será utilizado posteriormente na configuração do gateway dentro da Uappi. O fluxo também foi informado pela Frenet no material de configuração enviado à Uappi.
Com o Token em mãos, acesse o Painel Administrativo da Uappi.
Siga o caminho:
Configurações > Fretes
Localize a integração Frenet atual, identificada pelo hash: frenet-api, e acesse sua configuração.
Atenção: não utilize a opção Frenet — Legado para seguir este passo a passo, pois ela possui campos e funcionamento diferentes da integração atual.
Na configuração da integração, preencha os campos de acordo com a operação da loja.
Define se a integração com a Frenet ficará ativa ou inativa.
Para utilizar a integração, mantenha o gateway ativo.
Define o comportamento de homologação da integração.
Atenção: a Frenet não disponibiliza um ambiente sandbox independente de produção. Por isso, a utilização dessa opção não deve ser considerada como garantia de isolamento do ambiente produtivo. Antes de realizar testes envolvendo pedidos reais, confirme o fluxo adequado para a operação.
Informe o Token da conta Frenet obtido anteriormente no painel da Frenet.
O campo Define os status de pedidos para o envio dos pedidos para a WAPI determina quais pedidos poderão ser enviados automaticamente para a integração.
Selecione os status utilizados pela operação para indicar que o pedido está pronto para ser enviado.
A própria configuração do campo recomenda os status Faturado e Enviado.
Importante: se nenhum status estiver configurado, os pedidos não serão enviados para a Frenet por esse fluxo.
Permite acrescentar uma margem, em dias, ao prazo de frete apresentado ao cliente.
Por exemplo, caso a transportadora retorne um prazo de 3 dias e seja configurado 1 dia adicional, o prazo considerado pela loja será de 4 dias.
Permite adicionar um valor ao custo do frete apresentado ao cliente.
Esse campo pode ser utilizado quando a operação precisar considerar uma margem adicional sobre o valor retornado pela Frenet.
Define quais armazéns configurados na Uappi serão atendidos pela integração com a Frenet.
Selecione os armazéns correspondentes à operação que utilizará esse gateway.
Após concluir o preenchimento, salve as alterações.
Além da cotação de frete, a integração permite o envio de pedidos para a Frenet.
O envio ocorre automaticamente de acordo com os status de pedido selecionados na configuração da integração.
Por isso, é importante configurar o campo Define os status de pedidos para o envio dos pedidos para a WAPI de acordo com o fluxo da operação.
Quando o pedido atingir um dos status configurados, ele poderá ser processado pela rotina responsável pelo envio à integração.
Importante: pedidos que não estejam em um dos status configurados não serão enviados por esse fluxo.
A integração utiliza webhook para receber atualizações relacionadas aos pedidos enviados para a Frenet, como informações utilizadas no fluxo de rastreamento e atualização do pedido.
Nesse fluxo, a comunicação ocorre entre Frenet, WAPI e Uappi, utilizando o callback da integração.
O lojista não precisa cadastrar manualmente uma URL de callback na configuração da Uappi para utilizar esse fluxo.
Importante: caso exista alguma configuração específica de webhook necessária diretamente na conta Frenet, siga a orientação fornecida pela própria Frenet para a operação.
A integração permite receber informações de rastreamento dos pedidos.
O código de rastreio e o link de acompanhamento são tratados como informações distintas. Por isso, em determinadas entregas pode existir um link válido para acompanhar o pedido mesmo que o campo de código de rastreio esteja vazio.
Em operações com transportadoras diferentes dos Correios, consulte também o link de rastreio disponível no pedido.
Durante uma cotação, podem ser consultadas diferentes opções de frete.
Caso ocorra erro em apenas uma delas, a cotação completa não é cancelada automaticamente.
As demais opções válidas continuam podendo ser apresentadas ao cliente.
A cotação será considerada sem resultado quando nenhuma opção válida de frete permanecer disponível ao final do processamento.
Isso evita que uma falha isolada em determinado serviço ou modalidade impeça a apresentação das demais opções disponíveis.
Após finalizar a configuração, recomendamos realizar um teste antes de disponibilizar a integração em produção.
Verifique se:
Ao realizar testes, considere que a Frenet não disponibiliza um ambiente sandbox independente de produção. Evite utilizar pedidos reais sem antes validar o fluxo adequado para a operação.
Sim. É necessário possuir uma conta ativa na Frenet e obter o Token utilizado na configuração da integração.
No Painel do Cliente da Frenet, acesse Perfil > Dados cadastrais e localize a seção Chaves de acesso. O Token estará disponível nessa área.
A integração possui a opção Homologação em sua configuração na Uappi. No entanto, a Frenet não disponibiliza um ambiente sandbox independente de produção. Por isso, antes de realizar testes envolvendo pedidos reais, valide o fluxo adequado para a operação.
Sim. Utilize o campo Tempo adicional para fretes (dias) na configuração do gateway.
Sim. O campo Valor adicional para fretes (R$) permite adicionar uma margem ao valor apresentado ao cliente.
Não. Se outras opções válidas estiverem disponíveis, elas poderão continuar sendo retornadas. A integração só ficará sem resultado quando nenhuma opção válida permanecer ao final da cotação.
O código de rastreio e o link de acompanhamento são tratados como informações distintas. Por isso, pode existir um link válido para acompanhar a entrega mesmo que o campo de código de rastreio esteja vazio. Em operações com outras transportadoras, consulte também o link de rastreio disponível no pedido.
O webhook faz parte do fluxo de comunicação utilizado pela integração para receber atualizações dos pedidos. Na configuração da Uappi, não é necessário cadastrar manualmente uma URL de callback para esse fluxo.
Verifique se o pedido está em um dos status definidos no campo Define os status de pedidos para o envio dos pedidos para a WAPI. Somente pedidos que atendem aos critérios configurados são processados para envio pela integração.
Leave a Reply