Integração Frete Rápido

A Total Express possui integração com a Frete Rápido.

Como integrar o app Total Express à Frete Rápido?

Serviços Disponíveis na Integração:

Solicitação de Coleta
Impressão de Etiquetas (SmartLabel)
Rastreio, CT-es e Faturas

Passo a Passo para Configuração:

1. Acesse o card da Total Express

Vá até o menu "Integrações" e localize o card da Total Express. Clique sobre ele ou acesse diretamente por esse link.

2. Clique em "Adicionar Conta"

Essa ação iniciará o processo de cadastro de credenciais da transportadora.

3. Preencha os campos obrigatórios e clique em VALIDAR ACESSO.

Após a validação, a tela será expandida para exibir mais campos de configuração.

4. Complete os campos adicionais

Serviço: Tipo de serviço contratado com a Total Express, conforme acordado em contrato. Cada serviço possui características distintas de atendimento, prazo e preço.

Descrição do Serviço: Campo de uso interno para facilitar a identificação. Não interfere na integração.
CNPJ da Transportadora: Por padrão, o CNPJ principal da Total Express é 73.939.449/0001-93. Caso utilize outro CNPJ no fluxo de frete/faturamento, insira o correspondente.
CNPJ de Expedição: Caso sua operação utilize múltiplos pontos de coleta ou o remetente seja diferente do CNPJ de expedição, informe o CNPJ do ponto de coleta associado a estas credenciais. Cada CNPJ de coleta normalmente exige um cadastro separado.
Status da Integração: Defina se a conta estará habilitada ou desabilitada.

5. Configuração do Código de Barras da Etiqueta

Selecione qual informação será utilizada como base para o código de barras da etiqueta SmartLabel gerada pela Total Express.

6. Clique em "SALVAR"

Após preencher todos os campos, salve as configurações.

Para adicionar outras credenciais (por exemplo, para outros serviços ou CNPJs de expedição), clique novamente em Adicionar Conta.
A Ativação ou desativação da integração pode ser feita diretamente na tela de contas:
- Gota verde: Conta habilitada
- Gota vermelha: Conta desabilitada

II. MONITORAMENTO DE INTEGRAÇÃO

O TMS Frete Rápido oferece um dashboard para acompanhar o envio das Solicitações de Coleta realizadas para a API da Total Express. O acesso pode ser feito pelo menu Integrações > Monitoramento, ou diretamente pelo link.

Nesse painel, é possível:

Filtrar as solicitações por data, status e transportadora (Total Express);
Visualizar os detalhes das requisições, incluindo os logs de resposta (response) da API da Total Express;
Reenviar uma solicitação individualmente em caso de falha no processamento;
Filtrar todas as requisições com falha e realizar reprocessamento em massa.

⚠️ O TMS realiza automaticamente novas tentativas (retries) em caso de falhas na comunicação com a API. Por isso, o reenvio manual ou o reprocessamento em massa devem ser utilizados apenas em situações pontuais.

III. IMPRESSÃO DE ETIQUETAS

O TMS Frete Rápido permite a impressão de etiquetas no formato SmartLabel da Total Express, tanto de forma manual quanto via integração por API. Para automação, consulte a documentação disponível em Etiquetas - Documentação Frete Rápido.

Impressão Manual

O painel de etiquetas pode ser acessado através do menu Etiquetas > Frete Rápido ou diretamente por esse link.

Neste painel, é possível:

Filtrar pedidos por número do pedido, ID FR, nota fiscal, nome/endereço do destinatário ou transportadora;
Filtrar por período de contratação do frete;
Gerar a etiqueta do frete selecionado.

Orientações para a Geração da Etiqueta

No momento da geração, selecione o layout "Impressão única";
Escolha o formato de impressão "Impressão térmica";
Clique em "GERAR NESTE MODELO" para obter o arquivo da etiqueta em formato PDF.

A etiqueta gerada seguirá o padrão da Total Express. O último código de barras exibido na etiqueta conterá a informação definida previamente no cadastro da integração com a transportadora.

IV. RASTREIO, CTE E FATURAS

A ativação do recebimento de rastreio de entregas, CT-es e faturas da Total Express no TMS FR depende da atuação conjunta com o time responsável da Frete Rápido.

Como solicitar

Se sua operação estiver em fase de Onboarding (implantação), entre em contato com o Analista de Implantação responsável, caso o processo ainda não tenha sido iniciado;
Se estiver em fase de operação regular, com acompanhamento pelo time de Suporte/Customer Success, a solicitação deve ser feita ao seu Agente de Suporte ou Gerente de Contas.

O que será feito

A equipe da Frete Rápido será responsável por:

Acionar a Total Express para habilitação do rastreio¹ por API;
Configurar o recebimento dos arquivos de CT-e e faturas no ambiente do TMS.

O prazo médio para conclusão dessa configuração é de até 5 dias úteis após a solicitação.

¹O TMS Frete Rápido oferece suporte a rastreamento multivolume, permitindo que fretes com múltiplos volumes físicos — devidamente consolidados no sistema ou identificados por outros meios — sejam vinculados a diferentes códigos AWB. Com isso, é possível acompanhar o status de cada volume individualmente dentro de um mesmo frete.

Observação Importante

Para que a integração com a Total Express funcione corretamente, é obrigatório que exista uma tabela de frete ativa no TMS Frete Rápido. Essa tabela pode ser:

Cadastrada pelo time da Frete Rápido, tanto durante o processo de implantação quanto na fase de operação regular, com apoio do time de Suporte; ou
Configurada diretamente pelo embarcador, caso tenha autonomia para isso.

Sem uma tabela válida associada aos serviços configurados, não será possível realizar cotações, contratações ou emissão de etiquetas via sistema.

Além disso, é fundamental que haja correspondência entre o serviço cadastrado na tabela e o serviço configurado na integração. Essa consistência garante o funcionamento correto de todos os recursos integrados.

Suporte e Contato

Em caso de dúvidas ou necessidade de apoio durante a integração com a Total Express, entre em contato com os canais abaixo, conforme sua etapa operacional:

Setor de Implantação (para operações em fase de onboarding): 📧 implantacao@freterapido.com
Setor de Suporte (para operações já ativas): 📧 suporte@freterapido.com