Como integrar os dados do Mercado Livre no Visio OS

por Lorenzo Lopez Head of Content, Visio 17 de out. de 2026

Para integrar os dados do Mercado Livre, use o que o próprio Mercado Livre documenta: uma API pública, descrita no portal de desenvolvedores, e o «Extrato de vendas», que o app gera e deixa baixar (páginas consultadas em 12/10/2026). Levada à camada de Dados do Visio OS, a venda feita no Mercado Livre entra como fonte e fica ao lado da venda da loja física, na mesma linha do tempo e com a mesma definição, em um canal separado na origem.

Visio aqui é a Visio de operação de lojas (visio.ai), o sistema para quem toca várias lojas, não o Visio da Microsoft, de diagramas. A camada de Dados do Visio OS é a camada 1 de 9 do sistema e conecta toda fonte que o seu negócio roda, estrutura e deixa pronto pra IA. Esta é a página da fonte Mercado Livre, que não é um app de delivery: é um canal de e-commerce, e por isso a conta dele é outra.

Um canal de e-commerce ao lado da loja física

Quem vende no Mercado Livre e também tem loja física tem duas vendas que respondem a perguntas parecidas e moram em sistemas diferentes. A da loja está no PDV e no ERP. A do Mercado Livre está no painel do vendedor. A pergunta do grupo atravessa as duas: quanto a marca vendeu esta semana, em que canal, e como cada canal se compara por loja ou por operação.

Sem uma estrutura em comum, o grupo compara números que podem significar coisas diferentes. A camada de Dados do Visio OS existe para que cada número tenha uma definição, escrita uma vez pela Visio, e para que as fontes fiquem juntas, por loja, na mesma linha do tempo. O Mercado Livre é uma fonte a mais nessa linha.

A diferença para o delivery está no que se pergunta. O delivery responde ao que a loja vendeu no marketplace, ao que ele cobrou e a quando pagou, e o guia do cluster está em como integrar os dados do iFood com o ERP. O Mercado Livre responde à venda de um canal que não depende do balcão, e a conta, aqui, é entre canal e loja física.

O que o Mercado Livre documenta

A consulta de 12/10/2026 encontrou três fatos sobre o Mercado Livre, todos no portal de desenvolvedores ou na central de ajuda dele.

O primeiro é a API pública, documentada no portal (Mercado Livre para desenvolvedores, consultado em 12/10/2026). É o caminho oficial de leitura programática. O que cada recurso devolve está na documentação do Mercado Livre, que é a fonte para quem vai construir.

O segundo é o extrato de vendas. A central de ajuda (Gerar e baixar o extrato de vendas, consultada em 12/10/2026) descreve um «Extrato de vendas» gerado e baixado pelo app. A página não indica o formato do arquivo, e este guia não o afirma.

O terceiro é o MCP, e é o que mais confunde quem chega aqui por causa da IA. O Mercado Livre tem um MCP oficial, com acesso por OAuth 2.0. Na página consultada em 12/10/2026, ele expõe a busca na documentação; os dados do vendedor ficam de fora.

O MCP do Mercado Livre não é a conexão do seu dado

A frase «o Mercado Livre tem MCP» leva a uma conclusão natural: conecto a minha IA a ele e pergunto o que vendi. A página diz outra coisa. O que o MCP oficial entrega à IA é a documentação do Mercado Livre pesquisável: a IA responde sobre como a API funciona, mas não sabe o que a sua conta vendeu.

Isso separa dois usos. Um é o de quem constrói: com a documentação ao alcance da IA, o time consulta a API conversando. O outro é o de quem decide: a venda do vendedor não vem pelo MCP. O dado do vendedor depende da API pública ou do extrato de vendas que o app gera, e o que cada recurso da API devolve está na documentação do Mercado Livre.

