Toda demonstração de integração com marketplace mostra a mesma cena: dois cliques, e o produto aparece anunciado.

A cena é verdadeira. O que ela esconde é o trabalho que veio antes — e que, na sua empresa, ainda não foi feito.

Este artigo é o checklist honesto. Ele não vai te convencer a integrar mais rápido; vai te poupar de descobrir os problemas com o catálogo inteiro no ar.

1. O seu cadastro não foi feito para vender

Esta é a raiz de quase tudo.

O cadastro de produtos de um ERP foi construído para emitir nota. Ele precisa de código, NCM, unidade, preço e uma descrição que caiba no DANFE. Por isso ele está cheio de coisas como:

PARAF SEXT 1/2 GALV

Isso funciona perfeitamente no faturamento. Como título de anúncio, não vende nada — e em muitos casos nem é aceito.

Para o canal, o mesmo produto precisa de:

  • título descritivo, com os termos que as pessoas realmente buscam;
  • descrição que responda dúvida de comprador;
  • foto que atenda os requisitos do canal;
  • atributos estruturados — e é aqui que a maioria trava.

2. A categoria manda no anúncio

Essa é a parte que surpreende quem nunca integrou.

No marketplace, a categoria não é só uma gaveta. Ela define quais atributos são obrigatórios. Eletrodoméstico pede voltagem. Peça automotiva pede marca, modelo e ano de aplicação. Roupa pede tamanho e cor. Ferramenta pede dimensões.

Sem esses atributos preenchidos, o anúncio não sobe. Não é uma advertência — é uma recusa.

E a categoria certa não se deduz do NCM. O NCM é uma classificação fiscal; a categoria do canal é uma taxonomia comercial. Elas não se correspondem, e a escolha errada leva a um anúncio que não aparece nas buscas certas.

Por isso, no InfoKaw, os atributos do canal ficam num cadastro próprio, ligado ao produto — a especificação exigida pela categoria de um lado, o valor daquele produto do outro. É trabalho de cadastro, feito uma vez por produto, e é o que permite publicar sem preencher formulário no painel toda vez.

3. “Preparado para o canal” não é “à venda no canal”

Uma distinção que parece sutil e evita muito problema.

Existe um momento em que o produto já está mapeado — categoria escolhida, atributos preenchidos, título e descrição prontos — mas você ainda não quer que ele esteja à venda. Talvez falte definir preço para o canal, talvez você queira revisar, talvez o estoque ainda não tenha sido remetido.

Esse estado intermediário precisa existir. No InfoKaw ele se chama rascunho: o produto está preparado, e não publicado.

Sem esse estado, a equipe é empurrada para uma escolha ruim — ou publica incompleto, ou não começa o mapeamento. Ter o rascunho permite preparar o catálogo com calma e publicar em lote quando estiver pronto.

Depois de publicado, o anúncio passa a espelhar o que acontece no canal: ativo (no ar, vendendo), pausado (existe, fora do ar — tipicamente por estoque zerado), encerrado (acabou, só volta com anúncio novo) e erro (a última tentativa falhou, e o motivo fica registrado).

Esse último é importante: quando a publicação falha, você precisa saber por quê, no próprio anúncio. Integração que só mostra “deu erro” transfere para você o trabalho de investigar.

4. A conexão com o canal expira

Detalhe técnico com consequência prática.

A integração direta com o Mercado Livre usa OAuth: você autoriza uma vez, e o sistema recebe um token que vale poucas horas, renovado automaticamente por um segundo token.

O que isso significa no dia a dia: se alguém revogar a autorização no painel do canal, ou se a senha da conta mudar de um jeito que invalide a autorização, a integração para. E ela para silenciosamente, com os pedidos deixando de entrar.

Vale saber onde essa autorização se renova e checar o status quando algo parecer estranho.

Vale mencionar a diferença: integrações por intermediário (um hub entre você e o canal) autenticam com uma chave fixa e costumam ser mais simples de configurar — em troca, você fica com mais um fornecedor no caminho, mais um custo e mais um lugar onde o problema pode estar. Integração direta com a API do canal tem uma peça a menos entre a sua venda e o seu sistema.

5. Os erros que aparecem na primeira semana

Separei os mais comuns, porque saber deles antes economiza dias:

“Atributo obrigatório ausente.” A categoria exige algo que o cadastro não tem. Corrija no produto, não no painel — senão você refaz a cada republicação.

Foto recusada. Requisitos de tamanho mínimo e fundo. Foto de catálogo de fornecedor costuma reprovar.

Título rejeitado ou fraco. Regras de formato variam, e título ruim simplesmente não aparece nas buscas.

Produto duplicado. Você publicou duas vezes o mesmo item, com códigos internos diferentes. É sinal de cadastro com duplicidade — que já era problema antes, e agora ficou visível.

Anúncio pausado sozinho. Quase sempre estoque zerado no canal. É a proteção funcionando, não um defeito.

6. Comece por dez produtos

O conselho que mais repito, e o mais ignorado.

Não integre o catálogo. Escolha dez produtos que atendam a três critérios:

  1. Giro previsível — você sabe quanto vende por semana;
  2. Margem folgada — comissão do canal e frete comem margem, e produto de margem apertada vira prejuízo com frete grátis;
  3. Estoque confortável — para não cancelar pedido por falta logo no começo, quando a reputação ainda está sendo construída.

Com dez produtos você descobre, em duas semanas e com risco baixo, tudo que este artigo descreve: quais atributos a sua categoria exige, como as suas fotos se comportam, qual é o seu tempo real de expedição.

Depois disso, ampliar é repetição. Antes disso, ampliar é multiplicar um problema que você ainda não conhece.

O roteiro, em ordem

  1. Escolha os dez produtos.
  2. Descubra a categoria de cada um no canal e quais atributos ela exige.
  3. Preencha os atributos no cadastro, não no painel.
  4. Escreva título e descrição pensando em quem busca, não em quem fatura.
  5. Ajuste as fotos.
  6. Deixe tudo em rascunho e revise.
  7. Remeta o estoque que você aceita expor ao canal.
  8. Publique.
  9. Só então ligue a importação automática de pedidos.
  10. Amplie depois de um mês sem cancelamento por falta.

A parte chata é da etapa 2 à 5, e ela é sua — nenhum sistema inventa a ficha técnica do seu produto. O que um bom sistema faz é garantir que esse trabalho seja feito uma vez, fique no cadastro e não precise ser repetido a cada publicação.

Se quiser avaliar quanto do seu catálogo já está pronto para o canal, a gente olha junto com os seus produtos na demonstração.