Nó Frenet

O nó de workflow Frenet é um cliente REST para a Frenet API. Use-o para cotar fretes e rastrear envios pelo agregador logístico Frenet — ideal para automação pós-checkout em e-commerce brasileiro.

Node ID no editor: frenet_request
URL padrão: POST https://api.frenet.com.br/shipping/quote

O que faz

• Chama endpoints de frete Frenet com autenticação Bearer token
• Suporta GET e POST
• Retorna HTTP status, data da resposta e headers da resposta
• Auth padrão: Authorization: Bearer {{frenet_token}}

Pré-requisitos

1. Conta Frenet com acesso à API
2. API token do dashboard Frenet
3. Integration key em Configurações → API Keys:
   • frenet_token

Como configurar

Passo 1 — Obter API token

Faça login na Frenet e copie seu API token nas configurações de integração.

Passo 2 — Definir credenciais

Adicione frenet_token como integration key.

Passo 3 — Configurar o nó

Templates de operação integrados

Exemplo — cotar frete (POST body):

{
  "recipient": {
    "zipcode": "{{variables.destination_cep}}"
  },
  "shippingItem": {
    "weight": {{variables.package_weight}},
    "height": {{variables.package_height}},
    "width": {{variables.package_width}},
    "length": {{variables.package_length}}
  }
}

Use workflow variables para CEP e dimensões a partir de dados do pedido (saída de nó de e-commerce).

Exemplo — rastrear envio:

• URL: https://api.frenet.com.br/shipping/tracking?trackingCode={{variables.tracking_code}}
• Method: GET

Passo 4 — Usar dados da resposta

Opção mais barata: {{frenet_1.data.shippingServices[0].serviceDescription}}
Preço: {{frenet_1.data.shippingServices[0].shippingPrice}}
Prazo: {{frenet_1.data.shippingServices[0].deliveryTime}}

Inspecione a saída de execução — a Frenet retorna array de opções de transportadora em shippingServices.

Saídas do nó

Dicas e boas práticas

• Peso tipicamente em quilogramas; dimensões em centímetros — confirme em documentação Frenet
• Cote antes da compra — use nó Condition para escolher transportadora mais barata vs. mais rápida
• Encadeie com nós de e-commerce: buscar pedido → extrair CEP → cotação Frenet → notificar cliente
• Tracking GET exige trackingCode válido da geração de etiqueta (pode vir da Frenet ou da transportadora)
• Teste com pares de CEP reais — CEPs inválidos retornam listas vazias de serviços

Exemplos de uso

Cotar frete após pagamento

1. Webhook — pedido pago (NuvemShop, WooCommerce, etc.)
2. Nó de e-commerce — obter CEP do endereço de entrega
3. Frenet POST — cotar com dimensões padrão do pacote
4. Send WhatsApp — "Opções de frete: {{frenet_1.data.shippingServices[0].serviceDescription}} — R$ {{frenet_1.data.shippingServices[0].shippingPrice}}"

Atualização de rastreamento ao cliente

1. Schedule — a cada 4 horas
2. Variable — código de rastreamento dos metadados do pedido
3. Frenet GET — tracking
4. Condition — status alterado
5. Send WhatsApp — atualização de entrega

FAQ

Por que array shippingServices vazio?
CEP inválido, rota não suportada ou pacote excede limites da transportadora. Verifique dimensões e peso.

Por que 401 Unauthorized?
frenet_token inválido ou ausente. Regenere token no dashboard Frenet.

A Frenet gera etiquetas neste nó?
Templates integrados cobrem apenas cotação e rastreamento. Geração de etiqueta pode exigir endpoints Frenet adicionais — configure URL/body manualmente conforme docs, ou use nó Melhor Envio para etiquetas.

Posso cotar múltiplos itens?
Ajuste shippingItem ou use formato multi-item do body Frenet conforme documentação da API.

Referência da API

Relacionado

• Visão geral de E-commerce
• Nó Melhor Envio
• Nó Condition