Sincronização de produtos da Shopify
Como produtos, pedidos e coleções são sincronizados entre a Shopify e o Umbrella.
Sincronização de produtos da Shopify
O Umbrella usa webhooks da Shopify para sincronizar automaticamente, em tempo real, seus produtos, coleções, pedidos, clientes e dados de processamento. Quando algo muda na sua loja Shopify, o Umbrella atualiza automaticamente a elegibilidade de garantia, os preços e os registros de apólices.
O que é sincronizado
Produtos
O Umbrella sincroniza título, handle, tipo, fornecedor, tags, variantes (ID, título, preço, SKU), imagens e a participação em coleções de cada produto. Esses dados alimentam as regras de correspondência dos planos de garantia (por exemplo, “aplicar a todos os produtos com a tag ‘electronics’”).
Pedidos
O Umbrella processa número do pedido, itens, informações do cliente, status de pagamento, status de processamento e dados de reembolso/cancelamento. Isso possibilita a criação e a ativação de apólices de garantia e o cálculo dos prazos para sinistros.
Outros dados
- Coleções — usadas nas regras de elegibilidade de garantia baseadas em coleções
- Clientes — associados às apólices de garantia para consultas por conta
- Processamentos — acompanhados para determinar quando começa o prazo para sinistros (se configurado para começar no envio)
Reprocessamento manual
Se os dados parecerem dessincronizados, inicie um reprocessamento manual em Painel → Configurações → Integrações → Shopify:
- Reprocessar produtos — busca novamente todos os produtos e atualiza o cache local
- Reprocessar pedidos — busca novamente os pedidos recentes e reconcilia as apólices de garantia
- Reprocessar coleções — busca novamente as coleções e atualiza as regras de elegibilidade
Catálogos grandes podem levar vários minutos para concluir.
Confiabilidade dos webhooks
- A Shopify entrega cada webhook pelo menos uma vez (duplicatas são tratadas com segurança)
- Se o endpoint do webhook estiver temporariamente indisponível, a Shopify tenta novamente com backoff exponencial por até 48 horas
- Use o reprocessamento manual para recuperar dados que tenham ficado de fora
Solução de problemas
| Problema | Solução |
|---|---|
| Produtos novos não aparecem nas regras de garantia | Aguarde 1 a 2 minutos pelo processamento do webhook e verifique o status de sincronização do produto |
| O pedido não cria uma apólice de garantia | Verifique se o pedido contém um item de garantia e se foi pago |
| O prazo para sinistros não começa | Confirme que o pedido foi processado |
| Produtos dessincronizados após importação em massa | Use o reprocessamento manual para atualizar todos os dados de produtos |
Relacionados
- Integração com a Shopify — configuração geral da conexão com a Shopify
- Extensões de checkout da Shopify — exibição de garantias no checkout
- Criação de planos de garantia — regras de elegibilidade de produtos
