ML MLAPPPricebot Mercado Livre
Product ADS Verificando serviço
Rotina Não consultada Próxima — Última —
Acesso ao painel Chave administrativa salva somente nesta aba

Gestão por anúncio

Produtos e margens

Custos e limites individuais. OFF deixa o anúncio sob seu controle, sem remover a promoção atual.

Colunas: mlb, sku, custo_produto, embalagem, margem_minima e margem_objetivo.

Informe a chave administrativa para carregar seus produtos.

Automação SKU / anúncio Custo
R$
Embalagem
R$
Mínima
%
Alvo
%
Rebate
preço · margem · lucro
Âncora
preço · margem · lucro
Estado Ações
Seu cadastro aparecerá aqui. Nenhum exemplo é importado automaticamente.
Rotina automática Autorizar, acompanhar ou pausar a verificação de hora em hora
Auditoria Ações de operador com IP e data/hora (somente admin)

Abra este painel com a chave administrativa para carregar os eventos.

Conexão e configuração Conta Mercado Livre, autenticação e URLs de retorno
Configuração

Aplicação Mercado Livre

  • Client ID e Secret
  • Callback HTTPS
  • Criptografia dos tokens
  • Somente conta real
URI de redirecionamento OAuth Carregando…
URL de retornos de chamada de notificação Carregando…
Laboratório e diagnóstico Consulta individual, simulação e JSON — uso avançado
Pricebot · Simular, revisar, autorizar

Encontre a promoção para sua margem

Consulte um anúncio ou User Product e compare as promoções disponíveis. Frete e tarifas podem ser consultados automaticamente para cada anúncio e preço. As consultas e os cálculos usam somente leitura. Escolha entre autorizar um plano ou permitir a rotina automática abaixo.

GET · somente leitura

Regras do seu pricebot

Valores por unidade para conferência e modos legados. Produtos importados usam os custos e as margens individuais da tabela.

Você escolhe as margens

A margem alvo deve ser igual ou maior que a mínima. O piso é obrigatório. Ofertas fixas com rebate individual podem superar o alvo e são comparadas pela margem mais próxima dele.

O percentual vem diretamente da API, sem redução de 0,012. O rebate pode divergir do painel: o limite protege a margem calculada, não garante o lucro real da venda. Desmarque para usar a avaliação conservadora.

Informe o custo do produto sem o frete da venda e sem as tarifas do Mercado Livre. O frete automático é uma estimativa do valor pago pelo vendedor, consultada na API.

O rebate é calculado individualmente pelos dados da API de cada anúncio e oferta: preço original × participação do Mercado Livre, mais o boost monetário confirmado, quando houver. Não há valor fixo de rebate compartilhado entre anúncios.

O imposto é 10%. Entre rebates da mesma prioridade de vigência, o Pricebot prioriza as ofertas que melhoram preço e lucro líquido sem piorar nenhum lado; faixa e alvo servem de desempate, respeitando a margem mínima e a faixa de preços permitida pela promoção. No modo automático, cada cenário usa o frete, a comissão e a tarifa fixa consultados na API para aquele preço.

A margem objetivo deve ser igual ou maior que a mínima. Ofertas com preço fixo, como SMART e boosts confirmados, são avaliadas no preço disponível, sem tentar alterá-lo. A nova adesão exige a margem mínima. O alvo também é teto, exceto em ofertas fixas com rebate individual validado: elas podem superá-lo. A escolha compara preço ao comprador e lucro líquido em reais antes do desempate por alvo. Somente ofertas ajustáveis com faixa válida entram na busca de outro preço.

O custo informado será usado para avaliar este plano. A planilha será vinculada por SKU com as colunas SKU, custo_produto e embalagem.

Primeiro simula. Nada é ativado ao calcular.
Rotina automática · primeira agora, depois a cada 1 hora

Âncora + campanha com rebate

Verifica ao habilitar ou salvar as regras e repete uma hora após cada conclusão. Gerencia até uma Âncora do vendedor e uma campanha ML com rebate por anúncio, com cálculo independente para cada oferta. Sem opção válida para um dos grupos, mantém apenas o outro.

