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

# Canais e integrações

> Como o Apex conversa com os marketplaces: o que ele lê, o que ele envia e o que ainda fica com você.

O Hub de integrações, no menu **Integrações**, é onde os canais de venda são
conectados. Hoje o conector disponível é o **Mercado Livre**.

> [card] [Conectar o Mercado Livre](https://docs.apexx.work/integracoes/mercado-livre/conectar.md)
>
> Autorizar a conta, importar anúncios e deixar as vendas moverem o estoque.

## O princípio: o canal manda na venda, o Apex manda no estoque

Quem decide que uma venda foi paga, despachada ou cancelada é o marketplace. O
Apex lê essa informação e move o **estoque** de acordo.

```
Canal diz "paga"       →  Apex reserva o estoque
Canal diz "despachada" →  Apex baixa o físico
Canal diz "cancelada"  →  Apex libera a reserva
```

No sentido contrário, o que é seu sai do Apex para o canal: o saldo do depósito,
o preço da lista e a nota fiscal da venda. O envio de estoque e o de preço são
ligados por você, com uma prévia do que muda. Nenhum dos dois começa sozinho.

## O que o Apex lê do canal

> [card] Anúncios
>
> Título, preço, quantidade, variações, fotos e situação de cada anúncio.

> [card] Vendas
>
> Cada venda vira um pedido de venda, que reserva e baixa o estoque.

> [card] Envio
>
> A logística da venda, a situação da entrega e o prazo para despachar.

> [card] Dados para a nota
>
> Nome, documento e endereço do comprador, guardados na aba Entrega do pedido
> para a emissão da NF-e.

O Apex também avisa no sino quando o comprador abre uma reclamação no canal.

## O que o Apex envia ao canal

| O que vai | Como | Quem liga |
| - | - | - |
| **Estoque** | O saldo disponível do depósito do canal vira a quantidade dos anúncios vinculados, a cada dois minutos | Você, em **Configurações → Integrações** |
| **Preço** | O preço da lista escolhida vai aos anúncios vinculados quando você manda enviar | Você, a cada envio |
| **Nota fiscal** | A NF-e autorizada da venda vai ao Mercado Livre sozinha | Não precisa ligar |

Os detalhes de cada um estão em
[Configurações do canal](https://docs.apexx.work/integracoes/mercado-livre/configuracoes.md) e em
[Pedidos do Mercado Livre](https://docs.apexx.work/integracoes/mercado-livre/pedidos.md).

## O que o Apex ainda não faz

> [!WARNING]
>
> Estas tarefas continuam no painel do Mercado Livre. Vale saber antes de
> contar com elas.

* **Criar, editar ou pausar anúncios.** O Apex lê os anúncios e muda neles só a
  quantidade e o preço.
* **Responder perguntas e mensagens** dos compradores.
* **Trazer a devolução aberta pelo comprador.** A reclamação chega como aviso,
  e a devolução é registrada à mão em [Devoluções](https://docs.apexx.work/vendas/devolucoes.md). A
  exceção é a venda cancelada depois do envio, que abre a devolução sozinha.
* **Lançar a tarifa do canal no financeiro.** A venda gera a conta a receber;
  a tarifa e o repasse ainda são conferidos fora do Apex.
* **Controlar o estoque do Full.** Esse saldo está com o Mercado Livre e não é
  lido nem enviado pelo Apex.
* **Conectar mais de uma conta** do Mercado Livre no mesmo workspace.

Dados de cartão do comprador nunca chegam ao Apex.

## Outros canais

Shopee, Amazon, Magalu e os demais aparecem no Hub como catálogo e ainda não
têm conector.


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