# Venddor Connect

**Para quem:** qualquer pessoa que vai usar o Connect pela primeira vez.
**Responde:** o que o Connect é, o que ele resolve, e por onde começar.

---

## O que é

O Venddor Connect liga sistemas que não foram feitos para conversar.

Um ERP TOTVS Protheus e o aplicativo de força de vendas de um fornecedor. Um e-commerce e o ERP da loja. Uma planilha no SFTP da transportadora e a API do WMS. O Connect fica no meio: lê de um lado, transforma o dado, grava do outro, e mostra o que aconteceu com cada registro.

Você monta a integração numa tela, não em código. Escolhe de onde vem, para onde vai, liga campo com campo numa planilha, escreve fórmulas no estilo do Excel quando o valor precisa mudar de forma, e diz quando isso deve rodar.

**A Venddor é um conector, não o dono da casa.** A maioria das integrações do Connect não tem a Venddor em nenhuma das pontas. Quando ela é uma delas, é através de um conector dedicado, igual aos outros.

---

## O que ele resolve

| Situação | Como o Connect trata |
|---|---|
| O ERP tem API, o destino também, e os campos têm nomes diferentes | Descoberta nas duas pontas, mapeamento automático, planilha para ajustar o resto |
| O ERP não tem API, só banco | Conector de banco, sete SGBDs, com consulta parametrizada e proteção contra escrita acidental |
| O sistema deposita um arquivo posicional no SFTP toda noite | Conector de arquivo, editor visual de layout, e o arquivo nunca é processado duas vezes |
| A troca é EDI com uma montadora | Parser próprio, com dicionário de segmentos em português |
| O sistema só existe dentro da rede do cliente | Agente Bridge, com túnel de saída e lista de destinos autorizados |
| Ninguém sabe o que mudou desde ontem | Marca d'água tipada, feed de mudanças em duas etapas, e reconciliação para descobrir o que sumiu |
| Doze distribuidores com a mesma regra e filiais diferentes | Integração-mãe, réplicas vinculadas e promoção em lote |

---

## Como o dado atravessa

Um registro percorre sempre a mesma sequência:

```
Extrair → Normalizar → Filtrar → Expandir → Lookup → Mapear → Fórmula →
De-para de valores → Resolver referências → Validar → Autoridade →
Idempotência → Gravar → Registrar
```

Três consequências que valem entender desde o começo:

**Erro de um registro não derruba a execução.** Ele vira pendência ou erro daquele registro, e o resto continua. Só erro de conexão ou de autenticação aborta tudo — porque aí nenhum registro seguinte funcionaria.

**Registro que não mudou não é enviado ao destino.** O Connect guarda um checksum do que gravou. Igual ao anterior, ele conta como "sem mudança" e não chama o destino. É por isso que a segunda execução de uma integração bem configurada é rápida e silenciosa.

**Tudo fica registrado.** Entrada bruta, cada passo da transformação, saída, e o diff campo a campo. É essa gravação que permite responder "o que exatamente foi enviado no dia 12?" — e, em integração entre dois sistemas externos, ela é a **única** evidência do que trafegou.

---

## Por onde começar

1. **[Conceitos](conceitos.md)** — projeto, conexão, segredo, entidade, integração, ambiente, réplica. Vale os dez minutos: quase todo problema de configuração é um destes conceitos confundido com outro.
2. **[Primeiros passos](primeiros-passos.md)** — do zero até a primeira integração rodando.
3. **O guia do seu conector** — [REST](conectores/rest.md), [SOAP](conectores/soap.md), [Banco](conectores/banco.md), [Arquivo](conectores/arquivo.md), [EDI](conectores/edi.md), [Venddor](conectores/venddor.md), [Interno](conectores/interno.md).
4. **[Receitas](receitas.md)** — preço em centavos, data brasileira, status do ERP, e o que fazer quando o ERP não tem campo de data.

E depois, conforme a necessidade:

- **[Referência das fórmulas](formulas.md)** — as 135 funções, com exemplo de cada uma. É a página mais consultada do manual.
- **[Detecção de mudança](deteccao-de-mudanca.md)** — o problema mais comum de toda integração de ERP, com uma escada de decisão.
- **[Diagnóstico](diagnostico.md)** — quando dá errado, organizado por sintoma.

---

## Uma coisa que economiza tempo

Antes de publicar, use o painel de teste. Ele tem três botões:

- **Buscar amostra** traz até 50 registros reais da origem.
- **Executar sem gravar** roda o pipeline inteiro e mostra o que *seria* gravado, sem tocar no destino.
- **Executar 1 registro de verdade** grava um só, para conferir na ponta.

Quase todo erro que apareceria em produção aparece aqui primeiro, e sem consequência.

---

## Onde as coisas ficam

| Precisa de | Vá em |
|---|---|
| Ver o que rodou hoje | Início do projeto, ou Execuções |
| Resolver "valor desconhecido" | Pendências |
| Trocar uma senha do ERP | Segredos |
| Mudar uma URL que dez integrações usam | Conexões |
| Ver quem acessou o quê | Auditoria |
| Instalar o agente na rede do cliente | Bridges |
| Promover a versão nova para os doze clientes | Frota |