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

# Pedidos do Mercado Livre

> As vendas do canal entram como pedidos, movem o estoque, recebem a nota e vão para a expedição.

Cada venda do Mercado Livre vira um **pedido de venda** no Apex, com itens,
valores e os dados de entrega, ligado à venda original no canal.

## O princípio: o canal manda na venda

Você não aprova uma venda de marketplace: quem aprova é o comprador, pagando
lá. O Apex lê a situação no canal e move o estoque de acordo.

| O canal diz | O Apex faz |
| - | - |
| Venda **paga** | Reserva o estoque do depósito do canal |
| Envio **despachado** ou **entregue** | Baixa o físico |
| Venda **cancelada** | Libera a reserva |
| Qualquer outra situação | Espera |

O Apex não despacha, não cancela e não altera a venda no Mercado Livre. O que
ele envia ao canal é o estoque, o preço e a nota fiscal.

## Ligar o processamento

Em **Configurações → Integrações**, no card do canal, a chave **Processar
vendas do canal**.

> [!WARNING]
>
> **O momento em que você liga vira um corte.** Só vendas criadas no canal
> **a partir dali** reservam e baixam estoque sozinhas.
>
> É deliberado: sem o corte, as vendas das últimas semanas baixariam de novo
> mercadoria que já saiu da prateleira antes de você informar o saldo inicial.

Vendas anteriores ao corte entram para conferência e podem ser operadas à mão,
no próprio pedido. Uma venda que o Apex **já reservou** continua sendo
acompanhada: se o canal cancelar, a reserva é liberada.

Ligar exige que o **depósito do canal** esteja escolhido.

## Como as vendas chegam

Com o processamento ligado, o Apex lê as vendas novas sozinho, em poucos
minutos, e relê as que ainda estão em aberto. É assim que o cancelamento tardio
aparece.

Para trazer vendas de um período, use **Importar pedidos**, no menu de ações de
**Vendas → Pedidos de Venda**: escolha até 31 dias. Fechar o painel pausa a
consulta depois do lote atual. Vendas já importadas são atualizadas, nunca
duplicadas.

## O caminho da venda no Apex

Abrir uma venda do canal mostra o pedido de sempre, só para leitura, com um
bloco do canal. Em **Operação no Apex**, o pedido diz em que ponto está:

| Etapa | O que significa |
| - | - |
| **Importado** | A venda entrou e ainda não mexeu no estoque |
| **Estoque reservado** | Reservado no depósito do canal, esperando o faturamento |
| **Faturado** | NF-e emitida. Falta ir para a expedição |
| **Esperando a NF-e** | Enviado à expedição, esperando a nota ser autorizada |
| **Na expedição** | Embalado, esperando a coleta. A baixa acontece no despacho |
| **Despachado** | O físico foi baixado do depósito do canal |
| **Entregue** | O comprador recebeu |
| **Cancelado** | A reserva foi liberada e o estoque voltou ao disponível |

E quando algo precisa de você:

