Mercado Livre

Cadastre o produto na Brasmobi, publique no Mercado Livre e receba a venda aqui — com baixa no estoque, título no Financeiro, etiqueta, nota fiscal e atendimento no mesmo lugar.

A integração liga a sua conta de vendedor do Mercado Livre ao Estoque, ao Financeiro e às Notas Fiscais da Brasmobi. O produto continua sendo cadastrado uma vez só, aqui; o anúncio nasce dele, o estoque do anúncio acompanha o disponível do depósito, e cada venda paga no Mercado Livre vira baixa no kardex, cliente em Pessoas e título em Contas a Receber — sozinha.

O diferencial: a Brasmobi é a fonte da verdade do estoque e do cadastro. Vendeu no balcão, na loja virtual ou no Mercado Livre, o anúncio recebe a quantidade certa; vendeu no Mercado Livre, o estoque baixa aqui. Nada é digitado duas vezes.

Para que serve

  • Conexão da conta de vendedor com um clique (OAuth), token renovado sozinho a cada 6 horas e aviso no dashboard quando precisar reconectar.
  • Anúncios: publicar a partir do produto (simples e com grade), categoria sugerida, atributos obrigatórios guiados, tipo de anúncio com tarifa prevista, frete, garantia, descrição e título com IA, catálogo; importar anúncios que a conta já tem; pausar, reativar, encerrar e editar.
  • Estoque e preço sincronizados: toda movimentação do kardex e toda mudança de preço do canal vão para o anúncio pela fila; o Full (estoque no Mercado Livre) aparece como depósito só de leitura.
  • Vendas: pedido e carrinho viram venda com cliente, baixa de estoque, título pelo líquido (bruto − tarifa − frete do vendedor) e repasse conciliado; cancelamento, devolução e reembolso tratados.
  • Envio: Mercado Envios (etiqueta PDF/ZPL, uma ou em lote), Flex, Full e envio próprio com rastreio informado.
  • Nota fiscal: NF-e modelo 55 pelo emissor da Brasmobi (com o XML enviado ao ML) ou pelo Faturador do Mercado Livre; nota de devolução.
  • Atendimento: perguntas com sugestão (ou resposta automática) por IA, mensagens pós-venda, reclamações e devoluções com "Recebi a devolução".
  • Gestão: reputação e métricas da conta, KPIs do período, margem por anúncio, sugestão de preço e preço para ganhar o catálogo, promoções do ML e relatórios em CSV.

Resultado do primeiro teste real — lado do vendedor (28/10/2026)

Com um usuário de teste do Mercado Livre (conta user_product_seller) conectado de verdade a um negócio descartável, ficou confirmado: OAuth com PKCE de ponta a ponta; o formato real do aviso (_id, topic, resource, user_id, application_id, sent, attempts, received e um campo extra actions[], guardado sem erro); missed_feeds; as tags de /users/me; o anúncio criado por POST /items com family_name (o ML gera o título e devolve user_product_id); fotos por URL pública; tarifas, preditor de categoria e atributos condicionais; a sincronização real de estoque (PUT available_quantity), de preço (sempre acompanhado) e de fotos pelo worker do cron; avisos do tópico items e items_prices tratados em até 1 minuto; a renovação do token pelo cron (refresh token rotativo, POST /oauth/token) feita sozinha antes do vencimento.

Divergências corrigidas: o corpo do fiscal_information (acima); um 400 do /items/validate só com avisos (warning) não é recusa — o anúncio é aceito com avisos; conta User Products recusa variations (cada variação é um item da mesma família — a grade é barrada no preparo com explicação). Não testável com usuário de teste: Mercado Envios (a conta de teste não aderiu: etiqueta, rastreio e Full ficam para uma conta real), e tudo que depende do comprador (venda, pagamento, envio, NF-e, perguntas, mensagens e reclamações).

Onde fica: menu Mercado Livre, com as telas Visão geral, Anúncios, Vendas, Perguntas, Mensagens, Reclamações e Configurações. O módulo faz parte do Plano Loja e do plano Exclusivo Brasmobi. Fora do escopo: Mercado Ads, Mercado Shops e classificados.

Pré-requisitos

  1. Conta de vendedor no Mercado Livre Brasil (MLB), e o acesso ao usuário principal (titular) dela. Operadores e colaboradores da conta não conseguem autorizar a integração — o Mercado Livre recusa.
  2. Aplicativo "Brasmobi Marketplace" configurado no SaaS pelo Administrador da Brasmobi (veja Aplicativo no SaaS). Sem ele o botão Conectar nem aparece.
  3. Produtos cadastrados no Estoque com o que o Mercado Livre exige: pelo menos uma foto, marca, e — para boa parte das categorias — código de barras (GTIN). Peso e medidas evitam que o ML estime o frete pela categoria; NCM permite enviar os dados fiscais do item. O assistente de publicação mostra o que falta e deixa completar o produto na hora.
  4. Para emitir a NF-e pelo emissor da Brasmobi: emissor configurado em Notas Fiscais (certificado, série, responsável técnico) e natureza de operação com CFOP para venda fora do estado. Sem emissor, a nota sai pelo Faturador do Mercado Livre.
  5. Para o dinheiro baixar o título sozinho: uma conta de repasse no Financeiro (a conta do Mercado Pago), escolhida em Vendas › Conta de repasse.

Guia rápido: da conexão à primeira venda

  1. Conecte a conta em Mercado Livre › Configurações e confira os padrões (tipo de anúncio, garantia, frete, depósito de origem, margem de estoque, modo da NF-e).
  2. Publique em Anúncios › Publicar produtos: escolha o produto, confirme a categoria, complete o que falta, escolha o tipo e veja a tarifa, frete e garantia, título e descrição, revise e publique. Ou importe os anúncios que a conta já tem e vincule cada um a um produto.
  3. Venda: o pedido chega sozinho em Vendas. Ao ser pago, o estoque baixa, o cliente entra em Pessoas e o título nasce em Contas a Receber. Imprima a etiqueta, emita a NF-e (ou deixe automática) e despache.
  4. Atenda: responda perguntas (com a sugestão da IA), fale com o comprador pelas mensagens pós-venda e acompanhe reclamações e devoluções.
  5. Acompanhe na Visão geral: reputação, vendas do período, margem por anúncio, preços sugeridos, promoções e relatórios.

Configurações

Mercado Livre › Configurações reúne a conexão da conta, os padrões dos anúncios, a regra da nota fiscal, o atendimento automático e o diagnóstico da integração. Só quem tem a permissão de configurar o Mercado Livre vê esta tela.

Tela Configurações do Mercado Livre: cartão Conta do Mercado Livre com a conta LOJA_EXEMPLO conectada, cartão Padrões dos anúncios e cartão Diagnóstico com os indicadores, as últimas notificações e as últimas chamadas à API
Configurações: conta conectada, padrões dos anúncios e diagnóstico (desktop).

