Integrações de Transportadora — Como Usar

Como usar Integrações de Transportadora

Guia prático das principais ações para configurar e operar integrações de transportadora.

Fluxo típico

Acesse Operação > Integrações de transportadora (/carrier-integrations).
Use os filtros de filial e transportador para encontrar integrações específicas.
Clique em Nova integração de transportadora para criar, ou use o menu (⋮) para editar, duplicar, ativar/desativar ou excluir.
Ao editar, revise as automações vinculadas nas abas laterais.

Criar uma integração

Passo 1: Informações obrigatórias

Clique em Nova integração de transportadora.
Selecione a filial que usará esta integração.
Escolha o tipo de operação: Entrega ou Reversa.
Selecione o transportador e a modalidade (ex.: Uber / Carro, Correios / PAC).

Passo 2: Tabela de frete (opcional)

Selecione uma tabela de frete — CEP ou Raio. As tabelas disponíveis são filtradas pela modalidade selecionada.
Se selecionou uma tabela, a opção Cobertura restrita aparece. Ative se quiser que pedidos com destino fora da cobertura da tabela falhem automaticamente.

Passo 3: Horário de corte (opcional)

Informe o horário de corte (formato HH:MM:SS). Pedidos criados depois desse horário começam a contar prazo no próximo dia útil.

Passo 4: Informações adicionais (opcional)

Expanda a seção de informações adicionais para configurar:

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).

Passo 5: Configurações da transportadora

Dependendo da transportadora, campos adicionais específicos podem aparecer (credenciais, formato de etiqueta, etc.). Preencha conforme as instruções da transportadora.

Passo 6: Salvar

Clique em Salvar para criar a integração.

Editar uma integração (com automações)

No menu (⋮) da integração, clique em Editar.

Passo 2: Editar dados da integração

Na aba Integração da transportadora:

Campos editáveis: tabela de frete, cobertura restrita, horário de corte, GRIS, advalorem, fator de cubagem, isenção de cubagem e configurações da transportadora.
Campos somente leitura: filial, transportador e tipo de operação.

Passo 3: Revisar automações

Clique nas abas laterais para revisar as automações vinculadas a esta integração:

Automações de envio — Lista as automações de envio com indicador de validação.
Automações de reenvio — Lista as automações de reenvio.
Automações de inatividade — Lista as automações de inatividade.

Cada aba exibe um badge com o número de automações válidas (ex.: “3/4”). Automações com prazo inválido ficam com indicador vermelho.

Passo 4: Salvar

Clique em Salvar para atualizar a integração e todas as automações de uma vez.

Duplicar uma integração

Útil para criar integrações semelhantes para diferentes filiais:

No menu (⋮), clique em Duplicar.
O modal abre com as configurações pré-preenchidas:
- Fixos: transportador, tipo de operação, tabela de frete.
- Editáveis: filial (selecione a nova filial), horário de corte, cobertura restrita, informações adicionais e configurações da transportadora.
Ajuste os campos necessários e salve.

Ativar e desativar

Desativar — A integração deixa de ser usada nas cotações e envios, mas permanece salva. Útil para pausar temporariamente.
Ativar — A integração volta a ser usada.

Use o menu (⋮) > Ativar ou Desativar.

Excluir uma integração

No menu (⋮), clique em Excluir.
Confirme no modal de confirmação.

A exclusão é permanente. Automações que referenciam esta integração precisarão ser ajustadas.

Visualizar a tabela de frete vinculada

Na coluna Tabela de frete da tabela de integrações, clique no nome da tabela para abrir um modal com a visualização completa da tabela — prazos, faixas e preços.

Boas práticas

Uma integração por modalidade e operação — Cada filial pode ter apenas uma integração por combinação de transportadora + modalidade + tipo de operação.
Defina o horário de corte — Alinhe com o horário limite de coleta da transportadora para que a data de entrega esperada seja realista.
Use cobertura restrita com cuidado — Ative apenas se a tabela de frete cobre todas as regiões que a filial atende. Caso contrário, pedidos para destinos não mapeados falharão.
Revise automações ao mudar a tabela — Ao trocar a tabela de frete de uma integração, confira se os prazos da nova tabela são compatíveis com as automações existentes.
Duplique para escalar — Use a duplicação para replicar configurações entre filiais, ajustando apenas o que for diferente.