Conecta-seEntrar na plataforma

Melhor Envio

Cotar fretes, comprar, gerar, imprimir e cancelar etiquetas e consultar o rastreamento pelo Melhor Envio.

Integrações e ferramentasComércio e pagamentosConexão: Conexão do workspace ou do canal

O que faz

Cuide dos fretes da sua loja: cote entre CEPs, crie, compre, gere e imprima etiquetas, cancele quando precisar e responda "cadê meu pedido?" com o status atualizado da entrega.

Quando usar: Use quando o seu fluxo precisar cotar fretes, comprar, gerar, imprimir e cancelar etiquetas e consultar o rastreamento pelo Melhor Envio.

Exemplo de situação: Consultar um pedido ou executar uma ação comercial durante o atendimento.

Antes de começar

Conexão necessária: Conexão do workspace ou do canal.

Confirme que a integração ou o canal já está conectado no workspace.

Passo a passo

  1. Adicione Melhor Envio ao desenho a partir da aba Blocos e ligue a entrada dele à etapa anterior.
  2. Confirme que a integração ou o canal já está conectado no workspace.
  3. Escolha a operação. O painel mostra só os campos que essa operação usa.
  4. Preencha os campos obrigatórios. Para usar um dado de uma etapa anterior, digite < e escolha o bloco e o campo.
  5. Clique em Executar com dados de teste e confira, no terminal, o que entrou e o que saiu do bloco.
  6. Só publique depois de conferir o resultado da execução de teste.

Operações

OperaçãoO que faz
Rastrear PedidoRastreia Pedido com o bloco Melhor Envio.
Buscar Envios do ClienteBusca Envios do Cliente com o bloco Melhor Envio.
Cotar FreteCota Frete com o bloco Melhor Envio.
Listar EnviosLista Envios com o bloco Melhor Envio.
Criar Etiqueta (carrinho)Cria Etiqueta (carrinho) com o bloco Melhor Envio.
Comprar EtiquetaCompra Etiqueta com o bloco Melhor Envio.
Gerar EtiquetaGera Etiqueta com o bloco Melhor Envio.
Imprimir EtiquetaImprime Etiqueta com o bloco Melhor Envio.
Cancelar EtiquetaCancela Etiqueta com o bloco Melhor Envio.
Listar ServiçosLista Serviços com o bloco Melhor Envio.
Listar AgênciasLista Agências com o bloco Melhor Envio.
Status da ConexãoExecuta a operação “Status da Conexão” com o bloco Melhor Envio.

Campos

Mostrar campos de
  • Operação

    Escolhe qual ação este bloco executará.

    Opções:
    Rastrear Pedido · Buscar Envios do Cliente · Cotar Frete · Listar Envios · Criar Etiqueta (carrinho) · Comprar Etiqueta · Gerar Etiqueta · Imprimir Etiqueta · Cancelar Etiqueta · Listar Serviços · Listar Agências · Status da Conexão
    Exemplo:
    Rastrear Pedido
  • Conta Melhor Envio

    Usa a conta do Melhor Envio conectada no workspace. Os tokens de acesso nunca são expostos a este bloco nem ao agente.

    Exemplo:
    (escolha na lista do campo)

Saídas

Para usar um resultado deste bloco em uma etapa seguinte, digite < no campo e escolha o bloco e o campo. A referência tem o formato <melhorenvio.response>: antes do ponto vai o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.

ReferênciaTipoO que contém
<melhorenvio.response>jsonResposta da API v2 do Melhor Envio para a operação executada.

Exemplo de uso

Objetivo: Consultar um pedido ou executar uma ação comercial durante o atendimento.

InícioMelhor Enviopróxima etapa
Operação
Rastrear Pedido
Conta Melhor Envio
(escolha na lista do campo)

Os valores são ilustrativos. Teste primeiro com dados fictícios ou de homologação.

Erros comuns e como resolver

O bloco não executa
Confira se existe um caminho de setas que parte do gatilho (ou do Início) até este bloco. Blocos soltos no desenho são ignorados.
Aparece “Validação do fluxo” no terminal
Há campo obrigatório vazio. Clique no aviso, abra o bloco indicado e preencha o campo marcado.
Um campo chega vazio na etapa seguinte
Confira se a referência aponta para um bloco que já executou e para um campo que existe, como <melhorenvio.response>. O nome antes do ponto é o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
O campo que eu procuro não aparece
Os campos mudam conforme a operação escolhida. Escolha a operação primeiro; campos menos usados ficam em “Mostrar campos adicionais”.
O serviço recusou a chamada ou devolveu erro
Leia a mensagem no terminal: ela traz o motivo informado pelo serviço. Confira IDs, limites de uso e permissões, e teste antes com um recurso de homologação.

Blocos relacionados