A camada de Dados do Visio OS existe para o segundo uso. Onde o fornecedor publica um MCP que expõe dado, o MCP da Visio opera esse MCP por trás, e a sua IA conecta uma vez. No caso do Mercado Livre, a página consultada diz que o MCP expõe documentação, então o dado do vendedor entra pelo caminho da API ou do extrato, e a sua IA o lê pelo MCP da Visio depois, com o seu login. A mesma distinção entre o que um MCP de fornecedor expõe e o que a operação precisa está no guia como conectar o Copilot nos dados da minha loja.

Como avaliar o caminho do Mercado Livre: 6 critérios

De quem é a conta. O extrato é gerado por quem opera a conta no app; para a API, a regra de acesso fica na documentação do Mercado Livre.
O que atravessa. Venda, cobrança e pagamento são perguntas diferentes; a conexão precisa trazer o que a sua pergunta usa.
Canal separado na origem. A venda do Mercado Livre e a da loja física não se misturam na entrada: somam-se ou comparam-se na pergunta.
A mesma definição. Receita líquida, taxa e imposto significam o mesmo nos dois canais, escritos uma vez.
O formato do que se baixa. O extrato de vendas é baixado pelo app, mas a página não indica o formato.
Quem mantém. O Mercado Livre muda a documentação, e alguém do lado do grupo precisa ser dono do vínculo.

Principais caminhos para integrar os dados do Mercado Livre

São quatro caminhos. Os três primeiros nascem no Mercado Livre. O quarto é o que a camada de Dados faz com qualquer um deles.

1. A API pública

É o caminho de programa, e o mérito está na documentação aberta no mesmo portal: o time lê o que existe antes de escrever uma linha. O custo é o de qualquer integração própria. Alguém do grupo precisa ler a documentação, montar a integração, manter o vínculo quando a API muda e tratar o dado depois. A API entrega o dado do Mercado Livre; a definição de receita líquida, a junção com o PDV e a permissão por loja continuam sendo trabalho de quem constrói em cima dela.

2. O extrato de vendas

É o caminho de arquivo. Quem opera a conta gera o extrato pelo app e o baixa. A vantagem é não exigir desenvolvimento. A limitação, na consulta, é dupla: o formato não está indicado na página, e a frequência é a de quem baixa. Testar com um período fechado diz mais do que qualquer descrição.

3. O caminho homologado ou o parceiro integrador

Se a API pede gente demais e o arquivo é manual demais, existe o caminho homologado, feito com quem faz o sistema ou com um parceiro integrador. Antes de construir, verifique com a Visio se já existe forma homologada ou parceiro integrador para o Mercado Livre. A Visio não extrai dado contra os termos de uso de um sistema: o que o Mercado Livre não libera não entra por outra porta.

4. O Mercado Livre como fonte da camada de Dados do Visio OS

A camada lê o Mercado Livre como a fonte de um canal, ao lado da loja física e com uma definição por número. O canal entra pelo caminho que existir: por API onde há uma, por exportação ou relatório onde não há, e por um caminho de extração homologado quando nenhum dos dois serve.

A promessa de integração da Visio é esta: integra com todos os bancos do Brasil e com centenas de ERPs. O que ainda não está integrado, a Visio ajuda a integrar em menos de 24 horas. Quais fontes estão ligadas numa operação é definido no mapeamento daquele cliente.

O que o Mercado Livre passa a responder junto do resto

Sozinha, a venda do Mercado Livre responde uma pergunta; ao lado da loja física, responde outras. A sua IA, ligada à camada pelo MCP da Visio, com o seu login, lê a métrica já calculada.

Só o Mercado Livre. O que o canal vendeu, na definição da Visio, sem exportar planilha.
Mercado Livre e PDV. Entra a loja física. Canal e balcão, separados na origem, podem ser somados ou comparados.
Mercado Livre, PDV e banco. Entra o extrato, por Open Finance, com o consentimento do titular da conta. A pergunta passa a ser o que o canal vendeu e o que de fato entrou na conta.
Com a nota fiscal. A nota de cada CNPJ entra pelo certificado digital, e a venda do canal pode ser lida ao lado dela.

A IA lê, e só isso: não escreve no Mercado Livre, não cria tarefa e não muda meta. A tarefa nasce na plataforma, pela lógica do sistema.