Conectar e desconectar a conta

Clique em Conectar com Mercado Livre. Você é levado ao Mercado Livre, entra com o usuário principal da conta de vendedor, autoriza a Brasmobi e volta para cá já conectado. A conexão vale para um negócio só: a mesma conta do Mercado Livre não pode ficar conectada em dois negócios da Brasmobi ao mesmo tempo.

Cartão Conta do Mercado Livre sem conta conectada, com o aviso para entrar com o usuário principal da conta de vendedor e o botão Conectar com Mercado Livre
Sem conta conectada: o botão "Conectar com Mercado Livre".
Cartão Conta do Mercado Livre com a conta LOJA_EXEMPLO conectada em produção no site MLB, o ID do vendedor, a data da conexão, a validade do acesso renovado sozinho a cada 6 horas e o botão Desconectar
Conta conectada: apelido, ambiente, ID do vendedor, validade do acesso e o botão Desconectar.
  • O acesso dura 6 horas e é renovado sozinho (o cron de tokens roda a cada 5 minutos e a própria chamada renova quando falta menos de 30 minutos). Você não precisa fazer nada.
  • Se o Mercado Livre revogar a autorização (senha trocada, aplicativo removido na conta), a tela e o dashboard pedem para reconectar. Até lá, nada é enviado nem recebido — os anúncios e as vendas gravados continuam visíveis.
  • Desconectar apaga as credenciais e para a integração; anúncios, vendas e histórico ficam guardados. Ao reconectar com a mesma conta, tudo volta a andar.
  • Mensagens de recusa possíveis: conta de outro país (só MLB é aceito), operador/colaborador tentando autorizar, link expirado (vale 10 minutos) ou volta num navegador diferente do que começou.

Padrões dos anúncios

Cartão Padrões dos anúncios: tipo de anúncio Clássico, garantia do vendedor de 90 dias, frete Mercado Envios, depósito de origem, depósito do Full, margem de segurança de estoque 1, nota fiscal da venda em modo Automático, interruptor Emitir NF-e automaticamente ao pagar, interruptor Responder perguntas automaticamente com IA e a assinatura das mensagens
Padrões: valores sugeridos ao publicar; cada anúncio pode ter os seus.
CampoO que faz
Tipo de anúncioGrátis (sem tarifa, exposição baixa), Clássico (tarifa por venda) ou Premium (tarifa maior, parcelamento sem juros ao comprador). O assistente mostra a tarifa prevista de cada um.
GarantiaTipo (vendedor, fábrica, sem garantia) e tempo com unidade (dias, meses, anos) — o Mercado Livre exige a unidade.
FreteMercado Envios, envio próprio ou a combinar; frete grátis por padrão (o custo é descontado de você).
Fabricação própriaLigado, os produtos nacionais vão aos dados fiscais do anúncio como "fabricante"; desligado, como "revenda". Importados (origem 1, 2, 6 e 7) são sempre "importado". O Mercado Livre guarda esses dados por SKU: a Brasmobi envia o do produto e o de cada variação ativa. Mudar esta opção reenvia o dado fiscal de todos os anúncios publicados pela fila.
Depósito de origemO disponível deste depósito é o que vai ao anúncio; a venda no Mercado Livre baixa aqui.
Depósito do FullDepósito que representa a mercadoria guardada no Mercado Livre (Full). É só leitura: o ML desconta e a Brasmobi confere, avisando divergência. Vendas Full baixam deste depósito.
Margem de segurança de estoqueQuantidade retida: o anúncio recebe disponível − margem (0 = tudo). Cada anúncio pode, em vez disso, usar uma quantidade fixa.
Responder perguntas automaticamente com IADesligado (padrão), a IA só sugere e você aprova. Ligado, responde sozinha só quando a confiança é alta e a pergunta não fala de preço, prazo, estoque ou garantia (regras em Perguntas).
Assinatura das mensagensTexto acrescentado no fim de cada mensagem pós-venda (conta no limite de 350 caracteres).

Nota fiscal da venda (NF-e modelo 55)

  • Automático (padrão): usa o emissor da Brasmobi quando o negócio tem emissor configurado; senão, o Faturador do Mercado Livre.
  • Emissor da Brasmobi: a nota é emitida aqui, com CFOP e DIFAL resolvidos pela porta fiscal e o destinatário vindo dos dados fiscais do comprador, e o XML é enviado ao Mercado Livre.
  • Faturador do Mercado Livre: o ML emite a nota; a Brasmobi busca o XML e registra o documento em Notas Fiscais (como documento de terceiro), para o Fiscal e o SPED enxergarem a venda.
  • Emitir NF-e automaticamente ao pagar: ligado, a nota de cada venda paga (o carrinho inteiro, de uma vez) sai sozinha pelo modo acima, e a de devolução sai quando você registra a devolução recebida. Desligado, você emite pelo botão em Vendas. Vendas Full usam sempre o Faturador (o produto sai do centro de distribuição do ML).

Diagnóstico

Cartão Diagnóstico com seis indicadores (avisos em 24 h, na fila, processados, com erro, ignorados e chamadas à API), a tabela das últimas notificações recebidas por tópico com situação e tentativas, e a tabela das últimas chamadas à API com método, caminho, HTTP, duração e erro
Diagnóstico: o que o Mercado Livre nos enviou e o que pedimos a ele.

O Mercado Livre avisa por notificação cada venda, pergunta, mensagem, mudança de anúncio ou envio. O aviso é gravado na fila e processado em seguida pelo worker (a cada minuto). Na fila = ainda vai ser tratado; com erro = esgotou as 10 tentativas (a mensagem diz o motivo); ignorado = aviso de outro aplicativo, de conta não conectada ou de tópico ainda sem tratamento. As chamadas à API mostram método, caminho, código HTTP e duração — nunca o conteúdo nem o token.

Tela Configurações do Mercado Livre no celular, com o cartão da conta conectada e o início dos padrões dos anúncios
Configurações no celular.

Visão geral

Mercado Livre › Visão geral é a página inicial do módulo: situação da conta e reputação, notificações das últimas 24 horas, cartões com os números de cada tela (vendas de hoje, envios e NF-e pendentes, anúncios ativos e com aviso, perguntas sem resposta, mensagens não lidas, reclamações abertas) e as abas Resumo, Margem, Preço e concorrência, Promoções e Relatórios.

