Nó Melhor Envio

O nó de workflow Melhor Envio é um cliente REST para a Melhor Envio API. Use-o para calcular fretes, gerenciar o carrinho de envios, gerar etiquetas e imprimir etiquetas — fluxo logístico completo pós-venda para e-commerce brasileiro.

Node ID no editor: melhorenvio_request
URL padrão: POST https://api.melhorenvio.com.br/v2/me/cart

O que faz

• Chama endpoints Melhor Envio v2 API com autenticação Bearer token
• Suporta GET e POST
• Retorna HTTP status, data da resposta e headers da resposta
• Auth padrão: Authorization: Bearer {{melhorenvio_token}}

Pré-requisitos

1. Conta Melhor Envio com saldo na carteira para etiquetas
2. OAuth access token ou API token das configurações de desenvolvedor Melhor Envio
3. Integration key em Configurações → API Keys:
   • melhorenvio_token

Use credenciais sandbox (sandbox.melhorenvio.com.br) para testes antes de produção.

Como configurar

Passo 1 — Obter API token

Registre app em Melhor Envio developers e complete OAuth, ou gere personal access token conforme documentação.

Passo 2 — Definir credenciais

Adicione melhorenvio_token como integration key.

Passo 3 — Configurar o nó

Templates de operação integrados

Fluxo típico de etiqueta (encadear múltiplos nós):

1. Quote — POST /v2/me/shipment/quote com CEP origem/destino e pacote
2. Add to cart — POST /v2/me/cart com service ID selecionado da cotação
3. Generate labels — POST /v2/me/shipment/generate com order IDs do carrinho
4. Print labels — POST /v2/me/shipment/print para URL do PDF

Exemplo — calcular frete (POST body):

{
  "from": {
    "postal_code": "{{variables.origin_cep}}"
  },
  "to": {
    "postal_code": "{{variables.destination_cep}}"
  },
  "products": [
    {
      "weight": {{variables.weight}},
      "height": {{variables.height}},
      "width": {{variables.width}},
      "length": {{variables.length}}
    }
  ]
}

Exemplo — adicionar ao carrinho (POST body):

{
  "service": {{variables.selected_service_id}},
  "from": { "postal_code": "{{variables.origin_cep}}" },
  "to": { "postal_code": "{{variables.destination_cep}}" },
  "package": {
    "weight": {{variables.weight}},
    "height": {{variables.height}},
    "width": {{variables.width}},
    "length": {{variables.length}}
  }
}

Todos os campos suportam workflow variables de nós de pedido e-commerce anteriores.

Passo 4 — Usar dados da resposta

Tracking: {{melhorenvio_1.data.tracking}}
Label URL: {{melhorenvio_1.data.url}}
Quote price: {{melhorenvio_1.data[0].price}}

Estrutura da resposta varia por endpoint — inspecione histórico de execução após a primeira execução.

Saídas do nó

Dicas e boas práticas

• Saldo na carteira necessário antes de shipment/generate — garanta conta Melhor Envio financiada
• Use base URL sandbox para testes: https://sandbox.melhorenvio.com.br/v2/...
• Encadeie quatro nós (quote → cart → generate → print) em vez de um nó para o fluxo completo — logs mais claros e debug mais fácil
• Armazene Melhor Envio order IDs em workflow variables entre etapas
• Após geração de etiqueta, envie código de rastreamento via nó Send message WhatsApp
• service ID vem da resposta de cotação — use nó Variable para escolher opção mais barata/rápida

Exemplos de uso

Automação completa de etiqueta pós-pagamento

1. Webhook — pedido pago
2. VTEX GET — pedido com endereço de entrega
3. Melhor Envio POST — cotação
4. Variable — selecionar service ID
5. Melhor Envio POST — add to cart
6. Melhor Envio POST — generate labels
7. Send WhatsApp — rastreamento ao cliente

Apenas cotação para vendas WhatsApp

1. WhatsWave Agent — cliente informa CEP
2. Melhor Envio POST — cotação
3. Agent — responder com opções de {{melhorenvio_1.data}}

FAQ

Por que generate falha com erro de pagamento?
Saldo insuficiente na carteira Melhor Envio. Recarregue a conta antes de gerar etiquetas.

Por que 401 Unauthorized?
Token expirado — tokens OAuth Melhor Envio precisam de refresh. Atualize melhorenvio_token.

Posso pular a etapa do carrinho?
Fluxo Melhor Envio tipicamente exige carrinho antes de generate. Siga sequência quote → cart → generate.

Sandbox vs produção?
Substitua api.melhorenvio.com.br por sandbox.melhorenvio.com.br e use token sandbox para testes.

Qual a diferença da Frenet?
Frenet foca em cotação/rastreamento. Melhor Envio adiciona carrinho, geração de etiquetas e impressão em uma plataforma.

Referência da API

Relacionado

• Visão geral de E-commerce
• Nó Frenet
• Nó Variable
• Webhook trigger