VipterCentral de Ajuda

Conectar a Total Express

Rastreie os pacotes que você já envia pela Total Express e deixe o Vipter marcar os pedidos como enviados e entregues. A integração não cota frete nem compra etiquetas.

Admin ou DonoTodos os planosVerificado em 5 de out. de 2026

Com a Total Express conectada, o Vipter acompanha os pacotes que você já registra na Total Express, pela logística da Notazz ou pelo painel da própria Total Express. Cada pacote é ligado ao pedido da loja e, conforme o rastreio anda, o pedido vira enviado e depois entregue, sem ninguém marcar à mão.

A integração só rastreia. Ela não cota frete no checkout e não compra etiquetas.

Antes de começar

  • O usuário e a senha da API da Total Express. São os dados do cabeçalho de autenticação (Basic) que a Total Express envia para a loja. Se você não tem, peça ao seu comercial na Total Express.
  • A nota fiscal dos pedidos emitida pelo Vipter, pela integração de notas ou pelo ERP. É pelo número da NF-e que o Vipter encontra o pedido de cada pacote.
  • Papel Admin ou Dono no projeto do Vipter.

Como o Vipter liga o pacote ao pedido

A Total Express não conhece o pedido do Vipter, e o Vipter não conhece o código de rastreio antes do envio. Por isso, a cada hora o Vipter lê os pacotes registrados na sua conta Total Express e procura, para cada um:

  1. O código do pedido do Vipter, quando o pacote foi registrado com ele.
  2. O número da NF-e, comparado com as notas autorizadas da loja. Quando há mais de uma nota com o mesmo número, vale a da mesma série.

Pacotes que não batem com nenhum pedido da loja ficam de fora. Assim, uma conta Total Express usada por outros canais de venda não atrapalha.

Passo 1: conectar no Vipter

  1. No painel do Vipter, abra GeralIntegraçõesFreteTotal Express.
  2. No card Conexão, preencha Usuário da API e Senha da API.
  3. Deixe ligado Ativo e clique em Salvar.

Ao salvar, o Vipter confere o usuário e a senha na Total Express. Para trocar só o usuário depois, deixe a senha em branco: a senha salva continua valendo.

Passo 2: conferir um pacote

  1. Depois de salvar, o card Consultar um pacote aparece na página.
  2. Digite um código de rastreio da Total Express ou o número de uma NF-e e clique em Consultar.

Deu certo se

O pacote aparece com o último evento, a previsão de entrega e o pedido da loja ligado a ele. Um pacote ainda não rastreado entra no rastreio na próxima leitura.

Como funciona depois

  • Primeira leitura: acontece em até 5 minutos depois de salvar e busca os pacotes registrados nos últimos 7 dias. Depois, a leitura se repete a cada hora.
  • Rastreio: o Vipter consulta os pacotes abertos de hora em hora enquanto esperam a coleta, e a cada 3 horas em trânsito.
  • Enviado: assim que a Total Express coleta o pacote, o pedido vira enviado, com a Total Express como transportadora e o código de rastreio. O cliente recebe o e-mail Pedido enviado, se ele estiver ligado em E-mails transacionais.
  • Entregue: com a entrega realizada, o pedido vira entregue. Um pacote que o Vipter encontra já entregue muda o pedido sem mandar o e-mail de enviado, que chegaria atrasado.
  • Não entregue: tentativas sem sucesso (cliente ausente, endereço não localizado) e devoluções aparecem como Não entregue no pedido, com o último evento. O pedido continua enviado até a entrega.
  • Na página do pedido: o card Envio mostra o código de rastreio, o último evento da Total Express e a previsão de entrega. O botão Atualizar rastreio consulta o rastreio na hora.

Os eventos de pedido enviado e entregue também saem pelos webhooks e pelas automações, como quando a equipe marca o envio à mão. Veja Marcar o envio e a entrega.

Ligar, desligar e remover

  • Ativo: Desligado, o Vipter para de ler e de rastrear os pacotes.
  • Remover: o Vipter para de rastrear. Os envios já marcados continuam nos pedidos.

Problemas comuns

  • A Total Express recusou o usuário e a senha. Confira os dados da API com o seu comercial na Total Express.

    O usuário ou a senha não são os da API. Confira com a Total Express e salve de novo.

  • Um pacote não aparece no pedido

    Consulte o código no card Consultar um pacote. Se aparecer Nenhum pedido desta loja tem esta nota ou este código., a nota desse pedido não foi emitida pelo Vipter ou ainda não está autorizada. O Vipter confere as notas pendentes a cada 6 horas.

  • O pedido já tinha uma etiqueta

    Um pedido com etiqueta aberta de outra transportadora não ganha um segundo envio. Cancele a etiqueta antiga no pedido, se ela não vale mais.

O que fazer a seguir

Esta página ajudou?

Nesta página

Idioma