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.