> For the complete documentation index, see [llms.txt](https://chavedez.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://chavedez.gitbook.io/docs/gestao/fornecedores-or-chave-dez.md).

# Fornecedores | Chave Dez

Centralize seus parceiros de compra, mantenha contatos atualizados e ganhe agilidade na reposição de peças e insumos.

O módulo de **Fornecedores** reúne, em uma única área, tudo que você precisa para **cadastrar, localizar, revisar e remover** fornecedores. Você pode incluir registros **manualmente** ou **a partir do XML de uma nota fiscal de compra (NF-e)**, evitando digitação redundante e erros.

***

### 🛠️ O que é (e por que usar)

O cadastro de fornecedores é a base para um fluxo de compras **rápido e confiável**. Com ele você:

* Mantém **contatos oficiais** à mão (e-mail/telefone) para cotações e cobranças.
* Evita **duplicidades** (usando CNPJ/CPF como referência).
* Acelera a **entrada de novos fornecedores** via **importação de XML**.
* Deixa a equipe alinhada sobre **quem comprar**, **como negociar** e **onde cobrar**.

***

### 🗂️ Principais recursos da tela

* **Listagem filtrável e ordenável**: pesquise pelo campo **“Filtrar fornecedores…”** (por **Nome**) e ordene por **Nome, E-mail, Telefone, CPF/CNPJ**.
* **Paginação**: ajuste o número de linhas por página e navegue em **Anterior/Próximo**.
* **Adicionar fornecedor**: botão no topo direito (também aparece no estado vazio).
* **Edição**: clique sobre a **linha** desejada para abrir o modal e atualizar dados.
* **Exclusão**: **ícone de lixeira vermelho** ao final da linha para remover o cadastro.
* **Importação via XML de compra**: cria/atualiza fornecedores a partir dos dados do **emitente** na NF-e.

***

### 🚀 Fluxos essenciais

#### 1) Adicionar manualmente

1. Clique em **Adicionar fornecedor**.
2. Preencha **Nome** (obrigatório) e, se possível, **CNPJ/CPF**, **E-mail** e **Telefone**.
3. **Salvar fornecedor**.

**Padrão recomendado de nome**: defina se sua oficina usará **Razão Social** *ou* **Nome Fantasia** — e mantenha sempre o mesmo critério.

***

#### 2) Adicionar via XML de compra

1. Acesse **Importar XML de compra** e envie o **XML da NF-e**.
2. Confirme os dados detectados; o fornecedor será **criado/atualizado**.
3. Volte à listagem e **padronize** o nome se preciso (razão x fantasia) para evitar duplicidade.

> Dica: após importações, pesquise pelo **CNPJ** para checar se não ficou mais de um cadastro para o mesmo fornecedor.

***

#### 3) Editar fornecedor

* Clique na **linha** do fornecedor para abrir o modal **Editar fornecedor**.
* Campos: **Nome**, **CNPJ/CPF**, **E-mail**, **Telefone** (os mesmos da adição).
* Conclua em **Salvar fornecedor**.

***

#### 4) Excluir fornecedor

* Na listagem, clique no **ícone de lixeira vermelho** ao fim da linha e **confirme**.
* Use com critério: prefira **editar/padronizar** quando houver histórico útil.

***

### ✅ Boas práticas (dados limpos = compras rápidas)

1. **Padronize o Nome** (sempre Razão **ou** sempre Fantasia).
2. **Preencha CNPJ/CPF** sempre que possível — é a chave contra duplicidades.
3. **Valide contatos** (e-mail do financeiro/atendimento e telefone/WhatsApp).
4. **Revise após importar XML**: unifique variações e corrija abreviações.
5. **Busque antes de criar**: evite um segundo cadastro para o mesmo CNPJ.

***

### ❓Perguntas frequentes

**CNPJ/CPF é obrigatório?**\
Não — mas **altamente recomendado** para garantir unicidade e facilitar buscas.

**Importei um XML e surgiram dois cadastros parecidos. O que fazer?**\
Escolha um padrão de nome, **mantenha o CNPJ correto**, ajuste o principal e remova o duplicado, se for o caso.

**Posso editar tudo depois?**\
Sim. Abra o fornecedor pela listagem e ajuste **Nome, CNPJ/CPF, E-mail e Telefone**.

**A exclusão é reversível?**\
Trate como **definitiva**. Se excluir por engano, recadastre o fornecedor.

***

### 🧠 Diferenciais do Chave Dez para fornecedores

* **Entrada acelerada** via **XML de compra** (menos digitação, menos erro).
* **Listagem clara e ágil**, com filtro, ordenação e paginação.
* **Ações diretas** na própria grade (editar/excluir) e **estado vazio guiado**.

***

### 🧑‍💻 Suporte

Precisa de ajuda para padronizar nomes, revisar duplicidades ou organizar a importação de XML?\
**E-mail:** [suporte@chavedez.com.br](mailto:contato@chavedez.com.br)\
**WhatsApp:** [(31) 98234-2383](https://api.whatsapp.com/send?phone=553182342383)

**Fornecedores organizados = compras mais rápidas, menos retrabalho e melhor previsibilidade de estoque.**
