> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apexx.work/llms.txt
> Use this file to discover all available pages before exploring further.

# Contatos

> Clientes, fornecedores e transportadoras num cadastro só.

Em **Cadastros → Contatos**. Cliente, fornecedor e transportadora ficam na
mesma lista: o que a pessoa ou a empresa é para você está no **Tipo de
contato**, e um contato pode ter mais de um. O fornecedor que também compra de
você é um cadastro só, com os dois tipos marcados.

## Os tipos

> [card] Cliente
>
> Aparece para escolher no pedido de venda, que herda dele o endereço de
> entrega e a condição de pagamento.

> [card] Fornecedor
>
> Aparece no [pedido de compra](https://docs.apexx.work/compras/pedidos-de-compra.md), na nota de
> entrada, na conta a pagar e no cadastro do produto.

> [card] Transportadora
>
> Aparece no pedido de venda e na [Expedição](https://docs.apexx.work/vendas/expedicao.md).

Na lista, a coluna **Tipo** mostra um ícone por tipo, e o filtro **Tipo**
separa clientes, fornecedores e transportadoras. Os outros filtros são
**Pessoa** (física ou jurídica), **Estado** e **Cidade**.

## Cadastrar

**Novo contato** abre o formulário. Os dois primeiros campos decidem o resto:
**Tipo de contato** (um ou mais) e **Tipo de Cadastro** (Pessoa Física ou
Pessoa Jurídica). Trocar um deles muda os campos que aparecem.

> [accordion] Geral
>
> **Identificação**: nome, CPF e RG na pessoa física; CNPJ, razão social,
> nome fantasia e inscrições na jurídica. Digitar o CNPJ preenche razão
> social, telefone e endereço com os dados públicos da empresa.
>
> **Contato**: responsável (na pessoa jurídica), e-mail, telefone, WhatsApp
> e site. **Endereço**: o CEP preenche rua, bairro, cidade e UF.
>
> **Notas**: observações internas, no fim da seção.

> [accordion] Outros contatos e outros endereços
>
> O comprador, o financeiro, o endereço de cobrança. Aparecem em **Geral**
> depois que o contato é salvo.

> [accordion] Dados complementares
>
> Dados pessoais e filiação, na pessoa física. Regime tributário e inscrição
> Suframa, na jurídica.
>
> Para quem é cliente: a **Condição de pagamento** de costume e o **Limite
> de crédito**. Com o limite zerado, não há limite. Com valor, a aprovação do
> pedido de venda avisa quando o cliente passa dele. Avisa, não impede.

> [accordion] Comercial
>
> Para quem é fornecedor: **Meio de pagamento** e **Condição de pagamento**
> das compras, que o pedido de compra já traz preenchidos, e o **Prazo de
> entrega (dias)**.
>
> Para quem é transportadora: **Rastreio**, o endereço da página de rastreio
> com `{codigo}` no lugar do código. É dele que sai o link de rastreio do
> envio.

> [accordion] Arquivos
>
> Contrato, cartão do CNPJ, o que você quiser guardar junto do cadastro.

> [!NOTE]
>
> O contato não tem status. Ele nasce ativo e sai pela lixeira.

## Um CPF ou CNPJ, um contato

O documento é único. Ao tentar um segundo cadastro com o mesmo CPF ou CNPJ, o
Apex recusa e diz onde ele está:

* **Já é um contato**: abra o cadastro dele e marque o tipo que falta. É assim
  que um cliente vira também fornecedor.
* **Está na lixeira**: restaure o contato, ou exclua de vez para usar o
  documento de novo.

## Importar e exportar

Os dois ficam em **Ações**.

**1. Importar contatos**

Solte uma planilha (.xlsx ou .csv) ou XMLs de NF-e, até 500 linhas por
arquivo. **Baixar a planilha modelo** mostra as colunas. A exportação de
contatos do Bling e do Tiny entra como saiu de lá.

**2. Confira o resumo**

O diálogo mostra o arquivo lido e quantas linhas têm problema. Elas ficam
de fora, e **Baixar com os motivos** entrega uma planilha para corrigir e
mandar de novo. Não há conferência linha a linha.

**3. Importe**

Documento já cadastrado é ignorado. No fim, o diálogo diz quantos entraram
e quantos já existiam.

A coluna **Tipo de contato** diz o que cada linha é: `Cliente`, `Fornecedor`,
`Transportadora`, ou mais de um (`Cliente e Fornecedor`). Sem ela, todos entram
como cliente. Pessoa física ou jurídica sai do próprio documento: onze dígitos
é CPF, catorze é CNPJ.

De um XML de NF-e, o destinatário entra como cliente e o emitente como
fornecedor. A sua própria empresa fica de fora.

**Exportar contatos** gera Excel ou CSV com as colunas da lista: todos, só os
da busca e dos filtros de agora, ou só os selecionados. Contato na lixeira
nunca sai na exportação.

## De onde mais vêm os contatos

* **Nota de entrada**: quando o fornecedor da nota não está no cadastro,
  **Cadastrar fornecedor**, no menu da nota, cria o contato com os dados do
  XML. Veja [Notas de entrada](https://docs.apexx.work/compras/notas-de-entrada.md).
* **Marketplace**: a venda do Mercado Livre **não** cria contato. Os dados do
  comprador ficam no próprio pedido. Veja
  [Pedidos do Mercado Livre](https://docs.apexx.work/integracoes/mercado-livre/pedidos.md).

Nas listas de pedidos de venda e de notas fiscais, clicar no nome do cliente
abre o cadastro dele ao lado, sem sair da página.

## Excluir

**Excluir** manda o contato para a lixeira, de onde ele pode ser restaurado.
**Ver excluídos**, em Ações, abre a lixeira. Contato não se duplica: a cópia
nasceria com o mesmo CPF ou CNPJ.

Excluir de vez é recusado para o contato que aparece em pedido ou conta: um
pedido de dois anos atrás precisa continuar dizendo para quem foi.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.