Visão geral do Mercado Livre: conta LOJA_EXEMPLO conectada com MercadoLíder Platinum e termômetro verde, métricas de reputação, notificações das últimas 24 horas, oito cartões com números, aba Resumo com período, seis KPIs, gráfico de vendas por dia e a lista Anúncios que pedem ação
Visão geral com a aba Resumo (desktop).
Cartão da conta: LOJA_EXEMPLO conectada, selo MercadoLíder Platinum, termômetro de reputação verde, botão Atualizar reputação e as métricas vendas concluídas, reclamações, atrasos no envio, cancelamentos e avaliações positivas
Reputação: termômetro, MercadoLíder e as métricas que pesam na reputação (lidas uma vez por dia ou pelo botão).
Aba Resumo: período com atalhos Hoje, 7 dias, Este mês e 30 dias; KPIs de vendas, pedidos, ticket médio, tarifa média, líquido e margem estimada; gráfico de vendas por dia dos últimos 14 dias; e a lista Anúncios que pedem ação com o motivo de cada um
Aba Resumo: KPIs do período, vendas por dia e os anúncios que pedem ação.
  • Resumo: período com atalhos (hoje, 7 dias, este mês, 30 dias); KPIs de vendas, pedidos, ticket médio, tarifa média, líquido e margem estimada (vendas − tarifa − frete do vendedor − custo da baixa no kardex, com a cobertura informada); gráfico dos últimos 14 dias; e Anúncios que pedem ação (sem estoque, com erro, em revisão, perdendo o catálogo, preço acima da sugestão, margem negativa, com aviso).
  • Cartão de fase não instalada não aparece — a tela nunca mostra zero inventado.

Margem, preço e concorrência, promoções

Aba Margem: margem média ponderada, margem negativa, sem custo, sem frete estimado, filtro por tipo de margem, botão Exportar CSV e a tabela de anúncios com preço, tarifa, frete grátis, custo e margem por unidade, inclusive linhas não calculadas por falta de custo ou tarifa
Margem por anúncio = preço − tarifa prevista − frete grátis estimado − custo médio. Sem custo ou tarifa, "não calculada" (nunca um número inventado).
Aba Preço e concorrência: chips Acima da sugestão, Perdendo o catálogo, Com sugestão e Em promoção do ML; tabela com preço atual e margem, sugestão do Mercado Livre com a margem no preço sugerido, situação no catálogo com o preço para ganhar e os botões Aplicar sugestão e Aplicar preço para ganhar
Preço e concorrência: sugestão de preço do ML e "preço para ganhar" o catálogo. "Aplicar" grava o preço do canal Mercado Livre no produto; a sincronização leva ao anúncio.
Aba Promoções: campanhas da conta, anúncio Mouse Sem Fio Silencioso com a promoção Liquida Primavera ativa, preço travado e botão Sair, e anúncio Capa de Silicone com a campanha Ofertas da Semana em que pode participar
Promoções do Mercado Livre: participar com preço de oferta, acompanhar a vigência e sair.
Modal Participar da promoção: anúncio, campanha, preço da oferta preenchido com o sugerido pelo Mercado Livre, faixa aceita e o aviso de que o preço fica gerenciado no Mercado Livre enquanto a promoção vigorar
Participar: o preço da oferta precisa ficar na faixa que o ML aceita.
Promoção trava o preço. Enquanto um anúncio está numa promoção do Mercado Livre (ativa ou programada), o preço dele passa a ser gerenciado no Mercado Livre: a Brasmobi não envia preço até a promoção acabar, para não tirar o anúncio da oferta. No fim, o preço do canal volta a valer sozinho. Se você mesmo desligar "preço gerenciado no ML" durante a promoção, a Brasmobi respeita e não religa.

"Aplicar sugestão" é recusado, com o motivo, quando há promoção vigente, preço gerenciado no ML, uma tabela de preço decidindo o preço do canal, grade com preços diferentes entre variações, ou nenhuma sugestão.

Relatórios

Aba Relatórios: período, botão Atualizar prévia e quatro cartões com prévia e Baixar CSV — Vendas, Anúncios, Margem e Atendimento
Relatórios em CSV (abrem no Excel): vendas com comprador mascarado, anúncios, margem e atendimento por dia.
Visão geral no celular: conta conectada, MercadoLíder, termômetro de reputação e métricas em cartões
Visão geral no celular.
Aba Margem no celular, com cada anúncio em cartão: preço, tarifa, frete grátis, custo e margem
No celular as listas das abas viram cartões (aqui, a Margem).

Anúncios

Mercado Livre › Anúncios lista todos os anúncios da conta ligados a produtos da Brasmobi, com indicadores (ativos/pausados, com aviso, com erro, produtos sem anúncio, fila de sincronização), chips por situação, busca, filtros e ordenação. Cada linha mostra o produto, a situação com a saúde do anúncio, o preço enviado × o preço no ML (divergência destacada), as quantidades (enviada, no ML, vendida) e os avisos.

Tela Anúncios: seis indicadores, chips Todos, Rascunho, Publicando, Ativo, Pausado, Sem estoque, Em revisão, Encerrado e Com erro, botões Importar anúncios e Publicar produtos, filtros e a tabela de anúncios com produto, status e saúde, preço, quantidade, avisos e ações
Anúncios em todas as situações: rascunho, publicando, ativo, pausado, sem estoque, em revisão, encerrado e com erro.
SituaçãoSignificado
Rascunho / PublicandoCriado aqui e ainda não publicado / publicação em andamento pela fila (lote). Rascunho com erro mostra o motivo do ML e pode ser corrigido no detalhe.
Ativo / PausadoÀ venda / pausado por você. Reativar volta a vender.
Sem estoqueQuantidade zerou: o Mercado Livre pausa sozinho e volta sozinho quando repõe (não precisa reativar).
Em revisãoO Mercado Livre está revisando (moderação, catálogo, qualidade). Acompanhe pelo painel do ML.
EncerradoDefinitivo: para vender de novo, publique outro anúncio.
Com erroO ML recusou a publicação ou uma atualização; o texto do erro aparece traduzido na linha e no detalhe.
Menu Mais ações de um anúncio ativo com Pausar, Sincronizar agora e Encerrar
Menu "Mais ações": pausar, reativar, sincronizar agora, encerrar (definitivo, com confirmação), excluir rascunho, ajustar estoque.

Detalhe do anúncio (clique no título): abas Dados (título ou nome de família em contas User Products, categoria, tipo, garantia, frete, atributos da categoria, descrição com "Gerar com IA"), Preço e estoque, Fotos, Fiscal (NCM, CEST, origem enviados ao ML), Histórico e Fila (sincronizações pendentes). Salvar envia só o que mudou.

Detalhe do anúncio Fone Bluetooth Sonora XT-200, aba Dados: título com contador de 60 caracteres, aviso de que o anúncio tem 37 vendas e o Mercado Livre não deixa mudar o título, categoria, tipo de anúncio, garantia e frete, e os botões Pausar, Sincronizar agora, Encerrar e Salvar alterações
Aba Dados. Anúncio com vendas: o ML não aceita trocar o título — a tela avisa antes.
Aba Preço e estoque: preço enviado e preço no Mercado Livre, interruptor Preço gerenciado no Mercado Livre, link para alterar o preço do canal no produto, sugestão de preço do ML, tarifa prevista por tipo de anúncio com o que você recebe, quantidade enviada, no ML e vendida, e o interruptor Quantidade fixa
Aba Preço e estoque: tarifa prevista por tipo, sugestão de preço, quantidade calculada e a opção de quantidade fixa.

