# Integrações de Transportadora — Visão Geral

A página de **Integrações de Transportadora** centraliza a configuração das conexões entre a plataforma Abbiamo e transportadoras externas, habilitando cotação de frete, despacho automático e rastreamento em tempo real.

---

## Onde acessar

- **URL:** `https://dashboard.abbiamolog.com/carrier-integrations`
- **Menu:** seção **Configurações** > **Integrações de Transportadora**

---

## O que o cliente vê ao entrar

### Cabeçalho

| Elemento | Descrição |
|----------|-----------|
| **Título** | "Integrações de transportadora" |
| **Nova integração** | Abre o modal de criação de nova integração |

### Barra de filtros

- **Campo de busca** — Pesquisa por nome da integração ou transportadora.
- **Botão atualizar** — Recarrega a lista manualmente.
- **Filtros avançados** — Nome, Transportadora, Filial, Situação.
- **Visibilidade de colunas** — Mostrar/ocultar colunas da tabela.

### Tabela de integrações

| Coluna | O que mostra |
|--------|-------------|
| **Nome** | Nome dado à integração |
| **Transportadora** | Nome da transportadora integrada |
| **Filial** | Filial vinculada |
| **Situação** | Badge Ativa ou Desativada |
| **Criado em** | Data e hora de criação |
| **Atualizado em** | Data e hora da última atualização |
| **Ações** | Menu (⋮) com Ver, Editar, Ativar/Desativar e Excluir |

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

| Ação | Descrição |
|------|-----------|
| **Ver integração** | Abre modal somente leitura com os dados da integração |
| **Editar integração** | Abre modal de edição |
| **Ativar / Desativar** | Alterna a situação da integração |
| **Excluir integração** | Remove a integração após confirmação |

---

## Modal de criação e edição

O modal varia conforme a transportadora selecionada, mas geralmente solicita:

| Campo | Descrição |
|-------|-----------|
| **Nome** | Identificador interno da integração |
| **Transportadora** | Carrier a conectar |
| **Filial** | Filial de origem dos despachos |
| **Credenciais** | Chaves de API ou tokens da transportadora |
| **Configurações adicionais** | Parâmetros específicos da transportadora (ex.: conta, contrato, CNPJ remetente) |

---

## Relação com outras funcionalidades

| Funcionalidade | Como usa a integração |
|----------------|-----------------------|
| [**Cotação de Frete**](https://abbiamo-guide.netlify.app/log/acoes/cotacao-frete/) | Consulta a API da transportadora para retornar preços e prazos |
| [**Automações de Envio**](https://abbiamo-guide.netlify.app/log/products/regras-de-envio/) | Despacha para a transportadora configurada na automação |
| [**Tabelas de Frete**](https://abbiamo-guide.netlify.app/log/products/tabelas-de-frete/) | Complementa ou substitui a cotação via API com preços manuais |

---

## Estado vazio

Quando não há integrações configuradas:

> *"Nenhuma integração de transportadora encontrada"*

---

## Comportamentos automáticos

- Uma integração desativada impede cotação e despacho para aquela transportadora.
- Automações de Envio que referenciam uma integração desativada exibem um badge de alerta.
**Alerta em automações de envio:** Se você desativar ou excluir uma integração de transportadora, todas as [Automações de Envio](https://abbiamo-guide.netlify.app/log/products/regras-de-envio/) que usam essa transportadora passarão a exibir um badge de alerta e deixarão de funcionar até a integração ser reativada ou substituída.