> For the complete documentation index, see [llms.txt](https://docs.sprinthub.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sprinthub.com/topicos/integracoes/mercado-livre.md).

# Mercado Livre

> **Recurso em Beta.** A integração conecta sua conta do Mercado Livre à SprintHub por filial: os pedidos chegam automaticamente, viram contato e geram fatura no financeiro, os anúncios ficam à vista, e as perguntas e conversas privadas dos anúncios caem no atendimento (SAC360). O menu **Mercado Livre**, **Anúncios** e **Pedidos** só aparece depois que a integração está no seu plano e a conta está conectada.

{% embed url="<https://youtu.be/dr_7fdDiFKU?si=CQBvqzOhs06vHEt8>" %}

Antes de começar, você vai precisar de:

* Uma conta de vendedor no Mercado Livre.
* Um aplicativo criado no **DevCenter do Mercado Livre** ([developers.mercadolivre.com.br/devcenter](http://developers.mercadolivre.com.br/devcenter)) — é ele que autoriza a SprintHub a acessar sua conta.
* Permissão de administrador na SprintHub para configurar integrações e filiais.

A configuração acontece em quatro etapas, nesta ordem: **(1)** criar o aplicativo no Mercado Livre, **(2)** cadastrar o app na SprintHub, **(3)** conectar a conta em cada filial e **(4)** ligar as notificações de pedidos.

***

### 1. Crie o aplicativo no Mercado Livre (DevCenter)

Antes de conectar, você precisa de um **aplicativo** criado no Mercado Livre — é ele que autoriza a SprintHub a acessar sua conta. Faça uma vez, pela conta da sua empresa.

> **Use a conta certa.** O Mercado Livre recomenda criar a aplicação pela conta **titular** da solução, registrada como **pessoa jurídica** — mudar de conta depois é trabalhoso. No Brasil, cada conta só pode ter **uma aplicação**, e só depois que os dados do titular forem validados. Se a opção de criar não aparecer, confira se os dados da conta estão completos.

**1.** Acesse o **DevCenter**: [developers.mercadolivre.com.br/devcenter](http://developers.mercadolivre.com.br/devcenter) e entre com a conta da empresa. Você cai em **Minhas aplicações**.

<figure><img src="https://3534414179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9FzUKkagBNy5uQ7AtGNa%2Fuploads%2FlgbTZU4UPN3MQeAxZt2R%2Fimage.png?alt=media&amp;token=2d6df6ac-8170-4939-bfb0-b671064c8e91" alt=""><figcaption></figcaption></figure>

**2.** Clique em **Criar nova aplicação**.

**3.** Na primeira etapa, **Qual solução planeja desenvolver?**, preencha os dados básicos e clique em **Continuar**:

* **Nome** — precisa ser único no Mercado Livre.
* **Nome curto** — é o que o Mercado Livre usa para montar a URL da aplicação.
* **Descrição** — até **150 caracteres**. É esse texto que o vendedor lê na tela de autorização.
* **Propósito da solução** — marque **Negócios**.
* **Quantos usuários terá sua solução** — escolha a faixa mais próxima. Não muda nada na integração.
* **Logotipo** — **obrigatório**, arquivo **.png de até 1 MB**. Sem imagem o botão Continuar não avança. Aparece na tela de autorização.

<figure><img src="https://3534414179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9FzUKkagBNy5uQ7AtGNa%2Fuploads%2FobJYfXOYJgfRSCJZDOXA%2Fimage.png?alt=media&amp;token=7b94aa32-f04c-4a8c-927d-aa407b3ad650" alt=""><figcaption></figcaption></figure>

Na segunda etapa, **Configuração e scopes**, vem a parte que mais gera erro. Preste atenção nos três itens que o Mercado Livre deixa **desmarcados por padrão**.

<figure><img src="https://3534414179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9FzUKkagBNy5uQ7AtGNa%2Fuploads%2FXsjmSeJbE5ch8hQ6ZDaE%2Fimage.png?alt=media&amp;token=931ac5e1-a3c4-4492-bafa-f77453eceeb8" alt=""><figcaption></figcaption></figure>

**4.** Em **URIs de redirect**, cole o **Redirect URI** que o sistema mostra no card Mercado Livre (Configurações → Integrações) — tem que ser **idêntico** — e clique em **Adicionar URI de redirect**. O Mercado Livre exige **HTTPS**; endereço `http://` é recusado.

**5.** Em **Fluxos OAuth**, deixe **Authorization Code** e **Client Credentials** marcados (já vêm assim) e **marque também o Refresh Token**, que vem desmarcado. Sem ele o acesso expira e você precisa reconectar a conta toda hora.

**6.** Em **PKCE necessário**, **deixe o pkce desmarcado**. A integração não usa PKCE: com ele marcado, a conexão volta com erro mesmo com App ID e Secret certos.

**7.** Em **Negócios**, **marque Mercado Livre** — também vem desmarcado. É o que habilita os recursos de venda. **VIS** não é usado por esta integração.

**8.** Em **Permissões**, cada linha tem um seletor à direita que começa em **Sem acesso**. Troque para **Leitura e escrita** nas cinco abaixo. Só leitura não serve: sem escrita o sistema não responde perguntas nem envia mensagem ao comprador.

| Permissão funcional           | Para que a integração precisa                           |
| ----------------------------- | ------------------------------------------------------- |
| Usuários                      | Identificar a conta conectada (já vem ativa por padrão) |
| Comunicações pré e pós-vendas | Perguntas dos anúncios e conversas privadas no SAC360   |
| Venda e envios de um produto  | Pedidos, status de envio e rastreio                     |
| Publicação e sincronização    | Anúncios, fotos e preços                                |
| Faturamento de uma venda      | Dados de faturamento do pedido (tarifa, valor líquido)  |

**9.** Em **Tópicos**, abra os grupos e marque `orders_v2` (grupo Orders), `messages` (Messages), `questions` e `items` (Items) e `shipments` (Shipments).

**10.** Em **Configuração de notificações**, cole a Callback URL que o sistema fornece no campo **URL de retornos de chamada de notificação** — ela aparece na aba **Conta** da filial (passo 4). **Copie pelo botão da tela, não digite:** o final da URL (`?i=...`) identifica a sua licença, e uma letra diferente faz as notificações irem para outro lugar. Não use aqui o **Redirect URI** do passo 4 (o endereço que termina em `/mercadolivreredirect`): são dois campos diferentes, e com o Redirect URI no lugar da Callback URL a conta conecta, mas pedidos, perguntas e mensagens não chegam.

**11.** Marque **Aceito os Termos e Condições** e clique em **Criar**. O Mercado Livre gera o **App ID (Client ID)** e a **Secret Key** — guarde os dois: é o que você informa no sistema no próximo passo.

> **Guarde a Secret Key em lugar seguro** e não a compartilhe. O DevCenter permite **renovar** a chave depois ("Renove agora" ou "Programar renovação"); quando isso acontece a chave antiga expira, e a integração para até você cadastrar a nova no sistema.

***

### 2. Configure o app na SprintHub

Acesse **Configurações → Integrações** e abra o card **Mercado Livre**.

Nesta tela você informa os dados do app que criou no DevCenter do Mercado Livre:

* **App ID (Client ID)** — o identificador do seu app.
* **Secret Key** — a chave secreta do app. Se já houver uma salva, deixe o campo em branco para manter a atual.
* **Redirect URI** — já vem preenchido e é somente leitura. Use o botão de copiar e **cadastre esse endereço exatamente igual no seu app do Mercado Livre**, em "URIs de redirecionamento".

Clique em **Adicionar** (ou **Salvar**) para guardar.

Ainda no card, ative os **tópicos de notificação** no DevCenter do Mercado Livre. Em "Configuração de notificações", marque todos estes tópicos usando a mesma Callback URL:

`orders_v2 · shipments · items · messages · questions`

> **Lembrando:** `messages` traz as conversas privadas para o SAC e `questions` traz as perguntas dos anúncios para o SAC. Sem esses dois tópicos marcados, o atendimento do Mercado Livre não chega na SprintHub.

Esse app configurado aqui é o **mesmo Mercado Livre para todas as filiais**. Use isto quando suas filiais são da mesma empresa e vendem na mesma conta. Se uma filial precisar de uma conta/empresa diferente, veja o passo do "app avançado da filial" mais abaixo.

<figure><img src="https://3534414179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9FzUKkagBNy5uQ7AtGNa%2Fuploads%2FtLX9Cfy9nK4tO7GBWdGp%2Fimage.png?alt=media&amp;token=212172aa-ce86-4403-bc44-2368fe7588ff" alt=""><figcaption></figcaption></figure>

***

### 3. Conecte a conta em cada filial

Vá em **Configurações → Filiais**, abra a filial desejada e clique em **Integrações**. Localize o card **Mercado Livre** e clique em **Conectar**.

Um aviso avisa que **será conectada a conta do Mercado Livre que está logada neste navegador** — confira se é a conta da empresa antes de continuar. Se estiver logado em outra conta, use o link "Estou em outra conta — sair do Mercado Livre pra trocar" (dica: uma janela anônima ajuda a trocar de conta).

Clique em **Continuar**. Você é levado para o Mercado Livre, autoriza o acesso e volta para a SprintHub. Ao voltar, aparece a confirmação "Integração conectada com sucesso" e o card passa a mostrar o selo **Ativa** e a **conta conectada**.

<figure><img src="https://3534414179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9FzUKkagBNy5uQ7AtGNa%2Fuploads%2FBVXhDCN7ghlLMT6tziVd%2Fimage.png?alt=media&amp;token=beb927be-cc6a-406c-93cc-1a52389fffde" alt=""><figcaption></figcaption></figure>

> **Observação:** cada conta do Mercado Livre só pode estar conectada em **uma filial**. Se a conta já estiver em uso em outra filial, a SprintHub avisa "Esta conta do Mercado Livre já está conectada em outra filial" — desconecte lá primeiro ou use outra conta.

> **Lembrando:** se você precisar configurar o app da empresa (passo 2) antes de conectar, a própria tela oferece o botão **Configurar app da empresa** e leva direto para Configurações → Integrações.

***

### 4. Ative as notificações (aba Conta)

Depois de conectar, a filial passa a ter um item **Mercado Livre (Beta)** no menu lateral, com as abas **Anúncios**, **Pedidos** e **Conta**. Abra a aba **Conta**.

Para os pedidos, as perguntas dos anúncios e as conversas privadas chegarem sozinhos, o Mercado Livre precisa notificar a SprintHub. No bloco **Webhook de notificações**:

**1.** Copie a **URL de notificação (Callback URL)** pelo botão de copiar ao lado dela. Não digite a URL à mão.

**2.** Confira os **Tópicos a marcar**: `orders_v2`, `shipments`, `items`, `messages` e `questions`. Sem `messages` e `questions`, as conversas privadas e as perguntas dos anúncios não chegam no SAC360.

**3.** No **DevCenter do Mercado Livre → Minhas aplicações**, abra o app desta filial. A edição abre na etapa **Informações básicas**: clique em **Continuar** para chegar à etapa **Configuração e scopes**. É lá que ficam os tópicos e a URL de notificação — eles **não aparecem rolando a página**.

**4.** Em "Tópicos", marque os tópicos copiados; em "Configuração de notificações", cole a URL no campo "URL de retornos de chamada de notificação".

**5.** No fim da página, marque o aceite dos Termos, confirme o reCAPTCHA e clique em **Editar** — é esse o botão que salva. De volta à SprintHub, clique em **Reverificar**.

Quando tudo estiver certo, o status fica **Ativo**. Enquanto não estiver, aparece como **Pendente**. Se a URL cadastrada no app do Mercado Livre não for a desta licença, o status aparece como **URL incorreta** e a tela mostra qual URL está cadastrada hoje — troque pela URL da tela e salve de novo. A tela ainda mostra um resumo das **últimas 24h** (notificações recebidas, processadas e erros).

<figure><img src="https://3534414179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9FzUKkagBNy5uQ7AtGNa%2Fuploads%2FnB4qGdRxeilnzXWI2mws%2Fimage.png?alt=media&amp;token=329d1482-ac99-4269-9f57-6084eaa8393d" alt=""><figcaption></figcaption></figure>

> **Observação:** se a conexão parar de funcionar, a aba Conta avisa "A conexão parou de funcionar" — basta reconectar a conta pela aba Integrações.

#### App do Mercado Livre por filial (avançado)

Ainda na aba **Conta**, o bloco **App do Mercado Livre (avançado)** serve para quando **esta filial é uma empresa/conta diferente** e precisa de um Mercado Livre próprio. Preencha **App ID**, **Secret Key** e **Redirect URI** do app dessa filial e clique em **Salvar** — depois **reconecte** para aplicar. Deixe tudo em branco (ou clique em **Voltar ao app padrão**) para a filial usar o app da empresa configurado no passo 2.

<figure><img src="https://3534414179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9FzUKkagBNy5uQ7AtGNa%2Fuploads%2FEtvPJjVYgoV6dtOGTTIR%2Fimage.png?alt=media&amp;token=ff25753c-7af5-45b7-8d63-da5e9c46e055" alt=""><figcaption></figcaption></figure>

***

### Como usar

#### 1. Anúncios

Abra **Anúncios** no menu de Vendas (ou a aba **Anúncios** dentro da filial). A lista mostra, por anúncio: foto, título, **Preço**, **Situação** (Ativo, Pausado, Encerrado, Em revisão, Inativo), **Estoque**, **Vendidos**, **Pedidos** e **Receita**, com um link para abrir o anúncio no Mercado Livre.

Para trazer seus anúncios como produtos no sistema, clique em **Importar como produtos**, escolha a filial e, na janela **Importar produtos**, marque os anúncios desejados. Anúncios que já existem aparecem com o selo de já cadastrados (não podem ser marcados de novo); os novos aparecem como **Novo**. Clique em **Importar para o sistema**.

<figure><img src="https://3534414179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9FzUKkagBNy5uQ7AtGNa%2Fuploads%2FSB49DBA3Qr1KAXuW6Tks%2Fimage.png?alt=media&amp;token=a8a7fe49-d383-487f-b3b5-fe59e5ef91bb" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3534414179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9FzUKkagBNy5uQ7AtGNa%2Fuploads%2Fr60dd2HFu7ZEhGqYh0uy%2Fimage.png?alt=media&amp;token=5db2308a-4fbb-4eb0-b460-faea8eb8b6c2" alt=""><figcaption></figcaption></figure>

> **Observação:** se algum anúncio não puder ser importado, o motivo aparece em destaque, em vermelho, na própria linha da lista.

#### 2. Pedidos

Abra **Pedidos** no menu de Vendas (ou a aba **Pedidos** dentro da filial). Cada pedido recebido do Mercado Livre aparece na tabela com: número do pedido (link para o Mercado Livre), **Comprador**, **Status** (Pago, Confirmado, Enviado, Entregue, Cancelado, Reembolsado, Aguardando pgto, Processando), **Total**, **Tarifa ML**, **Frete**, **Líquido**, **Envio** (status + rastreio), **Data** e **Fatura**.

* Clique em uma linha para abrir os **detalhes** do pedido, com os blocos **Itens**, **Financeiro** (total, tarifa do Mercado Livre, frete, valor líquido e forma de pagamento), **Comprador** (nome, CPF/CNPJ, endereço) e **Envio** (status e rastreio). Quando o comprador virou lead, o nome é um link que abre o lead.
* Use **Buscar pedidos** (e escolha a filial) para puxar pedidos recentes do Mercado Livre na hora, sem esperar a notificação.
* Na coluna **Fatura**, clique em **Gerar fatura** para registrar a venda no financeiro. Se o pedido já tiver fatura, o botão vira o link da fatura existente.

<figure><img src="https://3534414179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9FzUKkagBNy5uQ7AtGNa%2Fuploads%2FHJzS8y2h0hscwiafaZ5p%2Fimage.png?alt=media&amp;token=37b2eeb3-bd02-4810-94e6-b7b08406f18e" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3534414179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9FzUKkagBNy5uQ7AtGNa%2Fuploads%2FvPItOyFkxOfHJFm71saR%2Fimage.png?alt=media&amp;token=72323cdd-506c-4380-a3f5-b0347817ff04" alt=""><figcaption></figcaption></figure>

> **Observação:** o comprador já pagou dentro do Mercado Livre — a fatura gerada aqui serve para relatórios e conciliação de faturamento, **não** cobra o cliente de novo. Pedidos cancelados não permitem gerar fatura.

> **Lembrando:** se ainda não chegou nenhum pedido e as notificações não estão ativas, a tela avisa e oferece o atalho **Configurar webhook na aba Conta**.

#### 3. Foto do produto vinda do Mercado Livre

Ao editar um produto no SprintHub, no campo de foto clique em **Importar foto**. Na janela, escolha a **origem** (marketplace + filial), navegue pelos **anúncios** e selecione a imagem desejada. Dá para filtrar entre as fotos **deste produto** e **todas** e buscar pelo anúncio. Clique em **Usar esta foto**.

<figure><img src="https://3534414179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9FzUKkagBNy5uQ7AtGNa%2Fuploads%2FjcqzgwrTDpNzZWvHhjaz%2Fimage.png?alt=media&amp;token=d7356cdf-42dd-41cb-b15d-537cfb3bd90f" alt=""><figcaption></figcaption></figure>

#### 4. Perguntas do Mercado Livre no atendimento (SAC360)

As perguntas feitas nos seus anúncios chegam no **SAC360** como atendimentos. Ao abrir a conversa, a lateral mostra um **card do anúncio** (foto, galeria, preço, quantidade disponível e botão **Ver no Mercado Livre**), para você responder já sabendo de qual produto o cliente está falando.

<figure><img src="https://3534414179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9FzUKkagBNy5uQ7AtGNa%2Fuploads%2FeNdGljod9DtHpZIFxs9P%2Fimage.png?alt=media&amp;token=6ac88a1d-8a55-4dd2-9b3b-50a3a82a96f1" alt=""><figcaption></figcaption></figure>

> **A conta precisa estar no funil do SAC360.** Depois de conectar a conta do Mercado Livre, inclua ela nas **contas do funil** de atendimento (Configurações do SAC360 → funil → Contas). Enquanto ela não estiver lá, as perguntas **entram no sistema mas não aparecem na fila** — e você não vê que elas chegaram. Funil sem nenhuma conta configurada mostra tudo; com contas configuradas, mostra só as listadas.

> **Lembrando:** para as perguntas e mensagens chegarem, os tópicos `questions` e `messages` precisam estar marcados no app do Mercado Livre (passo 1).

***

#### 5. Conversa privada (mensagens do pedido) no atendimento

As mensagens que o comprador manda **dentro de um pedido** (pós-venda) chegam no **SAC360** como atendimentos do canal **Mercado Livre – Conversa Privada**. Você responde por texto e pode **anexar imagem ou arquivo**; as mensagens que você envia aparecem no balão **amarelo** da marca, e as imagens/arquivos recebidos abrem direto na conversa.

> **Diferença para as perguntas:** nas **perguntas de anúncio** o Mercado Livre permite **apenas uma resposta** — por isso a SprintHub avisa e trava o reenvio. Na conversa privada você troca mensagens à vontade.

#### 6. Ajustes do Mercado Livre por conta (atendimento)

Em **Configurações → Contas**, aba **Mercado Livre**, você define o comportamento do atendimento **por conta conectada**:

* **Ignorar todas as perguntas** — quando ligado, as perguntas dos anúncios não entram no SAC360.
* **Ignorar conversas privadas** — quando ligado, as mensagens de pós-venda não abrem atendimento no SAC360.
* **Ativar automações na conversa privada** — permite que as automações de SAC rodem nas conversas privadas. Não vale para perguntas.
* **Criar contato automaticamente ao receber pergunta** — gera e vincula um contato com o autor da pergunta.
* **Inserir nome do atendente no início da resposta** — a resposta enviada ao comprador começa com o nome de quem respondeu.
* **Tipo de listagem de mensagens** — conversa contínua (histórico completo) ou ticket.
* **Importar conversas antigas** — e o **Período** (7, 30, 90 dias ou Todas).

As alterações só valem depois de clicar em **Salvar alterações**. Fechar a janela descarta o que você mexeu.

<figure><img src="https://3534414179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9FzUKkagBNy5uQ7AtGNa%2Fuploads%2FbnjEOCvT6VdFml4WW6it%2Fimage.png?alt=media&amp;token=271d3d01-2bfa-494b-9dc5-61eaa132a73e" alt=""><figcaption></figcaption></figure>

> **Atenção com "Importar conversas antigas".** Ele não sai buscando o histórico sozinho: ele **libera a entrada** das perguntas e conversas mais antigas quando elas forem carregadas. Cada pergunta e cada conversa antiga que entrar **abre um atendimento novo, e atendimento novo é cobrado** — quanto maior o período, maior o volume e maior o valor. Por isso o sistema pede que você digite **ENTENDIDO** antes de ligar. Desligado, entram só as conversas novas.

#### 7. Dashboard do Mercado Livre

Em **Dashboard**, na lista de dashboards, existe uma dashboard pronta chamada **Mercado Livre** — "Vendas, pedidos, entregas e anúncios do Mercado Livre". Clique em **Abrir**.

Ela vem com os tópicos **Visão geral** (Anúncios ativos, Pedidos, Receita ML, Ticket médio, Unidades vendidas) e **Vendas** (Pedidos por status, Receita por filial, Produtos mais vendidos), e um filtro de período que vale para todos os widgets. Clique em um widget para o **detalhamento** — a lista de pedidos por trás do número.

<figure><img src="https://3534414179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9FzUKkagBNy5uQ7AtGNa%2Fuploads%2FnZWX6xIghAyDjKQczJ2j%2Fimage.png?alt=media&amp;token=fafc7868-dc99-4f41-ac08-7d3b651b10dc" alt=""><figcaption></figcaption></figure>

***

### O que a integração consome

A integração registra consumo em três situações, e você acompanha tudo no relatório de consumo da sua licença:

| Consumo                         | Quando é registrado                                                                                                         |
| ------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| Pedido pago                     | Uma vez por pedido, quando ele fica **pago**. Se o pedido chega pendente e só depois é pago, conta no momento do pagamento. |
| Atendimento de pergunta         | Uma vez por **atendimento novo** aberto por uma pergunta de anúncio.                                                        |
| Atendimento de conversa privada | Uma vez por **atendimento novo** aberto por mensagem do comprador no pós-venda.                                             |

O que **não** conta:

* Pedido cancelado ou que nunca foi pago.
* O mesmo pedido notificado várias vezes pelo Mercado Livre — conta uma vez só.
* Perguntas e mensagens que caem em um atendimento **já aberto**. Quatro perguntas no mesmo atendimento contam como um.
* Importar pedidos antigos pelo botão **Buscar pedidos**.
* Conversa em que só você escreveu, sem mensagem do comprador.

> **Lembrando:** ligar **Importar conversas antigas** faz cada pergunta e conversa antiga virar atendimento novo — e cada atendimento novo conta. É a única situação em que histórico gera consumo.

***

### Limites conhecidos e erros comuns

* **A integração está em Beta** — comportamentos e telas podem mudar.
* **Uma conta por filial:** a mesma conta do Mercado Livre não pode ser conectada em duas filiais ao mesmo tempo.
* **Pedidos só chegam sozinhos com o webhook Ativo.** Enquanto o status estiver Pendente, use **Buscar pedidos** ou finalize o passo 4.
* **Status "URL incorreta":** a URL de notificação do app do Mercado Livre aponta para outra licença ou está incompleta. Copie a URL da aba **Conta** e cole no app (passo 4). O Mercado Livre não reenvia o que já entregou no endereço errado — os pedidos desse período você traz com **Buscar pedidos**.
* **Ao conectar, volta para a tela com erro e a conta não conecta:** no app do Mercado Livre (DevCenter → sua aplicação → **Configuração e scopes**), confira se o **pkce** está **desmarcado** (passo 6), se o **App ID** e a **Secret Key** cadastrados no sistema são do **mesmo** app e se o **Redirect URI** está idêntico ao que o sistema mostra. Depois de salvar no DevCenter, clique em **Conectar** de novo.
* **Conexão caiu:** se a aba Conta mostrar "A conexão parou de funcionar", reconecte a conta pela aba Integrações.
* **Falha ao carregar anúncios de uma filial:** a tela de Anúncios avisa quais filiais falharam — normalmente é preciso reconectá-las.
* **Nota Fiscal:** se você emite NF pelo próprio Mercado Livre, mantenha a emissão automática de NF do sistema desativada para não duplicar a nota.
* **Erro 403 com `PA_UNAUTHORIZED_RESULT_FROM_POLICIES`:** falta uma **permissão funcional** no aplicativo do Mercado Livre. Volte ao DevCenter, abra as configurações da aplicação e ative a permissão correspondente (passo 1), com leitura e escrita.
* **Parou tudo de uma vez, sem ninguém mexer:** confira se a **Secret Key** foi renovada no Mercado Livre. O DevCenter permite renovar a chave ("Renove agora" ou "Programar renovação"), e a chave antiga expira. Quando isso acontecer, copie a nova Secret Key e atualize no sistema, em Configurações → Integrações.
* **Perguntas só aceitam uma resposta:** o próprio Mercado Livre limita a uma resposta por pergunta. Na conversa privada não há esse limite.