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.
Nesta página
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
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.
Aplicativo "Brasmobi Marketplace" configurado no SaaS pelo Administrador da Brasmobi (veja Aplicativo no SaaS). Sem ele o botão Conectar nem aparece.
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.
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.
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
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).
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.
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.
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.
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.
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.
Sem conta conectada: o botão "Conectar com Mercado Livre".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
Padrões: valores sugeridos ao publicar; cada anúncio pode ter os seus.
Campo
O que faz
Tipo de anúncio
Grá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.
Garantia
Tipo (vendedor, fábrica, sem garantia) e tempo com unidade (dias, meses, anos) — o Mercado Livre exige a unidade.
Frete
Mercado Envios, envio próprio ou a combinar; frete grátis por padrão (o custo é descontado de você).
Fabricação própria
Ligado, 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 origem
O disponível deste depósito é o que vai ao anúncio; a venda no Mercado Livre baixa aqui.
Depósito do Full
Depó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 estoque
Quantidade 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 IA
Desligado (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 mensagens
Texto 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
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.
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 com a aba Resumo (desktop).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: 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
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).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.Promoções do Mercado Livre: participar com preço de oferta, acompanhar a vigência e sair.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
Relatórios em CSV (abrem no Excel): vendas com comprador mascarado, anúncios, margem e atendimento por dia.Visão geral no celular.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.
Anúncios em todas as situações: rascunho, publicando, ativo, pausado, sem estoque, em revisão, encerrado e com erro.
Situação
Significado
Rascunho / Publicando
Criado 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 estoque
Quantidade zerou: o Mercado Livre pausa sozinho e volta sozinho quando repõe (não precisa reativar).
Em revisão
O Mercado Livre está revisando (moderação, catálogo, qualidade). Acompanhe pelo painel do ML.
Encerrado
Definitivo: para vender de novo, publique outro anúncio.
Com erro
O ML recusou a publicação ou uma atualização; o texto do erro aparece traduzido na linha e no detalhe.
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.
Aba Dados. Anúncio com vendas: o ML não aceita trocar o título — a tela avisa antes.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.
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.
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.
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.
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.
Frete e garantia: Mercado Envios ou envio próprio, frete grátis, retirada no local; tipo e tempo de garantia.
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.
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.
Passo 1: escolha dos produtos, com os selos do que falta em cada um.Passo 2: categoria sugerida e oferta de publicar no catálogo.Passo 3: o que impede (vermelho) e o que é recomendado; "Completar o produto" grava no cadastro.Passo 4: tipo de anúncio com a tarifa prevista, preço do canal e quantidade.Passo 5: frete e garantia deste anúncio.Passo 6: título (até 60) e descrição, com "Gerar com IA".Passo 7: revisão validada no Mercado Livre e o botão "Publicar anúncio".Publicado: código MLB, link para o anúncio e atalho para o próximo.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
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.
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.
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):
Quando
A Brasmobi faz
Pedido criado
Grava 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.
Pago
Cria/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 liberado
Baixa 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).
Cancelado
Estorna baixas do título, cancela o título e devolve o estoque pelo custo da saída original — tudo numa transação.
Devolução
Quando 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.
Aba Itens: item sem vínculo com "Vincular produto"; comprador com documento mascarado.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.Linha do tempo: cada passo (importado, pago, cliente, baixa, título, envio, NF-e, erros) com data e origem.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.
Aba Envio: prazo de despacho, entrega prevista e os botões de etiqueta.Etiquetas em lote: marque os pedidos e imprima todas de uma vez.Menu "Mais ações" da linha: etiqueta, informar envio, emitir NF-e, XML e DANFE conforme a situação.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).
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).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
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.
Reembolso parcial a conferir.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.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
Perguntas sem resposta com a espera em destaque (mais de 2 h pesa na reputação)."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.
Mensagens pós-venda
Conversa por pedido: mensagens do comprador à esquerda, as suas à direita, com a assinatura e o limite de 350 caracteres (a assinatura conta).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.
No celular, primeiro a lista...
...depois a conversa, com "voltar".
Reclamações e devoluções
Reclamações abertas, com o prazo que o Mercado Livre espera e a devolução em andamento.Detalhe: prazo em destaque, devolução entregue ao vendedor, mensagens da reclamação e as ações."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.
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.
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.
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ão
Libera
Perfis padrão
Acessar o Mercado Livre
Visão geral e status da conta
Administrador, Gerente, Loja virtual, Estoque e Compras, Visualizador
Listar / gerenciar anúncios
Ver anúncios / publicar, importar, editar, pausar, aplicar preço, promoções
Listar: todos acima · Gerenciar: Administrador, Gerente, Loja virtual, Estoque e Compras
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.