Integrações de Transportadora — Como Usar

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

---

Fluxo típico

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

---

Criar uma integração

Passo 1: Informações obrigatórias

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

Passo 2: Tabela de frete (opcional)

1. Selecione uma tabela de frete — CEP ou Raio. As tabelas disponíveis são filtradas pela modalidade selecionada.
2. 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)

Passo 1: Abrir o modal de edição

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:

1. No menu (⋮), clique em Duplicar.
2. 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.
3. 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

1. No menu (⋮), clique em Excluir.
2. 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.