Não consultada

Salva o identificador, os custos e as margens atuais. Produtos sem custo confirmado ficam bloqueados.

Informe a chave administrativa para consultar a rotina. Nenhuma ativação automática é iniciada por abrir esta página.

Ativas e programadas ocupam o grupo correspondente. O piso mínimo é obrigatório em cada oferta. No grupo ML, prioriza campanhas vigentes agora; futuras ficam como alternativa se nenhuma atual for elegível. Na mesma prioridade temporal, elimina rebates dominados: preço não maior e lucro líquido em reais não menor, melhorando ao menos um lado. Entre as opções restantes, desempata por faixa e proximidade do alvo. Rebates fixos individuais validados podem superar o alvo, mas nunca ficar abaixo da mínima. Empate financeiro exato preserva a participação atual. O estado ativo ou programado é confirmado pela API, sem forçar datas ou presumir a oferta vencedora no checkout. A Âncora ativa poderá sair mesmo dentro da faixa para priorizar rebate vigente aprovado com datas conclusivas: primeiro confirma a saída por GET e só depois adere, se necessário. Rebate já aderido e programado não recebe outro POST. Se o rebate ML selecionado já está ativo, o par pode ser preservado quando não houver conflito de preço com a Âncora nem candidata ML melhor, sem somar descontos, rebates ou margens. Se a Âncora já estiver acima do rebate, não reposiciona apenas por essa regra; continuam as avaliações normais de margem e seleção. Campanha futura, datas inconclusivas ou margem abaixo da mínima não autorizam retirar uma Âncora válida. Não recria a Âncora durante a prioridade vigente, exceto no reposicionamento de R$ 0,20 acima validado; rebate aderido com vigência incerta também impede nova Âncora, mas não autoriza excluir a existente. Uma consulta de detalhes pode confirmar a vigência ausente no retorno por item. Antes de preencher um grupo livre ou trocar uma oferta, reconfirma todas as identidades e condições. Participações protegidas, acumuláveis, desconhecidas ou duplicadas válidas exigem revisão, sem exclusão para forçar o par. Uma falha pode deixar só uma campanha ou nenhuma; a ausência confirmada recebe a tag Sem promoção. Respostas incertas exigem revisão. Mantenha o servidor ligado.

Exceção autorizada: se a Âncora está ativa com preço menor ou igual ao rebate aderido, aprovado e vigente, pode sair e voltar à mesma campanha por preço do rebate + R$ 0,20 (exemplo: R$ 39,79 → R$ 39,99). Vale para rebate em started, active, pending ou programmed: é prioridade operacional por preço, sem depender do rótulo programada no painel. Antes de sair, recota frete, comissão e margem nesse preço. Depois do DELETE confirmado, exige que a mesma Âncora volte como candidata, com faixa que aceite o preço exato. Somente nesse reposicionamento a Âncora pode superar o alvo, nunca a margem mínima. Não ajusta o preço para caber na faixa, não cria outra Âncora e não envia POST/DELETE ao rebate nesse fluxo. Preserva o status bruto retornado pela API. A API não informa se a Âncora causou o adiamento e não há garantia de ativação. O par já validado em + R$ 0,20 é mantido sem repetir saídas e entradas a cada hora. A Âncora pode perder elegibilidade após sair.

Campanhas DEAL, PRE_NEGOTIATED e UNHEALTHY_STOCK já aderidas serão preservadas para revisão, sem remoção automática.

Informe o custo e as margens para gerar uma prévia. Nenhuma ativação está autorizada.

Retorno completo em JSON

{
  "test_only": true,
  "read_only": true,
  "status": "aguardando_consulta"
}
Conta compradora x promoções

Os recursos de seller-promotions exigem uma conta habilitada para vender e anúncios elegíveis. A autorização de um plano vale apenas para aquela execução. A rotina de hora em hora tem uma autorização contínua separada e pode ser pausada acima.