# Mercado Livre — Conectar e sincronizar catálogo

Conecte a conta de vendedor, exporte produtos e acompanhe pedidos do marketplace na Nortgraf.

### Para que serve este módulo?

A integração usa uma aplicação do Mercado Livre e autorização OAuth para relacionar a conta do vendedor à loja. O recurso está identificado como Beta e deve ser validado com poucos produtos antes do uso em escala.

## 1 - Antes de começar

- Conta de vendedor ativa no Mercado Livre.
- Aplicação criada no DevCenter.
- Client ID/App ID e Client Secret.
- URL de redirecionamento cadastrada na aplicação.
- Produtos revisados com imagens, categoria, preço e estoque.

## 2 - Criando a aplicação

1. Acesse o DevCenter do Mercado Livre.
2. Crie ou abra a aplicação usada pela loja.
3. Copie o App ID e o Client Secret.
4. Na Nortgraf, abra **Configurações > Integrações > Mercado Livre**.
5. Copie a URL de redirecionamento exibida.
6. Cadastre essa URL na aplicação do Mercado Livre.

## 3 - Conectando a conta

1. Informe o Client ID/App ID e o Client Secret.
2. Escolha se a sincronização de pedidos ficará automática ou manual.
3. Salve a configuração.
4. Na autorização do Mercado Livre, entre com a conta vendedora correta.
5. Aceite as permissões solicitadas.
6. Retorne à integração e confirme o status conectado, nickname e Seller ID.

## 4 - Exportando produtos

Abra um produto no catálogo e use a ação de exportação para o Mercado Livre quando disponível. Revise categoria, título, descrição, imagens, preço, estoque e atributos exigidos pelo marketplace.

Depois da exportação, acompanhe o vínculo e os retornos. Corrija os campos indicados antes de tentar novamente.

## 5 - Pedidos do marketplace

Com a integração conectada, pedidos recebidos do Mercado Livre podem ser trazidos para a Nortgraf conforme o fluxo habilitado. Confira cliente, itens, valores, entrega e vínculo externo antes de avançar a operação.

Evite cadastrar manualmente outro pedido para a mesma venda.

## 6 - Sincronização e limites

Produtos, estoque e pedidos dependem dos vínculos e permissões da conta. Preços podem seguir regras diferentes conforme a configuração atual.

Alterações feitas diretamente no Mercado Livre podem exigir nova sincronização ou conferência na Nortgraf.

## 7 - Problemas comuns

### Autorização não conclui

Confira a URL de redirecionamento e se as credenciais pertencem à mesma aplicação.

### Conta errada foi conectada

Desconecte e refaça a autorização com o vendedor correto.

### Produto rejeitado

Revise categoria, atributos obrigatórios, imagens, preço e políticas do marketplace.

### Pedido não apareceu

Confirme a conexão, o modo de sincronização e se o pedido pertence ao Seller ID conectado.

## 8 - Boas práticas

- Teste com poucos produtos.
- Não compartilhe o Client Secret.
- Revise pedidos importados antes de produzir.
- Mantenha estoque e preço coerentes entre canais.
- Acompanhe erros e vínculos de sincronização.

**Atenção:** A integração está em Beta. Valide cuidadosamente catálogo, estoque e pedidos antes de depender dela como único fluxo operacional.