API Frenet

---
title: API Frenet
slug: api-frenet
sistema:
  - Gestão Administrativa [04]
chamado: "0000501144"
categoria: user_manual
tipo: how-to
publico: "operadores de vendas e administradores do sistema"
keywords:
  - frenet
  - api
  - frete negociado
  - cotação de frete
  - transportadora
  - pedido de venda
  - orçamento
  - token
autor: Antonio Marcos Zampier
setor: Qualidade
modulo: Gestão Administrativa
aprovado_em: 10/2024
release:
versao_pipeline: 2.5.2
ultima_revisao: "2026-06-12"
---

## Visão Geral

Permite realizar cotações de fretes negociados diretamente no sistema, com integração à Interface de Programação de Aplicações (API) da plataforma Frenet. Para usar a integração, o cliente deve firmar contrato com a Frenet; após a assinatura, a Frenet fornece um Token que deve ser configurado no sistema. O módulo integrador Frenet deve estar habilitado pela Teorema.

**Vídeo explicativo:** https://teorema.assetway.com.br/p/teorema/search/m/asset/4966

## Configurar a integração com a API Frenet

Acesse o módulo Administrador e clique em **Administrador > F - Parâmetros Gerais**.

![Menu Administrador com submenu aberto mostrando as opções de A a M e "Informações da Release"; o item "F - Parâmetros Gerais" está destacado](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/api-frenet/api-frenet-06.png)

Na tela Parâmetros Gerais, acesse a aba **API Config**. Será exibida a janela **Config API**. Preencha os campos:

1. **API** — selecione `apiFrenete`
2. **Descrição** — informe `FRENET`
3. **Token** — insira o Token fornecido pela Frenet

Clique em **Confirmar**.

![Janela "Config API" com campo API preenchido com "apiFrenete", campo Descrição preenchido com "FRENET" e campo Token destacado para preenchimento; botões Cancelar e Confirmar ao final](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/api-frenet/api-frenet-07.png)

## Liberar acesso ao Frete Negociado no cadastro de usuários

Para que o campo Frete Negociado fique disponível no Pedido de Vendas e no Orçamento, o acesso deve ser habilitado no cadastro do usuário. Acesse **Cadastro de Usuários**, selecione o usuário desejado, abra a aba **2 Acessos** e, dentro da árvore de permissões, marque a opção **Informar Frete Negociado** (localizada em Processos).

![Tela Cadastro de Usuários, aba "2 Acessos", com a opção "Informar Frete Negociado" destacada na árvore de permissões do usuário ADMINISTRADOR SISTEMA](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/api-frenet/api-frenet-08.png)

## Abrir o Pedido de Venda ou Orçamento

No módulo Gestão Administrativa, acesse **Vendas > Pedidos de Venda** ou **Vendas > Orçamentos**.

![Menu Vendas do módulo Gestão Administrativa com as opções "Orçamentos", "Pedidos de Venda", "Emissão de Nota Fiscal", "Romaneios de Saída" e "Expedição"](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/api-frenet/api-frenet-09.png)

Na tela **Pedido de Vendas**, abra o pedido desejado. Em seguida, clique em **Processos > Informar Frete Negociado**.

![Tela Pedido de Vendas com o menu Processos aberto mostrando a opção "Informar Frete Negociado"](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/api-frenet/api-frenet-10.png)

## Acessar o Lançamento do Valor do Frete Negociado

O sistema abre a tela **Lançamento do Valor do Frete Negociado**. Nessa tela o botão **Frenet** fica habilitado, permitindo abrir a integração com a API Frenet.

![Tela "Lançamento do Valor do Frete Negociado" com o botão Frenet destacado; campos Nº Documento, Data Emissão, Cliente, Negociador, Transportador e Valor do Documento visíveis](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/api-frenet/api-frenet-11.png)

## Incluir volume para cotação

Ao clicar no botão **Frenet**, o sistema abre a tela **Frenet - Cotação de Frete** com o painel **Incluir Volume**. Preencha os campos:

1. **Altura** (cm)
2. **Largura** (cm)
3. **Comprimento** (cm)
4. **Peso** (kg)
5. **Quantidade** (un)

Clique no botão de confirmação (6 — ícone de visto no canto superior direito do painel) para registrar o volume.

![Tela "Frenet - Cotação de Frete" com painel "Incluir Volume" aberto; campos Altura (10 cm), Largura (15 cm), Comprimento (15 cm), Peso (0,300 kg) e Quantidade (1 un) numerados de 1 a 5; botão de confirmação indicado como item 6](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/api-frenet/api-frenet-12.png)

