Integrações na prática

O estoque que não bate com o portal: publicar é fácil, despublicar é o problema

Anúncio fantasma não gera reclamação imediata — gera atendimento inútil dias depois. Por que a retirada quebra e o que resolve.

Leonardo Peron4 min de leitura

Quem vende por classificado convive com duas reclamações que parecem opostas e têm a mesma causa. A primeira: "anunciei e o cliente ligou perguntando de um item que já saiu". A segunda: "tenho isso no pátio há três semanas e ninguém procurou".

As duas são o mesmo problema visto de lados diferentes — o estoque real e o estoque publicado deixaram de ser a mesma coisa.

Três estoques, não um

Numa operação que anuncia fora do próprio site existem pelo menos três versões da verdade ao mesmo tempo:

O físico. O que está no pátio, na loja ou no depósito agora.

O do sistema de gestão. O que o ERP ou o DMS acredita que existe. Já diverge do físico por causa de baixa não lançada, item reservado sem registro ou devolução em trânsito.

O publicado. O que os portais estão mostrando. Diverge dos outros dois por um motivo diferente e mais irritante: latência. Mesmo com integração, existe uma janela entre a mudança acontecer e o portal refletir.

A maior parte dos projetos trata só a ligação entre o segundo e o terceiro, e depois descobre que o primeiro nunca esteve certo. Vale conferir os três antes de culpar a integração.

Publicar é fácil, despublicar é o problema

Quase toda integração com portal é construída de olho na publicação: enviar foto, preço, descrição e atributos, na regra de cada canal. Funciona, é o pedaço divertido, e é o que a demonstração mostra.

O que quebra em produção é a retirada.

Quando o item sai, alguém precisa avisar todos os canais. Se um deles falhar — API fora do ar, token expirado, limite de requisição atingido — o anúncio continua no ar e ninguém percebe, porque falha de remoção não gera reclamação imediata. Ela gera atendimento inútil dias depois, e a equipe comercial atribui isso a "lead ruim".

O caso pior é a falha silenciosa: o portal responde 200, aceita a requisição e não remove, porque o anúncio estava em outro estado. Do lado de cá parece que funcionou.

Reconciliar é obrigatório

A conclusão que costuma demorar a chegar: não basta enviar mudanças, é preciso conferir o resultado.

Uma rotina de reconciliação lê o que cada portal está exibindo, compara com o que deveria estar, e reporta as diferenças. Ela roda todo dia, encontra o que a integração perdeu, e é o único jeito de o anúncio fantasma ter vida curta.

É o mesmo princípio que vale numa migração de base — provar que nada se perdeu exige comparar os dois lados, não confiar no processo que fez a carga. Integração contínua com portal tem exatamente a mesma natureza, só que o desencontro se repete todo dia em vez de uma vez só.

O que cada canal cobra de diferente

Não existe integração genérica que sirva para todos. Cada canal tem:

Regra de mídia própria. Quantidade mínima e máxima de fotos, proporção, tamanho, ordem. Foto que o canal recusa costuma derrubar o anúncio inteiro em vez de só ignorar a imagem.

Campos obrigatórios diferentes. O que é opcional num canal é obrigatório em outro, e o valor "não informado" às vezes é aceito e às vezes rebaixa o anúncio na busca interna do portal.

Limite de requisições. Enviar o catálogo inteiro a cada mudança esbarra em cota, e a estratégia de respeitar o limite da API determina se a atualização leva minutos ou horas.

Janela de atualização. Alguns canais processam em lote, com atraso próprio. Prometer tempo real onde o canal trabalha em lote é criar expectativa que a integração não pode cumprir.

Onde isso dói mais

Em concessionária o efeito é direto: veículo é item único, e anúncio fantasma de item único gera o pior atendimento possível — o cliente ligou por aquele carro específico. Some a isso a reputação no classificado, que costuma penalizar anunciante com muita retirada tardia.

Em varejo com muitos SKUs o problema muda de forma: não é o item específico, é o volume. Com milhares de itens, a divergência vira percentual, e percentual pequeno de catálogo grande ainda é muita gente atendida à toa.

Por onde começar

Antes de mexer na integração, vale medir a divergência atual. Uma extração do que cada canal está exibindo, comparada com o sistema de gestão, costuma responder em uma tarde se o problema é de publicação, de retirada ou de estoque mal lançado na origem — e os três pedem trabalho diferente.

Se a origem estiver certa e o desencontro for na ponta, o caminho é integração com reconciliação diária, não integração mais rápida. Velocidade sem conferência só faz o erro chegar antes.

Isso é o que fazemos em integração de sistemas

ERP, e-commerce, CRM, banco e planilha falando entre si por API, webhook ou arquivo. Sem duplicar pedido e sem uma pessoa no meio copiando dado.

Resposta em até 1 dia útil