Assistente de publicação (7 passos)

Clique em Publicar produtos. Um produto é publicado na hora; vários vão para a fila (lote), com as opções comuns.

  1. Produtos: produtos sem anúncio vivo, com busca e filtros "com código de barras" e "com foto"; selos mostram o que falta em cada um (GTIN, foto, marca, peso, NCM) e se já há rascunho.
  2. Categoria: a sugerida pelo Mercado Livre, outras sugestões e busca; categoria que não aceita anúncio aparece desabilitada. Quando o produto existe no catálogo do ML (pelo GTIN), a tela oferece publicar no catálogo.
  3. Campos que faltam: o que impede a publicação (atributo obrigatório, foto, categoria, preço zero, grade sem variação) e o que é recomendado (GTIN, medidas, NCM). "Completar o produto" grava direto no cadastro (vale para a loja, o PDV e a nota fiscal). Atributos condicionais aparecem conforme você preenche.
  4. Tipo e preço: Grátis, Clássico ou Premium com a tarifa prevista e o que você recebe; preço vindo do produto (canal Mercado Livre › promoção › tabela › preço de venda) e a quantidade calculada (disponível − margem) ou fixa.
  5. Frete e garantia: Mercado Envios ou envio próprio, frete grátis, retirada no local; tipo e tempo de garantia.
  6. Título e descrição: título até 60 caracteres (ou nome de família em contas User Products, em que o ML gera o título) e descrição em texto puro; Gerar com IA propõe os dois a partir do cadastro.
  7. Revisão: a Brasmobi valida o anúncio no Mercado Livre antes de publicar; se o ML recusar, o motivo aparece e você volta ao passo certo.
Assistente Publicar no Mercado Livre, passo 1 de 7 Produtos: busca, filtros com código de barras e com foto, cartões dos produtos sem anúncio com os selos do que falta e o Tapete de Yoga selecionado
Passo 1: escolha dos produtos, com os selos do que falta em cada um.
Passo 2 Categoria: categoria sugerida Tapetes de Yoga com o caminho completo, outra sugestão, busca de outra categoria e o aviso de que o produto existe no catálogo do Mercado Livre
Passo 2: categoria sugerida e oferta de publicar no catálogo.
Passo 3 Campos que faltam: item em vermelho impede a publicação (atributo Material), itens recomendados (medidas e NCM) e o formulário Completar o produto com peso, medidas, NCM, CEST e origem da mercadoria
Passo 3: o que impede (vermelho) e o que é recomendado; "Completar o produto" grava no cadastro.
Passo 4 Tipo e preço: cartões Grátis, Clássico e Premium com tarifa e o que você recebe, preço do anúncio com a origem e a quantidade que vai ao anúncio com a opção de quantidade fixa
Passo 4: tipo de anúncio com a tarifa prevista, preço do canal e quantidade.
Passo 5 Frete e garantia: forma de envio Mercado Envios, frete grátis, retirada no local, aviso de produto sem peso ou medidas, tipo e tempo da garantia
Passo 5: frete e garantia deste anúncio.
Passo 6 Título e descrição: título gerado pela IA com contador de 60 caracteres e a descrição em texto puro
Passo 6: título (até 60) e descrição, com "Gerar com IA".
Passo 7 Revisão: resumo com título, categoria, tipo Premium, preço, tarifa prevista, quantidade, frete, garantia, atributos, dados fiscais e fotos, avisos e a confirmação de que o Mercado Livre aceitou o anúncio, com o botão Publicar anúncio
Passo 7: revisão validada no Mercado Livre e o botão "Publicar anúncio".
Assistente concluído: Anúncio publicado no Mercado Livre, com o código MLB, o status Ativo e os botões Ver no Mercado Livre, Ver detalhes e Publicar outro produto
Publicado: código MLB, link para o anúncio e atalho para o próximo.
Assistente no celular, passo 3 de 7, com barra de progresso, a lista do que falta e o formulário Completar o produto; botões Voltar e Avançar fixos no rodapé
No celular o assistente ocupa a tela inteira, com "Passo N de 7" e os botões fixos no rodapé.

Importar anúncios que a conta já tem

Modal Importar anúncios que a conta já tem: filtro Ativos, botão Buscar no Mercado Livre, total e já vinculados, tabela com cada anúncio, situação, preço, disponível, SKU e GTIN, sugestão de produto da Brasmobi por SKU ou código de barras, busca de produto, botão Vincular e botão de criar o produto a partir do anúncio
Importação: vincule pela sugestão (mesmo SKU ou mesmo código de barras), escolha o produto ou crie o produto a partir do anúncio ("+").
  • Depois de vinculado, o anúncio passa a receber estoque e preço daqui. A importação nunca reduz o anúncio: se a Brasmobi tem menos disponível que o ML, a tela mostra a divergência e você decide ("Ajustar estoque").
  • Criar o produto a partir do anúncio traz nome, marca, GTIN, grade, até 6 fotos e o estoque inicial igual à quantidade do anúncio (exige permissão de cadastrar produtos).
  • Anúncios do Full ficam com o estoque só de leitura; anúncios no catálogo recebem o selo e o acompanhamento do "preço para ganhar".

Estoque e preço sincronizados

  • Quantidade publicada = disponível do depósito de origem (físico − reservas) − margem de segurança, ou a quantidade fixa do anúncio. Toda movimentação do kardex (venda no PDV, na loja, compra, ajuste, inventário) entra numa fila com debounce: dez movimentos no mesmo minuto viram um envio só. Zerou, o Mercado Livre pausa por falta de estoque; repôs, volta sozinho.
  • Preço = preço do canal Mercado Livre do produto › promoção › tabela de preço › preço de venda. Mudou no produto (ou na loja), vai para o anúncio. O preço nunca é enviado sozinho ao ML (regra do Mercado Livre): sempre acompanhado da quantidade ou dos atributos.
  • Preço gerenciado no ML: ligado por você no detalhe (ou automaticamente durante uma promoção), a Brasmobi deixa de enviar preço para aquele anúncio. Com ele desligado, preço alterado no painel do ML vira aviso e o preço do canal é reenviado.
  • Dados, fotos e fiscal (NCM, CEST, origem) também seguem o produto. O anúncio guarda só o que é do ML: categoria, tipo, garantia, atributos sem campo no produto e título editado.
  • Full: o estoque está no Mercado Livre e é só leitura; divergência entre o depósito Full e o ML vira aviso, nunca ajuste automático.
  • A fila aparece na aba Fila do detalhe e nos indicadores; erro esgotado (10 tentativas) fica visível com o motivo.
Tela Anúncios no celular: indicadores em dois por linha, chips de situação, botões Importar anúncios e Publicar produtos e os filtros
Anúncios no celular (os anúncios vêm em cartões).

Vendas