## Solicitar cotação de frete

Após confirmar o volume, o sistema retorna à tela **Frenet - Cotação de Frete**. Preencha:

1. **CEP de Origem**
2. **CEP de Destino**
3. **Valor Total**

Em seguida, clique no botão **Cotação de Frete no Produto** (4) para acionar a consulta junto à Frenet.

![Tela "Frenet - Cotação de Frete" com campos CEP de Origem, CEP de Destino e Valor Total numerados de 1 a 3; seção "Volumes para Cotação" com linha de volume cadastrado (Altura 15, Largura 30, Comprimento 150, Peso 0,500, Qtde 1); botão "Cotação de Frete no Produto" indicado como item 4; seção "Transportadoras e Cotações" com colunas Código, Transportador, Descrição, Dias e Valor ainda sem resultados](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/api-frenet/api-frenet-13.png)

## Visualizar transportadoras e selecionar frete

O sistema exibe a lista de transportadoras que atendem ao CEP de destino com os respectivos valores. Os botões disponíveis na seção **Volumes para Cotação** são:

- **1 (ícone lixeira)** — excluir o volume informado
- **2 (ícone editar)** — editar o volume informado
- **3 (botão +)** — incluir um novo volume quando não há nenhum cadastrado

Selecione a transportadora desejada marcando o campo ao final da linha correspondente.

![Tela "Frenet - Cotação de Frete" mostrando seção "Volumes para Cotação" com volume (Altura 10, Largura 15, Comprimento 15, Peso 0,300, Qtde 1) e botões 1 (excluir) e 2 (editar) indicados; origem 85023500, destino 24465256; seção "Transportadoras e Cotações" com quatro linhas: F_3 / 6 dias / R$ 28,52; 04510 / 8 dias / R$ 35,40; LOG_DRPOFF / 8 dias / R$ 43,20; 04014 / 4 dias / R$ 70,80; botão + indicado como item 3](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/api-frenet/api-frenet-14.png)

## Conferir valores no site da Frenet

