A sincronização de produtos agora são quatro nós: estoque, preço, imagens e ficha
Os antigos nós de «estoque + produtos» faziam tudo no mesmo ritmo. Agora são quatro nós: estoque a cada 15 minutos, preço diário, imagens e ficha sob demanda.
Antes eram dois nós: channel.push_inventory (estoque) e channel.push_products (produtos). Um dizia «quanto resta», o outro «o que está à venda». Na prática era estranho: o estoque precisa ser enviado a cada 15 minutos; as informações do produto (títulos, imagens, preços) mal mudam uma vez por dia. Ou o estoque chegava atrasado e você vendia além, ou imagens e preços eram reenviados sem parar, gastando a cota de API da plataforma.
Por que quatro nós#
A lógica é uma frase: o que muda em velocidade diferente deve ser sincronizado separadamente.
- Estoque: cada venda reduz; numa grande promoção muda em minutos → a cada 15 minutos.
- Preço: é uma decisão humana, poucas vezes por dia no máximo → uma vez por dia, ou manual após cada alteração.
- Imagens: só mudam com novos cadastros ou trocas de imagem → sob demanda, sem agenda.
- Ficha (título / descrição / peso / código de barras): só muda ao criar ou editar um produto → sob demanda, sem agenda.
O que cada nó faz#
channel.push_product_inventory — sincronização de estoque
Envia o estoque disponível do OMS / WMS ao canal: o número de «restam X» que o comprador vê. É o mais ativo dos quatro e o único que deve rodar com agenda rigorosa.
- Ative: a cada 15 minutos com temporizador (padrão do modelo).
- Em grandes promoções pode ajustar para 5–10 minutos; observe o limite da API do canal.
- Só envia quantidades; não toca preço nem imagens, por isso é rápido e consome pouca cota.
channel.push_product_price — sincronização de preços
Envia o preço de venda ao canal. Preços são definidos por pessoas: só precisam ser enviados quando mudam.
- Uma vez por dia com temporizador (padrão do modelo), como rede de segurança.
- Após cada alteração de preço, execute manualmente uma vez: o novo preço vale na hora.
- Mantenha na própria agenda; não amarre ao nó de estoque.
channel.push_product_images — sincronização de imagens
Envia a imagem principal e as de detalhe ao canal. Imagens consomem mais banda e o canal as revisa mais devagar: não faz sentido agendá-las.
- Execute manualmente ao cadastrar um produto, trocar a imagem principal ou adicionar detalhes.
- Uma execução envia o conjunto completo; se só uma mudou, a maioria dos conectores permite enviar só ela.
- Após enviar, confira a vitrine: o canal usa cache de imagens e pode levar alguns minutos.
channel.push_product_profile — sincronização de ficha
Envia os campos de «ficha»: título, descrição, peso, dimensões, código de barras.
- Execute manualmente ao criar um produto ou editar título / descrição / peso.
- Campos que afetam o fulfillment (código de barras, peso) devem ser enviados logo após a alteração.
- Sem temporizador.
Como usar o modelo «Sincronização total de produtos»#
A biblioteca de modelos de Flow traz um modelo «Sincronização total de produtos»: um clique executa os quatro nós em ordem (estoque → preço → imagens → ficha). A forma mais rápida de publicar um produto novo num canal ou de atualizar tudo após refazer um cadastro.
- Vá em Integration → Flows → Novo de modelo e escolha «Sincronização total de produtos».
- Escolha a conexão: para qual canal esta sincronização envia (um Flow por canal).
- Revise o mapping de campos uma vez: confira se SKU, preço e imagens batem com o que o canal espera. Um mapping errado quebra os quatro nós.
- Clique Executar uma vez à mão: confirme que o produto aparece certo no canal antes de confiar nele.
- Use sempre que cadastrar ou editar produtos: é manual por design, não coloque temporizador.
Migrar dos nós antigos#
Os antigos channel.push_inventory e channel.push_products foram removidos — os Flows existentes devem usar os quatro novos nós. A correspondência:
- push_inventory (estoque) → push_product_inventory
- push_products (produtos) → divide-se em três: push_product_price (preço) + push_product_images (imagens) + push_product_profile (ficha)
Perguntas frequentes#
O estoque continua errado / vendi além — e agora?
Confira duas coisas: ① se o ritmo de 15 minutos basta para esta loja (aperte em picos de venda); ② se o canal limitou a API, o que pula envios em silêncio. Se estiver tudo bem, confira o mapping.
Posso alterar as agendas dos quatro nós?
Sim. Cada nó tem a própria agenda e não se afetam. Antes de acelerar, lembre: mais frequência = mais chamadas à API.
Enviei imagens mas a vitrine não mudou?
«Sucesso» no nó só significa que o envio saiu. O canal ainda tem revisão de imagens e cache de CDN: atraso de minutos a horas é normal. Confira primeiro o painel do canal.