Mercado Livre › Vendas recebe cada pedido (e cada carrinho, com um pedido por item) assim que o Mercado Livre avisa. Indicadores de hoje, 7 dias, a enviar, itens sem vínculo, liberado sem baixa e a liberar; atalhos de envio e NF-e (etiquetas para imprimir, prontos há mais de 24 h, envio próprio sem rastreio, pagos sem NF-e, NF-e com erro, XML fora do ML); chips por situação; busca por pedido, carrinho, envio, comprador ou item; filtros de envio, NF-e e período; seleção em lote para etiquetas.

Tela Vendas: seis indicadores, atalhos de envio e NF-e, chips de situação de Aguardando pagamento a Devolvido, filtros, botão Conta de repasse e a tabela de pedidos com comprador, itens, valor e líquido, status, envio e NF-e
Vendas em todas as situações, com envio e NF-e na própria linha.

O que acontece com a venda (tudo idempotente: aviso repetido não baixa duas vezes):

QuandoA Brasmobi faz
Pedido criadoGrava o pedido e os itens, ligando cada item ao produto pelo anúncio. Item de anúncio que não está vinculado fica sem vínculo e não baixa estoque até você vincular.
PagoCria/atualiza o cliente em Cadastros › Pessoas (documento e endereço dos dados fiscais do comprador), baixa o estoque item a item pelo kardex (origem marketplace, custo médio congelado; sem saldo baixa negativo e avisa) e cria o título a receber pelo líquido (bruto − tarifa de venda − frete do vendedor), com vencimento na liberação prevista. O frete do vendedor é apurado antes do título nascer.
Dinheiro liberadoBaixa o título na conta de repasse. Se o Mercado Pago liberou um valor diferente do título (além de R$ 0,05), a baixa automática é suspensa e você escolhe como baixar (veja Repasse).
CanceladoEstorna baixas do título, cancela o título e devolve o estoque pelo custo da saída original — tudo numa transação.
DevoluçãoQuando o produto chega, você registra "devolução recebida" (total ou parcial): o estoque volta pelo custo da saída original e, se houver NF-e, a nota de devolução pode ser emitida. Uma devolução por item: o teto de cada item é o que saiu e ainda não voltou e, quando há devolução aberta no Mercado Livre, o que ele diz que volta (return_quantity) menos o que já voltou desde a abertura da reclamação. Vendas e Reclamações contam no mesmo teto: registrada por uma tela, a tentativa pela outra é recusada com o motivo ("A devolução já foi registrada em Vendas em dd/mm/aaaa hh:mm — o estoque já recebeu essas unidades") e a reclamação fica marcada como recebida. O reembolso ao comprador chega pelo pagamento: título em aberto é cancelado; reembolso parcial ou com repasse já baixado vira aviso para você conferir.

Detalhe da venda

Abas Itens, Pagamento, Envio, Nota fiscal e Linha do tempo; ações: marcar separado, reimportar do Mercado Livre, registrar devolução recebida, etiqueta, informar envio, emitir NF-e.

Detalhe do pedido 2000077003, aba Itens: item Boné Aba Curva sem vínculo com o botão Vincular produto, quantidade, preço, tarifa e subtotal; bloco Comprador com nome, CPF mascarado e endereço de entrega; botões Marcar separado e Reimportar do Mercado Livre
Aba Itens: item sem vínculo com "Vincular produto"; comprador com documento mascarado.
Modal Vincular item a um produto: busca por nome, SKU ou código de barras e a opção Lembrar este vínculo no anúncio
Vincular item: "lembrar" grava o vínculo no anúncio e aplica aos itens iguais de outros pedidos; pedido pago baixa o estoque na hora.
Detalhe do pedido, aba Linha do tempo: eventos de pedido recebido, pagamento aprovado, cliente vinculado, estoque baixado, título criado e envio
Linha do tempo: cada passo (importado, pago, cliente, baixa, título, envio, NF-e, erros) com data e origem.
Detalhe da venda no celular, com as abas Itens, Pagto, Envio, NF-e e Histórico e os itens em cartões
No celular os itens viram cartões e as abas ganham rótulos curtos.

Envio e etiquetas

  • Mercado Envios (drop off, agência, coleta): quando o envio fica pronto para envio, a etiqueta é liberada — imprima em PDF ou baixe em ZPL (impressora térmica) pela linha, pelo detalhe ou em lote (selecione os pedidos; carrinho = uma etiqueta). Reimpressão é permitida; pedidos ainda não prontos são informados.
  • Flex (Mercado Envios com entrega própria): sem etiqueta do ML, você entrega e o ML acompanha.
  • Full: o Mercado Livre separa e envia; aqui é só acompanhamento, e a nota sai pelo Faturador.
  • Envio próprio: Informar envio com transportadora, código e link de rastreio. O pedido vai a enviado aqui e o rastreio é enviado ao ML (se o ML não confirmar, fica registrado localmente e a tela diz).
  • Status do envio seguem o ML: pronto para envio → a caminho → entregue; não entregue e envio cancelado viram alerta na linha do tempo. A NF-e pendente (invoice_pending) também avisa.
Detalhe do pedido 2000077006, aba Envio: envio pelo Mercado Envios pronto para envio com a data limite para despachar e a entrega prevista, botões Imprimir etiqueta (PDF) e Etiqueta ZPL e a linha do tempo do envio
Aba Envio: prazo de despacho, entrega prevista e os botões de etiqueta.
Barra de seleção em lote: 2 pedidos selecionados, botões Etiquetas (PDF) e Etiquetas (ZPL) e Limpar seleção
Etiquetas em lote: marque os pedidos e imprima todas de uma vez.
Lista de vendas filtrada pelo pedido 2000077006 com o menu Mais ações aberto: Etiqueta (PDF), Etiqueta (ZPL) e Emitir NF-e
Menu "Mais ações" da linha: etiqueta, informar envio, emitir NF-e, XML e DANFE conforme a situação.
Modal Informar envio com transportadora, código de rastreio e link de rastreio
Envio próprio: informe a transportadora e o rastreio.

Nota fiscal da venda

  • Emissor da Brasmobi (modo A): a nota do carrinho inteiro vai para a fila de emissão; o número é reservado só na hora de transmitir; CFOP e DIFAL saem da natureza de operação (venda para outro estado sem natureza com CFOP 6xxx é bloqueada com mensagem, nunca remendada); o intermediador (Mercado Livre) vai na nota; frete pago pelo comprador rateado nos itens; tarifa do ML fora da nota. Autorizada, o XML é enviado ao Mercado Livre e o status vira emitida.
  • Faturador do Mercado Livre (modo B): a Brasmobi pede a nota ao ML e acompanha; autorizada, baixa o XML e registra em Notas Fiscais como documento de terceiro (origem Mercado Livre). Negócio sem emissor cadastrado guarda o XML no pedido e avisa; cadastrado o emissor, "Registrar no Fiscal" completa.
  • Devolução: NF-e de entrada referenciando a nota da venda, com o CFOP de devolução derivado do CFOP que a venda usou (sem o XML de origem, a tela pede o CFOP).
  • XML e DANFE ficam na aba Nota fiscal e no menu da linha, só para quem gerencia vendas (o documento traz CPF e endereço completos).