Para confirmar a consistência dos valores, é possível acessar o simulador em **www.frenet.com.br/simular-frete/** e verificar que os valores calculados pelo sistema correspondem aos exibidos no site da Frenet.

![Comparação lado a lado: à esquerda, o site da Frenet (www.frenet.com.br/simular-frete/) com os resultados PAC, Jadlog Package, Loggi e SEDEX com valores em reais; à direita, a tela "Frenet - Cotação de Frete" do sistema com as mesmas transportadoras e valores correspondentes](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/api-frenet/api-frenet-15.png)

## Confirmar a seleção da transportadora

Ao selecionar a transportadora na lista, o sistema exibe uma caixa de diálogo **Confirm** com o resumo: transportadora, prazo em dias e valor. Clique em **OK** para confirmar a seleção.

![Tela "Frenet - Cotação de Frete" com caixa de diálogo "Confirm" sobreposta exibindo "Frete selecionado.", Transportadora (borrada), "Dia(s).: 6", "Valor.: 28.52" e a pergunta "Confirma seleção?"; botões OK e Cancelar; na lista, a linha F_3 com valor 28,52 está marcada (item 1) e a seta indica o botão OK (item 2)](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/api-frenet/api-frenet-16.png)

## Registrar transportadora e valor no Lançamento do Frete Negociado

Após confirmar, o sistema retorna à tela **Lançamento do Valor do Frete Negociado** e preenche o campo **Observações** com as informações da transportadora selecionada (nome, prazo e valor).

![Tela "Lançamento do Valor do Frete Negociado" com campo Observações preenchido automaticamente com dados da transportadora selecionada (TRANSPORTADORA, DIAS e VALOR)](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/api-frenet/api-frenet-17.png)

## Cotar frete pela aba Dados de Transporte no Pedido de Venda ou Orçamento

No Pedido de Vendas ou Orçamento, a cotação também pode ser iniciada diretamente pela aba **6 Dados de Transporte**. O sistema exibe a seção **Dados de Transporte** com os campos de transportador, endereço e a seção **Frete e Volumes**.

![Tela Pedido de Venda com a aba "6 Dados de Transporte" selecionada (item 1); seção "Dados de Transporte" visível com subcampos Transportador, dados do Transportador/Endereço, e seção "Frete e Volumes" com campos Frete p/Conta, Valor do Frete, Quantidade Volumes, Marca Volumes, Espécie Volumes, Peso Bruto e Peso Líquido; seta indica a aba ativa (item 2)](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/api-frenet/api-frenet-18.png)

## Incluir volume e cotar pelo fluxo do Pedido de Venda

Ao clicar no botão **Frenet** dentro da aba Dados de Transporte, o sistema abre a tela **Frenet - Cotação de Frete** com o painel **Incluir Volume**. Preencha os campos (Altura, Largura, Comprimento, Peso, Quantidade) conforme indicado e clique no botão de confirmação (ícone de visto).

![Tela "Frenet - Cotação de Frete" com painel "Incluir Volume" aberto; campos numerados: 1 Altura (1 cm), 2 Comprimento (40 cm), 3 Quantidade (1 un), 4 Largura (3 cm), 5 Peso (3,200 kg); botão de confirmação (visto) indicado pela seta; Valor Total R$ 635,46](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/api-frenet/api-frenet-19.png)

## Selecionar transportadora e confirmar cotação

Após clicar em **Cotação de Frete no Produto**, o sistema retorna a lista de transportadoras disponíveis. Selecione a transportadora desejada (item 1) e clique em **OK** na caixa de diálogo de confirmação (item 2).

![Tela "Frenet - Cotação de Frete" com volume (Altura 1, Largura 1, Comprimento 10, Peso 3,200, Qtde 1); caixa "Confirm" sobreposta com "Frete selecionado.", Transportadora (borrada), "Dia(s).: 5", "Valor.: 46.85" e "Confirma seleção?"; botão OK indicado como item 2; na lista, linha F_3 com valor 46,85 marcada como item 1; demais linhas: LOG_DRPOFF 39,20 / 5 dias; 04510 58,50 / 7 dias; 04014 118,10 / 3 dias; 34819 visível](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/api-frenet/api-frenet-20.png)

## Mapear transportadora Frenet para transportadora cadastrada

Na primeira utilização de uma transportadora Frenet, o sistema abre a tela **Consulta de Seleção para Transportadora para Integração** para realizar o mapeamento DE-PARA. Localize a transportadora cadastrada no sistema pelo campo de busca e selecione-a. Nas próximas cotações com a mesma transportadora, o mapeamento será aplicado automaticamente.

![Tela "Consulta de Seleção para Transportadora para Integração" com campo de busca "Digite o texto para localizar" e opção "Localizar por Nome/Descrição"; tabela com colunas CÓDIGO, NOME, TELEFONE e ENDEREÇO listando diversas transportadoras cadastradas](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/api-frenet/api-frenet-21.png)

## Verificar transportadora e custo do frete no Pedido de Venda

Após a seleção e confirmação, o sistema preenche automaticamente o campo **Transportador** com o código e nome da transportadora mapeada e o campo **Valor do Frete** com o valor cotado na seção Frete e Volumes da aba Dados de Transporte.

![Tela Pedido de Venda, aba "6 Dados de Transporte", com campo Transportador preenchido com "0019047 - JADLOG LOGISTICA E TAXI AEREO LTDA" e campo Valor do Frete preenchido com 46,85; dados do endereço da transportadora visíveis com U.F. BA](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/api-frenet/api-frenet-22.png)

## Solicitar ativação do módulo integrador Frenet

Para usar a integração Frenet, é necessário solicitar a ativação do módulo à Teorema. Se o módulo não estiver habilitado, ao acessar a aba **6 Dados de Transporte** o sistema exibe a mensagem:

> **API não configurada !!! Para Configurar acesse o Módulo Administrador do Menu Administrador na opção Parâmetros Gerais Configurar a Aba Api Config.**

Entre em contato com a Teorema para solicitar a liberação.

![Tela Pedido de Venda com a aba "6 Dados de Transporte" selecionada (item 1); caixa de diálogo "Gestão Administrativa" exibindo mensagem de erro "API não configurada!!!" com orientação para acessar Parâmetros Gerais e configurar a Aba Api Config; botão OK indicado (item 2)](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/api-frenet/api-frenet-23.png)

## Informações do documento

> Autor: Antonio Marcos Zampier
>
> Setor: Qualidade
>
> Módulo: Gestão Administrativa
>
> Chamado: 0000501144
>
> Versão do Sistema:
>
> Versão do documento: 01
>
> Revisão: Andreia Burko Bley
>
> Aprovado em: 10/2024

---

> 📎 **Arquivos originais:** [Manual API FRENET.docx](https://drive.google.com/uc?export=download&id=1vPr8W00mk4o3OKIGzNV0KbFrEX0uOfh5) · [Manual API FRENET.pdf](https://drive.google.com/uc?export=download&id=1KO6V--I7sUqHpGemvProTk9uKubQmrUx)