| Etapa | O que fazer |
| - | - |
| **Produto pendente** | Algum item não está ligado a um produto. Vincule em [Anúncios](https://docs.apexx.work/integracoes/mercado-livre/anuncios.md) |
| **Pendência** | O Apex tentou e foi recusado. O motivo está escrito no pedido |
| **Revisar pedido** | A venda veio com algo a conferir antes de processar |
| **Full** | O estoque e o envio são do Mercado Livre. Nada a fazer no Apex |

Resolva o que falta e clique em **Atualizar** no pedido: o Apex relê a venda no
canal e tenta de novo.

O bloco do canal mostra ainda a **Situação no canal**, os **Anúncios vendidos**
com o produto do Apex ligado a cada um, e os **Valores informados pelo canal**:
total da venda, pago pelo comprador e frete.

## Nota fiscal

A venda do canal é faturada como qualquer pedido (veja
[Notas Fiscais](https://docs.apexx.work/vendas/notas-fiscais.md)). Duas opções de
**Configurações → Pedidos de venda** decidem o ritmo:

* **Emitir a NF-e ao aprovar**: a nota sai sozinha, inclusive da venda que o
  canal aprova. O que não puder sair fica no pedido como pendência.
* **Faturar antes de enviar**: o pedido só vai à expedição depois da NF-e.

Os dados do comprador que a nota pede (nome, CPF ou CNPJ e endereço) vêm do
canal e ficam na aba **Entrega** do pedido.

Quando a NF-e é autorizada, o Apex a **envia ao Mercado Livre sozinho**:

> [card] Coleta e agência
>
> A nota é importada no envio. É ela que libera a etiqueta do Mercado Envios.

> [card] Flex e envio próprio
>
> A nota é anexada à venda, para o comprador.

> [!WARNING]
>
> O Mercado Livre só aceita nota **autorizada em produção**. Nota emitida em
> ambiente de testes é recusada, e a venda fica sem etiqueta.

Se o canal recusar a nota, o pedido mostra o motivo que ele deu: CEP ou
documento do comprador que não confere com a venda, data da nota anterior à da
venda, conta sem permissão para importar NF-e.

## Etiqueta e despacho

A etiqueta do Mercado Envios é impressa na [Expedição](https://docs.apexx.work/vendas/expedicao.md),
depois que a nota chega ao canal. O estoque é baixado quando o canal informa o
despacho.

## Venda cancelada

Antes do envio, a venda cancelada no canal libera a reserva sozinha.

Depois do envio, o Apex abre uma [devolução](https://docs.apexx.work/vendas/devolucoes.md) com os itens
do pedido e a forma de reembolso "Reembolsado pelo Mercado Livre". O estoque
volta quando você receber a mercadoria.

## Venda do Full

A venda de um anúncio Full aparece no Apex para consulta, com a etapa **Full**.
O estoque e o envio são do Mercado Livre: o Apex não reserva, não baixa e não
emite a nota dessa venda.

## Operar à mão

Quando o processamento está desligado, ou a venda é anterior ao corte, os
comandos ficam disponíveis no pedido: **Reservar estoque**, **Despachar** e
**Cancelar**. O cancelamento pede o motivo, e some quando o pedido já tem NF-e.

Se você tentar algo que a situação do canal não permite, a recusa diz o motivo:

> [accordion] A venda ainda não está paga no Mercado Livre
>
> O estoque é reservado quando o canal confirmar o pagamento.

> [accordion] Vincule todos os produtos desta venda aos anúncios antes de reservar o estoque
>
> Uma linha sem vínculo não sabe qual saldo reservar. Resolva em
> [Anúncios](https://docs.apexx.work/integracoes/mercado-livre/anuncios.md) e atualize o pedido.

> [accordion] Defina o depósito do canal em Configurações → Integrações
>
> Sem depósito escolhido não há de onde reservar. Configure e atualize o
> pedido.

> [accordion] A venda foi cancelada no Mercado Livre
>
> Cancele o pedido para liberar o estoque, em vez de seguir com ele.

> [accordion] O envio foi cancelado no Mercado Livre
>
> Confira a venda no canal antes de seguir.

> [accordion] Venda Full: o estoque e o envio são do Mercado Livre
>
> O Apex não reserva nem despacha esta venda.

## O dinheiro da venda

A venda do canal gera uma **conta a receber** contra o marketplace, **Em
aberto**: o comprador já pagou, e o canal segura o dinheiro até liberar. O
vencimento nasce numa previsão de liberação, que você pode ajustar na conta.

> [!WARNING]
>
> A baixa dessa conta é manual: quando o dinheiro cair, dê a baixa em
> [Contas a receber](https://docs.apexx.work/financeiro/contas.md). A **tarifa do Mercado Livre não é
> lançada** no financeiro, e o Apex ainda não mostra quanto o canal reteve.

## O que ainda não acontece

* Vendas do mesmo carrinho entram como pedidos separados, cada um com a
  própria nota.
* A devolução que o comprador abre no canal não entra sozinha: o Apex avisa a
  reclamação no sino, e a devolução é registrada à mão.
* Perguntas e mensagens do comprador não aparecem no Apex.


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