Aba Nota fiscal de uma venda com erro de emissão: motivo CFOP 5102 do cadastro não serve para venda a outro estado e as saídas para emitir de novo ou pedir ao Faturador do ML
NF-e com erro: o motivo da SEFAZ ou da porta fiscal e o que fazer (corrigir e emitir de novo, ou pedir ao Faturador).
Aba Nota fiscal de uma venda emitida pelo emissor da Brasmobi: situação Emitida, chave de acesso, XML no Mercado Livre não enviado com o motivo e o botão Enviar XML ao ML, e a linha do tempo da nota
Nota emitida aqui e XML ainda não aceito pelo ML: reenvie pelo botão (o endpoint de envio do XML é confirmado no teste real).

Repasse e reembolso

Aba Pagamento: valores bruto, tarifa, frete do vendedor e líquido; pagamento aprovado e liberado; título a receber; alerta de que o Mercado Pago liberou um valor diferente do título com os botões Baixar pelo valor do Mercado Pago e Baixar pelo valor do título
Repasse divergente: a baixa automática é suspensa e você escolhe como baixar.
  • Conta de repasse (botão na tela de Vendas): a conta bancária do Financeiro onde a liberação do Mercado Pago baixa o título. Sem conta, o título fica em aberto com um aviso "baixar manualmente" e o dashboard lembra.
  • Divergência maior que R$ 0,05 entre o líquido liberado e o título: nenhuma baixa automática. "Baixar pelo valor do Mercado Pago" quita o título e lança a diferença como desconto ou juros; "pelo valor do título" baixa o valor cheio. Diferenças de centavos são baixadas sozinhas (os centavos vão como desconto/juros). Exige a permissão de baixar contas a receber.
  • Reembolso parcial (um de dois cartões, por exemplo) ou reembolso de venda com repasse já baixado: o título é mantido e aparece "Marcar reembolso como conferido" depois que você acertar no Financeiro.
Aba Pagamento de uma venda com reembolso parcial: aviso e o botão Marcar reembolso como conferido
Reembolso parcial a conferir.
Modal Registrar devolução recebida com a quantidade por item e observação
Devolução recebida na própria venda: as unidades voltam ao estoque pelo custo da saída original. O teto por item é o mesmo do botão "Recebi a devolução" da reclamação — quem registrar primeiro vale.
Tela Vendas no celular: pedidos em cartões com número, comprador, situação, envio e valor
Vendas no celular: cada pedido vira um cartão (os indicadores e filtros ficam acima da lista).

Atendimento

Três telas: Perguntas (antes da compra), Mensagens (pós-venda, por pedido) e Reclamações (com devoluções). As três leem o que o Mercado Livre avisou e têm o botão Buscar agora para conferir na hora. Em todas, textos com telefone, e-mail, link ou rede social são barrados antes de ir ao Mercado Livre (o ML modera e a reputação cai).

Perguntas

Tela Perguntas: indicadores sem resposta, esperando há mais de 2 horas, respondidas hoje, tempo médio de resposta e resposta automática com IA ligada; chips Sem resposta, Respondidas, Encerradas e Todas; lista com cada pergunta, a sugestão da IA com a confiança e o motivo de não ter respondido sozinha, o campo de resposta com contador e os botões Sugerir com IA e Responder
Perguntas sem resposta com a espera em destaque (mais de 2 h pesa na reputação).
Uma pergunta com a sugestão da IA copiada para o campo de resposta pelo botão Usar esta sugestão, com o contador de caracteres
"Usar esta sugestão" copia o texto da IA para o campo; você revisa e envia.
  • Sugerir com IA: a IA lê título, atributos, descrição, garantia, logística e as perguntas já respondidas do anúncio e propõe a resposta (nunca envia sozinha).
  • Resposta automática (opção em Configurações, desligada por padrão): responde sozinha só quando todas valem — pergunta sem assunto sensível (preço, pagamento, prazo, frete, estoque, garantia, troca, contato, pedido já feito, nota fiscal), anúncio com dados (vinculado a um produto), confiança da IA ≥ 85% usando só dados do cadastro, resposta sem preço, prazo, estoque, contato nem evasivas. Qualquer dúvida vira sugestão com o motivo escrito ("a pergunta fala de preço", "confiança baixa (72%)"). Até 100 perguntas analisadas pela IA por dia por negócio (as automáticas e as do botão "Sugerir com IA" contam juntas); atingido o limite, só a resposta automática para — o "Sugerir com IA" continua funcionando.
  • Pergunta de anúncio não importado aparece pelo título do ML, marcada "sem produto vinculado" (a IA não tem dados dele).
  • Falha de rede ao responder: o envio não é repetido às cegas — a pergunta é reconsultada e, se o ML já mostra a resposta, fica como enviada. Resposta reprovada pela moderação do ML vira erro claro.
Perguntas no celular: indicadores, chips e a pergunta em cartão com a sugestão da IA
Perguntas no celular.

Mensagens pós-venda

Tela Mensagens: lista de conversas à esquerda com comprador, última mensagem e pedido; conversa com MARIA_SILVA aberta à direita com as mensagens do comprador e do vendedor, aviso de que não foi possível atualizar com o Mercado Livre, o campo de envio com a assinatura incluída e o contador de 330 caracteres
Conversa por pedido: mensagens do comprador à esquerda, as suas à direita, com a assinatura e o limite de 350 caracteres (a assinatura conta).
Conversa sem mensagem do comprador: aviso de que o Mercado Livre só deixa iniciar por um dos motivos permitidos, o seletor Escolha o motivo e o campo da mensagem
Enquanto o comprador não escreveu, o Mercado Livre só deixa você iniciar por um motivo da lista dele.
  • Conversa bloqueada pelo ML (prazo encerrado, reclamação aberta) aparece com o motivo e sem campo de envio.
  • Abrir a conversa marca as mensagens como lidas aqui e no ML; o selo "não lidas" do cabeçalho e o dashboard acompanham.
  • "Nova conversa" pelo número do pedido ou do carrinho; "Ver venda" leva ao detalhe. Anexos do comprador aparecem pelo nome (abra no Mercado Livre); envio de anexo não está disponível.
Mensagens no celular: a lista de conversas
No celular, primeiro a lista...
Mensagens no celular: a conversa aberta com o botão de voltar
...depois a conversa, com "voltar".

Reclamações e devoluções

