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

# Conectar a conta

> Autorizar o Mercado Livre no Apex, o que a conexão guarda e o que acontece ao desconectar.

> [!NOTE]
>
> Por enquanto a conexão aceita apenas contas de teste do Mercado Livre. A
> liberação para contas reais será avisada em [Novidades](https://docs.apexx.work/novidades.md).

Conectar e desconectar é tarefa de quem administra o workspace. Os outros
membros veem o estado da conta, sem os botões.

**1. Abra o Hub**

No menu lateral, **Integrações**. O card do Mercado Livre fica na grade de
canais.

**2. Clique para conectar**

O Apex leva você ao Mercado Livre, onde **você** entra com a sua conta de
vendedor e autoriza o acesso. Depois de autorizar, você volta ao Apex.

> [!NOTE]
>
> Sua senha do Mercado Livre nunca passa pelo Apex. A autorização acontece
> no site deles, e o Apex recebe apenas uma chave de acesso.

**3. Escolha o depósito do canal**

Antes de importar qualquer coisa, escolha em **Configurações → Integrações**
de qual depósito as vendas do canal saem.

Veja [Configurações do canal](https://docs.apexx.work/integracoes/mercado-livre/configuracoes.md).

**4. Importe os anúncios**

Em **Vendas → Anúncios**. Veja [Anúncios](https://docs.apexx.work/integracoes/mercado-livre/anuncios.md).

## O painel da conta

Clicar no card conectado abre o painel com:

| Informação | O que diz |
| - | - |
| **Conta** | O apelido e o número do vendedor no canal |
| **Acesso concedido** | Quais permissões o Mercado Livre deu ao Apex |
| **Anúncios** | Quando o catálogo foi lido pela última vez |
| **Pedidos** | Quando as vendas foram importadas pela última vez |
| **Leitura automática das vendas** | Como anda a leitura que o Apex faz sozinho, e o que ela deixou de fora |
| **Tabela de preços, depósito e categorias** | O atalho para as configurações do canal |

## Quando a conta pede atenção

O card do Mercado Livre na grade do Hub mostra uma linha de aviso quando algo
precisa de você:

> [accordion] A autorização caiu. Reconecte a conta.
>
> O acesso expirou ou foi revogado no Mercado Livre. Conecte de novo pelo
> Hub. Reconectar a **mesma** conta reaproveita anúncios, vínculos e pedidos.

> [accordion] Uma leitura falhou várias vezes seguidas
>
> A atualização dos anúncios, a leitura das vendas ou um dos envios falhou
> três vezes seguidas. O painel da conta mostra o motivo que o canal deu.

> [accordion] Vendas e estoque pausados desde a desconexão
>
> A conta foi desconectada e conectada de novo. O processamento das vendas e
> o envio do estoque não voltam sozinhos: veja "Desconectar", abaixo.

## Uma conta por workspace

O Apex mantém **uma conta ativa** do Mercado Livre por workspace. Para trocar,
desconecte a atual primeiro.

## Desconectar

Desconectar revoga o acesso no Mercado Livre e tira as credenciais do Apex.

> [card] Fica guardado
>
> Os anúncios importados, os vínculos com seus produtos e os pedidos já
> trazidos. Voltam a responder ao reconectar a mesma conta.

> [card] Para de funcionar
>
> O Apex deixa de ler o canal, de processar as vendas e de enviar o estoque
> aos anúncios.

> [!WARNING]
>
> Desconectado, o Apex não acompanha mais as vendas: uma venda cancelada no
> canal deixa de liberar a reserva sozinha.

Ao reconectar, o processamento das vendas e o envio do estoque ficam
**pausados**. Em **Configurações → Integrações** você escolhe:

* **Religar**: volta como estava. Se o envio do estoque estava ligado, o Apex
  mostra antes quantos anúncios mudam de quantidade e quantos vão a zero.
* **Desligar**: mantém a conta conectada, só para leitura.

Se o Mercado Livre não confirmar a revogação, o Apex avisa. Nesse caso, remova
o Apex dos aplicativos autorizados nas configurações de segurança da sua conta
do Mercado Livre.


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