Configuração inicial

Antes de sincronizar pedidos ou enviar notas fiscais, é preciso conectar o TryERP à sua conta de vendedor do Mercado Livre. Essa conexão é feita uma única vez por emitente e fica guardada nas configurações do sistema. Este capítulo mostra onde configurar, como gerar o token de acesso corretamente e como preparar usuários de teste antes de trabalhar com pedidos reais.
A integração só funciona para empresas que emitem NF-e modelo 55 (pessoa jurídica contribuinte). Se você ainda tem dúvidas sobre o funcionamento geral, leia antes os capítulos Visão geral e justificativa e Como funciona.
Onde configurar
A conexão com o Mercado Livre fica em Configurações Adicionais, na aba Mercado Livre. É nessa aba que você informa as credenciais do aplicativo do Mercado Livre e gera o token que autoriza o TryERP a conversar com a plataforma em nome do vendedor.
A configuração é por emitente. Se a sua empresa trabalha com mais de um emitente (mais de um CNPJ), cada um pode ter a sua própria conta do Mercado Livre configurada de forma independente. Isso permite que empresas com múltiplos CNPJs vendam por contas diferentes do marketplace sem misturar tokens.

As credenciais (App ID, Secret e código de autorização) vêm do aplicativo que você cria no portal de desenvolvedores do Mercado Livre. Esse aplicativo é o "crachá" que identifica o TryERP perante a plataforma. Se você ainda não tem essas informações, peça ao responsável pela conta do Mercado Livre da sua empresa ou ao seu suporte para criar o aplicativo e fornecer os dados.
Passo a passo da conexão
Com a aba Mercado Livre aberta, siga a ordem abaixo. Cada campo depende do anterior, então respeite a sequência.

Preencha o campo App ID com o identificador do aplicativo do Mercado Livre.
Preencha o campo Secret com a chave secreta desse mesmo aplicativo.
Informe o código de autorização gerado pelo aplicativo do Mercado Livre.
Clique em Autorizar Usuário para vincular a conta do vendedor (detalhado na próxima seção).
Gere o token. É o token que efetivamente dá ao TryERP permissão para ler os pedidos e enviar as notas fiscais.

Depois de gerado, o token fica salvo e é renovado automaticamente pelo sistema quando necessário. Você não precisa repetir esse processo a cada uso.
O botão "Autorizar Usuário"
Ao clicar em Autorizar Usuário, o sistema pergunta como você deseja abrir a página de autorização do Mercado Livre: abrir direto no navegador ou copiar a URL para você colar manualmente em um navegador de sua escolha.
Essa escolha existe por um motivo importante. A autorização gera o token da conta que estiver logada no navegador naquele momento. Se o seu navegador padrão estiver logado em outra conta do Mercado Livre (a sua conta pessoal, por exemplo, e não a conta da loja), o token será gerado para a conta errada.
Por isso, quando houver qualquer dúvida sobre qual conta está logada, prefira copiar a URL e colá-la em um navegador (ou janela anônima) onde você tenha certeza de estar logado como o vendedor — o dono da loja no Mercado Livre.

Opção
Quando usar

Abrir no navegador
Quando você tem certeza de que o navegador padrão já está logado na conta da loja.

Copiar a URL
Quando quer controlar exatamente em qual navegador/conta a autorização acontece. Cole em uma janela logada como o vendedor.

O token PRECISA ser da conta do vendedor (a loja do Mercado Livre). Se o token for gerado a partir de uma conta errada, a integração conecta, mas o botão Sincronizar traz 0 pedidos — porque está lendo os pedidos de outra conta, que não tem as vendas da loja. Se isso acontecer, refaça a autorização copiando a URL e colando em uma janela logada como o vendedor. Veja também o capítulo Perguntas frequentes e glossário.
Usuários de teste
O Mercado Livre não oferece um ambiente de sandbox separado como outros sistemas. Para testar a integração sem mexer em vendas reais, a própria plataforma permite criar usuários de teste: contas fictícias de comprador e de vendedor que existem só para experimentar o fluxo.
Na aba Mercado Livre há o botão Criar usuários de teste. Use-o para gerar as contas fictícias que você usará para simular compras e acompanhar o passo a passo de sincronizar, conciliar e enviar a nota — tudo sem afetar clientes de verdade.
Ao testar com usuários fictícios, emita apenas notas de HOMOLOGAÇÃO. Nunca emita nota de produção para um comprador de teste: além de não representar uma venda real, isso gera uma NF-e válida no seu movimento fiscal para um destinatário que não existe.
Atenção ao inverso, que é o erro mais comum: o Mercado Livre só aceita NF-e de PRODUÇÃO em vendas reais. Nota emitida em ambiente de homologação/teste é sempre rejeitada pela plataforma. Ou seja, homologação serve apenas para os usuários de teste; para clientes reais, sempre nota de produção.
Recomendação prática: faça um ciclo completo com usuários de teste antes de ir para o ambiente real. Crie os usuários de teste, simule uma compra, sincronize, concilie e envie uma nota de homologação. Assim você conhece cada etapa (descritas nos capítulos seguintes) sem risco antes de trabalhar com pedidos de verdade.

Com a conta conectada e o token válido gerado pela conta correta do vendedor, o próximo passo é trazer os pedidos pagos do período para a lista de trabalho. Continue no capítulo Sincronização de pedidos.