Tela Reclamações: indicadores abertas, prazo vencendo em 48 horas, devoluções a receber e encerradas; chips de filtro; tabela com número, motivo e venda, situação (aberta, em mediação), prazo com a ação esperada e a devolução com rastreio
Reclamações abertas, com o prazo que o Mercado Livre espera e a devolução em andamento.
Detalhe da reclamação 5000077301: aviso de que não foi possível atualizar com o Mercado Livre, prazo para responder em destaque, blocos Reclamação e Devolução (entregue ao vendedor, dinheiro retido, rastreio), o que o Mercado Livre permite agora, mensagens, e os botões Recebi a devolução, Ir para e Fechar
Detalhe: prazo em destaque, devolução entregue ao vendedor, mensagens da reclamação e as ações.
Modal Recebi a devolução: item, quanto saiu do estoque, quanto já voltou, quanto chegou agora preenchido com o que o Mercado Livre indica, observação e o botão Registrar devolução
"Recebi a devolução": confira o que chegou; as unidades voltam ao estoque pelo custo da venda original, limitadas ao que o ML diz que volta.
  • Responder ao comprador ou à mediação é feito aqui; reembolsar, aceitar a devolução e as demais ações são feitas no painel do Mercado Livre ("Ir para › Abrir no Mercado Livre"). Sem resposta no prazo, o ML decide a favor do comprador e a reputação cai.
  • "Recebi a devolução" e a devolução registrada em Vendas são a mesma devolução: cada item tem um só teto (o return_quantity da devolução menos o que já voltou desde a abertura da reclamação). Se já foi registrada pela outra tela, o botão some e o detalhe explica ("A devolução já foi registrada em Vendas em dd/mm/aaaa hh:mm — o estoque já recebeu essas unidades"); uma segunda tentativa é recusada com esse motivo e a reclamação fica marcada como recebida. Venda ainda não importada é recusada com explicação. A linha do tempo da venda ganha o evento e, com NF-e emitida, a nota de devolução pode sair (automática se a opção estiver ligada).
Reclamações no celular, em cartões com prazo, ação esperada e devolução
Reclamações no celular.

Aplicativo no SaaS (Administrador da Brasmobi)