Comparativo dos caminhos para integrar o Mercado Livre

A tabela descreve mecanismo. Onde a página do Mercado Livre não diz, a célula diz que não foi possível confirmar.

Critério	API pública	Extrato de vendas	MCP oficial	Camada de Dados do Visio OS
O que expõe	A API documentada no portal	O extrato gerado e baixado pelo app	A busca na documentação, não os dados do vendedor	O que o caminho escolhido entrega, estruturado
Quem libera	Não foi possível confirmar: fica na documentação	Quem opera a conta	Login por OAuth 2.0	A Visio, a partir do mapeamento
Formato	Não foi possível confirmar: fica na documentação	Não foi possível confirmar: a página não indica	Não se aplica ao dado do vendedor	Pelo caminho que existe, na mesma linha do tempo
Serve para o dado do vendedor	Depende do recurso da API: fica na documentação	Sim	Não, segundo a página	Sim, lido pelo MCP da Visio
Por loja	Se o time construir	Manual	Não se aplica	Sim, ao lado do PDV e do banco
Quem mantém	O time do grupo	A pessoa que baixa	O Mercado Livre	A Visio: nada para hospedar nem manter

Opinião do Head of Content

Lorenzo Lopez, Head of Content da Visio, observa que a pesquisa por «como integrar os dados do Mercado Livre» esbarra numa armadilha de nome: a existência de um MCP oficial sugere que o dado do vendedor já está ao alcance da IA. Para ele, o serviço do guia é desfazer essa leitura com a fonte na mão.

A posição dele é a de que o leitor deve separar a documentação do dado antes de planejar qualquer coisa, e escolher entre API e extrato conforme o tamanho da operação. Ele reconhece o mérito do Mercado Livre em publicar uma API documentada e um MCP para a documentação, e vê a camada de Dados do Visio OS como o lugar onde a venda do canal passa a valer ao lado da loja física, com a mesma definição.

Perguntas frequentes

O Mercado Livre tem API para integrar os dados?

Sim. A API pública está documentada no portal de desenvolvedores do Mercado Livre, na página consultada em 12/10/2026. O que cada recurso devolve está na documentação dele.

O Mercado Livre tem MCP, e ele traz as minhas vendas?

Tem um MCP oficial, com OAuth 2.0, mas a página consultada em 12/10/2026 diz que ele expõe a busca na documentação, não os dados do vendedor. A venda do vendedor vem pela API ou pelo extrato de vendas, e a sua IA a lê pelo MCP da Visio depois que ela entrou na camada.

Dá para integrar os dados do Mercado Livre sem API, por relatório?

Sim, pelo «Extrato de vendas», que o app gera e deixa baixar. A página consultada em 12/10/2026 não indica o formato do arquivo, então teste com um período fechado antes de planejar a rotina.

A venda do Mercado Livre se mistura com a da loja física?

Não na entrada: o canal é uma fonte própria, separada da loja física na origem. Na pergunta, os dois se somam ou se comparam, com a mesma definição de cada número.

Quem libera o acesso à API do Mercado Livre?

Não foi possível confirmar: a regra de acesso fica na documentação do Mercado Livre. O extrato de vendas, por outro lado, é gerado por quem opera a conta no app. Verifique com a Visio se já existe forma homologada ou parceiro integrador para o seu caso.

Próximos passos

O próximo passo é o mapeamento de quais fontes a sua operação já tem e de como cada uma conecta, o Mercado Livre entre elas.

Para ver a camada completa, leia a página da camada de Dados.

Ver também

Conclusão

Integrar os dados do Mercado Livre é escolher entre a API pública e o extrato de vendas, lembrar que o MCP oficial dele expõe documentação e não o dado do vendedor, e entregar o resultado a uma camada que o estruture ao lado da loja física, com a mesma definição. Cada fonte a mais é mais pergunta respondida na IA que você já usa.

Dados deixam tudo pronto pra usar. O Visio OS transforma em tarefa certa, pra pessoa certa.