Pular para o conteúdo

Integrações de Transportadora — Visão Geral

A tela de Integrações de Transportadora permite criar, editar e gerenciar as configurações que conectam cada filial a uma transportadora para criar e gerenciar envios.



ElementoDescrição
Menu lateral duploAbre/fecha a sidebar
Título”Integrações de transportadora”
Nova integração de transportadoraAbre o modal de criação
  • Filial — Filtro multiselect para mostrar integrações de filiais específicas.
  • Transportador — Filtro multiselect para mostrar integrações de transportadoras específicas.
  • Ativa — Checkbox que filtra apenas integrações ativas (ativo por padrão).
  • Campo de busca — Busca textual.
  • Botão atualizar — Recarrega a lista.
  • Visibilidade de colunas — Mostrar/ocultar colunas da tabela.
ColunaO que mostra
IDIdentificador da integração
FilialNome da filial vinculada
TransportadorNome da transportadora + modalidade (ex.: Uber / Carro)
MetadadosBotão “Ver” que abre as configurações específicas da transportadora
Tabela de freteTipo da tabela (CEP ou Raio) + nome. Exibe ícone de cadeado quando a cobertura restrita está ativada
Horário de corteHorário limite do dia para considerar o pedido como “do dia”
AtivaBadge indicando se a integração está ativa ou inativa
GRISPercentual de GRIS configurado
AdvaloremPercentual de ad valorem configurado
Fator de cubagemValor do fator de cubagem (g/m³)
Isenção de cubagemPeso máximo isento de cubagem (g)
Tipo de operaçãoEntrega ou Reversa
Criada emData/hora de criação
Atualizada emData/hora da última atualização
Menu (⋮)Ações por integração
AçãoDescrição
EditarAbre o modal de edição com abas de automações
DuplicarCria uma cópia da integração para outra filial
Ativar / DesativarAlterna a situação da integração
ExcluirRemove a integração

Ao clicar em Nova integração de transportadora, o modal de criação é aberto:

  • Filial — Selecione a filial que usará esta integração.
  • Tipo de operação — Entrega ou Reversa.
  • Transportador — Selecione a transportadora e a modalidade (ex.: Uber / Carro, Correios / PAC).
  • Tabela de frete — Selecione uma tabela de frete (CEP ou Raio) para vincular. As tabelas disponíveis são filtradas pela modalidade selecionada.
  • Cobertura restrita — Aparece apenas quando uma tabela de frete é selecionada. Quando ativada, pedidos com destino fora da cobertura da tabela falham automaticamente.
  • Horário de corte — Horário limite do dia (formato HH:MM:SS). Pedidos criados depois desse horário começam a contar prazo no próximo dia útil.

Em uma seção expansível:

  • GRIS — Percentual de gerenciamento de risco.
  • Advalorem — Percentual ad valorem.
  • Fator de cubagem — Fator para cálculo de peso cúbico (g/m³).
  • Isenção de cubagem — Peso máximo isento de cálculo de cubagem (g).

Dependendo da transportadora selecionada, campos adicionais específicos podem aparecer — como credenciais de acesso, formato de etiqueta, comprovante obrigatório, entre outros. Esses campos variam de transportadora para transportadora.


Ao clicar em Editar, um modal com abas laterais é aberto:

Exibe os dados da integração para edição:

  • Somente leitura: Filial, Transportador, Tipo de operação
  • Editáveis: Tabela de frete, Cobertura restrita, Horário de corte, GRIS, Advalorem, Fator de cubagem, Isenção de cubagem, Configurações específicas da transportadora

Lista as automações de envio vinculadas a esta integração. Cada automação mostra um indicador de validação:

  • Verde: a automação está válida (o prazo referenciado existe na tabela de frete).
  • Vermelho: a automação está inválida (o prazo foi removido ou não existe na tabela).

O badge no título da aba exibe o total de automações válidas (ex.: “3/4”).

Lista as automações de reenvio vinculadas, com o mesmo indicador de validação.

Lista as automações de inatividade vinculadas, com o mesmo indicador de validação.

Ao clicar em salvar, a integração e todas as automações são atualizadas em conjunto. Não é possível salvar enquanto houver automações inválidas.


Ao clicar em Duplicar, um modal é aberto com as configurações da integração original pré-preenchidas:

  • Fixos (não editáveis): Transportador, Tipo de operação, Tabela de frete
  • Editáveis: Filial (obrigatório — selecione a filial de destino), Horário de corte, Cobertura restrita, GRIS, Advalorem, Fator de cubagem, Isenção de cubagem, Configurações da transportadora

Isso facilita a criação de integrações semelhantes para diferentes filiais sem precisar preencher tudo do zero.


Ao clicar em Ativar ou Desativar, um modal de confirmação é exibido. Integrações desativadas deixam de ser usadas nas cotações e nos envios.


Ao clicar em Excluir, um modal de confirmação é exibido. A integração é removida permanentemente.


Na coluna Tabela de frete, ao clicar no nome da tabela, um modal é aberto com a visualização completa da tabela de frete vinculada — os mesmos dados que aparecem na tela de Tabelas de Frete.


  • Tamanhos de página: 50, 100, 150, 200

  • Como usar — passo a passo para criar, editar e gerenciar integrações.
  • Troubleshooting — dúvidas comuns e problemas frequentes.