A Brasmobi tem um aplicativo no DevCenter do Mercado Livre, "Brasmobi Marketplace". O cartão Mercado Livre — aplicativo Brasmobi Marketplace em Configurações do SaaS (só o Administrador do SaaS vê) guarda o App ID e o Client Secret (gravado cifrado, nunca exibido — em branco mantém o atual) e mostra, para copiar e cadastrar exatamente iguais no DevCenter: a Redirect URI (https://sistema.brasmobi.com/api/mercadolivre_retorno.php), a URL de notificações (https://sistema.brasmobi.com/api/mercadolivre_notificacoes.php) e os tópicos a marcar (orders_v2, items, items_prices, questions, messages, shipments, claims, payments, price_suggestion, stock_locations, catalog_item_competition_status). Tópico não marcado no aplicativo nunca chega aqui. Enquanto o cartão estiver incompleto, o botão "Conectar" não aparece para os negócios.

Cartão do aplicativo Brasmobi Marketplace em Configurações do SaaS: App ID 3054194227811421, Client Secret mascarado, tópicos de notificação a marcar, Redirect URI e URL de notificações com botão de copiar
Configurações do SaaS: o cartão do aplicativo, com o App ID, o Client Secret mascarado, os tópicos a marcar e as duas URLs para copiar (desktop).
O cartão do aplicativo no celular
O cartão do aplicativo no celular.

Regras de negócio importantes

  • Uma conta por negócio. A conta do Mercado Livre identifica o negócio quando um aviso chega; duas conexões da mesma conta seriam ambíguas, então a segunda é recusada.
  • O produto é o mestre. Nome, preço, fotos, grade e dados fiscais vêm do Estoque; o anúncio guarda só o que é do ML. Editar o produto atualiza o anúncio; editar o anúncio no painel do ML gera aviso (e o preço é devolvido, salvo "preço gerenciado no ML").
  • Estoque publicado = disponível do depósito de origem − margem, ou quantidade fixa por anúncio. Baixa e retorno passam sempre pelo kardex; nenhum número é digitado no anúncio à mão.
  • Preço do canal. O anúncio usa o preço do canal Mercado Livre do produto (depois promoção, tabela, preço de venda). Promoção do ML trava o preço até acabar.
  • Título pelo líquido. O que entra no Contas a Receber é bruto − tarifa − frete do vendedor, com vencimento na liberação prevista. O frete pago pelo comprador fica com o Mercado Envios.
  • NF-e: modo automático, emissor ou Faturador; carrinho = uma nota; Full = Faturador; a nota nunca é emitida duas vezes para a mesma venda (trava por referência).
  • Ao pagar / cancelar / devolver: baixa, cliente e título; estorno e retorno do estoque; retorno ao registrar a devolução recebida e tratamento do reembolso — sempre idempotentes.
  • Uma devolução por item, compartilhada entre Vendas e Reclamações. O teto de cada item é o que saiu e ainda não voltou e, com devolução aberta no Mercado Livre, o que ele diz que volta menos o que já voltou desde a abertura da reclamação. As duas telas registram no mesmo ponto: a segunda tentativa, por qualquer uma, é recusada com o motivo e a reclamação fica marcada como recebida — o estoque nunca recebe a mesma unidade duas vezes.
  • Resposta automática com IA só com confiança alta e assunto não sensível; nunca inventa preço, prazo, estoque ou contato; dúvida vai para você.
  • Repasse divergente não baixa sozinho: você escolhe o valor.
  • Dados pessoais: quem só consulta vê documento e endereços mascarados; XML/DANFE e dados completos só para quem gerencia vendas; CSVs saem com o comprador mascarado.
  • Avisos nunca são confiados às cegas: cada notificação é reconsultada no Mercado Livre com o token da conta antes de qualquer efeito.

Permissões por perfil

PermissãoLiberaPerfis padrão
Acessar o Mercado LivreVisão geral e status da contaAdministrador, Gerente, Loja virtual, Estoque e Compras, Visualizador
Listar / gerenciar anúnciosVer anúncios / publicar, importar, editar, pausar, aplicar preço, promoçõesListar: todos acima · Gerenciar: Administrador, Gerente, Loja virtual, Estoque e Compras
Listar / gerenciar vendasVer vendas (dados mascarados) / vincular, separar, devolução, etiquetas, envio, NF-e, XML/DANFE, repasseListar: Administrador, Gerente, Loja virtual, Visualizador · Gerenciar: Administrador, Gerente, Loja virtual
AtendimentoPerguntas, mensagens e reclamações (ler e responder)Administrador, Gerente, Loja virtual
RelatóriosKPIs, margem, relatórios CSV, "Atualizar reputação"Administrador, Gerente, Loja virtual, Visualizador
ConfiguraçõesConectar/desconectar, padrões, NF-e automática, diagnósticoAdministrador

Baixar repasse e conferir reembolso exigem também a permissão de baixar contas a receber (Financeiro); completar o produto no assistente exige alterar produtos; criar produto na importação exige cadastrar produtos. Papéis são personalizáveis em Equipe e acessos.

Perguntas frequentes

O aplicativo "Brasmobi Marketplace" ainda não foi configurado no SaaS (App ID e Client Secret) ou o seu plano não inclui o módulo. Fale com o suporte da Brasmobi.

Só o usuário principal (titular) da conta de vendedor pode autorizar aplicativos. Saia da conta de operador/colaborador no navegador, entre com o titular e clique em Conectar de novo.

A sincronização passa pela fila e roda a cada minuto. Veja a aba Fila do anúncio e o indicador "Sincronizações com erro": anúncio com quantidade fixa não segue o estoque; anúncio do Full é só leitura; conta pedindo reconexão não envia nada até reconectar.

A Brasmobi é a fonte do preço: mude o preço do canal Mercado Livre no produto. Se você prefere controlar o preço pelo painel do ML, ligue "Preço gerenciado no Mercado Livre" no detalhe do anúncio.

O anúncio daquele item ainda não está ligado a um produto da Brasmobi. Abra a venda, clique em "Vincular produto" (com "lembrar" marcado) e o estoque baixa na hora; os próximos pedidos daquele anúncio já chegam vinculados. Nada é vinculado por adivinhação.

Divergência maior que R$ 0,05 suspende a baixa automática. Na aba Pagamento escolha "Baixar pelo valor do Mercado Pago" (a diferença vira desconto ou juros) ou "pelo valor do título". O valor do título é bruto menos tarifa menos frete do vendedor.

Cadastre a natureza de operação com o CFOP de venda fora do estado (6xxx) no Fiscal e emita de novo; a Brasmobi nunca troca o dígito do CFOP por conta própria. Enquanto isso, a venda pode sair pelo Faturador do Mercado Livre.

Só se a opção "Responder perguntas automaticamente com IA" estiver ligada em Configurações, e mesmo assim apenas em perguntas de característica, compatibilidade, uso ou medidas, com confiança alta e sem citar preço, prazo, estoque ou contato. A lista "Respondidas" mostra a origem (equipe ou automática).

Não. Responder à reclamação e registrar a devolução recebida são feitos aqui; reembolso, aceite da devolução e mediação ficam no painel do Mercado Livre ("Ir para › Abrir no Mercado Livre").

O que ainda depende de confirmação no teste real

O Mercado Livre não tem ambiente de testes: toda a integração foi construída e testada contra um servidor falso que segue a documentação oficial, mais os harnesses automatizados. O primeiro teste com usuários de teste do ML (criados a partir de uma conta vendedora, nunca a conta real) confirma os pontos abaixo. Até lá, cada um está implementado com o melhor candidato e, quando falha, avisa em vez de quebrar.

  • Conexão: o OAuth real com PKCE (S256) de ponta a ponta e a rotação do refresh token (uso único: o token velho tem de ser recusado) com um usuário de teste do ML; o formato real do payload da notificação (_id, attempts, sent/received); o retorno de GET /missed_feeds?app_id= com o token do aplicativo; as tags de GET /users/me (user_product_seller, messages_as_seller decidem o desenho dos anúncios e das mensagens).
  • Anúncios: grafia do corpo de POST /items/fiscal_information (confirmada em 28/10/2026: dado por SKU, com sku, title, type = single e tax_information{ncm, origin_type manufacturer|reseller|imported, origin_detail 0–8, cest, csosn}; falta só o perfil fiscal do vendedor na conta do ML, que o usuário de teste não tem); aceitação de URLs em variations[].picture_ids (não testável em conta User Products: lá cada variação é um item da família); GET /user-products/{id}/stock devolve x-version: 1 (confirmado).
  • Vendas: sale_fee por unidade; formato de GET /orders/billing-info/MLB/{id} e se o id é order.billing_info.id; money_release_status e net_received_amount em GET /payments/{id} (uma premissa errada vira aviso de divergência, não saldo errado); senders[].cost em /shipments/{id}/costs; carrinho com payment_id compartilhado; formato do resource do tópico payments.
  • Envio: POST /shipments/{id}/tracking para o rastreio do envio próprio; formato da etiqueta ZPL (texto ou ZIP) e os substatus que liberam a impressão; campos do formato novo do envio (x-format-new).
  • NF-e: o endpoint de envio do XML da nota emitida fora do ML (candidato POST /shipments/{id}/invoice_data?siteId=MLB) — se o MLB não aceitar XML externo, o emissor da Brasmobi fica para envio próprio/Flex e ME2/Full usam o Faturador; corpo e estados do Faturador (POST /users/{id}/invoices/orders, xml_location); CNPJ do intermediador no infIntermed (03.007.331/0001-41) e idCadIntTran = apelido da conta; se o Full exige mesmo o Faturador; cupom do vendedor como desconto; consumidor final de contribuinte (confirmar com o contador); o cProd que o Faturador grava no XML × o SKU do produto (se não for o SKU, toda devolução de venda faturada pelo ML passa pela escolha do item da nota na tela — já possível; se for, casa sozinha).
  • Atendimento: grafia de POST /post-purchase/v1/claims/{id}/actions/send-message, busca de reclamações e motivos, devolução v2; GET /messages/unread; formato do resource do tópico messages; POST /messages/action_guide/packs/{pack}/option, limite de 350 e cap_available; se POST /answers moderado devolve 400 ou 200 com BANNED; se um 5xx no POST de mensagem/reclamação de fato entrega (a Brasmobi confere antes de reenviar); conversation_status.substatus (os rótulos de bloqueio da conversa); message_date.read como "lida no painel do ML"; na devolução v2, orders[].return_quantity por item/variação e se order_id vem em cada entrada (a Brasmobi ignora a entrada de outro pedido do carrinho quando ele vem).
  • Gestão: forma de seller_reputation.metrics; Seller Promotions com app_version=v2 (formatos, corpo do POST por tipo, parâmetros do DELETE, se o preço do item passa ao preço da oferta e se um PUT de preço tira o anúncio da promoção); GET /users/{id}/shipping_options/free; status de price_to_win e suggestions; listing_prices.sale_fee_details.
  • Operação: as três linhas do crontab (tokens a cada 5 min, worker a cada minuto, diário às 04:31) precisam estar instaladas; os tópicos precisam estar assinados no DevCenter; o responsável técnico do emissor precisa estar preenchido em Notas › Configurações para qualquer NF-e sair. Os crons só trabalham com conexões de produção: as conexões marcadas como teste (as que os testes automatizados da Brasmobi criam contra o servidor falso) ficam fora da renovação de tokens, das filas e do diário — nenhuma credencial de teste chega ao Mercado Livre real, e um teste rodando ao mesmo tempo que o crontab não interfere nele.
Pronto para vender no Mercado Livre: conta conectada, padrões conferidos, produtos completos e o primeiro anúncio publicado — a próxima venda chega sozinha em Vendas, com o estoque baixado e o título no Financeiro.