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.

---

Onde acessar

• URL: https://dashboard.abbiamolog.com/carrier-integrations
• Menu: seção Operação > Integrações de transportadora

---

O que o cliente vê ao entrar

Cabeçalho

Barra de filtros e controles

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

Tabela de integrações

Menu de ações por integração (⋮)

---

Criar integração

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

Campos obrigatórios

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

Campos opcionais

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

Informações adicionais

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

Configurações da transportadora

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.

---

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

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

Aba "Integração da transportadora"

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

Aba "Automações de envio"

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

Aba "Automações de reenvio"

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

Aba "Automações de inatividade"

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

Salvar

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.

---

Duplicar integração

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.

---

Ativar / Desativar

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.

---

Excluir

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

---

Visualizar tabela de frete

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.

---

Paginação

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

---

Próximos passos

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

---

Links relacionados

• Conceito de Integração de Transportadora — o que é e para que serve
• Tabelas de Frete — onde criar e gerenciar as tabelas vinculadas
• Conceito de Tabela de Frete — estrutura, tipos e relação com contrato
• Automações de Envio — automações que usam as integrações
• Cotação de Frete — como a integração e tabela são usadas na cotação